Kurulum

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

Aspose.Slides FOSS for C++, CMake ile derlenen, başlık ve kaynak dosyalarından oluşan bir kütüphanedir. Windows’ta MSVC ile derleme yapıyorsanız önceden derlenmiş NuGet paketini (Aspose.Slides.Cpp.FOSS) yükleyebilirsiniz; her platformda kütüphaneyi doğrudan GitHub deposundan CMake projenize ekleyebilirsiniz. Microsoft Office veya başka bir tescilli çalışma zamanı gerekmez.


Ö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.9.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)

Alternatif: NuGet ile kurulum (Windows, MSVC)

Windows’ta MSVC ile derliyorsanız, kaynak koddan derlemek yerine önceden derlenmiş paketi yükleyebilirsiniz:

dotnet add package Aspose.Slides.Cpp.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