Installing Documentize via NuGet

Como instalar via Console do Gerenciador de Pacotes NuGet

1. Abra seu projeto:

   • Inicie o Visual Studio e abra sua aplicação .NET.

2. Acesse o Console do Gerenciador de Pacotes:

   • Navegue até Ferramentas > Gerenciador de Pacotes NuGet > Console do Gerenciador de Pacotes.

3. Instale o pacote:

   • Para instalar a versão completa mais recente, digite o comando Install-Package Documentize.
   • Para instalar a versão mais recente incluindo hot fixes, use Install-Package Documentize -prerelease.
   • Pressione Enter para executar o comando.

Como atualizar o pacote via Console do Gerenciador de Pacotes NuGet

Se você já instalou o Documentize via NuGet e deseja atualizar para a versão mais recente:

1. Abra seu projeto:

   • Inicie o Visual Studio e abra sua aplicação .NET.

2. Acesse o Console do Gerenciador de Pacotes:

   • Navegue até Ferramentas > Gerenciador de Pacotes NuGet > Console do Gerenciador de Pacotes.

3. Atualize o pacote:

   • Para atualizar para a versão completa mais recente, digite Update-Package Documentize.
   • Para atualizar para a versão mais recente incluindo hot fixes, use Update-Package Documentize -prerelease.
   • Pressione Enter para executar o comando.

Como instalar via GUI do Gerenciador de Pacotes NuGet

1. Abra seu projeto:

   • Inicie o Visual Studio e abra sua aplicação .NET.

2. Navegue até Gerenciar Pacotes NuGet:

   • No menu Projeto, selecione Gerenciar Pacotes NuGet.

3. Procure por Documentize:

   • Vá até a aba Procurar e digite Documentize na caixa de pesquisa.

4. Instale o pacote:

   • Clique em Instalar/Atualizar ao lado da versão mais recente do Documentize.
   • Confirme clicando em Aceitar na janela pop-up.

Prós de usar o NuGet

• Gerenciamento automático de dependências:

  • O NuGet lida automaticamente com as dependências, garantindo que todas as bibliotecas necessárias sejam incluídas e atualizadas corretamente. Isso reduz o risco de dependências ausentes ou incompatíveis.

• Atualizações simplificadas:

  • Atualizar pacotes é simples com o NuGet, seja pelo Console do Gerenciador de Pacotes ou pela interface gráfica. Isso facilita manter suas bibliotecas atualizadas com os recursos mais recentes e correções de bugs.

• Integração com o Visual Studio:

  • O NuGet está perfeitamente integrado ao Visual Studio, oferecendo uma interface amigável para gerenciar pacotes sem sair do ambiente de desenvolvimento.

• Versionamento:

  • O NuGet permite especificar e gerenciar diferentes versões de bibliotecas, facilitando reverter para versões anteriores ou testar novas versões sem interromper o desenvolvimento.

Contras de usar o NuGet

• Limitado ao Visual Studio:

  • O NuGet foi projetado principalmente para uso dentro do Visual Studio. Embora possa ser usado em outros ambientes, a integração é mais robusta no Visual Studio.

• Potencial para conflitos de versão:

  • Em projetos maiores com muitas dependências, gerenciar versões e resolver conflitos pode se tornar complexo. O NuGet fornece ferramentas para lidar com isso, mas requer atenção cuidadosa.

• Dependência de rede:

  • Instalar e atualizar pacotes requer conexão à internet. Se você estiver trabalhando em um ambiente com acesso restrito ou sem internet, pode ser necessário usar métodos offline ou pré‑baixar os pacotes.

• Complexidade para projetos grandes:

  • Para projetos muito grandes com árvores extensas de dependências, o overhead de gerenciar pacotes pelo NuGet pode se tornar cansativo. Nesses casos, ferramentas ou estratégias adicionais podem ser necessárias para gerenciar as dependências de forma eficaz.

Instalando Documentize via ZIP

Como Instalar via Arquivo ZIP

1. Baixar o Arquivo ZIP:

   • Clique no v26.11 ZIP para baixar a versão mais recente do Documentize em formato de arquivo.

2. Extrair o Conteúdo:

   • Após o download, extraia o conteúdo do arquivo ZIP para um diretório de sua escolha. Você pode manter esses arquivos em um diretório compartilhado ou dentro da estrutura do seu projeto.

3. Adicionar Referências ao Seu Projeto:

   • Abra seu projeto na sua IDE (por exemplo, Visual Studio).
   • Vá em Project > Add Reference > Browse e navegue até o diretório onde você extraiu os DLLs.
   • Selecione os arquivos DLL relevantes e adicione-os como referências ao seu projeto.

4. Atualizações Manuais:

   • Se uma nova versão do Documentize for lançada, será necessário baixar manualmente o arquivo ZIP atualizado e substituir os arquivos DLL antigos no seu projeto pelos novos.

Vantagens de Usar o Arquivo ZIP

• Controle Total:

  • Você tem controle completo sobre onde e como os DLLs são armazenados e referenciados no seu projeto. Isso pode ser benéfico se você preferir uma configuração personalizada ou precisar gerenciar dependências manualmente.

• Sem Dependência de Gerenciadores de Pacotes:

  • Diferente do NuGet, você não depende de um gerenciador de pacotes para lidar com as instalações. Isso pode ser vantajoso em ambientes onde gerenciadores de pacotes não estão disponíveis ou são indesejados.

• Portabilidade:

  • O arquivo ZIP pode ser facilmente compartilhado e movido entre diferentes sistemas, o que o torna ideal para projetos que precisam ser portáteis ou distribuídos sem depender de ferramentas externas.

Desvantagens de Usar o Arquivo ZIP

• Gerenciamento Manual:

  • Ao contrário do NuGet, onde as atualizações e o gerenciamento de dependências são automatizados, com o arquivo ZIP você deve gerenciar manualmente as atualizações e garantir que todos os DLLs necessários estejam corretamente referenciados.

• Risco de Conflitos de Versão:

  • Se você estiver gerenciando múltiplos projetos ou trabalhando em equipe, há risco de conflitos de versão caso projetos diferentes usem versões diferentes dos DLLs. Isso requer um acompanhamento cuidadoso das versões entre os projetos.

• Sem Atualizações Automáticas:

  • Você não receberá atualizações ou notificações automáticas quando uma nova versão estiver disponível. Isso pode levar ao risco de usar bibliotecas desatualizadas, a menos que você verifique regularmente por atualizações.

Installing Documentize via MSI

Como Instalar via Instalador MSI

1. Baixe o Instalador MSI:

   • Clique no v26.11 MSI para baixar o instalador MSI da versão mais recente do Documentize.

2. Execute o Instalador:

   • Dê um duplo clique no arquivo MSI baixado para iniciar o assistente de instalação.

3. Siga o Assistente de Instalação:

   • Siga as instruções na tela fornecidas pelo instalador. Pode ser necessário aceitar o contrato de licença e selecionar as opções de instalação.

4. Conclua a Instalação:

   • Quando a instalação for concluída, as DLLs do Documentize serão instaladas no Cache de Assemblies Global (GAC) do seu sistema ou em outro local especificado.

5. Verifique a Instalação:

   • Verifique se as DLLs foram instaladas corretamente, confirmando a presença delas no diretório de instalação designado ou no GAC.

Prós de Usar o Instalador MSI

• Facilidade de Uso:

  • O instalador MSI fornece um processo de instalação simples e guiado. Ele cuida de todas as configurações necessárias e coloca as DLLs em um local central, facilitando o uso do Documentize em vários projetos.

• Instalação em Todo o Sistema:

  • O método MSI instala o Documentize no Cache de Assemblies Global (GAC) ou em outro local centralizado. Isso permite que qualquer aplicação no sistema acesse as DLLs sem precisar referenciá‑las individualmente em cada projeto.

• Atualizações Automatizadas:

  • Se o Documentize disponibilizar um instalador atualizado, você pode atualizar sua instalação facilmente executando o novo arquivo MSI, que normalmente lida com o processo de atualização de forma fluida.

• Consistência:

  • Usar o instalador MSI garante que todos os arquivos necessários sejam instalados corretamente e de forma consistente em diferentes ambientes, reduzindo o risco de DLLs ausentes ou deslocadas.

Contras de Usar o Instalador MSI

• Flexibilidade Limitada:

  • O instalador MSI instala o Documentize em um local de sistema, o que pode não ser adequado para todos os ambientes de desenvolvimento. Ele pode faltar a flexibilidade necessária para acomodar configurações ou versões específicas de projeto.

• Sobrecarga Potencial:

  • Instalar DLLs no GAC pode introduzir sobrecarga e complexidade, especialmente em cenários onde múltiplas versões do Documentize precisam ser usadas simultaneamente.

• Remoção Manual:

  • Se for necessário desinstalar o Documentize, você deve usar o desinstalador fornecido pelo MSI, que pode deixar arquivos ou configurações residuais se não for gerenciado corretamente.

• Conflitos de Versão:

  • Instalações em todo o sistema podem levar a conflitos de versão se diferentes projetos exigirem versões distintas do Documentize. Gerenciar esses conflitos pode exigir configuração adicional ou limpeza.

Ambiente Não Windows

Trabalhando com DLLs .NET Core em Ambiente Não Windows

Como o Documentize for .NET fornece suporte ao .NET Standard 2.0 (.NET Core 2.0), ele pode ser usado em Aplicações Core que rodem em sistemas operacionais semelhantes ao Linux. Estamos continuamente trabalhando para melhorar o suporte ao .NET Core em nossa API. Contudo, há algumas operações que recomendamos que nossos clientes realizem para obter melhores resultados ao usar os recursos do Documentize for .NET. Por favor, instale:

• pacote libgdiplus
• Pacote com fontes compatíveis da Microsoft: ttf-mscorefonts-installer (por exemplo, sudo apt-get install ttf-mscorefonts-installer). Essas fontes devem ser colocadas no diretório /usr/share/fonts/truetype/msttcorefonts, pois o Documentize for .NET verifica essa pasta em sistemas operacionais semelhantes ao Linux. Caso o sistema operacional possua outra pasta/pasta padrão para fontes, você deve usar a linha de código a seguir antes de realizar qualquer operação usando o Documentize:

  Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<user's path to ms fonts>"));