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

RequirementDetail
C++ CompilerC++17-compatible compiler (GCC 9+, Clang 10+, or MSVC 2019+)
CMakeVersion 3.15 or higher
GitAny recent version
Operating SystemLinux, 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 que Worksheet. h et Cell.H si 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

IssueCauseFix
fatal error: aspose/cells_foss/Workbook.h: No such file or directoryInclude path not configuredEnsure target_include_directories points to the library’s include/ folder
undefined reference to Aspose::Cells_FOSS::Workbook::Workbook()Library not linkedAdd target_link_libraries(MyApp Aspose.Cells.Foss.Cpp) in CMakeLists.txt
CMake version errorCMake < 3.15Upgrade CMake to 3.15+ or adjust the cmake_minimum_required version
Build fails on C++14 modeStandard too oldAdd 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
 Français