Esta página está localizada para Português de Portugal e mantém nomes de API, ficheiros e valores literais inalterados
Guia de instalação
Requisitos do 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)
- Espaço livre mínimo em disco de 50 MB
Passos de instalação
- Execute o instalador: Execute
PDFiumPas-FULL.exe ou PDFiumPas-TRIAL.exe como Administrador
- Seleccione a integração no IDE: Na página RAD Studio Integration, as personalidades Delphi detectadas são listadas primeiro com a versão mais recente pré-marcada; as personalidades C++Builder são listadas separadamente e vêm desactivadas por defeito
- Seleccione conteúdo opcional: Marque C++Builder ou Lazarus apenas quando esses ficheiros de pacote e projectos de demonstração devam ser instalados
- Escolha o caminho de instalação: Seleccione o directório onde os componentes serão instalados
- Conclua a instalação: Siga as instruções no ecrã
- 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 interacção com PDF
Ajuda localizada e compilações de demonstração
- O instalador instala sempre os recursos partilhados de
Docs e depois copia apenas as pastas de idioma da ajuda seleccionadas pelo nome de locale do Windows e pelo LCID do idioma da interface
- A ajuda em inglês usa
en-GB para locales em inglês britânico, da Commonwealth e das Caraíbas suportados; en-US é usado para outros locales em inglês e como fallback quando nenhum conjunto regional de ajuda corresponde
- A ajuda em espanhol divide-se entre
es para locales ao estilo de Espanha e es-419 para locales da América Latina; a ajuda em chinês divide-se entre zh-cn e zh-tw
- Conjuntos de ajuda localizados correspondentes são adicionados quando disponíveis para idiomas de interface ou nomes de locale em árabe, alemão, francês, italiano, japonês, coreano, neerlandês, polaco, português, russo, sueco, turco e chinês
- As compilações de demonstração Delphi e C++Builder pós-instalação usam a raiz RAD Studio mais recente seleccionada e requerem a personalidade Delphi ou C++Builder correspondente mais o compilador Win32 / Win64 pedido
Instalação manual (avançada)
Se a instalação automática falhar, pode instalar os componentes manualmente:
- Copie os ficheiros dos componentes para o caminho de bibliotecas do seu IDE
- Adicione o caminho de bibliotecas aos directórios de pesquisa do seu IDE
- Instale o pacote de tempo de desenho através do gestor de pacotes do IDE
- Recompile o IDE para registar os componentes
Redistribuição
Ao distribuir aplicações que usam PDFium VCL:
- Inclua a árvore correspondente
DLLs\Win32\pdfium.dll ou DLLs\Win64\pdfium.dll ao lado da sua aplicação ou numa pasta superior da aplicação
- Para suporte a formulários V8/XFA, inclua a correspondente
DLLs\Win32\pdfium.v8.dll ou DLLs\Win64\pdfium.v8.dll na mesma árvore DLLs e defina EnableV8Engine antes de carregar
- Não são necessárias licenças adicionais de execução
- Distribuição sem royalties para aplicações compiladas
Resolução de problemas
Problemas comuns:
- Componentes não visíveis: Confirme que o IDE foi reiniciado após a instalação
- Erros de execução: Verifique se a DLL PDFium correcta está em
DLLs\Win32 ou DLLs\Win64, ou directamente no caminho da aplicação
- Violações de acesso: Verifique se todas as dependências necessárias estão instaladas e se a arquitectura da DLL corresponde à da aplicação (32 bits vs 64 bits)
- Erros em tempo de desenho: Recompile os pacotes e reinicie o IDE
- Formulários XFA não funcionam: Certifique-se de que a
pdfium.v8.dll correspondente está disponível na pasta DLLs da plataforma e de que EnableV8Engine está definido antes de carregar
Desinstalação
Para remover os componentes PDFium VCL:
- Use Adicionar/remover programas do Windows
- Ou execute o desinstalador a partir do directório de instalação
- Remova manualmente quaisquer ficheiros remanescentes, se necessário