Aspose.Cells FOSS
Getting Started
Instalace

Instalace

Instalace

Tento průvodce ukazuje, jak nastavit Aspose.Cells FOSS pro C++ na vašem vývojovém počítači, sestavit knihovnu a ověřit nastavení pomocí minimálního programu pro tvorbu tabulek.

Požadavky

PožadavekDetail
C++ kompilátorC++17 kompatibilní kompilátor (GCC 9+, Clang 10+, nebo MSVC 2019+)
CMakeVerze 3.15 nebo vyšší
GitJakákoli nedávná verze
Operační systémLinux, macOS nebo Windows

Krok 1 — Klonování repozitáře

Klonujte zdrojový repozitář Aspose.Cells FOSS pro C++:

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

Krok 2 — Sestavení ukázek

Použijte dodanou konfiguraci CMake k sestavení projektu ukázek, která také zkompiluje knihovnu:

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

Výstup sestavení umístí zkompilované binární soubory do adresáře build/.

Krok 3 — Začlenění knihovny do vašeho projektu

Přidejte hlavičkové soubory knihovny a strom zdrojového kódu do svého vlastního CMakeLists.txt pomocí FetchContent nebo lokálního zahrnutí cesty:

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)

Alternativa: Instalovat pomocí NuGet

Pokud váš projekt již používá NuGet pro správu závislostí C++, můžete nainstalovat publikovaný balíček místo sestavování ze zdrojů:

dotnet add package Aspose.Cells.Cpp.FOSS

Poté v projektu běžně propojte s balíčkem; vynechejte kroky 1–3 výše a pokračujte ke kroku 4 ověření instalace.

Krok 4 — Ověření instalace

Vytvořte minimální main.cpp, který vytvoří a uloží soubor 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;
}

Sestavte a spusťte. Pokud se v pracovním adresáři vytvoří hello.xlsx, instalace je úspěšná.

Tipy a osvědčené postupy

  • Vždy používejte jmenný prostor Aspose::Cells_FOSS, abyste se vyhnuli kolizím symbolů s jinými knihovnami.
  • Vstupní bod pro zahrnutí většiny operací je aspose/cells_foss/Workbook.h; podle potřeby zahrňte další hlavičky, například Worksheet.h a Cell.h.
  • Používejte CMake 3.15 nebo novější; starší verze nemusí podporovat zabalenou konfiguraci cíle.
  • Pro produkční sestavení předávejte -DCMAKE_BUILD_TYPE=Release do cmake, abyste povolili optimalizace.
  • Uchovávejte adresář klonu jako kořen knihovny; nekopírujte jednotlivé hlavičky — relativní cesty k zahrnutí v hlavičkách knihovny závisí na původním rozložení adresářů.

Běžné problémy

ProblémPříčinaOprava
fatal error: aspose/cells_foss/Workbook.h: No such file or directoryCesta k include není nakonfigurovánaUjistěte se, že target_include_directories ukazuje na složku include/ knihovny
undefined reference to Aspose::Cells_FOSS::Workbook::Workbook()Knihovna není propojenaPřidejte target_link_libraries(MyApp Aspose.Cells.Foss.Cpp) do CMakeLists.txt
Chyba verze CMakeCMake < 3.15Aktualizujte CMake na verzi 3.15+ nebo upravte verzi cmake_minimum_required
Sestavení selhává v režimu C++14Standard je příliš starýPřidejte set(CMAKE_CXX_STANDARD 17) před volání add_executable

Další kroky

  • License — Projděte si podmínky licence MIT pro Aspose.Cells FOSS pro C++.
  • Features — Procházejte všechny podporované funkce tabulek.
  • Práce se správou tabulek — Naučte se operace se sešity a listy.

Viz také:

 Čeština