Installation

O Sheetize SDK pode ser instalado usando vários métodos, cada um adequado a diferentes ambientes de desenvolvimento e preferências. Abaixo estão as opções de instalação recomendadas:

1. NuGet (Método Recomendado)

O gerenciador de pacotes NuGet é o método mais fácil e preferido para instalar o Sheetize, garantindo que você tenha acesso às últimas atualizações diretamente do seu ambiente de desenvolvimento. Aprenda mais sobre este método em Como instalar SDKs do Sheetize usando NuGet.

2. Instalador MSI

O Instalador MSI é uma opção conveniente para aqueles que preferem ter os DLLs do Sheetize instalados diretamente em seu sistema. Esta abordagem é ideal para desenvolvedores que precisam do Sheetize em vários projetos sem gerenciar manualmente os arquivos DLL. Aprenda mais sobre este método em Como instalar SDKs do Sheetize usando MSI.

3. Arquivo ZIP

Se você preferir uma instalação manual, o Arquivo ZIP fornece os DLLs do Sheetize que podem ser extraídos e adicionados diretamente ao seu projeto. Aprenda mais sobre este método em Como instalar SDKs do Sheetize usando ZIP.

System Requirements

Sheetize SDKs são projetados para se integrar perfeitamente com aplicações .NET, suportando uma variedade de 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 até Windows Server 2022 (x64, x86)
Microsoft Azure

macOS

macOS 10.12 (Sierra) e 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 posteriores

Ambientes de Desenvolvimento

Microsoft Visual Studio:
- Visual Studio 2010 e posteriores (inclusive 2019 e 2022)
Suporta qualquer ambiente de desenvolvimento que tenha como alvo plataformas .NET

.NET Frameworks 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 é requerido para usar Sheetize SDKs, mas é recomendado para visualizar documentos de planilhas.

Declaration

SDKs Sheetize requerem um conjunto de permissões de Confiança Total quando usados em aplicações .NET. Este nível de permissão é necessário para realizar operações críticas em nível de sistema, como acessar configurações do registro, arquivos do sistema e gerenciar fontes.

Por que a Confiança Total é Necessária

Os SDKs Sheetize dependem de classes principais do sistema .NET, que muitas vezes precisam de permissões elevadas pelas seguintes razões:

Acesso ao Registro: Algumas operações podem exigir a leitura ou escrita no registro do sistema para fins de configuração.
Arquivos do Sistema: Tarefas como manipulação de fontes ou operações de arquivos podem precisar de acesso a arquivos do sistema além do diretório virtual da aplicação.

Limitações em Ambientes de Confiança Média

Em ambientes de hospedagem que impõem segurança de Confiança Média, várias permissões críticas são restritas ou indisponíveis, o que pode prejudicar a funcionalidade dos SDKs. As seguintes limitações se aplicam sob Confiança Média:

OleDbPermission: Impede o uso de provedores de dados OLE DB gerenciados pelo ADO.NET para acessar bancos de dados.
EventLogPermission: Bloqueia o acesso ao Log de Eventos do Windows, limitando capacidades de diagnóstico.
ReflectionPermission: Restringe reflexão, afetando certas operações dinâmicas.
RegistryPermission: Nega acesso ao registro do sistema.
WebPermission: Limita a comunicação a endereços ou intervalos pré-definidos, conforme configurado no elemento <trust>.
FileIOPermission: Limita o acesso a arquivos dentro do diretório virtual da aplicação.

Para garantir total funcionalidade, os SDKs Sheetize devem ser usados em um ambiente de Confiança Total.

Non-Windows Environment

Sheetize SDKs suportam .NET Standard 2.0, permitindo que sejam usados em aplicações .NET Core que rodam em Linux ou outros ambientes que não sejam Windows. Para garantir um desempenho ideal e a renderização correta do texto, siga os passos abaixo:

Configuração Recomendada para Linux

1. Instale o Pacote libgdiplus

O pacote libgdiplus fornece funcionalidades essenciais do GDI+, críticas para a renderização e processamento de planilhas. Instale-o executando o seguinte comando em seu terminal:

sudo apt-get install libgdiplus

2. Instale as Fontes Compatíveis com Microsoft

Para garantir a renderização correta do texto, instale as fontes TrueType da Microsoft usando:

sudo apt-get install ttf-mscorefonts-installer

Essas fontes devem estar localizadas no diretório /usr/share/fonts/truetype/msttcorefonts. Se o seu sistema usar um diretório diferente, atualize o caminho em seu código antes de realizar quaisquer operações com Sheetize SDKs:

Sheetize.Text.FontRepository.Sources.Add(new FolderFontSource("<path to ms fonts>"))

Dica

Ao instalar esses pacotes e configurar corretamente o caminho das fontes, você pode maximizar o desempenho dos Sheetize SDKs no Linux ou em outros sistemas que não sejam Windows.

Evaluation

Você pode facilmente baixar os SDKs do Sheetize para fins de avaliação. A versão de avaliação é totalmente funcional, com a única diferença sendo a forma como você ativa a licença.

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

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

Uma marca d’água de avaliação é adicionada a toda a saída gerada.
Apenas as quatro primeiras páginas de qualquer planilha podem ser visualizadas ou editadas.

Para remover essas limitações e desbloquear todas as capacidades do Sheetize, basta aplicar uma licença adicionando algumas linhas de código ao seu projeto.