Instalas

Instalasi Aspose.Slides FOSS untuk C++

Aspose.Slides FOSS for C++ is a header-and-source library built with CMake. It has no binary distribution; you integrate it directly into your CMake project from the GitHub repository. No Microsoft Office or other proprietary runtime is required.


Prasyarat

PersyaratanRincian
Standar C++C++20 atau lebih baru
Sistem buildCMake 3.20 atau lebih baru
KompilerGCC 10+, Clang 13+, atau MSVC 2019+ (kompiler apa pun dengan dukungan C++20)
Sistem operasiWindows, macOS, Linux
Dependensi eksternalTidak ada (semua dependensi di‑vendor atau hanya header)

1. CMake FetchContent (Recommended)

Cara paling sederhana untuk menambahkan Aspose.Slides FOSS ke proyek Anda adalah CMake FetchContent. Tambahkan ini ke CMakeLists.txt:

cmake_minimum_required(VERSION 3.20)
project(my_slides_app LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

include(FetchContent)
FetchContent_Declare(
    aspose_slides_foss
    GIT_REPOSITORY https://github.com/aspose-slides-foss/Aspose.Slides-FOSS-for-Cpp.git
    GIT_TAG        main
)
FetchContent_MakeAvailable(aspose_slides_foss)

add_executable(my_app main.cpp)
target_link_libraries(my_app PRIVATE aspose_slides_foss)

CMake mengunduh repositori dan membuat target pustaka tersedia. Tidak diperlukan cloning manual atau instalasi tingkat sistem.

Untuk mengunci versi tertentu agar build dapat direproduksi, ganti main dengan tag rilis atau hash commit:

FetchContent_Declare(
    aspose_slides_foss
    GIT_REPOSITORY https://github.com/aspose-slides-foss/Aspose.Slides-FOSS-for-Cpp.git
    GIT_TAG        v26.3.0
)

2. Git Submodule

Jika Anda lebih suka menaruh kode sumber di dalam repositori Anda:

git submodule add https://github.com/aspose-slides-foss/Aspose.Slides-FOSS-for-Cpp.git third_party/aspose_slides_foss

Kemudian referensikan itu dari Anda CMakeLists.txt:

add_subdirectory(third_party/aspose_slides_foss)
target_link_libraries(my_app PRIVATE aspose_slides_foss)

3. Build and Verify

Setelah menambahkan dependensi, konfigurasikan dan bangun proyek Anda:

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build

Buat yang minimal main.cpp untuk memverifikasi build:

#include <Aspose/Slides/Foss/presentation.h>
#include <Aspose/Slides/Foss/export/save_format.h>
#include <Aspose/Slides/Foss/slide.h>
#include <Aspose/Slides/Foss/slide_collection.h>

#include <iostream>

using namespace Aspose::Slides::Foss;

int main() {
    Presentation pres;
    std::cout << "Aspose.Slides FOSS built successfully" << std::endl;
    std::cout << "Slides in empty presentation: " << pres.slides().size() << std::endl;
    return 0;
}

Output yang diharapkan:

Aspose.Slides FOSS built successfully
Slides in empty presentation: 1

Panduan Cepat: Membuat Presentasi dengan Bentuk

Program berikut membuat presentasi baru, menambahkan persegi panjang dengan teks, dan menyimpannya sebagai .pptx file:

#include <Aspose/Slides/Foss/auto_shape.h>
#include <Aspose/Slides/Foss/export/save_format.h>
#include <Aspose/Slides/Foss/presentation.h>
#include <Aspose/Slides/Foss/shape_collection.h>
#include <Aspose/Slides/Foss/shape_type.h>
#include <Aspose/Slides/Foss/slide.h>
#include <Aspose/Slides/Foss/slide_collection.h>
#include <Aspose/Slides/Foss/text_frame.h>

#include <iostream>

using namespace Aspose::Slides::Foss;

int main() {
    Presentation pres;
    auto& slide = pres.slides()[0];

    // Add a rectangle shape and set its text
    auto& shape = slide.shapes().add_auto_shape(ShapeType::RECTANGLE, 50, 50, 400, 150);
    shape.text_frame()->set_text("Hello from Aspose.Slides FOSS!");

    pres.save("hello.pptx", SaveFormat::PPTX);
    std::cout << "Saved hello.pptx" << std::endl;
    return 0;
}

Penting: Presentation menggunakan RAII. Ketika objek keluar dari ruang lingkup, sumber daya internal dilepaskan secara otomatis. Anda juga dapat memanggil pres.dispose() secara eksplisit jika diperlukan; memanggilnya beberapa kali aman.


Catatan Platform

Windows, macOS, Linux: Perpustakaan dibangun secara identik di semua platform. Tidak ada jalur kode khusus platform atau ekstensi biner.

Docker / CI: Klon atau ambil repositori dalam langkah build Anda dan jalankan CMake. Tidak ada paket sistem tambahan yang diperlukan selain kompiler C++20 dan CMake.

vcpkg / Conan: Saat ini belum dipublikasikan ke vcpkg atau Conan. Gunakan FetchContent atau submodul git sebagai gantinya.


Sumber Daya Tambahan

 Bahasa Indonesia