Aspose.Slides FOSS
C++
Başlarken
Kurulum

Kurulum

Aspose.Slides FOSS for C++‘ın kurulumu

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.

Önkoşullar

GereksinimAyrıntı
C++ standardıC++20 veya daha yeni
Derleme sistemiCMake 3.20 veya daha yeni
DerleyiciGCC 10+, Clang 13+ veya MSVC 2019+ (C++20 desteği olan herhangi bir derleyici)
İşletim sistemiWindows, macOS, Linux
Harici bağımlılıklarYok (tüm bağımlılıklar satır içi sağlanmış veya sadece başlık dosyasıdır)

1. CMake FetchContent (Recommended)

Projenize Aspose.Slides FOSS eklemenin en basit yolu CMake FetchContent’tir. Bunu projenize ekleyin 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, depoyu indirir ve kütüphane hedefini kullanılabilir hâle getirir. Elle klonlama veya sistem‑seviyesinde kurulum gerekmez.

Tekrarlanabilir derlemeler için belirli bir sürümü sabitlemek amacıyla, şunu değiştirin main bir sürüm etiketi veya commit hash’i ile:

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

Kaynak kodunu deponuzun içinde tutmayı tercih ediyorsanız:

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

Ardından bunu projenizden referans alın CMakeLists.txt:

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

3. Build and Verify

Bağımlılığı ekledikten sonra projenizi yapılandırın ve derleyin:

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

Minimum bir örnek oluşturun main.cpp derlemeyi doğrulamak için:

#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;
}

Beklenen çıktı:

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

Hızlı Başlangıç: Şekilli Bir Sunum Oluşturma

Aşağıdaki program yeni bir sunum oluşturur, metin içeren bir dikdörtgen ekler ve bunu bir .pptx dosya:

#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;
}

Önemli: Presentation RAII kullanır. Nesne kapsam dışına çıktığında, iç kaynaklar otomatik olarak serbest bırakılır. Ayrıca şu şekilde çağırabilirsiniz pres.dispose() gerektiğinde açıkça; birden fazla kez çağırmak güvenlidir.

Platform Notları

Windows, macOS, Linux: Kütüphane tüm platformlarda aynı şekilde derlenir. Platforma özgü kod yolları veya ikili uzantılar yoktur.

Docker / CI: Derleme adımınızda depoyu klonlayın veya fetch edin ve CMake’i çalıştırın. C++20 derleyicisi ve CMake dışındaki ek sistem paketlerine gerek yoktur.

vcpkg / Conan: Şu anda vcpkg veya Conan’a yayınlanmamış. Bunun yerine FetchContent ya da git submodule kullanın.

Ek Kaynaklar

 Türkçe