Pemasangan

Pemasangan 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

KeperluanButiran
Standard C++C++20 atau lebih baru
Sistem binaanCMake 3.20 atau lebih baru
PengkompilGCC 10+, Clang 13+, atau MSVC 2019+ (sebarang pengkompil dengan sokongan C++20)
Sistem operasiWindows, macOS, Linux
Kebergantungan luaranTiada (semua kebergantungan disertakan atau hanya header)

1. CMake FetchContent (Recommended)

Cara paling mudah untuk menambah Aspose.Slides FOSS ke projek anda ialah 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 memuat turun repositori dan menjadikan sasaran perpustakaan tersedia. Tiada klon manual atau pemasangan pada peringkat sistem diperlukan.

Untuk menandakan versi tertentu bagi binaan yang boleh diulangi, gantikan main dengan tag pelepasan atau hash komit:

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 menempatkan kod 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 rujuk ia dari projek anda CMakeLists.txt:

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

3. Build and Verify

Selepas menambah kebergantungan, konfigurasikan dan bina projek anda:

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

Cipta satu minimal main.cpp untuk mengesahkan binaan:

#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 dijangka:

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

Mula Cepat: Cipta Persembahan dengan Bentuk

Program berikut mencipta persembahan baru, menambah segi empat tepat dengan teks, dan menyimpannya sebagai .pptx fail:

#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. Apabila objek keluar dari skop, sumber dalaman dibebaskan secara automatik. Anda juga boleh memanggil pres.dispose() secara eksplisit jika diperlukan; memanggilnya berulang kali adalah selamat.


Nota Platform

Windows, macOS, Linux: Perpustakaan dibina secara serupa pada semua platform. Tiada laluan kod khusus platform atau sambungan binari.

Docker / CI: Klon atau ambil repositori dalam langkah bina anda dan jalankan CMake. Tiada pakej sistem tambahan diperlukan selain kompilator C++20 dan CMake.

vcpkg / Conan: Tidak diterbitkan ke vcpkg atau Conan pada masa ini. Gunakan FetchContent atau submodul git sebagai gantinya.


Sumber Tambahan

 Bahasa Melayu