Instalación
Instalación
Este guía muestra cómo configurar Aspose.Cells FOSS para C++ en su máquina de desarrollo, construir la biblioteca y verificar la configuración con un programa de creación de hoja de espalda mínima.
Prediciones
| Requisitos | Detalles |
|---|---|
| C++ Compilador | Compilador compatible con C++17 (GCC 9+, Clang 10+ o MSVC 2019+) |
| Cómago | Versión 3.15 o superior |
| Git | Toda versión reciente |
| Sistema operativo | Linux, MacOS o Windows |
Paso 1 - Clone el repositorio
Clone el Aspose.Cells FOSS para repositorio de fuentes C++:
git clone https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Cpp.git
cd Aspose.Cells-FOSS-for-CppPaso 2 - Construir las muestras
Utilice la configuración de CMake envuelta para construir el proyecto de muestras, que también compila la biblioteca:
cd samples
mkdir build
cd build
cmake ..
cmake --build .La producción de la construcción coloca las binarias compiladas en el build/ Directorias .
Paso 3 – Incluir la biblioteca en su proyecto
Añade las cabezas de la biblioteca y el árbol de fuente a su propio CMakeLists.txt a través de FetchContent O un camino local incluye:
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)Paso 4 - Verificar la instalación
Crea un mínimo main.cpp que crea y salva un archivo 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;
}Construcción y marcha. si hello.xlsx Se crea en el directorio de trabajo, la instalación es exitosa.
Consejos y mejores prácticas
- Siempre usa el
Aspose::Cells_FOSSEl nombre espacial para evitar los conflictos de símbolos con otras bibliotecas. - El punto de entrada para la mayoría de las operaciones es el
aspose/cells_foss/Workbook.h;• Incluye otros titulares como:Worksheet.hyCell.hcomo se necesita. - Utilice CMake 3.15 o más reciente; las versiones anteriores pueden no soportar la configuración de meta envuelta.
- Para las construcciones de producción, pasar
-DCMAKE_BUILD_TYPE=Releaseparacmakepara permitir optimizaciones. - Mantenga el directorio de clona como la raíz de su biblioteca; no copiar los títulos individuales — relativamente incluye caminos en los titulares de la biblioteca dependerá del diseño original del directory.
Problemas comunes
| Problemas | Causas | Fixado |
|---|---|---|
fatal error: aspose/cells_foss/Workbook.h: No such file or directory | Incluye el camino no configurado | Seguridad target_include_directories Punto de referencia a la biblioteca include/ Fólogo |
undefined reference to Aspose::Cells_FOSS::Workbook::Workbook() | Biblioteca no vinculada | añadir target_link_libraries(MyApp Aspose.Cells.Foss.Cpp) En la página CMakeLists.txt |
| Errores de versión CMake | Cajón < 3.15 | Upgrade CMake a 3.15+ o ajuste el cmake_minimum_required Versión |
| El modo de construcción es C++14 | El estándar demasiado viejo | añadir set(CMAKE_CXX_STANDARD 17) Antes de la add_executable llamadas |
Siguiente pasos
- Licencia — Revisa los términos de licencia del MIT para Aspose.Cells FOSS para C++.
- Características - Navega todas las capacidades de la hoja de espalda apoyadas.
- Trabajar con la gestión de Spreadsheet Aprende las operaciones de libro y hoja de trabajo.