Installatie
Overview
Deze gids laat zien hoe u Aspose.Cells FOSS voor C++ op uw ontwikkelmachine instelt, de bibliotheek bouwt en de installatie verifieert met een minimaal spreadsheet-creatieprogramma.
Vereisten
| Vereiste | Detail |
|---|---|
| C++-compiler | C++17-compatibele compiler (GCC 9+, Clang 10+, of MSVC 2019+) |
| CMake | Versie 3.15 of hoger |
| Git | Elke recente versie |
| Besturingssysteem | Linux, macOS of Windows |
Stap 1 — Kloon de repository
Kloon de Aspose.Cells FOSS voor C++ bronrepository:
git clone https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Cpp.git
cd Aspose.Cells-FOSS-for-CppStap 2 — Bouw de voorbeelden
Gebruik de meegeleverde CMake-configuratie om het voorbeeldenproject te bouwen, wat ook de bibliotheek compileert:
cd samples
mkdir build
cd build
cmake ..
cmake --build .De buildoutput plaatst de gecompileerde binaries in de build/ map.
Stap 3 — Voeg de bibliotheek toe aan uw project
Voeg de bibliotheek-headers en bronboom toe aan uw eigen CMakeLists.txt via FetchContent of een lokale pad-include:
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)Alternatief: Installeer via NuGet
Als uw project al NuGet gebruikt voor C++-afhankelijkheidsbeheer, kunt u het gepubliceerde pakket installeren in plaats van te bouwen vanaf de bron:
dotnet add package Aspose.Cells.Cpp.FOSSLink vervolgens tegen het pakket in uw project zoals gewoonlijk; sla de stappen 1–3 hierboven over en ga verder naar stap 4 om de installatie te verifiëren.
Stap 4 — Verifieer de installatie
Maak een minimale main.cpp die een XLSX-bestand maakt en opslaat:
#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;
}Bouw en voer uit. Als hello.xlsx wordt aangemaakt in de werkmap, is de installatie geslaagd.
Tips en best practices
- Gebruik altijd de
Aspose::Cells_FOSSnamespace om botsingen van symbolen met andere bibliotheken te voorkomen. - Het include-ingangspunt voor de meeste bewerkingen is
aspose/cells_foss/Workbook.h; voeg indien nodig extra headers toe, zoalsWorksheet.henCell.h. - Gebruik CMake 3.15 of nieuwer; oudere versies ondersteunen mogelijk de meegeleverde targetconfiguratie niet.
- Voor productie-builds, geef
-DCMAKE_BUILD_TYPE=Releasedoor aancmakeom optimalisaties in te schakelen. - Behoud de kloonmap als je bibliotheek-root; kopieer geen individuele headers — relatieve include-paden in de bibliotheek-headers zijn afhankelijk van de oorspronkelijke mapstructuur.
Veelvoorkomende problemen
| Probleem | Oorzaak | Oplossing |
|---|---|---|
fatal error: aspose/cells_foss/Workbook.h: No such file or directory | Include-pad niet geconfigureerd | Zorg ervoor dat target_include_directories wijst naar de include/-map van de bibliotheek |
undefined reference to Aspose::Cells_FOSS::Workbook::Workbook() | Bibliotheek niet gelinkt | Voeg target_link_libraries(MyApp Aspose.Cells.Foss.Cpp) toe in CMakeLists.txt |
| CMake-versiefout | CMake < 3.15 | Upgrade CMake naar 3.15+ of pas de cmake_minimum_required-versie aan |
| Build mislukt in C++14-modus | Standaard te oud | Voeg set(CMAKE_CXX_STANDARD 17) toe vóór de add_executable-aanroep |
Volgende stappen
- License — Beoordeel de MIT-licentievoorwaarden voor Aspose.Cells FOSS voor C++.
- Features — Blader door alle ondersteunde spreadsheetmogelijkheden.
- Werken met Spreadsheetbeheer — Leer werkboek- en werkbladbewerkingen.