Installation
Installation
В этом руководстве показано, как настроить Aspose.Cells FOSS для C++ на своей разработчике, создать библиотеку и проверить установку с минимальной программой по созданию электронных таблиц.
Prerequisites
| Requirement | Detail |
|---|---|
| C++ компилятор | Компилятор, совместимый с C++17 (GCC 9+, Clang 10+ или MSVC 2019+) |
| СМак | Версия 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 для создания проекта samples, который также компилирует библиотеку:
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 Просмотр всех поддерживаемых возможностей электронных таблиц.
- Работа с управлением электронными таблицами Узнать операции с учебниками и таблицами.