Documentation – 시작하기

Rust-Cpp: Rust용 Aspose.PDF를 C++를 통해 설치하는 방법

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

설치

Aspose 웹사이트에서 설치

이 패키지에는 bzip2 압축 파일로 저장된 대용량 파일이 포함되어 있습니다.

다운로드 아카이브 Aspose.PDF for Rust via C++ 공식 Aspose 웹사이트에서. 가장 최신(가장 최근) 버전이 상단에 표시되며, Download 버튼을 클릭하면 기본적으로 다운로드됩니다. 최신 버전을 사용하는 것이 권장됩니다. 필요할 경우에만 이전 버전을 다운로드하십시오. 예시: Aspose.PDF-for-Rust-via-CPP-25.6.zip

아카이브 파일 이름 형식은: Aspose.PDF-for-Rust-via-CPP-YY.M.zip, 어디:
- YY = 연도의 마지막 두 자리 (예: 25 2025년용)
- M = 월 번호부터 1 에 12
추출 아카이브를 선택한 디렉터리로 {path} 적절한 도구를 사용하여:
- Linux/macOS에서:
```
unzip Aspose.PDF-for-Rust-via-CPP-YY.M.zip -d {path}
```
- Windows에서는 기본 제공 Explorer 추출을 사용하거나 압축 해제 도구(7-Zip, WinRAR)를 사용하십시오.
Add 라이브러리를 Rust 프로젝트에 종속성으로 추가하십시오. 두 가지 방법으로 할 수 있습니다:
- 명령줄 사용:
```
cargo add asposepdf --path {path}/asposepdf
```
- 수동 편집 Cargo.toml: 프로젝트를 엽니다 Cargo.toml 아래에 다음을 추가 [dependencies]:
```
[dependencies]
asposepdf = { path = "{path}/asposepdf" }
```
프로젝트를 빌드 (cargo build). 첫 번째 빌드 시, 플랫폼에 적합한 동적 라이브러리가 자동으로 추출됩니다 .bz2 아카이브 안에 lib 폴더와 프로젝트에 연결되었습니다.

노트

빌드 스크립트는 출력 디렉터리(예: target/debug/)에 라이브러리의 symbolic link를 만들려고 시도합니다.
Linux 및 macOS에 대해, 귀하는 또한 다음을 따라야 합니다. 런타임 구성 실행 파일이 런타임에 라이브러리를 찾을 수 있도록 아래 섹션을 확인하십시오.
모두 .bz2 아카이브는 해당됩니다 .sha256 체크섬 파일. 체크섬이 누락되었거나 잘못된 경우, 빌드가 실패합니다.

GitHub에서 설치

이 패키지에는 사전 컴파일된 네이티브 라이브러리가 포함되어 있습니다 (".dll, .so, .dylib) 압축된 형태로 저장됩니다 .bz2 GitHub 리포지토리 내부의 아카이브.

Add 라이브러리를 Rust 프로젝트에 종속성으로 추가하십시오. 두 가지 방법으로 할 수 있습니다:
- 명령줄 사용:
```
cargo add asposepdf --git https://github.com/aspose-pdf/aspose-pdf-rust-cpp.git
```
- 수동 편집 Cargo.toml:
  
  프로젝트를 엽니다 Cargo.toml 아래에 다음을 추가 [dependencies]:
```
[dependencies]
asposepdf = { git = "https://github.com/aspose-pdf/aspose-pdf-rust-cpp.git" }
```
Note: 특정 릴리스 버전을 사용하려면 태그를 지정할 수 있습니다:
```
asposepdf = { git = "https://github.com/aspose-pdf/aspose-pdf-rust-cpp.git", tag = "v1.26.1" }
```
프로젝트를 빌드 (cargo build). 첫 번째 빌드 시, 플랫폼에 적합한 동적 라이브러리가 자동으로 추출됩니다 .bz2 아카이브 안에 lib 폴더와 프로젝트에 연결되었습니다.

노트

수동으로 파일을 다운로드하거나 추출할 필요가 없습니다 - 모든 것이 GitHub 저장소에 포함되어 있습니다.
빌드 스크립트는 출력 디렉터리(예: target/debug/)에 라이브러리의 symbolic link를 만들려고 시도합니다.
Linux 및 macOS에 대해, 귀하는 또한 다음을 따라야 합니다. 런타임 구성 실행 파일이 런타임에 라이브러리를 찾을 수 있도록 아래 섹션을 확인하십시오.
모두 .bz2 아카이브가 일치합니다 .sha256 checksum 파일. 체크섬은 압축을 풀기 전에 확인됩니다.
체크섬 검증에 실패하거나 아카이브가 없으면, 빌드가 상세 오류와 함께 실패합니다.

crates.io에서 설치

이 패키지는 다음에서 사용할 수 있습니다 crates.io. 크기 제한으로 인해, 배포된 크레이트에는 네이티브 바이너리 라이브러리가 포함되지 않습니다 (.dll, .so, 또는 .dylib). 필요한 기본 라이브러리는 공식 배포 아카이브 (see Aspose 웹사이트에서 설치) 또는 GitHub 저장소에서 (참조 GitHub에서 설치). 빌드 스크립트는 빌드 과정에서 압축된 .bz2 아카이브에서 적절한 네이티브 라이브러리를 찾고, 확인하며, 추출합니다.

Add 라이브러리를 Rust 프로젝트에 종속성으로 추가하십시오. 두 가지 방법으로 할 수 있습니다:
- 명령줄 사용:
```
cargo add asposepdf
```
- 수동 편집 Cargo.toml:
  
  프로젝트를 엽니다 Cargo.toml 아래에 다음을 추가 [dependencies]:
```
[dependencies]
asposepdf = "1.26.1"
```
경로 설정: 네이티브 라이브러리를 포함하는 디렉터리로 설정하고 필요한 파일을 다운로드하십시오.
- 환경 변수 설정 ASPOSE_PDF_LIB_DIR 네이티브를 배치할 폴더를 가리키도록 .bz2 아카이브, 그들의 .sha256 체크섬 파일, 및 추출된 네이티브 라이브러리 (.dll, .so, .dylib, 그리고 Windows용도 .lib):
  - Linux/macOS에서:
```
export ASPOSE_PDF_LIB_DIR=/path/to/lib
```
  - Windows에서 (명령 프롬프트):
```
set ASPOSE_PDF_LIB_DIR=C:\path\to\lib
```
  - Windows에서 (PowerShell):
```
$env:ASPOSE_PDF_LIB_DIR = "C:\path\to\lib"
```

ASPOSE_PDF_LIB_DIR에 대한 참고

그 ASPOSE_PDF_LIB_DIR 환경 변수는 빌드 스크립트의 작업 디렉터리를 정의합니다. 이 변수는 컴파일 중에만 사용되어 네이티브 라이브러리 아카이브를 찾고, 검증하고, 추출합니다. 이 변수를 설정해도 자동으로 디렉터리가 시스템의 런타임 라이브러리 검색 경로에 추가되지는 않습니다 (see 런타임 구성).

필요한 항목 다운로드 .bz2 archives** 및 체크섬 파일을 GitHub 리포지토리의 lib/ 폴더 그리고 그것들을 설정된 폴더에 넣으세요 ASPOSE_PDF_LIB_DIR:
Linux x64용, 다운로드:
- libAsposePDFforRust_linux_amd64.so.bz2
- libAsposePDFforRust_linux_amd64.so.bz2.sha256
다음 macOS x86_64 용으로 다운로드:
- libAsposePDFforRust_darwin_amd64.dylib.bz2
- libAsposePDFforRust_darwin_amd64.dylib.bz2.sha256
macOS arm64용 다운로드:
- libAsposePDFforRust_darwin_arm64.dylib.bz2
- libAsposePDFforRust_darwin_arm64.dylib.bz2.sha256
Windows x64용, 다운로드:
- AsposePDFforRust_windows_amd64.dll.bz2
- AsposePDFforRust_windows_amd64.dll.bz2.sha256
- AsposePDFforRust_windows_amd64.lib (네이티브 가져오기 라이브러리, 압축되지 않음)

주의: GitHub에서 이 파일들을 수동으로 다운로드하고 지정된 디렉터리에 배치해야 합니다. ASPOSE_PDF_LIB_DIR.
빌드 스크립트는 네이티브 라이브러리를 자동으로 풀어냅니다. .bz2 첫 번째 빌드 시 아카이브.

빌드 귀하의 프로젝트 (cargo build). 첫 번째 빌드 시, 플랫폼에 맞는 네이티브 라이브러리가 자동으로 해당 위치에서 추출됩니다. .bz2 아카이브되고 프로젝트에 연결됩니다.

중요: Linux 및 macOS에 대해, 귀하는 또한 다음을 따라야 합니다. 런타임 구성 실행 파일이 런타임에 라이브러리를 찾을 수 있도록 아래 섹션을 확인하십시오.

노트

그 ASPOSE_PDF_LIB_DIR 변수는 빌드 과정 중에만 아카이브를 찾고 추출하는 데 사용됩니다.
빌드 스크립트는 추출된 라이브러리에 대한 심볼릭 링크를 출력 디렉터리(예: target/debug/)에 만들려고 시도합니다.
포함하는 폴더를 제공해야 합니다 .bz2 그리고 .sha256 파일을 별도로, 이러한 바이너리 아카이브는 crates.io를 통해 배포되지 않기 때문입니다.
필수 아카이브가 없거나 체크섬이 실패하면, 빌드가 상세 오류와 함께 실패합니다.
GitHub 또는 Aspose 웹사이트를 통해 설치에 사용된 동일한 바이너리 파일을 여기에서 재사용할 수 있습니다.

빠른 시작

모든 코드 스니펫은 다음에 포함됩니다 스니펫.

Rust-Cpp: 시스템 요구 사항

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

C++를 통한 Aspose.PDF for Rust 지원 플랫폼

asposepdf 패키지는 개발자가 PDF 파일을 직접 조작할 수 있게 해주는 강력한 툴킷이며, PDF와 관련된 다양한 작업을 수행하는 데 도움이 됩니다. PDF를 다른 형식으로 변환하기 위한 고유한 기능을 포함하고 있습니다.

Linux x64, macOS x86_64, macOS arm64 및 Windows x64 플랫폼에 대한 지원이 구현되었습니다.

패키지 루트 디렉터리의 ‘lib’ 폴더에 있는 플랫폼별 동적 라이브러리 버전이 결과 애플리케이션을 배포하는 데 필요합니다:

Linux x64 플랫폼용 libAsposePDFforRust_linux_amd64.so
macOS arm64 플랫폼용 libAsposePDFforRust_darwin_arm64.dylib
macOS x86_64 플랫폼용 libAsposePDFforRust_darwin_amd64.dylib
AsposePDFforRust_windows_amd64.dll for Windows x64 플랫폼용.

Rust-Cpp: Rust 언어를 사용한 Hello World 예제

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

“Hello World” 예제는 전통적으로 간단한 사용 사례를 통해 프로그래밍 언어나 소프트웨어의 기능을 소개하는 데 사용됩니다.

Aspose.PDF for Rust는 기능이 풍부한 PDF API로, 개발자가 Rust를 사용하여 PDF 문서 생성, 조작 및 변환 기능을 삽입할 수 있게 합니다. PDF, TXT, XLSX, EPUB, TEX, DOC, DOCX, PPTX, 이미지 형식 등 많은 인기 파일 형식을 지원합니다. 이 기사에서는 텍스트 “Hello World!“가 포함된 PDF 문서를 생성합니다. 환경에 Aspose.PDF for Rust를 설치한 후 코드 샘플을 실행하여 Aspose.PDF API가 어떻게 작동하는지 확인할 수 있습니다. 아래 코드 스니펫은 다음 단계를 따릅니다:

새 PDF 문서 인스턴스를 생성합니다.
PDF 문서에 새 페이지를 추가하는 데 사용 page_add 함수.
페이지 크기를 설정하려면 page_set_size.
첫 번째 페이지에 “Hello World!” 텍스트를 추가하려면 page_add_text.
PDF 문서를 저장하려면 save_as 메서드.

다음 코드 스니펫은 Aspose.PDF for Rust API의 작동을 보여주기 위한 Hello World 프로그램입니다.


    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: 지원되는 파일 형식

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

다음 표는 Aspose.PDF for Rust가 로드하고 저장할 수 있는 파일 형식을 나타냅니다.

형식	설명	로드	저장	비고
PDF	휴대용 문서 형식
EPUB	전자책 파일 형식
TeX	LaTex 조판 파일 형식
SVG	Scalable Vector Graphics (XML 기반 벡터 이미지 형식)
XPS	XPS 문서
XLSX	문서를 Microsoft Excel 2007 형식으로 저장합니다
PPTX	Microsoft PowerPoint 프레젠테이션 형식으로 문서를 저장합니다
DOC	Microsoft Word 형식으로 문서를 저장합니다
DOCX	Microsoft Word 형식으로 문서를 저장합니다
JPEG	문서를 JPEG 형식으로 저장합니다
PNG	문서를 PNG 형식으로 저장합니다
BMP	문서를 BMP 형식으로 저장합니다.
TIFF	문서를 단일 페이지 또는 다중 페이지 TIFF 이미지로 저장합니다.
텍스트	문서를 텍스트 형식으로 저장
DICOM	문서를 DICOM 텍스트 형식으로 저장

Rust-Cpp: Aspose.PDF for Rust의 주요 기능

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

크로스 플랫폼 소프트웨어

다양한 플랫폼 및 Rust 버전을 지원합니다. 참조 시스템 요구 사항 자세히 보려면.

일반 기능

다양한 목록에서 로드 및 저장을 지원합니다 파일 형식.

지원되는 PDF 표준

Aspose.PDF for Rust는 PDF 버전 1.2, 1.3, 1.4, 1.5, 1.6 및 1.7을 지원합니다.

기능 유형별 특징

핵심 작업

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

정리

optimize
optimize_resource
grayscale
rotate
set_background
repair
page_add_text
page_set_size
page_rotate
page_grayscale

변환 및 저장

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

Rust-Cpp: Aspose PDF 라이선스

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

라이선스

Rust source code는 MIT 라이선스에 따라 라이선스됩니다.
shared library (AsposePDFforRust_windows_amd64.dll, libAsposePDFforRust_linux_amd64.so, libAsposePDFforRust_darwin_amd64.dylib, libAsposePDFforRust_darwin_arm64.dylib)는 독점이며 상업용 라이선스가 필요합니다. 전체 기능을 사용하려면 라이선스를 취득해야 합니다.

평가 버전

평가를 위해 Aspose.PDF for Rust via C++ 를 무료로 사용할 수 있습니다. 평가 버전은 특정 제한이 있지만 제품의 거의 모든 기능을 제공합니다. 라이선스를 구매하고 라이선스를 적용하는 몇 줄의 코드를 추가하면 동일한 평가 버전이 라이선스가 적용됩니다.

평가 버전 제한 없이 Aspose.PDF for Rust를 테스트하려면 30일 임시 라이선스를 요청할 수 있습니다. 자세한 내용은 다음을 참조하십시오. 임시 라이선스를 받는 방법은??

평가 버전의 제한 사항

고객이 구매 전에 당사 구성 요소를 충분히 테스트하길 원하므로 평가 버전에서는 일반적으로 사용하듯이 이용할 수 있습니다.

평가 워터마크가 있는 문서. Aspose.PDF for Rust의 평가 버전은 전체 제품 기능을 제공하지만, 생성된 파일의 모든 페이지 상단에 "Evaluation Only. Created with Aspose.PDF. Copyright 2002-2025 Aspose Pty Ltd." 텍스트가 워터마크로 표시됩니다.
처리할 수 있는 페이지 수 제한. 평가 버전에서는 문서의 처음 네 페이지만 처리할 수 있습니다.

프로덕션 환경에서 사용

프로덕션 환경에서는 상업 라이선스 키가 필요합니다. 상업 라이선스를 구매하려면 문의해 주세요.

라이선스 적용

라이선스 파일 (Aspose.PDF.RustViaCPP.lic)을 사용하여 Aspose.PDF for Rust의 전체 기능을 활성화하기 위해 라이선스를 적용합니다.


    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: Aspose.PDF for Rust 지원

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

Aspose는 모든 제품에 대해 무제한 무료 기술 지원을 제공합니다. 지원은 평가 사용자를 포함한 모든 사용자에게 제공됩니다. 주요 지원 경로는 Aspose.Forums입니다.

Aspose는 전화로 기술 지원을 제공하지 않는다는 점에 유의하십시오. 전화 지원은 판매 및 구매 문의에만 제공됩니다.

Aspose 무료 지원 포럼

Aspose.PDF는 모든 제품에 대해 무료 기술 지원을 사용할 수 있도록 합니다. Aspose.PDF에 대한 질문이 있으면 다음 문서를 확인하십시오:

가장 많이 사용되는 지원 출처는 Aspose.Forums. 에서 Aspose.PDF 포럼 섹션에서 질문을 하시면 가능한 한 빨리 답변을 받을 수 있습니다.
전화로 기술 지원을 제공하지 않는다는 점을 알아두셔야 합니다. 전화는 판매 및 구매 문의에만 가능합니다.
시간대 차이가 있다는 점을 기억하시기 바랍니다. 이것이 귀하에 대한 응답 속도에 영향을 줄 수 있습니다.

문제 또는 기능 요청 보고

Aspose.PDF와 관련된 문제에 대한 도움이 필요하다면, 가장 효율적인 방법으로 해결될 수 있도록 다음 권장 사항을 따르세요:

먼저, 문제를 보고하기 전에 최신 Aspose.PDF 버전을 사용하고 있는지 확인하고, 참고: Aspose.PDF for Rust 다운로드 최신 버전을 확인하려면.
아마도 귀하의 문제에 대한 해결책이 이미 논의되었고 해결책이 존재할 수 있습니다. 이를 위해 포럼과 문서를 살펴보고 확인하십시오. API 참조 문제를 보고하기 전에.
질문을 작성할 때는 원본 문서와 문제를 일으키는 코드 조각을 포함해 주세요. 파일이 여러 개라면 이 파일들을 하나의 문서로 압축할 수 있습니다.
걱정하지 마세요, 귀하와 Aspose 개발자만이 스티키 파일에 접근할 수 있습니다.

Rust-Cpp: 런타임 구성 Aspose.PDF for Rust via C++

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

이는 Rust에서 네이티브 동적 라이브러리를 사용할 때 표준 요구 사항입니다.

Linux와 macOS에서, 시스템 동적 로더는 RPATH가 설정되지 않으면 실행 파일 디렉터리를 자동으로 검색하지 않습니다. 런타임에 Aspose.PDF 네이티브 라이브러리를 애플리케이션이 찾을 수 있도록 RPATH(Run-time Search Path)를 설정해야 합니다.

우리 빌드 스크립트는 라이브러리를 추출하고 출력 디렉터리(예: target/debug/)에 심볼릭 링크를 만들려고 시도합니다. 실행 파일이 이를 찾을 수 있도록 하려면, 다음 옵션 중 하나를 선택하십시오:

옵션 1: 프로젝트 수준 구성 (권장)

폴더를 이름으로 생성 .cargo 프로젝트 루트 디렉터리(존재하지 않을 경우)에 파일을 만들고 이름을 지정하십시오 config.toml 그 안에:

[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"]

옵션 2: RUSTFLAGS 환경 변수

다음 플래그를 사용하여 프로젝트를 빌드하세요:

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

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

옵션 3: 시스템 전체 설치 (개발에는 권장되지 않음)

전역적으로 라이브러리를 설치하고 싶다면:

Linux: 복사 .so 파일로 /usr/local/lib 그리고 실행 sudo ldconfig.
macOS: 복사 .dylib 파일로 /usr/local/lib.

Windows 보통은 라이브러리가 동일한 폴더에 있기 때문에 별도의 조치가 필요하지 않습니다. .exe. 또는, 포함하는 디렉터리를 추가할 수 있습니다. .dll 귀하의 시스템으로 PATH 환경 변수.