Instalação

O SDK do Documentize pode ser instalado através de múltiplos métodos, cada um adaptado a diferentes ambientes de desenvolvimento e preferências. Abaixo estão as maneiras recomendadas de instalar o Documentize:

1. NuGet (Método Preferido)

NuGet é o método mais direto e preferido para instalar o Documentize, garantindo que você sempre tenha a versão mais recente e atualizações diretamente em seu ambiente de desenvolvimento. Confira mais detalhes sobre este método de instalação em Como instalar SDKs do Documentize usando NuGet.

2. Instalador MSI

O instalador MSI é uma opção conveniente se você prefere ter as DLLs do Documentize instaladas diretamente em seu sistema. Este método é ideal para desenvolvedores que podem querer usar o Documentize em vários projetos sem precisar gerenciar manualmente os arquivos DLL. Confira mais detalhes sobre este método de instalação em Como instalar SDKs do Documentize usando MSI.

3. Arquivo ZIP

Para desenvolvedores que preferem uma abordagem manual, o arquivo ZIP contém as DLLs do Documentize, que podem ser extraídas e adicionadas ao seu projeto diretamente. Confira mais detalhes sobre este método de instalação em Como instalar SDKs do Documentize usando ZIP.

Requisitos do Sistema

Os SDKs do Documentize são projetados para se integrar a aplicações .NET e suportar vários sistemas operacionais e ambientes de desenvolvimento. Abaixo estão os principais requisitos do sistema:

Sistemas Operacionais Suportados

Windows

Windows 7 (x64, x86)
Windows 8, 8.1 (x64, x86)
Windows 10 (x64, x86)
Windows 11 (x64, x86)
Windows Server 2003 a Windows Server 2022 (x64, x86)
Nuvem: Microsoft Azure

macOS

macOS 10.12 (Sierra) e posterior

Linux

Compatível com várias distribuições Linux:
- Ubuntu (16.04, 18.04, 20.04, 22.04)
- CentOS (7, 8)
- Debian (9, 10)
- OpenSUSE (Leap 15+, SLES 12+)

Android

Suporta Android 8.0 (Oreo) e posterior.

Ambientes de Desenvolvimento

Microsoft Visual Studio:
- Visual Studio 2010 e posterior (incluindo 2019 e 2022)
Suporta qualquer ambiente de desenvolvimento destinado a plataformas .NET.

Frameworks .NET Suportados

.NET Framework 4.0 e superior
.NET Standard 2.0 (.NET Core 3.1+)
.NET 6.0, .NET 7.0, .NET 8.0

Notas Adicionais

Adobe Acrobat não é necessário para executar os SDKs do Documentize, mas é recomendado para visualização de PDFs.

Declaração

Os SDKs do Documentize.com requerem um conjunto de permissões Confiança Total quando utilizados em aplicações .NET. Este nível de permissão é essencial para que os SDKs realizem certas operações em nível de sistema, como acessar configurações do registro, arquivos do sistema e analisar fontes.

Por que a Confiança Total é Necessária

Os SDKs do Documentize utilizam classes de sistema .NET fundamentais, que frequentemente precisam de permissões elevadas pelos seguintes motivos:

Acesso ao Registro: Algumas operações podem exigir leitura ou gravação no registro do sistema.
Arquivos do Sistema: O acesso a arquivos do sistema além do diretório virtual da aplicação pode ser necessário para certas tarefas, como manipulação de fontes ou realização de operações com arquivos.

Limitações do Ambiente de Confiança Média

Em ambientes de hospedagem que aplicam segurança de Confiança Média, várias permissões importantes são restritas ou indisponíveis. Isso pode impedir que os SDKs funcionem corretamente em tais ambientes. As seguintes restrições se aplicam sob Confiança Média:

OleDbPermission: Não é possível usar o provedor de dados OLE DB gerenciado ADO.NET para acessar bancos de dados.
EventLogPermission: O acesso ao Registro de Eventos do Windows é proibido.
ReflectionPermission: Impede o uso de reflexão, o que pode afetar certas operações dinâmicas.
RegistryPermission: O acesso ao registro do sistema é negado.
WebPermission: A comunicação é restrita a endereços ou intervalos predefinidos conforme configurado no elemento <trust>.
FileIOPermission: O acesso a arquivos é limitado àqueles dentro do diretório virtual da aplicação.

Ambiente Não-Windows

Os SDKs do Documentize suportam .NET Standard 2.0, o que permite seu uso em aplicações .NET Core executando em Linux ou outros ambientes não-Windows. Para garantir desempenho ideal e renderização correta de texto, siga os passos abaixo:

Configuração Recomendada para Linux

1. Instalar o Pacote libgdiplus

Este pacote fornece a funcionalidade GDI+ necessária, que é crítica para renderização e processamento de PDFs. Você pode instalá-lo executando o seguinte comando no seu terminal:

sudo apt-get install libgdiplus

2. Instalar Fontes Compatíveis com a Microsoft

Para uma renderização correta de texto, instale as fontes TrueType da Microsoft usando o comando:

sudo apt-get install ttf-mscorefonts-installer

Essas fontes devem ser colocadas no diretório /usr/share/fonts/truetype/msttcorefonts. Se o seu sistema armazena fontes em um diretório diferente, atualize o caminho em seu código antes de realizar qualquer operação com os SDKs do Documentize:

Documentize.Text.FontRepository.Sources.Add(new FolderFontSource("<caminho para as fontes ms>"));

Dica

Ao garantir que essas instalações estejam completas e configurando o caminho das fontes corretamente, você pode maximizar o desempenho dos SDKs do Documentize em Linux ou outros sistemas não-Windows.

Avaliação

Você pode facilmente baixar os SDKs do Documentize para fins de avaliação. A versão de avaliação é idêntica à versão comprada, com a única diferença sendo como você aplica a licença.

Limitações da Versão de Avaliação

Embora a versão de avaliação forneça acesso total a todos os recursos, ela inclui as seguintes limitações até que uma licença seja aplicada:

Uma marca d’água de avaliação é inserida em todos os documentos de saída.
Somente as quatro primeiras páginas de qualquer documento PDF podem ser visualizadas ou editadas.

Para remover essas limitações e desbloquear a versão completa, basta aplicar uma licença adicionando algumas linhas de código ao seu projeto.