Guia de Instalação

Requisitos de Sistema

• Delphi XE5 / C++Builder XE5 (RAD Studio XE5) até Delphi/C++Builder 13.1 Florence (RAD Studio 13.1)
• Lazarus 1.0 ou posterior (para Free Pascal)
• Windows XP ou posterior (Win32 / Win64)
• Mínimo de 50 MB de espaço livre em disco

Passos de Instalação

1. Execute o instalador: Execute PDFiumPas-FULL.exe ou PDFiumPas-TRIAL.exe como Administrador
2. Selecione a integração com a IDE: Na página RAD Studio Integration, as personalidades Delphi detectadas são listadas primeiro com a versão mais nova pré-marcada; as personalidades C++Builder são listadas separadamente e ficam desativadas por padrão
3. Selecione o conteúdo opcional: Marque C++Builder ou Lazarus somente quando esses arquivos de pacote e projetos de demo devam ser instalados
4. Escolha o caminho de instalação: Selecione o diretório onde os componentes serão instalados
5. Conclua a instalação: Siga as instruções na tela
6. Verifique a instalação: Os seguintes componentes serão adicionados à paleta losLab:
   • TPdf - Componente principal de manipulação de PDF
   • TPdfView - Componente de visualização e interação com PDF

Ajuda Localizada e Builds de Demo

• O instalador sempre instala os recursos compartilhados de Docs e depois copia somente as pastas de idioma de ajuda selecionadas pelo Windows locale name e pelo UI language LCID
• A ajuda em inglês usa en-GB para os English locales britânicos, da Commonwealth e caribenhos compatíveis; en-US é usado para os demais English locales e como fallback quando nenhum conjunto de ajuda regional corresponde
• A ajuda em espanhol é dividida entre es para locales de estilo Espanha e es-419 para locales latino-americanos; a ajuda em chinês é dividida entre zh-cn e zh-tw
• Conjuntos de ajuda localizados correspondentes são adicionados quando disponíveis para UI languages ou locale names em árabe, alemão, francês, italiano, japonês, coreano, neerlandês, polonês, português, russo, sueco, turco e chinês
• Os builds de demo de Delphi e C++Builder pós-instalação usam a raiz RAD Studio selecionada mais recente e exigem a personalidade Delphi ou C++Builder correspondente mais o compilador Win32 / Win64 solicitado

Instalação Manual (Avançado)

Se a instalação automática falhar, você pode instalar os componentes manualmente:

1. Copie os arquivos de componentes para o caminho de biblioteca da sua IDE
2. Adicione o caminho da biblioteca aos diretórios de busca da sua IDE
3. Instale o pacote de tempo de design através do Gerenciador de Pacotes da IDE
4. Reconstrua sua IDE para registrar os componentes

Plataformas nativas Free Pascal e LCL

Compilações do wrapper nativo usam um compilador Free Pascal, Lazarus/LCL e biblioteca compartilhada do PDFium compatíveis com o SO e a CPU. As configurações qualificadas usam FPC 3.3.1 com LCL 4.99, Qt6 no Linux x86_64 e Cocoa no macOS arm64

Compile executáveis e unidades nativos em diretórios de destino separados com o widget set selecionado. Forneça os caminhos de unidade LCL e lazutils correspondentes e use a configuração de alvo real do compilador; arquivos DCU/PPU do Windows e DLLs do Windows não podem ser reutilizados como saídas Unix

Defina LibraryName com o caminho pretendido de libpdfium.so ou libpdfium.dylib antes do carregamento. Um runtime comum ou V8 deve corresponder a esse alvo e expor os recursos solicitados. Capacidades V8/XFA ausentes permanecem recursos indisponíveis; um nome de arquivo de biblioteca não as estabelece

O acesso a fontes do sistema usa fontconfig no Linux e CoreText no macOS; o subsetting opcional de fontes CID usa HarfBuzz com IDs de glifo retidos. Bitmaps LCL usam sua ordem de bytes e descrição de canais reais, com conversão quando o layout do buffer nativo não pode ser usado diretamente

Tests/PlatformAcceptance/run_native.py e NativeWrapper.lpr fornecem aceitação nativa vinculada à origem para carregamento, renderização, texto, formulários, salvamento, cancelamento e checagens de ciclo de vida. Execute o executável de destino em seu host real e retenha o relatório; um inventário de prontidão ou uma compilação cruzada bem-sucedida por si só é insuficiente

Instaladores do Windows e projetos VCL/C++Builder permanecem a rota de configuração do Windows. Os auxiliares nativos de criptografia e timestamp do macOS em Delphi são qualificados separadamente do componente visual FPC/LCL

Redistribuição

Ao distribuir aplicações que usam o PDFium VCL:

• Inclua a árvore DLLs\Win32\pdfium.dll ou DLLs\Win64\pdfium.dll correspondente ao lado da sua aplicação ou em uma pasta de aplicativo pai
• Para suporte a formulários V8/XFA, inclua o DLLs\Win32\pdfium.v8.dll ou DLLs\Win64\pdfium.v8.dll correspondente na mesma árvore de DLLs e defina EnableV8Engine antes de carregar
• Nenhuma licença de runtime adicional é necessária
• Distribuição livre de royalties para aplicações compiladas

Solução de Problemas

Desinstalação

Para remover os componentes PDFium VCL:

1. Use o Adicionar ou Remover Programas do Windows
2. Ou execute o desinstalador a partir do diretório de instalação
3. Remova manualmente quaisquer arquivos restantes, se necessário