Installation
Installation
Ce guide montre comment configurer Aspose.Cells FOSS pour C++ sur votre machine de développement, construire la bibliothèque et vérifier l’installation avec un programme minimal de création de feuilles d’écran.
Principaux
| Requirement | Detail |
|---|---|
| C++ Compiler | C++17-compatible compiler (GCC 9+, Clang 10+, or MSVC 2019+) |
| CMake | Version 3.15 or higher |
| Git | Any recent version |
| Operating System | Linux, macOS, or Windows |
Étape 1 - Clonez le récipient
Clonez l’Aspose.Cells FOSS pour le stockage source C++ :
git clone https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Cpp.git
cd Aspose.Cells-FOSS-for-CppÉtape 2 – Construire les échantillons
Utilisez la configuration CMake en lien pour construire le projet de motifs, qui compile également la bibliothèque:
cd samples
mkdir build
cd build
cmake ..
cmake --build .La sortie de construction place les binaires compilés dans le catalogue ‘build/’.
Étape 3 – Inclure la bibliothèque dans votre projet
Ajouter les titres de la bibliothèque et l’arbre source à votre propre CMakeLists.txt via ‘FetchContent’ ou un parcours local comprend:
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)Étape 4 - Vérifier l’installation
Créer un minimum de ‘main.cpp’ qui crée et sauvegarde un fichier 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;
}Construire et exécution.Si ‘hello.xlsx’ est créé dans le catalogue de travail, l’installation est réussie.
Conseils et meilleures pratiques
- Utilisez toujours le nomespace ‘Aspose::Cells_FOSS’ pour éviter les collisions symboliques avec d’autres bibliothèques.
- Le point d’entrée pour la plupart des opérations est
aspose/cells_foss/Workbook.h; il comprend des titres supplémentaires tels queWorksheet. hetCell.Hsi nécessaire. - Utilisez CMake 3.15 ou plus récent; les versions antérieures peuvent ne pas soutenir la configuration cible intégrée.
- Pour les constructions de production, passez
-DCMAKE_BUILD_TYPE=Releaseà ‘cmake’ pour permettre des optimisations. - Gardez le catalogue clone comme votre bibliothèque racine; ne copiez pas les titres individuels — relative inclut des chemins dans les rubriques de la bibliotheque dépend du layout original du cataloge.
Les problèmes communs
| Issue | Cause | Fix |
|---|---|---|
fatal error: aspose/cells_foss/Workbook.h: No such file or directory | Include path not configured | Ensure target_include_directories points to the library’s include/ folder |
undefined reference to Aspose::Cells_FOSS::Workbook::Workbook() | Library not linked | Add target_link_libraries(MyApp Aspose.Cells.Foss.Cpp) in CMakeLists.txt |
| CMake version error | CMake < 3.15 | Upgrade CMake to 3.15+ or adjust the cmake_minimum_required version |
| Build fails on C++14 mode | Standard too old | Add set(CMAKE_CXX_STANDARD 17) before the add_executable call |
Les prochains pas
- Licence — Recherche des conditions de licence du MIT pour Aspose.Cells FOSS pour C++.
- Caractéristiques — Naviguer dans toutes les capacités de feuille de passe supportées.
- Travailler avec le Gestion des feuilles de travail - Apprenez les opérations du livre de travaux et du feuille de classe.
Voir aussi
- Aspose.Cells - Documentation d’entreprise
- Aspose.Cells pour C++ - Documentation d’entreprise