Installation

Installation

У цьому керівництві показано, як налаштувати Aspose.Cells FOSS для C++ на машині розробки, побудувати бібліотеку та перевірити встановлення з мінімальною програмою створення таблиць.


Prerequisites

RequirementDetail
Компілятор C++Компілятор, сумісний з C++17 (GCC 9+, Clang 10+ або MSVC 2019+)
CMake (зробка)Версія 3.15 або вище
Зійди.Будь-яка остання версія
Операційна системаLinux, macOS або Windows

Крок 1 Клонируйте репозиторій

Клонуйте Aspose.Cells FOSS для сховища джерел C++:

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

Крок 2 Створення зразків

Використовуйте конфігурацію CMake для створення проекту зразків, який також компілює бібліотеку:

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

Вихід будіума розміщує компільовані двоякі в build/ каталог.


Крок 3 Включіть бібліотеку в свій проект

Додати заголовки бібліотеки та джерело дерева до власного CMakeLists.txt через FetchContent або місцевий шлях включають:

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)

Крок 4 Перевірка установки

Створити мінімальний main.cpp що створює і зберігає файл 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;
}

Будівництво і експлуатація. hello.xlsx створюється в робочому каталозі, установка успішна.


Поради та найкращі практики

  • Завжди використовуйте Aspose::Cells_FOSS namespace, щоб уникнути зіткнень символів з іншими бібліотеками.
  • Включення вхідного пункту для більшості операцій є: aspose/cells_foss/Workbook.h; включати додаткові заголовки, такі як: Worksheet.h і Cell.h за необхідністю.
  • Використовуйте CMake 3.15 або більш пізніші версії; старі версии можуть не підтримувати конфігурацію об’єднаного цільового набору.
  • Для виробничих конструкцій, проходить. -DCMAKE_BUILD_TYPE=Release до cmake для оптимізації.
  • Залиште клонний каталог як корінь бібліотеки; не копіюйте окремі заголовки відносно включити шляхи в библиотеці. Заголовки залежить від оригінального макету каталогу.

Загальні питання

IssueCauseВиправлення
fatal error: aspose/cells_foss/Workbook.h: No such file or directoryВключити неконфігуровану дорожкуEnsure target_include_directories вказує на бібліотеку include/ папка
undefined reference to Aspose::Cells_FOSS::Workbook::Workbook()Бібліотека не пов’язанаДодавати target_link_libraries(MyApp Aspose.Cells.Foss.Cpp) в CMakeLists.txt
Помилка версії CMakeCMake < 3,15Підвищити CMake до 3.15+ або скористати cmake_minimum_required версія
Пошкодження створення в режимі C++14Стандарт занадто старий.Додавати set(CMAKE_CXX_STANDARD 17) до add_executable Покликання

Наступні кроки

See Also

 Українська