Documentation – Memulai

Rust-Cpp: Cara Menginstal Aspose.PDF untuk Rust via C++

Mon, 20 Jul 2026 00:00:00 +0000

Instalasi

Instalasi dari situs web Aspose

Paket ini menyertakan file besar yang disimpan sebagai arsip bzip2.

Download arsip Aspose.PDF for Rust via C++ dari situs resmi Aspose. Versi terbaru (paling baru) terdaftar di bagian atas dan diunduh secara default ketika Anda mengklik tombol Download. Disarankan untuk menggunakan versi terbaru ini. Hanya unduh versi sebelumnya jika diperlukan. Contoh: Aspose.PDF-for-Rust-via-CPP-25.6.zip

Format nama file arsip adalah: Aspose.PDF-for-Rust-via-CPP-YY.M.zip, di mana:
- YY = dua digit terakhir tahun (misalnya, 25 untuk 2025)
- M = nomor bulan dari 1 ke 12
Ekstrak arsip ke direktori pilihan Anda {path} menggunakan alat yang sesuai:
- Di Linux/macOS:
```
unzip Aspose.PDF-for-Rust-via-CPP-YY.M.zip -d {path}
```
- Di Windows, gunakan ekstraksi bawaan Explorer atau alat unzip apa saja (7-Zip, WinRAR).
Add perpustakaan sebagai dependensi dalam proyek Rust Anda. Anda dapat melakukan ini dengan dua cara:
- Menggunakan baris perintah:
```
cargo add asposepdf --path {path}/asposepdf
```
- Pengeditan manual Cargo.toml: Buka proyek Anda Cargo.toml dan tambahkan yang berikut di bawah [dependencies]:
```
[dependencies]
asposepdf = { path = "{path}/asposepdf" }
```
Bangun proyek Anda (cargo build). Pada build pertama, perpustakaan dinamis yang sesuai untuk platform Anda akan secara otomatis diekstrak dari .bz2 arsipkan di dalam lib folder dan terhubung ke proyek Anda.

Catatan

Skrip build berusaha membuat tautan simbolik ke perpustakaan di direktori output Anda (mis., target/debug/).
Untuk Linux dan macOS, Anda juga harus mengikuti Konfigurasi Runtime bagian di bawah untuk memastikan executable dapat menemukan library saat runtime.
Semua .bz2 arsip memiliki korespondensi .sha256 file checksum. Jika checksum tidak ada atau tidak valid, proses build akan gagal.

Instalasi dari GitHub

Paket ini mencakup pustaka native yang telah dikompilasi sebelumnya (.dll, .so, .dylib) yang disimpan dalam bentuk terkompresi .bz2 arsip di dalam repositori GitHub.

Add perpustakaan sebagai dependensi dalam proyek Rust Anda. Anda dapat melakukan ini dengan dua cara:
- Menggunakan baris perintah:
```
cargo add asposepdf --git https://github.com/aspose-pdf/aspose-pdf-rust-cpp.git
```
- Pengeditan manual Cargo.toml:
  
  Buka proyek Anda Cargo.toml dan tambahkan yang berikut di bawah [dependencies]:
```
[dependencies]
asposepdf = { git = "https://github.com/aspose-pdf/aspose-pdf-rust-cpp.git" }
```
Catatan: Untuk menggunakan versi rilis tertentu, Anda dapat menentukan tag:
```
asposepdf = { git = "https://github.com/aspose-pdf/aspose-pdf-rust-cpp.git", tag = "v1.26.1" }
```
Bangun proyek Anda (cargo build). Pada build pertama, perpustakaan dinamis yang sesuai untuk platform Anda akan secara otomatis diekstrak dari .bz2 arsipkan di dalam lib folder dan terhubung ke proyek Anda.

Catatan

Anda tidak perlu mengunduh atau mengekstrak file secara manual - semuanya sudah termasuk dalam repositori GitHub.
Skrip build berusaha membuat tautan simbolik ke perpustakaan di direktori output Anda (mis., target/debug/).
Untuk Linux dan macOS, Anda juga harus mengikuti Konfigurasi Runtime bagian di bawah untuk memastikan executable dapat menemukan library saat runtime.
Semua .bz2 arsip memiliki kecocokan .sha256 file checksum. Checksum diverifikasi sebelum ekstraksi.
Jika verifikasi checksum gagal atau arsip tidak ada, proses build akan gagal dengan kesalahan terperinci.

Instalasi dari crates.io

Paket ini tersedia di crates.io. Karena batasan ukuran, crate yang dipublikasikan tidak menyertakan pustaka biner native (.dll, .so, atau .dylib). Anda dapat memperoleh pustaka native yang diperlukan baik dari arsip distribusi resmi (lihat Instalasi dari situs web Aspose) atau dari repositori GitHub (lihat Instalasi dari GitHub). Skrip build akan menemukan, memverifikasi, dan mengekstrak pustaka native yang sesuai dari arsip .bz2 yang terkompresi selama proses build.

Add perpustakaan sebagai dependensi dalam proyek Rust Anda. Anda dapat melakukan ini dengan dua cara:
- Menggunakan baris perintah:
```
cargo add asposepdf
```
- Pengeditan manual Cargo.toml:
  
  Buka proyek Anda Cargo.toml dan tambahkan yang berikut di bawah [dependencies]:
```
[dependencies]
asposepdf = "1.26.1"
```
Setel jalur ke direktori yang berisi pustaka asli dan unduh file yang diperlukan:
- Setel variabel lingkungan ASPOSE_PDF_LIB_DIR untuk menunjuk ke folder tempat Anda akan menempatkan native .bz2 arsip, mereka .sha256 file checksum, dan perpustakaan native yang diekstrak (.dll, .so, .dylib, dan untuk Windows juga .lib):
  - Di Linux/macOS:
```
export ASPOSE_PDF_LIB_DIR=/path/to/lib
```
  - Pada Windows (Command Prompt):
```
set ASPOSE_PDF_LIB_DIR=C:\path\to\lib
```
  - Di Windows (PowerShell):
```
$env:ASPOSE_PDF_LIB_DIR = "C:\path\to\lib"
```

Catatan tentang ASPOSE_PDF_LIB_DIR

Itu ASPOSE_PDF_LIB_DIR variabel lingkungan mendefinisikan direktori kerja untuk skrip build. Ini digunakan hanya selama kompilasi untuk menemukan, memverifikasi, dan mengekstrak arsip pustaka native. Menetapkan variabel ini tidak secara otomatis menambahkan direktori ke jalur pencarian pustaka runtime sistem Anda (lihat Konfigurasi Runtime).

Unduh yang diperlukan .bz2 arsip** dan file checksum dari repositori GitHub lib/ folder dan letakkan mereka ke dalam folder yang ditetapkan di ASPOSE_PDF_LIB_DIR:
Untuk Linux x64, unduh:
- libAsposePDFforRust_linux_amd64.so.bz2
- libAsposePDFforRust_linux_amd64.so.bz2.sha256
Untuk macOS x86_64, unduh:
- libAsposePDFforRust_darwin_amd64.dylib.bz2
- libAsposePDFforRust_darwin_amd64.dylib.bz2.sha256
Untuk macOS arm64, unduh:
- libAsposePDFforRust_darwin_arm64.dylib.bz2
- libAsposePDFforRust_darwin_arm64.dylib.bz2.sha256
Untuk Windows x64, unduh:
- AsposePDFforRust_windows_amd64.dll.bz2
- AsposePDFforRust_windows_amd64.dll.bz2.sha256
- AsposePDFforRust_windows_amd64.lib (pustaka impor asli, tidak terkompresi)

Catatan: Anda harus mengunduh file-file ini secara manual dari GitHub dan menaruhnya ke direktori yang ditunjuk oleh ASPOSE_PDF_LIB_DIR.
Skrip build akan secara otomatis mengekstrak perpustakaan native dari .bz2 arsip pada build pertama.

Bangun proyek Anda (cargo build). Pada build pertama, pustaka native yang cocok dengan platform Anda akan secara otomatis diekstrak dari .bz2 arsipkan dan ditautkan ke proyek Anda.

Penting: Untuk Linux dan macOS, Anda juga harus mengikuti Konfigurasi Runtime bagian di bawah untuk memastikan executable dapat menemukan library saat runtime.

Catatan

Itu ASPOSE_PDF_LIB_DIR variabel digunakan hanya selama proses build untuk menemukan dan mengekstrak arsip.
Skrip build berusaha membuat tautan simbolik ke perpustakaan yang diekstrak di direktori output Anda (misalnya, target/debug/).
Anda harus menyediakan folder yang berisi .bz2 dan .sha256 file secara terpisah, karena arsip biner ini tidak didistribusikan melalui crates.io.
Jika arsip yang diperlukan tidak ada atau checksum gagal, build akan gagal dengan kesalahan terperinci.
Berkas biner yang sama yang digunakan untuk instalasi melalui GitHub atau situs web Aspose dapat digunakan kembali di sini.

Panduan Cepat

Semua potongan kode berada di dalam potongan.

Rust-Cpp: Persyaratan Sistem

Mon, 20 Jul 2026 00:00:00 +0000

Platform yang Didukung oleh Aspose.PDF untuk Rust via C++

Paket asposepdf adalah toolkit yang kuat yang memungkinkan pengembang memanipulasi file PDF secara langsung dan membantu melakukan berbagai tugas untuk PDF. Berisi fitur unik untuk mengonversi PDF ke format lain.

Mendukung Linux x64, macOS x86_64, macOS arm64, dan platform Windows x64.

Versi khusus platform dari pustaka dinamis yang berada di folder ‘lib’ dalam direktori root paket diperlukan untuk mendistribusikan aplikasi yang dihasilkan:

libAsposePDFforRust_linux_amd64.so untuk platform Linux x64
libAsposePDFforRust_darwin_arm64.dylib untuk platform macOS arm64
libAsposePDFforRust_darwin_amd64.dylib untuk platform macOS x86_64
AsposePDFforRust_windows_amd64.dll untuk platform Windows x64.

Rust-Cpp: Contoh Hello World menggunakan bahasa Rust

Mon, 20 Jul 2026 00:00:00 +0000

Contoh “Hello World” secara tradisional digunakan untuk memperkenalkan fitur-fitur suatu bahasa pemrograman atau perangkat lunak dengan kasus penggunaan yang sederhana.

Aspose.PDF for Rust adalah API PDF yang kaya fitur yang memungkinkan pengembang menyematkan pembuatan dokumen PDF, manipulasi, dan kemampuan konversi dengan Rust. Ia mendukung banyak format file populer, termasuk PDF, TXT, XLSX, EPUB, TEX, DOC, DOCX, PPTX, format gambar, dll. Dalam artikel ini, kami membuat dokumen PDF yang berisi teks “Hello World!” Setelah memasang Aspose.PDF for Rust di lingkungan Anda, Anda dapat menjalankan contoh kode untuk melihat cara kerja API Aspose.PDF. Cuplikan kode di bawah ini mengikuti langkah-langkah berikut:

Buat sebuah instance dokumen PDF baru.
Tambahkan halaman baru ke dokumen PDF menggunakan page_add fungsi.
Atur ukuran halaman menggunakan page_set_size.
Tambahkan teks “Hello World!” ke halaman pertama menggunakan page_add_text.
Simpan dokumen PDF menggunakan save_as metode.

Potongan kode berikut adalah program Hello World untuk menunjukkan cara kerja Aspose.PDF for Rust API.


    use asposepdf::{Document, PageSize};
    use std::error::Error;

    fn main() -> Result<(), Box<dyn Error>> {
        // Create a new PDF-document
        let pdf = Document::new()?;

        // Add a new page
        pdf.page_add()?;

        // Set the size of the first page to A4
        pdf.page_set_size(1, PageSize::A4)?;

        // Add "Hello World!" text to the first page
        pdf.page_add_text(1, "Hello World!")?;

        // Save the PDF-document as "hello.pdf"
        pdf.save_as("hello.pdf")?;

        println!("Saved PDF-document: hello.pdf");

        Ok(())
}

Rust-Cpp: Format File yang Didukung

Mon, 20 Jul 2026 00:00:00 +0000

Tabel berikut menunjukkan format file yang dapat dimuat dan disimpan oleh Aspose.PDF for Rust.

Format	Deskripsi	Muat	Simpan	Catatan
PDF	Format Dokumen Portabel
EPUB	format file ebook
TeX	format file penataan LaTex
SVG	Grafik Vektor Skalabel (Format gambar vektor berbasis XML)
XPS	Dokumen XPS
XLSX	Menyimpan dokumen dalam format Microsoft Excel 2007
PPTX	Menyimpan dokumen dalam format Microsoft PowerPoint Presentations
DOC	Menyimpan dokumen dalam format Microsoft Word
DOCX	Menyimpan dokumen dalam format Microsoft Word
JPEG	Menyimpan dokumen dalam format JPEG
PNG	Menyimpan dokumen dalam format PNG
BMP	Menyimpan dokumen dalam format BMP
TIFF	Menyimpan dokumen sebagai Gambar TIFF Single atau Multi-Halaman
Teks	Simpan dokumen ke dalam format Teks
DICOM	Simpan dokumen ke dalam format Teks DICOM

Rust-Cpp: Fitur Utama Aspose.PDF for Rust

Mon, 20 Jul 2026 00:00:00 +0000

Perangkat lunak lintas platform

Mendukung berbagai platform dan versi Rust. Lihat Persyaratan Sistem untuk detail.

Fitur Umum

Mendukung pemuatan dari dan penyimpanan ke daftar luas format file.

Standar PDF yang Didukung

Aspose.PDF for Rust mendukung versi PDF 1.2, 1.3, 1.4, 1.5, 1.6, dan 1.7.

Fitur berdasarkan jenis fungsi

Operasi inti

new PDF
open PDF
save PDF
save_as
page_insert
page_add
page_count
page_delete
extract_text
set_license

Mengatur

optimize
optimize_resource
grayscale
rotate
set_background
repair
page_add_text
page_set_size
page_rotate
page_grayscale

Mengonversi dan Menyimpan

PDF, DOC, DOCX, XLSX, PPTX, JPEG, PNG, BMP, TIFF, EPUB, DICOM, SVG, XPS, TEX, TXT

Rust-Cpp: Lisensi Aspose PDF

Mon, 20 Jul 2026 00:00:00 +0000

Lisensi

Kode sumber Rust dilisensikan di bawah Lisensi MIT.
The shared library (AsposePDFforRust_windows_amd64.dll, libAsposePDFforRust_linux_amd64.so, libAsposePDFforRust_darwin_amd64.dylib, libAsposePDFforRust_darwin_arm64.dylib) bersifat proprietary dan memerlukan lisensi komersial. Untuk menggunakan semua fungsionalitas, Anda harus memperoleh lisensi.

Versi evaluasi

Anda dapat menggunakan Aspose.PDF for Rust via C++ secara gratis untuk evaluasi. Versi evaluasi menyediakan hampir semua fungsionalitas produk dengan beberapa batasan. Versi evaluasi yang sama menjadi berlisensi ketika Anda membeli lisensi dan menambahkan beberapa baris kode untuk menerapkan lisensi.

Jika Anda ingin menguji Aspose.PDF for Rust tanpa batasan versi evaluasi, Anda juga dapat meminta Lisensi Sementara selama 30 hari. Silakan merujuk ke Bagaimana cara mendapatkan Lisensi Sementara??

Batasan versi evaluasi

Kami ingin pelanggan kami menguji komponen kami secara menyeluruh sebelum membeli, sehingga versi evaluasi memungkinkan Anda menggunakannya seperti biasa.

Dokumen yang dibuat dengan watermark evaluasi. Versi evaluasi Aspose.PDF for Rust menyediakan semua fungsi produk, tetapi semua halaman dalam file yang dihasilkan diberi watermark dengan teks “Evaluation Only. Created with Aspose.PDF. Copyright 2002-2025 Aspose Pty Ltd.” di bagian atas.
Batasi jumlah halaman yang dapat diproses. Pada versi evaluasi, Anda hanya dapat memproses empat halaman pertama dari sebuah dokumen.

Gunakan dalam produksi

Kunci lisensi komersial diperlukan di lingkungan produksi. Silakan hubungi kami untuk membeli lisensi komersial.

Terapkan lisensi

Menerapkan lisensi untuk mengaktifkan fungsionalitas penuh Aspose.PDF for Rust menggunakan file lisensi (Aspose.PDF.RustViaCPP.lic).


    use asposepdf::Document;

    fn main() -> Result<(), Box<dyn std::error::Error>> {
        // Open a PDF-document with filename
        let pdf = Document::open("sample.pdf")?;

        // Set license with filename
        pdf.set_license("Aspose.PDF.RustViaCPP.lic")?;

        // Now you can work with the licensed PDF document
        // ...

        Ok(())
    }

Rust-Cpp: Dukungan Aspose.PDF for Rust

Mon, 20 Jul 2026 00:00:00 +0000

Aspose menyediakan dukungan teknis gratis tanpa batas untuk semua produknya. Dukungan tersedia untuk semua pengguna, termasuk evaluasi. Saluran utama dukungan adalah Aspose.Forums.

Harap dicatat bahwa Aspose tidak menyediakan dukungan teknis melalui telepon. Dukungan telepon hanya tersedia untuk pertanyaan penjualan dan pembelian.

Forum Dukungan Gratis Aspose

Aspose.PDF memungkinkan Anda menggunakan dukungan teknis gratis untuk semua produknya. Jika Anda memiliki pertanyaan tentang Aspose.PDF, lihat artikel berikut:

Sumber dukungan yang paling populer adalah Aspose.Forums. Di Aspose.PDF forum bagian, Anda dapat mengajukan pertanyaan Anda dan mendapatkan jawaban sesegera mungkin.
Anda harus tahu bahwa Aspose tidak menyediakan dukungan teknis melalui telepon. Panggilan hanya tersedia untuk pertanyaan penjualan dan pembelian.
Harap ingat, bahwa kami memiliki perbedaan zona waktu, ini dapat memengaruhi kecepatan respons kepada Anda.

Laporkan Masalah atau Permintaan Fitur

Jika Anda memerlukan bantuan dengan masalah pada Aspose.PDF, ikuti rekomendasi berikut untuk memastikan masalah tersebut diselesaikan dengan cara yang paling efisien:

Pertama, pastikan Anda menggunakan versi terbaru Aspose.PDF sebelum melaporkan masalah, lihat Unduh Aspose.PDF untuk Rust untuk mengetahui versi terbaru.
Mungkin solusi untuk masalah Anda sudah dibahas dan memiliki solusi, untuk itu, pelajari forum dan dokumentasi, periksa Referensi API sebelum melaporkan masalah.
Saat Anda menyusun pertanyaan, harap sertakan dokumen asli dan mungkin potongan kode Anda yang menyebabkan masalah. Anda dapat mengompres file-file ini menjadi satu dokumen jika ada beberapa.
Jangan khawatir, hanya Anda dan pengembang Aspose yang memiliki akses ke file sticky.

Rust-Cpp: Konfigurasi Runtime Aspose.PDF untuk Rust via C++

Mon, 20 Jul 2026 00:00:00 +0000

Ini adalah persyaratan standar saat menggunakan pustaka dinamis native di Rust.

Di Linux dan macOS, pemuat dinamis sistem tidak secara otomatis mencari direktori executable kecuali RPATH dikonfigurasi. Untuk memastikan aplikasi Anda dapat menemukan pustaka native Aspose.PDF saat runtime, Anda perlu mengonfigurasi RPATH (Run-time Search Path).

Script build kami mengekstrak perpustakaan dan berusaha membuat tautan simbolik ke dalamnya di direktori output Anda (misalnya, target/debug/). Untuk memungkinkan executable menemukan itu, pilih salah satu opsi berikut:

Opsi 1: Konfigurasi Tingkat Proyek (Disarankan)

Buat folder bernama .cargo di direktori root proyek Anda (jika belum ada) dan buat file bernama config.toml di dalamnya:

[target.'cfg(target_os = "linux")']
rustflags = ["-C", "link-arg=-Wl,-rpath,$ORIGIN"]

[target.'cfg(target_os = "macos")']
rustflags = ["-C", "link-arg=-Wl,-rpath,@loader_path"]

Opsi 2: Variabel Lingkungan RUSTFLAGS

Bangun proyek Anda dengan flag berikut:

# Linux
RUSTFLAGS="-C link-arg=-Wl,-rpath,\$ORIGIN" cargo build

# macOS
RUSTFLAGS="-C link-arg=-Wl,-rpath,@loader_path" cargo build

Opsi 3: Instalasi Seluruh Sistem (Tidak direkomendasikan untuk pengembangan)

Jika Anda lebih suka menginstal perpustakaan secara global:

Linux: Salin .so file ke /usr/local/lib dan jalankan sudo ldconfig.
macOS: Salin .dylib file ke /usr/local/lib.

Windows Tidak ada tindakan yang biasanya diperlukan karena perpustakaan berada di folder yang sama dengan .exe. Alternatifnya, Anda dapat menambahkan direktori yang berisi .dll ke sistem Anda PATH variabel lingkungan.