Installation
Installation
У цьому керівництві показано, як налаштувати Aspose.Cells FOSS для C++ на машині розробки, побудувати бібліотеку та перевірити встановлення з мінімальною програмою створення таблиць.
Prerequisites
| Requirement | Detail |
|---|---|
| Компілятор 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_FOSSnamespace, щоб уникнути зіткнень символів з іншими бібліотеками. - Включення вхідного пункту для більшості операцій є:
aspose/cells_foss/Workbook.h; включати додаткові заголовки, такі як:Worksheet.hіCell.hза необхідністю. - Використовуйте CMake 3.15 або більш пізніші версії; старі версии можуть не підтримувати конфігурацію об’єднаного цільового набору.
- Для виробничих конструкцій, проходить.
-DCMAKE_BUILD_TYPE=Releaseдоcmakeдля оптимізації. - Залиште клонний каталог як корінь бібліотеки; не копіюйте окремі заголовки відносно включити шляхи в библиотеці. Заголовки залежить від оригінального макету каталогу.
Загальні питання
| Issue | Cause | Виправлення |
|---|---|---|
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 |
| Помилка версії CMake | CMake < 3,15 | Підвищити CMake до 3.15+ або скористати cmake_minimum_required версія |
| Пошкодження створення в режимі C++14 | Стандарт занадто старий. | Додавати set(CMAKE_CXX_STANDARD 17) до add_executable Покликання |
Наступні кроки
- License Переглянути умови ліцензії MIT для Aspose.Cells FOSS для C++.
- Features Переглянути всі підтримувані можливості таблиці.
- Робота з управлінням таблицями Вивчити операції з робочих книг та таблиць.