Instalando Documentize via NuGet

Como Instalar via Console do Gerenciador de Pacotes NuGet

1. Abra Seu Projeto:

   • Inicie o Visual Studio e abra seu aplicativo .NET.

2. Acesse o Console do Gerenciador de Pacotes:

   • Navegue em Ferramentas > Gerenciador de Pacotes NuGet > Console do Gerenciador de Pacotes.

3. Instale o Pacote:

   • Para instalar a versão completa mais recente, insira o comando Install-Package Documentize.
   • Para instalar a versão mais recente, incluindo correções rápidas, 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 quer atualizar para a versão mais recente:

1. Abra Seu Projeto:

   • Inicie o Visual Studio e abra seu aplicativo .NET.

2. Acesse o Console do Gerenciador de Pacotes:

   • Navegue em Ferramentas > Gerenciador de Pacotes NuGet > Console do Gerenciador de Pacotes.

3. Atualize o Pacote:

   • Para atualizar para a versão completa mais recente, insira Update-Package Documentize.
   • Para atualizar para a versão mais recente, incluindo correções rápidas, 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 seu aplicativo .NET.

2. Navegue até Gerenciar Pacotes NuGet:

   • No menu Projeto, selecione Gerenciar Pacotes NuGet.

3. Pesquise por Documentize:

   • Vá para a aba Procurar e insira Documentize no campo de busca.

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 gerencia automaticamente as dependências, garantindo que todas as bibliotecas necessárias estejam incluídas e atualizadas corretamente. Isso reduz o risco de faltar dependências ou de terem compatibilidades incorretas.

• Atualizações Simplificadas:

  • Atualizar pacotes é direto com o NuGet, seja através do Console do Gerenciador de Pacotes ou GUI. Isso torna fácil manter suas bibliotecas atualizadas com os últimos recursos e correções de bugs.

• Integrado com o Visual Studio:

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

• Versionamento:

  • O NuGet permite que você especifique e gerencie diferentes versões de bibliotecas, permitindo que você reverta facilmente para versões anteriores ou teste novas versões sem interromper seu desenvolvimento.

Contras de Usar o NuGet

• Limitado ao Visual Studio:

  • O NuGet é 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 gerenciar isso, mas requer atenção cuidadosa.

• Dependência de Rede:

  • Instalar e atualizar pacotes requer uma conexão com a internet. Se você estiver trabalhando em um ambiente com acesso à internet restrito ou inexistente, pode precisar usar métodos offline ou pré-baixar pacotes.

• Complexidade para Projetos Grandes:

  • Para projetos muito grandes com árvores de dependência extensivas, a sobrecarga de gerenciar pacotes através do NuGet pode se tornar trabalhosa. Nesses casos, ferramentas ou estratégias adicionais podem ser necessárias para gerenciar dependências de forma eficaz.

Instalando Documentize via ZIP

Como Instalar via Arquivo ZIP

1. Baixe o Arquivo ZIP:

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

2. Extraia o Conteúdo:

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

3. Adicione Referências ao Seu Projeto:

   • Abra seu projeto em seu IDE (por exemplo, Visual Studio).
   • Vá para Projeto > Adicionar Referência > Procurar e navegue até o diretório onde você extraiu as 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, você precisará baixar manualmente o arquivo ZIP atualizado e substituir os antigos arquivos DLL em seu projeto pelos novos.

Prós do Uso do Arquivo ZIP

• Controle Completo:

  • Você tem controle total sobre onde e como as DLLs são armazenadas e referenciadas em 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 instalações. Isso pode ser vantajoso em ambientes onde gerenciadores de pacotes não estão disponíveis ou não são preferidos.

• Portabilidade:

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

Contras do Uso do Arquivo ZIP

• Gerenciamento Manual:

  • Diferente do NuGet, onde atualizações e gerenciamento de dependências são automatizados, com o arquivo ZIP, você deve gerenciar manualmente as atualizações e garantir que todas as DLLs necessárias estejam corretamente referenciadas.

• Risco de Conflitos de Versão:

  • Se você está gerenciando vários projetos ou trabalhando em equipe, há um risco de conflitos de versão se projetos diferentes usarem versões diferentes das DLLs. Isso requer um rastreamento cuidadoso das versões entre os projetos.

• Sem Atualizações Automáticas:

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

Instalando o Documentize via MSI

Como Instalar via Instalador MSI

1. Baixe o Instalador MSI:

   • Clique no v24.12 MSI para baixar o instalador MSI para a versão mais recente do Documentize.

2. Execute o Instalador:

   • Clique duas vezes 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. Você poderá precisar concordar com o contrato de licença e selecionar opções de instalação.

4. Finalize a Instalação:

   • Uma vez que a instalação esteja completa, 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 estão corretamente instaladas verificando 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 proporciona um processo de instalação simples e guiado. Ele lida com 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 Global:

  • O método MSI instala o Documentize no Cache de Assemblies Global (GAC) do sistema ou em outro local central. 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 fornecer um instalador atualizado, você pode facilmente atualizar sua instalação executando o novo arquivo MSI, que normalmente lida com o processo de atualização suavemente.

• 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 mal posicionadas.

Contras de Usar o Instalador MSI

• Flexibilidade Limitada:

  • O instalador MSI instala o Documentize em um local global do sistema, o que pode não ser adequado para todos os ambientes de desenvolvimento. Pode carecer da flexibilidade para acomodar configurações ou versões específicas de projeto.

• Sobrecarga Potencial:

  • Instalar DLLs no GAC pode introduzir sobrecarga e complexidade, particularmente em cenários onde múltiplas versões do Documentize podem ser necessárias simultaneamente.

• Remoção Manual:

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

• Conflitos de Versão:

  • Instalações globais podem levar a conflitos de versão se diferentes projetos requerem diferentes versões do Documentize. Gerenciar esses conflitos pode exigir configuração ou limpeza adicional.

Ambiente Não-Windows

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

Como o Documentize para .NET oferece suporte ao .NET Standard 2.0 (.NET Core 2.0), ele pode ser usado em Aplicativos Core que executam em sistemas operacionais semelhantes ao Linux. Estamos constantemente trabalhando para melhorar o suporte ao .NET Core em nossa API. No entanto, há algumas operações que recomendamos que nossos clientes realizem para obter melhores resultados ao usar recursos do Documentize para .NET. Por favor, instale:

• pacote libgdiplus
• Pacote com fontes compatíveis com 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 para .NET verifica esta pasta em sistemas operacionais semelhantes ao Linux. Caso o sistema operacional tenha outra pasta/diretório padrão para fontes, você deve usar a seguinte linha de código antes de realizar qualquer operação usando o Documentize:

  Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<caminho do usuário para fontes ms>"));

v24.12

Adicionado novo Plugin: Conversor de PDF para PNG

• Classe PngConverter: Representa o plugin Documentize.PngConverter. Usado para converter documentos PDF em formato PNG.
• Classe PdfToPngOptions: Representa as opções do conversor de PDF para PNG para o plugin Documentize.PngConverter.

Exemplo de Uso:

// criar PngConverter
var plugin = new PngConverter();
// criar objeto PdfToPngOptions para definir instruções
var opt = new PdfToPngOptions();
// adicionar caminho do arquivo de entrada
opt.AddInput(new FileDataSource("caminho_para_seu_arquivo_pdf.pdf"));
// definir caminho do arquivo de saída
opt.AddOutput(new DirectoryDataSource("caminho_para_diretorio_de_resultados"));
// realizar o processo
plugin.Process(opt);

Adicionado novo Plugin: Conversor de PDF para TIFF

• Classe TiffConverter: Representa o plugin Documentize.TiffConverter. Usado para converter documentos PDF em formato TIFF.
• Classe PdfToTiffOptions: Representa as opções do conversor de PDF para TIFF para o plugin Documentize.TiffConverter.

Exemplo de Uso:

// criar TiffConverter
var plugin = new TiffConverter();
// criar objeto PdfToTiffOptions para definir instruções
var opt = new PdfToTiffOptions();
// adicionar caminho do arquivo de entrada
opt.AddInput(new FileDataSource("caminho_para_seu_arquivo_pdf.pdf"));
// definir caminho do arquivo de saída
opt.AddOutput(new DirectoryDataSource("caminho_para_diretorio_de_resultados"));
// realizar o processo
plugin.Process(opt);

Adicionado novo Plugin: Gerador de Tabela PDF

• Classe TableGenerator: Representa o plugin Documentize.TableGenerator. Usado para adicionar uma tabela a um documento PDF.
• Classe TableBuilder: Classe representa o construtor para tabela na página pdf.
• Classe TableRowBuilder: Classe representa o construtor para linha da tabela.
• Classe TableRowBuilder: Classe representa o construtor para célula da tabela.

Exemplo de Uso:

// criar TableGenerator
var plugin = new TableGenerator();
// criar objeto TableOptions para definir instruções
TableOptions opt = new TableOptions().InsertPageBefore(1)
   .AddTable()
        .AddRow()
            .AddCell().AddParagraph("Nome")
            .AddCell().AddParagraph("Idade")
        .AddRow()
            .AddCell().AddParagraph("Bob")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Sam")
            .AddCell().AddParagraph("20")
        .AddRow()
            .AddCell().AddParagraph("Sandy")
            .AddCell().AddParagraph("26")
        .AddRow()
            .AddCell().AddParagraph("Tom")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Jim")
            .AddCell().AddParagraph("27");
// adicionar caminho do arquivo de entrada
opt.AddInput(new FileDataSource("caminho_para_seu_arquivo_pdf.pdf"));
// definir caminho do arquivo de saída
opt.AddOutput(new FileDataSource("caminho_para_o_arquivo_convertido.pdf"));
// realizar o processo
plugin.Process(opt);

Renomeada Classe PdfDoc para DocConverter

• Classe DocConverter: Representa o plugin Documentize.DocConverter. Usado para converter documentos PDF em formato DOC/DOCX.

Exemplo de Uso:

// criar DocConverter
var plugin = new DocConverter();
// criar objeto PdfToDocOptions para definir instruções
var opt = new PdfToDocOptions();
// adicionar caminho do arquivo de entrada
opt.AddInput(new FileDataSource(inputPath));
// definir caminho do arquivo de saída
opt.AddOutput(new FileDataSource(outputPath));
// realizar o processo
plugin.Process(opt);

v24.11

Adicionado novo Plugin: Conversor de PDF para JPEG

• Propósito: A classe JpegConverter é projetada para converter documentos PDF em formato JPEG, facilitando para os usuários manusear e compartilhar imagens derivadas de PDFs.
• Construtor:
  • JpegConverter(): Inicializa uma nova instância do conversor JPEG.

Exemplo de Uso:

var plugin = new JpegConverter();
var opt = new PdfToJpegOptions();
opt.AddInput(new FileDataSource("caminho_para_seu_arquivo_pdf.pdf"));
opt.AddOutput(new DirectoryDataSource("caminho_para_diretorio_de_resultados"));
plugin.Process(opt);

• Método:
  • Process(PdfToJpegOptions options): Inicia o processo de conversão JPEG usando as opções especificadas.

Adicionada Classe DirectoryDataSource

• Propósito: A classe DirectoryDataSource permite que os usuários gerenciem dados de diretório para operações de carregamento e salvamento dentro dos plugins.
• Construtor:
  • DirectoryDataSource(string path): Inicializa um novo objeto de dados de diretório com o caminho especificado.

Exemplo de Uso:

var directorySource = new DirectoryDataSource("caminho_para_seu_diretorio");

• Propriedades:
  • DataType: Recupera o tipo de fonte de dados.
  • Path: Obtém o caminho do diretório de dados atual.

Adicionada Classe PdfToJpegOptions

• Propósito: Esta classe contém opções para configurar o processo de conversão JPEG, permitindo que os usuários especifiquem resolução, listas de páginas e qualidade da imagem.
• Construtor:
  • PdfToJpegOptions(): Inicializa uma nova instância de opções para o conversor JPEG.

Propriedades:

• OutputResolution: Especifica a resolução das imagens JPEG resultantes.
• PageList: Uma lista de páginas a serem convertidas do PDF.
• Quality: Define a qualidade da saída JPEG.

v24.10

Novo Plugin Adicionado: Conversor PDF/A

• Um novo recurso de conversão PDF/A foi introduzido, permitindo aos usuários converter facilmente arquivos PDF padrão em documentos compatíveis com PDF/A.

Exemplo de Uso:

var options = new PdfAConvertOptions
{
    PdfAVersion = PdfAStandardVersion.PDF_A_3B
};

options.AddInput(new FileDataSource("caminho_para_seu_arquivo_pdf.pdf"));
options.AddOutput(new FileDataSource("caminho_para_o_arquivo_convertido.pdf"));

var plugin = new PdfAConverter();
plugin.Process(options);

Correções de Bugs

• Corrigidos problemas relacionados à classe FileResult que resultavam em caminhos de saída incorretos.
• Resolvidos erros menores que afetavam o HtmlConverter ao lidar com arquivos grandes.

Melhorias

• Desempenho aprimorado de PdfExtractor e ImageExtractor para tempos de processamento mais rápidos.
• Atualizada a classe RotateOptions para suportar ângulos de rotação adicionais.

v24.9

Lançado