Documentation – Começar

Rust-Cpp: Como Instalar Aspose.PDF para Rust via C++

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

Instalação

Instalação a partir do site da Aspose

Este pacote inclui um arquivo grande que está armazenado como um arquivo bzip2.

Baixe o arquivo Aspose.PDF for Rust via C++ do site oficial da Aspose. A versão mais recente (mais atual) está listada no topo e é baixada por padrão ao clicar no botão Download. Recomenda-se usar esta versão mais recente. Baixe uma versão anterior somente se necessário. Exemplo: Aspose.PDF-for-Rust-via-CPP-25.6.zip

O formato do nome de arquivo do arquivo é: Aspose.PDF-for-Rust-via-CPP-YY.M.zip, onde:
- YY = últimos dois dígitos do ano (por exemplo, 25 para 2025)
- M = número do mês a partir de 1 para 12
Extrair o arquivo para o diretório escolhido {path} usando uma ferramenta adequada:
- Em Linux/macOS:
```
unzip Aspose.PDF-for-Rust-via-CPP-YY.M.zip -d {path}
```
- No Windows, use a extração incorporada do Explorer ou qualquer ferramenta de descompactação (7-Zip, WinRAR).
Adicionar a biblioteca como dependência no seu projeto Rust. Você pode fazer isso de duas maneiras:
- Usando a linha de comando:
```
cargo add asposepdf --path {path}/asposepdf
```
- Edição manual Cargo.toml: Abra o projeto Cargo.toml e adicione o seguinte abaixo [dependencies]:
```
[dependencies]
asposepdf = { path = "{path}/asposepdf" }
```
Compile seu projeto (cargo build). Na primeira compilação, a biblioteca dinâmica apropriada para sua plataforma será extraída automaticamente de .bz2 arquivo em lib pasta e vinculada ao seu projeto.

Notas

O script de compilação tenta criar um link simbólico para a biblioteca no seu diretório de saída (por exemplo, target/debug/).
Para Linux e macOS, você também deve seguir o Configuração de Tempo de Execução seção abaixo para garantir que o executável possa encontrar a biblioteca em tempo de execução.
Tudo .bz2 arquivos têm correspondentes .sha256 arquivos de checksum. Se um checksum estiver ausente ou inválido, a compilação falhará.

Instalação a partir do GitHub

Este pacote inclui bibliotecas nativas pré-compiladas (.dll, .so, .dylib) que são armazenados como comprimidos .bz2 arquivos dentro do repositório do GitHub.

Adicionar a biblioteca como dependência no seu projeto Rust. Você pode fazer isso de duas maneiras:
- Usando a linha de comando:
```
cargo add asposepdf --git https://github.com/aspose-pdf/aspose-pdf-rust-cpp.git
```
- Edição manual Cargo.toml:
  
  Abra o projeto Cargo.toml e adicione o seguinte abaixo [dependencies]:
```
[dependencies]
asposepdf = { git = "https://github.com/aspose-pdf/aspose-pdf-rust-cpp.git" }
```
Nota: Para usar uma versão de lançamento específica, você pode especificar uma tag:
```
asposepdf = { git = "https://github.com/aspose-pdf/aspose-pdf-rust-cpp.git", tag = "v1.26.1" }
```
Compile seu projeto (cargo build). Na primeira compilação, a biblioteca dinâmica apropriada para sua plataforma será extraída automaticamente de .bz2 arquivo em lib pasta e vinculada ao seu projeto.

Notas

Você não precisa baixar ou extrair manualmente nenhum arquivo - tudo está incluído no repositório do GitHub.
O script de compilação tenta criar um link simbólico para a biblioteca no seu diretório de saída (por exemplo, target/debug/).
Para Linux e macOS, você também deve seguir o Configuração de Tempo de Execução seção abaixo para garantir que o executável possa encontrar a biblioteca em tempo de execução.
Tudo .bz2 os arquivos têm correspondência .sha256 arquivos de checksum. O checksum é verificado antes da descompactação.
Se a verificação de checksum falhar ou o arquivo estiver ausente, a compilação falhará com um erro detalhado.

Instalação a partir do crates.io

Este pacote está disponível em crates.io. Devido a limitações de tamanho, a crate publicada não inclui as bibliotecas binárias nativas (.dll, .so, ou .dylib). Você pode obter as bibliotecas nativas necessárias tanto do arquivo de distribuição oficial (veja Instalação a partir do site da Aspose) ou do repositório GitHub (veja Instalação a partir do GitHub). O script de compilação localizará, verificará e extrairá a biblioteca nativa apropriada de um arquivo compactado .bz2 durante o processo de compilação.

Adicionar a biblioteca como dependência no seu projeto Rust. Você pode fazer isso de duas maneiras:
- Usando a linha de comando:
```
cargo add asposepdf
```
- Edição manual Cargo.toml:
  
  Abra o projeto Cargo.toml e adicione o seguinte abaixo [dependencies]:
```
[dependencies]
asposepdf = "1.26.1"
```
Defina o caminho para o diretório que contém as bibliotecas nativas e faça o download dos arquivos necessários:
- Definir a variável de ambiente ASPOSE_PDF_LIB_DIR** para apontar para a pasta onde você colocará o nativo .bz2 arquivos, seus .sha256 arquivos de checksum, e as bibliotecas nativas extraídas (.dll, .so, .dylib, e para Windows também .lib):
  - No Linux/macOS:
```
export ASPOSE_PDF_LIB_DIR=/path/to/lib
```
  - No Windows (Prompt de Comando):
```
set ASPOSE_PDF_LIB_DIR=C:\path\to\lib
```
  - No Windows (PowerShell):
```
$env:ASPOSE_PDF_LIB_DIR = "C:\path\to\lib"
```

Nota sobre ASPOSE_PDF_LIB_DIR

O ASPOSE_PDF_LIB_DIR variável de ambiente define o diretório de trabalho para o script de construção. Ela é usada apenas durante a compilação para localizar, verificar e extrair os arquivos de biblioteca nativa. Definir esta variável não adiciona automaticamente o diretório ao caminho de pesquisa de bibliotecas em tempo de execução do seu sistema (veja Configuração de Tempo de Execução).

Baixe o necessário .bz2 arquivos e arquivos de soma de verificação do repositório GitHub lib/ pasta e coloque-os na pasta definida em ASPOSE_PDF_LIB_DIR:
Para Linux x64, baixe:
- libAsposePDFforRust_linux_amd64.so.bz2
- libAsposePDFforRust_linux_amd64.so.bz2.sha256
Para macOS x86_64, download:
- libAsposePDFforRust_darwin_amd64.dylib.bz2
- libAsposePDFforRust_darwin_amd64.dylib.bz2.sha256
Para macOS arm64, baixar:
- libAsposePDFforRust_darwin_arm64.dylib.bz2
- libAsposePDFforRust_darwin_arm64.dylib.bz2.sha256
Para Windows x64, faça o download:
- AsposePDFforRust_windows_amd64.dll.bz2
- AsposePDFforRust_windows_amd64.dll.bz2.sha256
- AsposePDFforRust_windows_amd64.lib (biblioteca de importação nativa, não compactada)

Nota: Você precisa baixar manualmente esses arquivos do GitHub e colocá-los no diretório apontado por ASPOSE_PDF_LIB_DIR.
O script de compilação desempacotará automaticamente as bibliotecas nativas do .bz2 arquivos na primeira compilação.

Construa seu projeto (cargo build). No primeiro build, a biblioteca nativa que corresponde à sua plataforma será extraída automaticamente da .bz2 arquivar e vincular ao seu projeto.

Importante: Para Linux e macOS, você também deve seguir o Configuração de Tempo de Execução seção abaixo para garantir que o executável possa encontrar a biblioteca em tempo de execução.

Notas

O ASPOSE_PDF_LIB_DIR variável é usada apenas durante o processo de compilação para localizar e extrair os arquivos.
O script de compilação tenta criar um link simbólico para a biblioteca extraída em seu diretório de saída (por exemplo, target/debug/).
Você deve fornecer a pasta que contém o .bz2 e .sha256 arquivos separadamente, pois esses arquivos binários não são distribuídos via crates.io.
Se o arquivo necessário estiver ausente ou a soma de verificação falhar, a compilação falhará com um erro detalhado.
Os mesmos arquivos binários usados para instalação via GitHub ou o site da Aspose podem ser reutilizados aqui.

Início rápido

Todos os trechos de código estão contidos no trecho.

Rust-Cpp: Requisitos do Sistema

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

Plataformas Compatíveis do Aspose.PDF for Rust via C++

O pacote asposepdf é uma poderosa caixa de ferramentas que permite aos desenvolvedores manipular arquivos PDF diretamente e ajuda a realizar várias tarefas relacionadas a PDF. Contém recursos exclusivos para converter PDF para outros formatos.

Implementado suporte para plataformas Linux x64, macOS x86_64, macOS arm64 e Windows x64.

A versão específica da plataforma da biblioteca dinâmica da pasta ‘lib’ no diretório raiz do pacote é necessária para distribuir o aplicativo resultante:

libAsposePDFforRust_linux_amd64.so para a plataforma Linux x64
libAsposePDFforRust_darwin_arm64.dylib para a plataforma macOS arm64
libAsposePDFforRust_darwin_amd64.dylib para a plataforma macOS x86_64
AsposePDFforRust_windows_amd64.dll para a plataforma Windows x64.

Rust-Cpp: Exemplo de Hello World usando a linguagem Rust

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

Um exemplo “Hello World” é tradicionalmente usado para introduzir recursos de uma linguagem de programação ou software com um caso de uso simples.

Aspose.PDF for Rust é uma API PDF rica em recursos que permite aos desenvolvedores incorporar a criação, manipulação e conversão de documentos PDF com Rust. Ela suporta muitos formatos de arquivo populares, incluindo PDF, TXT, XLSX, EPUB, TEX, DOC, DOCX, PPTX, formatos de imagem etc. Neste artigo, estamos criando um documento PDF contendo o texto “Hello World!” Depois de instalar o Aspose.PDF for Rust no seu ambiente, você pode executar o exemplo de código para ver como a API Aspose.PDF funciona. O trecho de código abaixo segue estas etapas:

Crie uma nova instância de documento PDF.
Adicione uma nova página ao documento PDF usando page_add função.
Defina o tamanho da página usando page_set_size.
Adicione o texto “Hello World!” à primeira página usando page_add_text.
Salve o documento PDF usando save_as método.

O trecho de código a seguir é um programa Hello World para demonstrar o funcionamento da API Aspose.PDF for Rust.


    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: Formatos de Arquivo Suportados

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

A tabela a seguir indica os formatos de arquivo que o Aspose.PDF for Rust pode carregar e salvar.

Formato	Descrição	Carregar	Salvar	Observações
PDF	Formato de Documento Portátil
EPUB	Formato de arquivo de ebook
TeX	Formato de arquivo de composição tipográfica LaTex
SVG	Gráficos Vetoriais Escaláveis (Um formato de imagem vetorial baseado em XML)
XPS	Documentos XPS
XLSX	Salva o documento no formato Microsoft Excel 2007
PPTX	Salva o documento no formato Microsoft PowerPoint Presentations
DOC	Salva o documento no formato Microsoft Word
DOCX	Salva o documento no formato Microsoft Word
JPEG	Salva o documento no formato JPEG
PNG	Salva o documento no formato PNG
BMP	Salva o documento no formato BMP
TIFF	Salva o documento como imagem TIFF de página única ou multipágina
Texto	Salvar o documento no formato Texto
DICOM	Salvar o documento no formato Texto DICOM

Rust-Cpp: Principais recursos do Aspose.PDF for Rust

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

Software multiplataforma

Suporta várias plataformas e versões do Rust. Veja Requisitos do Sistema para detalhes.

Recursos Gerais

Suporta carregamento a partir e gravação em uma ampla lista de formatos de arquivo.

Padrões PDF suportados

Aspose.PDF for Rust suporta as versões PDF 1.2, 1.3, 1.4, 1.5, 1.6 e 1.7.

Recursos por tipo de função

Operações principais

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

Organizar

optimize
optimize_resource
grayscale
rotate
set_background
repair
page_add_text
page_set_size
page_rotate
page_grayscale

446

Recursos por tipo de função

Operações principais

Novo PDF
Abrir PDF
Guardar PDF
Guardar como
Inserir página
Adicionar página
Contar páginas
Apagar página
Extrair texto
Definir licença

Organizar

Otimizar
Otimizar recursos
Escala de cinzentos
Girar
Definir plano de fundo
Reparar
Adicionar texto à página
Definir tamanho da página
Girar página
Escala de cinzentos da página

Converter e guardar

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

Rust-Cpp: Licença Aspose PDF

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

Licença

O código-fonte Rust está licenciado sob a Licença MIT.
A biblioteca compartilhada (AsposePDFforRust_windows_amd64.dll, libAsposePDFforRust_linux_amd64.so, libAsposePDFforRust_darwin_amd64.dylib, libAsposePDFforRust_darwin_arm64.dylib) é proprietária e requer uma licença comercial. Para usar a funcionalidade completa, você deve obter uma licença.

Versão de avaliação

Você pode usar Aspose.PDF for Rust via C++ gratuitamente para avaliação. A versão de avaliação fornece quase toda a funcionalidade do produto com certas limitações. A mesma versão de avaliação torna-se licenciada quando você compra uma licença e adiciona algumas linhas de código para aplicar a licença.

Se você quiser testar Aspose.PDF for Rust sem as limitações da versão de avaliação, também pode solicitar uma Licença Temporária de 30 dias. Por favor, consulte Como obter uma Licença Temporária??

Limitação de uma versão de avaliação

Queremos que nossos clientes testem nossos componentes de forma completa antes de comprar, por isso a versão de avaliação permite que você a use como faria normalmente.

Documentos criados com uma marca d’água de avaliação. A versão de avaliação do Aspose.PDF for Rust fornece funcionalidade completa do produto, mas todas as páginas nos arquivos gerados são marcadas com a marca d’água contendo o texto “Evaluation Only. Created with Aspose.PDF. Copyright 2002-2025 Aspose Pty Ltd.” no topo.
Limitar o número de páginas que podem ser processadas. Na versão de avaliação, você só pode processar as quatro primeiras páginas de um documento.

Uso em produção

Uma chave de licença comercial é necessária em um ambiente de produção. Por favor, entre em contato conosco para adquirir uma licença comercial.

Aplicar licença

Aplicando uma licença para habilitar a funcionalidade completa do Aspose.PDF for Rust usando um arquivo de licença (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: Configuração de Tempo de Execução Aspose.PDF for Rust via C++

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

Esta é uma exigência padrão ao usar bibliotecas dinâmicas nativas em Rust.

No Linux e macOS, o carregador dinâmico do sistema não procura automaticamente o diretório do executável a menos que o RPATH esteja configurado. Para garantir que sua aplicação encontre a biblioteca nativa do Aspose.PDF em tempo de execução, você precisa configurar o RPATH (caminho de pesquisa em tempo de execução).

Nosso script de compilação extrai a biblioteca e tenta criar um link simbólico para ela no seu diretório de saída (por exemplo, target/debug/). Para que o executável o encontre, escolha uma das seguintes opções:

Opção 1: Configuração ao nível do projeto (Recomendado)

Crie uma pasta chamada .cargo no diretório raiz do seu projeto (se não existir) e crie um arquivo chamado config.toml dentro dele:

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

Opção 2: variável de ambiente RUSTFLAGS

Compile seu projeto com a seguinte flag:

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

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

Opção 3: Instalação em todo o sistema (Não recomendada para desenvolvimento)

Se preferir instalar a biblioteca globalmente:

Linux: Copie o .so arquivo para /usr/local/lib e execute sudo ldconfig.
macOS: Copie o .dylib arquivo para /usr/local/lib.

Windows Nenhuma ação costuma ser necessária porque a biblioteca está localizada na mesma pasta que a .exe. Alternativamente, você pode adicionar o diretório que contém o .dll para o seu sistema PATH variável de ambiente.

Rust-Cpp: Suporte do Aspose.PDF para Rust

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

A Aspose oferece suporte técnico gratuito e ilimitado para todos os seus produtos. O suporte está disponível para todos os usuários, incluindo avaliação. O principal canal de suporte é o Aspose.Forums

Observe que a Aspose não fornece suporte técnico por telefone. O suporte telefônico está disponível apenas para perguntas de vendas e compras.

Fórum de Suporte Gratuito da Aspose

Aspose.PDF permite que você use suporte técnico gratuito para todos os seus produtos. Se você tiver dúvidas sobre o Aspose.PDF, consulte o próximo artigo:

A fonte de suporte mais popular é Aspose.Forums. Na Aspose.PDF fórum seção, você pode fazer sua pergunta e obter uma resposta o mais rápido possível.
Você deve saber que a Aspose não fornece suporte técnico por telefone. Você pode ligar, isso está disponível apenas para perguntas de vendas e compras.
Por favor, lembre-se de que temos diferenças de fuso horário, isso pode afetar a rapidez das respostas para você.

Relatar um Problema ou Solicitação de Recurso

Se você precisar de ajuda com um problema no Aspose.PDF, siga as próximas recomendações para garantir que ele seja resolvido da maneira mais eficiente:

Primeiro, verifique se você está usando a versão mais recente do Aspose.PDF antes de relatar o problema, veja Baixe o Aspose.PDF for Rust para saber sobre a versão mais recente.
Talvez a solução para o seu problema já tenha sido discutida e tenha uma solução, para isso, estude o fórum e a documentação, verifique Referência da API antes de relatar o problema.
Ao formular sua pergunta, inclua o documento original e, possivelmente, um fragmento do seu código que causa o problema. Você pode compactar esses arquivos em um único documento se houver vários.
Não se preocupe, apenas você e os desenvolvedores da Aspose têm acesso aos sticky files.