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
| Requisitos | Detalhes |
|---|---|
| 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ção | Linux, 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-CppPasso 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_FOSSEspaç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.he a)Cell.hconforme 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=Releasea) para ocmakepara 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ão | Causa da morte | Correção |
|---|---|---|
fatal error: aspose/cells_foss/Workbook.h: No such file or directory | Inclua caminho não configurado | Assegurar 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 ligada | Adicionar target_link_libraries(MyApp Aspose.Cells.Foss.Cpp) em CMakeLists.txt |
| Erro de versão do CMake | CMake < 3,15 | Atualizar CMake para 3.15+ ou ajustar o cmake_minimum_required versão |
| Construção falha no modo C++14 | Padrão demasiado antigo. | Adicionar set(CMAKE_CXX_STANDARD 17) antes do add_executable chamada |
Pasos seguintes
- Licença de condução Revise os termos da licença MIT para Aspose.Cells FOSS para C++.
- Características Analisar todas as funcionalidades de planilha suportadas.
- Trabalhar com a gestão de planilhas Aprenda as operações de folhas e folhetos.