Инсталация

Инсталация

Това ръководство показва как да настроите Aspose.Cells FOSS за C++ в вашата машина за разработване, изградете библиотеката и проверете настройката с минимална програма за създаване на електронни таблици .


Предварителни условия

ИзискванеДетайли
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 за изграждане на проекта 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 за да се позволят оптимизации.
  • Запазете каталога на клона като коренна библиотека; не копирайте отделни заглавия относително включва пътеки в заголовките на библиотеката зависят от оригиналния дизайн на директорията.

Общи проблеми

ИзданиеПричина за товаРемонтиране
fatal error: aspose/cells_foss/Workbook.h: No such file or directoryНеконфигуриран пътОсигуряване на 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 повикване

Следващи стъпки

Вижте също:

 Български