Installation
Installation
Installation
Panduan ini menunjukkan cara mengatur Aspose.Cells FOSS untuk C++ pada mesin pengembang Anda, membangun perpustakaan, dan memverifikasi pengaturan dengan program pembuatan spreadsheet minimal.
Prerequisites
| Requirement | Detail |
|---|---|
| C++ Compiler | Kompilator yang kompatibel dengan C++17 (GCC 9+, Clang 10+ atau MSVC 2019+) |
| CMake | Versi 3.15 atau lebih baru |
| Pergilah ! | Versi terbaru |
| Sistem Operasi | Linux, macOS atau Windows |
Langkah 1 Kloning Repository
Klon Aspose.Cells FOSS untuk repositori sumber C++:
git clone https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Cpp.git
cd Aspose.Cells-FOSS-for-CppLangkah 2 Membangun Sampel
Gunakan konfigurasi CMake yang terbungkus untuk membangun proyek sampel, yang juga mengkompilasi perpustakaan:
cd samples
mkdir build
cd build
cmake ..
cmake --build .Build output menempatkan binary yang dikompilasi di dalam build/ direktori.
Langkah 3 Masukkan Perpustakaan dalam Proyek Anda
Tambahkan header perpustakaan dan sumber pohon ke CMakeLists.txt Anda sendiri melalui FetchContent atau jalur lokal termasuk:
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)Langkah 4 Verifikasi instalasi
Buat minimal main.cpp yang membuat dan menyimpan file 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;
}Membangun dan menjalankan. hello.xlsx dibuat dalam direktori kerja, instalasi berhasil.
Tips dan Praktik Terbaik
- Selalu gunakan
Aspose::Cells_FOSSnamespace untuk menghindari benturan simbol dengan perpustakaan lain. - Untuk sebagian besar operasi, titik masuk adalah:
aspose/cells_foss/Workbook.h; termasuk header tambahan seperti:Worksheet.hdan (b)Cell.hsesuai kebutuhan. - Gunakan CMake 3.15 atau lebih baru; versi lama mungkin tidak mendukung konfigurasi target yang terpasang.
- Untuk produksi membangun, lulus
-DCMAKE_BUILD_TYPE=Releasekecmakeuntuk memungkinkan optimasi. - Simpan direktori klon sebagai root perpustakaan Anda; jangan menyalin header individu relatif termasuk jalur di library headers tergantung pada tata letak directory asli.
Masalah Umum
| Issue | Cause | Perbaiki |
|---|---|---|
fatal error: aspose/cells_foss/Workbook.h: No such file or directory | Masukkan jalur yang tidak dikonfigurasi | Ensure target_include_directories menunjuk ke perpustakaan include/ folder (folder) |
undefined reference to Aspose::Cells_FOSS::Workbook::Workbook() | Perpustakaan tidak terhubung | Tambahkan target_link_libraries(MyApp Aspose.Cells.Foss.Cpp) dalam CMakeLists.txt |
| Kesalahan versi CMake | CMake < 3,15 | Upgrade CMake ke 3.15+ atau menyesuaikan cmake_minimum_required versi |
| Build gagal pada mode C++14 | Standar terlalu tua. | Tambahkan set(CMAKE_CXX_STANDARD 17) sebelum tanggal 1 Oktober add_executable panggilan |
Langkah-langkah Selanjutnya
- License Tinjau persyaratan lisensi MIT untuk Aspose.Cells FOSS for C++.
- Features Periksa semua fitur spreadsheet yang didukung.
- Bekerja dengan Manajemen Spreadsheet Pelajari operasi buku kerja dan lembar kerja.