Installation

Installation

В этом руководстве показано, как настроить Aspose.Cells FOSS для C++ на своей разработчике, создать библиотеку и проверить установку с минимальной программой по созданию электронных таблиц.


Prerequisites

RequirementDetail
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_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

 Русский