Installation
Installation
本指南说明如何在开发机器上设置 Aspose.Cells FOSS for C++,构建库,并通过最小的电子表格创建程序验证设定.
Prerequisites
| Requirement | Detail |
|---|---|
| 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第二步 建立样本
使用包装的CMake配置来构建样本项目,该项目还编译了库:
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避免与其他库发生符号冲突. - 对于大多数操作的入口点是:
aspose/cells_foss/Workbook.h;包含其他标题,如:Worksheet.h及其他Cell.h根据需要. - 使用CMake 3.15或更新的版本;较早的版本可能不支持捆绑目标配置.
- 对于生产建造,通过
-DCMAKE_BUILD_TYPE=Release于 年 月 日cmake实现优化. - 保持克隆目录作为图书馆的根;不要复制单个头.
常见问题
| Issue | Cause | 修复 |
|---|---|---|
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 中 |
| 编辑版本错误 | 值< 3. 15 | 升级CMake到3.15+或调整CMake的 cmake_minimum_required 版本 |
| 在C++14模式下构建失败 | 标准太老了. | 添加 set(CMAKE_CXX_STANDARD 17) 在 add_executable 呼叫 |
下一步步骤
- License 审查MIT许可条款的 Aspose.Cells FOSS for C++.
- Features 浏览所有支持的电子表格功能.
- 使用电子表格管理工作 学习工作簿和工作表操作.