Aspose.Cells FOSS
C++
Getting Started
Installation

Installation

Overview

Dieser Leitfaden zeigt, wie man Aspose.Cells FOSS für C++ auf Ihrer Entwicklungsmaschine einrichtet, die Bibliothek baut und die Einrichtung mit einem minimalen Tabellenkalkulations-Erstellungsprogramm überprüft.

Voraussetzungen

AnforderungDetail
C++-CompilerC++17-kompatibler Compiler (GCC 9+, Clang 10+, oder MSVC 2019+)
CMakeVersion 3.15 oder höher
GitBeliebige aktuelle Version
BetriebssystemLinux, macOS oder Windows

Schritt 1 — Repository klonen

Klonen Sie das Quell-Repository von Aspose.Cells FOSS für C++:

git clone https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Cpp.git
cd Aspose.Cells-FOSS-for-Cpp

Schritt 2 — Beispiele bauen

Verwenden Sie die mitgelieferte CMake-Konfiguration, um das Beispielprojekt zu bauen, das zudem die Bibliothek kompiliert:

cd samples
mkdir build
cd build
cmake ..
cmake --build .

Die Build-Ausgabe legt die kompilierten Binärdateien im build/-Verzeichnis ab.

Schritt 3 — Bibliothek in Ihrem Projekt einbinden

Fügen Sie die Bibliotheks-Header und den Quellbaum zu Ihrer eigenen CMakeLists.txt über FetchContent oder über eine lokale Pfadinklusion hinzu:

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)

Alternative: Installation über NuGet

Wenn Ihr Projekt bereits NuGet für das C++-Abhängigkeitsmanagement verwendet, können Sie das veröffentlichte Paket installieren, anstatt aus dem Quellcode zu bauen:

dotnet add package Aspose.Cells.Cpp.FOSS

Verlinken Sie dann wie üblich gegen das Paket in Ihrem Projekt; überspringen Sie die Schritte 1–3 oben und fahren Sie mit Schritt 4 fort, um die Installation zu überprüfen.

Schritt 4 — Installation überprüfen

Erstellen Sie ein minimales main.cpp, das eine XLSX-Datei erzeugt und speichert:

#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;
}

Erstellen und ausführen. Wenn hello.xlsx im Arbeitsverzeichnis erstellt wird, ist die Installation erfolgreich.

Tipps und bewährte Vorgehensweisen

  • Verwenden Sie stets den Aspose::Cells_FOSS-Namensraum, um Symbolkonflikte mit anderen Bibliotheken zu vermeiden.
  • Der Include-Einstiegspunkt für die meisten Vorgänge ist aspose/cells_foss/Workbook.h; fügen Sie bei Bedarf weitere Header wie Worksheet.h und Cell.h hinzu.
  • Verwenden Sie CMake 3.15 oder neuer; ältere Versionen unterstützen möglicherweise die mitgelieferte Zielkonfiguration nicht.
  • Für Produktions-Builds übergeben Sie -DCMAKE_BUILD_TYPE=Release an cmake, um Optimierungen zu aktivieren.
  • Behalten Sie das Klonverzeichnis als Bibliothekswurzel; kopieren Sie keine einzelnen Header — relative Include-Pfade in den Bibliotheks-Headern hängen vom ursprünglichen Verzeichnislayout ab.

Häufige Probleme

ProblemUrsacheLösung
fatal error: aspose/cells_foss/Workbook.h: No such file or directoryInclude-Pfad nicht konfiguriertStellen Sie sicher, dass target_include_directories auf den include/-Ordner der Bibliothek verweist
undefined reference to Aspose::Cells_FOSS::Workbook::Workbook()Bibliothek nicht verlinktFüge target_link_libraries(MyApp Aspose.Cells.Foss.Cpp) in CMakeLists.txt hinzu
CMake-VersionsfehlerCMake < 3.15Aktualisiere CMake auf 3.15+ oder passe die cmake_minimum_required-Version an
Build schlägt im C++14-Modus fehlStandard zu altFüge set(CMAKE_CXX_STANDARD 17) vor dem Aufruf von add_executable hinzu

Nächste Schritte

Siehe auch

 Deutsch