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

RequirementDetail
C++ CompilerKompilator yang kompatibel dengan C++17 (GCC 9+, Clang 10+ atau MSVC 2019+)
CMakeVersi 3.15 atau lebih baru
Pergilah !Versi terbaru
Sistem OperasiLinux, 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-Cpp

Langkah 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_FOSS namespace untuk menghindari benturan simbol dengan perpustakaan lain.
  • Untuk sebagian besar operasi, titik masuk adalah: aspose/cells_foss/Workbook.h; termasuk header tambahan seperti: Worksheet.h dan (b) Cell.h sesuai kebutuhan.
  • Gunakan CMake 3.15 atau lebih baru; versi lama mungkin tidak mendukung konfigurasi target yang terpasang.
  • Untuk produksi membangun, lulus -DCMAKE_BUILD_TYPE=Release ke cmake untuk 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

IssueCausePerbaiki
fatal error: aspose/cells_foss/Workbook.h: No such file or directoryMasukkan jalur yang tidak dikonfigurasiEnsure target_include_directories menunjuk ke perpustakaan include/ folder (folder)
undefined reference to Aspose::Cells_FOSS::Workbook::Workbook()Perpustakaan tidak terhubungTambahkan target_link_libraries(MyApp Aspose.Cells.Foss.Cpp) dalam CMakeLists.txt
Kesalahan versi CMakeCMake < 3,15Upgrade CMake ke 3.15+ atau menyesuaikan cmake_minimum_required versi
Build gagal pada mode C++14Standar terlalu tua.Tambahkan set(CMAKE_CXX_STANDARD 17) sebelum tanggal 1 Oktober add_executable panggilan

Langkah-langkah Selanjutnya

See Also

 Bahasa Indonesia