Aspose.Cells FOSS
C++
Getting Started
Instalacja

Instalacja

Overview

Ten przewodnik pokazuje, jak skonfigurować Aspose.Cells FOSS dla C++ na Twojej maszynie deweloperskiej, zbudować bibliotekę oraz zweryfikować konfigurację przy użyciu minimalnego programu do tworzenia arkuszy kalkulacyjnych.

Wymagania wstępne

WymaganieSzczegół
Kompilator C++Kompatybilny z C++17 kompilator (GCC 9+, Clang 10+ lub MSVC 2019+)
CMakeWersja 3.15 lub wyższa
GitDowolna aktualna wersja
System operacyjnyLinux, macOS lub Windows

Krok 1 — Sklonuj repozytorium

Sklonuj repozytorium źródłowe Aspose.Cells FOSS dla C++:

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

Krok 2 — Zbuduj przykłady

Użyj dołączonej konfiguracji CMake, aby zbudować projekt przykładów, który również kompiluje bibliotekę:

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

Wynik budowania umieszcza skompilowane pliki binarne w katalogu build/.

Krok 3 — Dołącz bibliotekę do swojego projektu

Dodaj nagłówki biblioteki i drzewo źródeł do własnego pliku CMakeLists.txt za pomocą FetchContent lub lokalnego dołączenia ścieżki:

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)

Alternatywnie: Zainstaluj za pomocą NuGet

Jeśli Twój projekt już używa NuGet do zarządzania zależnościami C++, możesz zainstalować opublikowany pakiet zamiast budować go ze źródeł:

dotnet add package Aspose.Cells.Cpp.FOSS

Następnie połącz się z pakietem w swoim projekcie jak zwykle; pomiń kroki 1–3 powyżej i przejdź do kroku 4, aby zweryfikować instalację.

Krok 4 — Zweryfikuj instalację

Utwórz minimalny main.cpp, który tworzy i zapisuje plik 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;
}

Zbuduj i uruchom. Jeśli hello.xlsx zostanie utworzony w katalogu roboczym, instalacja zakończy się sukcesem.

Wskazówki i najlepsze praktyki

  • Zawsze używaj przestrzeni nazw Aspose::Cells_FOSS, aby uniknąć kolizji symboli z innymi bibliotekami.
  • Punkt wejścia include dla większości operacji to aspose/cells_foss/Workbook.h; w razie potrzeby dołącz dodatkowe nagłówki, takie jak Worksheet.h i Cell.h.
  • Używaj CMake 3.15 lub nowszego; starsze wersje mogą nie obsługiwać dołączonej konfiguracji celu.
  • W przypadku kompilacji produkcyjnych przekaż -DCMAKE_BUILD_TYPE=Release do cmake, aby włączyć optymalizacje.
  • Trzymaj katalog klonu jako korzeń biblioteki; nie kopiuj pojedynczych nagłówków — względne ścieżki include w nagłówkach biblioteki zależą od pierwotnej struktury katalogów.

Typowe problemy

ProblemPrzyczynaRozwiązanie
fatal error: aspose/cells_foss/Workbook.h: No such file or directoryŚcieżka include nie jest skonfigurowanaUpewnij się, że target_include_directories wskazuje na folder include/ biblioteki
undefined reference to Aspose::Cells_FOSS::Workbook::Workbook()Biblioteka nie została połączonaDodaj target_link_libraries(MyApp Aspose.Cells.Foss.Cpp) w CMakeLists.txt
Błąd wersji CMakeCMake < 3.15Uaktualnij CMake do wersji 3.15+ lub dostosuj wersję cmake_minimum_required
Kompilacja nie udaje się w trybie C++14Standard jest zbyt staryDodaj set(CMAKE_CXX_STANDARD 17) przed wywołaniem add_executable

Kolejne kroki

Zobacz także

 Polski