Instalación

Instalación

Este guía muestra cómo configurar Aspose.Cells FOSS para C++ en su máquina de desarrollo, construir la biblioteca y verificar la configuración con un programa de creación de hoja de espalda mínima.


Prediciones

RequisitosDetalles
C++ CompiladorCompilador compatible con C++17 (GCC 9+, Clang 10+ o MSVC 2019+)
CómagoVersión 3.15 o superior
GitToda versión reciente
Sistema operativoLinux, MacOS o Windows

Paso 1 - Clone el repositorio

Clone el Aspose.Cells FOSS para repositorio de fuentes C++:

git clone https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Cpp.git
cd Aspose.Cells-FOSS-for-Cpp

Paso 2 - Construir las muestras

Utilice la configuración de CMake envuelta para construir el proyecto de muestras, que también compila la biblioteca:

cd samples
mkdir build
cd build
cmake ..
cmake --build .

La producción de la construcción coloca las binarias compiladas en el build/ Directorias .


Paso 3 – Incluir la biblioteca en su proyecto

Añade las cabezas de la biblioteca y el árbol de fuente a su propio CMakeLists.txt a través de FetchContent O un camino local incluye:

cmake_minimum_required(VERSION 3.15)
project(MyProject CXX)

set(CMAKE_CXX_STANDARD 17)

# Option A: local path
add_subdirectory(path/to/Aspose.Cells-FOSS-for-Cpp)

add_executable(MyApp main.cpp)
target_link_libraries(MyApp PRIVATE Aspose.Cells.Foss.Cpp)

Paso 4 - Verificar la instalación

Crea un mínimo main.cpp que crea y salva un archivo XLSX:

#include "aspose/cells_foss/Workbook.h"
#include "aspose/cells_foss/WorksheetCollection.h"
#include "aspose/cells_foss/Worksheet.h"
#include "aspose/cells_foss/Cell.h"

using namespace Aspose::Cells_FOSS;

int main() {
    Workbook workbook;
    Worksheet& sheet = workbook.GetWorksheets()[0];
    sheet.SetName("Hello");
    sheet.GetCells()["A1"].PutValue("Hello, Aspose.Cells FOSS!");
    workbook.Save("hello.xlsx");
    return 0;
}

Construcción y marcha. si hello.xlsx Se crea en el directorio de trabajo, la instalación es exitosa.


Consejos y mejores prácticas

  • Siempre usa el Aspose::Cells_FOSS El nombre espacial para evitar los conflictos de símbolos con otras bibliotecas.
  • El punto de entrada para la mayoría de las operaciones es el aspose/cells_foss/Workbook.h;• Incluye otros titulares como: Worksheet.h y Cell.h como se necesita.
  • Utilice CMake 3.15 o más reciente; las versiones anteriores pueden no soportar la configuración de meta envuelta.
  • Para las construcciones de producción, pasar -DCMAKE_BUILD_TYPE=Release para cmake para permitir optimizaciones.
  • Mantenga el directorio de clona como la raíz de su biblioteca; no copiar los títulos individuales — relativamente incluye caminos en los titulares de la biblioteca dependerá del diseño original del directory.

Problemas comunes

ProblemasCausasFixado
fatal error: aspose/cells_foss/Workbook.h: No such file or directoryIncluye el camino no configuradoSeguridad target_include_directories Punto de referencia a la biblioteca include/ Fólogo
undefined reference to Aspose::Cells_FOSS::Workbook::Workbook()Biblioteca no vinculadaañadir target_link_libraries(MyApp Aspose.Cells.Foss.Cpp) En la página CMakeLists.txt
Errores de versión CMakeCajón < 3.15Upgrade CMake a 3.15+ o ajuste el cmake_minimum_required Versión
El modo de construcción es C++14El estándar demasiado viejoañadir set(CMAKE_CXX_STANDARD 17) Antes de la add_executable llamadas

Siguiente pasos

Ver también

 Español