Instalação

Instalação

Este guia mostra como configurar Aspose.Cells FOSS para C++ em sua máquina de desenvolvimento, criar a biblioteca e verificar a configuração com um programa mínimo de criação de planilha.


Precondições

RequisitosDetalhes
Compilador C++Compilador compatível com C++17 (GCC 9+, Clang 10+ ou MSVC 2019+)
CMake (Manual de dados)Versão 3.15 ou superior
- Não .Qualquer versão recente
Sistema de operaçãoLinux, macOS ou Windows

Passo 1 Clonar o repositório

Clone the Aspose.Cells FOSS para o repositório de fontes C++:

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

Passo 2 Construir as amostras

Use a configuração CMake para construir o projeto de amostras, que também compila a biblioteca:

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

A saída de compilação coloca os binários compilados no build/ directório.


Passo 3 Incluir a biblioteca no seu projeto

Adicionar os cabeçalhos da biblioteca e árvore de origem para o seu próprio CMakeLists.txt via FetchContent ou um percurso local, incluindo:

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)

Passo 4 Verificar a instalação

Criar um mínimo de main.cpp que cria e salva um arquivo 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;
}

Construir e executar. hello.xlsx Se o sistema de instalação for criado no diretório de trabalho, a instalações é bem sucedida.


Dicas e melhores práticas

  • Utilize sempre o Aspose::Cells_FOSS Espaço de nomes para evitar conflitos de símbolos com outras bibliotecas.
  • O ponto de entrada para a maioria das operações é o aspose/cells_foss/Workbook.h;Incluir cabeçalhos adicionais, tais como: Worksheet.h e a) Cell.h conforme necessário.
  • Utilize CMake 3.15 ou posterior; as versões mais antigas podem não suportar a configuração de alvo em pacote.
  • Para construções de produção, passar -DCMAKE_BUILD_TYPE=Release a) para o cmake para permitir a optimização.
  • Mantenha o diretório clon como a raiz da sua biblioteca; não copie cabeçalhos individuais relativo incluam caminhos na biblioteca cabeças dependem do layout original do diretorio.

Problemas comuns

EmissãoCausa da morteCorreção
fatal error: aspose/cells_foss/Workbook.h: No such file or directoryInclua caminho não configuradoAssegurar a target_include_directories O que é o “Ponto de vista” da biblioteca? include/ Folha de Arquivo
undefined reference to Aspose::Cells_FOSS::Workbook::Workbook()Biblioteca não ligadaAdicionar target_link_libraries(MyApp Aspose.Cells.Foss.Cpp) em CMakeLists.txt
Erro de versão do CMakeCMake < 3,15Atualizar CMake para 3.15+ ou ajustar o cmake_minimum_required versão
Construção falha no modo C++14Padrão demasiado antigo.Adicionar set(CMAKE_CXX_STANDARD 17) antes do add_executable chamada

Pasos seguintes

Ver também:

 Português