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

VereisteDetail
C++-compilerC++17-compatibele compiler (GCC 9+, Clang 10+, of MSVC 2019+)
CMakeVersie 3.15 of hoger
GitElke recente versie
BesturingssysteemLinux, 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-Cpp

Stap 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.FOSS

Link 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_FOSS namespace 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, zoals Worksheet.h en Cell.h.
  • Gebruik CMake 3.15 of nieuwer; oudere versies ondersteunen mogelijk de meegeleverde targetconfiguratie niet.
  • Voor productie-builds, geef -DCMAKE_BUILD_TYPE=Release door aan cmake om 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

ProbleemOorzaakOplossing
fatal error: aspose/cells_foss/Workbook.h: No such file or directoryInclude-pad niet geconfigureerdZorg ervoor dat target_include_directories wijst naar de include/-map van de bibliotheek
undefined reference to Aspose::Cells_FOSS::Workbook::Workbook()Bibliotheek niet gelinktVoeg target_link_libraries(MyApp Aspose.Cells.Foss.Cpp) toe in CMakeLists.txt
CMake-versiefoutCMake < 3.15Upgrade CMake naar 3.15+ of pas de cmake_minimum_required-versie aan
Build mislukt in C++14-modusStandaard te oudVoeg 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.

Zie ook

 Nederlands