Installation

Installation

Aquesta guia mostra com configurar Aspose.Cells FOSS per a C++ en la seva màquina de desenvolupament, construir la biblioteca i verificar l’implementació amb un mínim programa de creació de fitxes de càlcul.


Prerequisites

RequirementDetail
Compilador de C++Compiler compatible amb C++17 (GCC 9+, Clang 10+ o MSVC 2019+)
CMare (Màquina de fer)Versió 3.15 o superior.
Vés-te’n.Qualsevol versió més recent
Sistema d’explotacióLinux, macOS o Windows

Pas 1 Clona el repositori

Clona l’Aspose.Cells FOSS per al repositori de fonts C++:

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

Pas 2 Construir les mostres

Utilitza la configuració CMake empaquetada per construir el projecte de mostres, que també compila la biblioteca:

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

La sortida de la compilació col·loca els binaris compilats en el sistema d’execució. build/ directori.


Pas 3 Inclou la biblioteca en el teu projecte

Afegir els encabezats de la biblioteca i l’arbre font al seu propi CMakeLists.txt via FetchContent o una ruta local inclou:

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)

Pas 4 Verificar la instal·lació

Crear un mínim de main.cpp que crea i guarda un fitxer 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;
}

Construir i executar. hello.xlsx Creat en el directori de treball, la instal·lació és exitosa.


Consells i millors pràctiques

  • Utilitza sempre el Aspose::Cells_FOSS namespace per evitar col·lisions de símbols amb altres biblioteques.
  • El punt d’entrada inclús per a la majoria de les operacions és el aspose/cells_foss/Workbook.h;Incloure encabezaments addicionals com ara: Worksheet.h i de la Cell.h segons sigui necessari.
  • Utilitzar CMake 3.15 o posterior; les versions anteriors poden no suportar la configuració de destinació combinada.
  • Per a les construccions de producció, passin. -DCMAKE_BUILD_TYPE=Release a la cmake per permetre optimitzacions.
  • Mantingui el directori clon com a raí de la biblioteca; no copiï caps individuals inclou camins relatives en els capts de biblioteques depenen del disseny original del directòria.

Problemàtiques comuns

IssueCauseCorrecció
fatal error: aspose/cells_foss/Workbook.h: No such file or directoryInclou la ruta no configuradaEnsure target_include_directories apunta a la biblioteca de include/ carpeta
undefined reference to Aspose::Cells_FOSS::Workbook::Workbook()Biblioteca no vinculadaAjuntar target_link_libraries(MyApp Aspose.Cells.Foss.Cpp) en CMakeLists.txt
Error de versió del CMakeCMake < 3,15Actualitzar CMake a 3.15+ o ajustar el sistema de control. cmake_minimum_required versió
Construir no funciona en el mode C++14Estandard massa antic.Ajuntar set(CMAKE_CXX_STANDARD 17) abans de la add_executable trucar

Primiers passos

See Also

 Català