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 simples e preferido para instalar o Documentize, garantindo que você sempre tenha a versão mais recente e as 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ê preferir ter os DLLs do Documentize instalados 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 os DLLs do Documentize, que podem ser extraídos e adicionados 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 com 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 versões posteriores

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 versões posteriores.

Ambientes de Desenvolvimento

Microsoft Visual Studio:
- Visual Studio 2010 e versões posteriores (incluindo 2019 e 2022)
Suporta qualquer ambiente de desenvolvimento que tenha como alvo 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

O 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 de Confiança Total quando usados dentro de 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 de sistema e analisar fontes.

Por que a Confiança Total é Necessária

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

Acesso ao Registro: Algumas operações podem exigir leitura ou escrita no registro do sistema.
Arquivos de Sistema: O acesso a arquivos de 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 impõem 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 ADO.NET gerenciado OLE DB para acessar bancos de dados.
EventLogPermission: O acesso ao Log 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 pré-definidos conforme configurado no elemento <trust>.
FileIOPermission: O acesso a arquivos é limitado aos que estão dentro do diretório virtual da aplicação.

Ambiente Não Windows

Os SDKs Documentize suportam .NET Standard 2.0, o que permite que sejam usados 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. Instale 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. Instale Fontes Compatíveis com a Microsoft

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

sudo apt-get install ttf-mscorefonts-installer

Estas 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 Documentize:

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

Dica

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

Avaliação

Você pode baixar facilmente os SDKs do Documentize para fins de avaliação. A versão de avaliação é idêntica à versão adquirida, com a única diferença sendo a forma 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.
Apenas as primeiras quatro 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.