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
| Requirement | Detail |
|---|---|
| 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-CppPas 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_FOSSnamespace 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.hi de laCell.hsegons 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=Releasea lacmakeper 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
| Issue | Cause | Correcció |
|---|---|---|
fatal error: aspose/cells_foss/Workbook.h: No such file or directory | Inclou la ruta no configurada | Ensure target_include_directories apunta a la biblioteca de include/ carpeta |
undefined reference to Aspose::Cells_FOSS::Workbook::Workbook() | Biblioteca no vinculada | Ajuntar target_link_libraries(MyApp Aspose.Cells.Foss.Cpp) en CMakeLists.txt |
| Error de versió del CMake | CMake < 3,15 | Actualitzar CMake a 3.15+ o ajustar el sistema de control. cmake_minimum_required versió |
| Construir no funciona en el mode C++14 | Estandard massa antic. | Ajuntar set(CMAKE_CXX_STANDARD 17) abans de la add_executable trucar |
Primiers passos
- License Revisar els termes de llicència del MIT per a Aspose.Cells FOSS per C++.
- Features Explora totes les capacitats de fitxa de càlcul suportades.
- Treballar amb la gestió de fitxes de càlcul Aprendre les operacions dels llibres de treball i la fulla.