Installation

El SDK de Sheetize se puede instalar utilizando varios métodos, cada uno adecuado para diferentes entornos de desarrollo y preferencias. A continuación se presentan las opciones de instalación recomendadas:

1. NuGet (Método Recomendado)

El administrador de paquetes NuGet es el método más fácil y preferido para instalar Sheetize, asegurando que tenga acceso a las últimas actualizaciones directamente desde su entorno de desarrollo. Aprenda más sobre este método en Cómo instalar SDKs de Sheetize usando NuGet.

2. Instalador MSI

El Instalador MSI es una opción conveniente para aquellos que prefieren tener las DLLs de Sheetize instaladas directamente en su sistema. Este enfoque es ideal para desarrolladores que necesitan Sheetize en múltiples proyectos sin tener que gestionar manualmente los archivos DLL. Aprenda más sobre este método en Cómo instalar SDKs de Sheetize usando MSI.

3. Archivo ZIP

Si prefiere una instalación manual, el Archivo ZIP proporciona las DLLs de Sheetize que se pueden extraer y agregar directamente a su proyecto. Aprenda más sobre este método en Cómo instalar SDKs de Sheetize usando ZIP.

System Requirements

Sheetize SDKs están diseñados para integrarse sin problemas con aplicaciones .NET, soportando una variedad de sistemas operativos y entornos de desarrollo. A continuación se presentan los requisitos del sistema clave:

Sistemas Operativos Soportados

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)
Microsoft Azure

macOS

macOS 10.12 (Sierra) y versiones posteriores

Linux

Compatible con múltiples distribuciones de Linux:
- Ubuntu (16.04, 18.04, 20.04, 22.04)
- CentOS (7, 8)
- Debian (9, 10)
- OpenSUSE (Leap 15+, SLES 12+)

Android

Soporta Android 8.0 (Oreo) y versiones posteriores

Entornos de Desarrollo

Microsoft Visual Studio:
- Visual Studio 2010 y versiones posteriores (incluyendo 2019 y 2022)
Soporta cualquier entorno de desarrollo que apunte a plataformas .NET

Frameworks .NET Soportados

.NET Framework 4.0 y superiores
.NET Standard 2.0 (.NET Core 3.1+)
.NET 6.0, .NET 7.0, .NET 8.0

Notas Adicionales

Adobe Acrobat no es requerido para usar Sheetize SDKs, pero se recomienda para visualizar documentos de hojas de cálculo.

Declaration

Los SDK de Sheetize requieren un conjunto de permisos de Confianza Total cuando se utilizan dentro de aplicaciones .NET. Este nivel de permiso es necesario para realizar operaciones críticas a nivel de sistema, como acceder a configuraciones del registro, archivos del sistema y gestionar fuentes.

Por qué es Necesaria la Confianza Total

Los SDK de Sheetize dependen de las clases del sistema central de .NET, que a menudo necesitan permisos elevados por las siguientes razones:

Acceso al Registro: Algunas operaciones pueden requerir leer o escribir en el registro del sistema con fines de configuración.
Archivos del Sistema: Tareas como manejar fuentes o realizar operaciones de archivos pueden necesitar acceso a archivos del sistema más allá del directorio virtual de la aplicación.

Limitaciones en Entornos de Confianza Media

En entornos de hospedaje que imponen seguridad de Confianza Media, varios permisos críticos están restringidos o no disponibles, lo que podría obstaculizar la funcionalidad de los SDK. Las siguientes limitaciones se aplican bajo Confianza Media:

OleDbPermission: Previene el uso de proveedores de datos OLE DB administrados por ADO.NET para acceder a bases de datos.
EventLogPermission: Bloquea el acceso al Registro de Eventos de Windows, limitando las capacidades de diagnóstico.
ReflectionPermission: Restringe la reflexión, afectando ciertas operaciones dinámicas.
RegistryPermission: Niega el acceso al registro del sistema.
WebPermission: Limita la comunicación a direcciones o rangos predefinidos, según se configure en el elemento <trust>.
FileIOPermission: Limita el acceso a archivos dentro del directorio virtual de la aplicación.

Para asegurar la funcionalidad completa, los SDK de Sheetize deben ser utilizados en un entorno de Confianza Total.

Non-Windows Environment

Sheetize SDKs soportan .NET Standard 2.0, permitiendo su uso en aplicaciones .NET Core que se ejecutan en Linux u otros entornos que no sean Windows. Para asegurar un rendimiento óptimo y un renderizado de texto preciso, sigue los pasos a continuación:

Configuración Recomendada para Linux

1. Instalar el Paquete libgdiplus

El paquete libgdiplus proporciona funcionalidades esenciales de GDI+, críticas para renderizar y procesar hojas de cálculo. Instálalo ejecutando el siguiente comando en tu terminal:

sudo apt-get install libgdiplus

2. Instalar Fuentes Compatibles con Microsoft

Para asegurar un renderizado de texto correcto, instala las fuentes TrueType de Microsoft usando:

sudo apt-get install ttf-mscorefonts-installer

Estas fuentes deberían ubicarse en el directorio /usr/share/fonts/truetype/msttcorefonts. Si tu sistema utiliza un directorio diferente, actualiza la ruta en tu código antes de realizar cualquier operación con Sheetize SDKs:

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

Consejo

Al instalar estos paquetes y configurar correctamente la ruta de las fuentes, puedes maximizar el rendimiento de Sheetize SDKs en Linux u otros sistemas que no sean Windows.

Evaluation

Puedes descargar fácilmente SDKs de Sheetize para fines de evaluación. La versión de evaluación es completamente funcional, con la única diferencia en cómo se activa la licencia.

Limitaciones de la Versión de Evaluación

La versión de evaluación proporciona acceso completo a todas las funciones, pero incluye las siguientes limitaciones hasta que se aplique una licencia:

Se agrega una marca de agua de evaluación a toda la salida generada.
Solo se pueden ver o editar las primeras cuatro páginas de cualquier hoja de cálculo.

Para eliminar estas limitaciones y desbloquear todas las capacidades de Sheetize, simplemente aplica una licencia añadiendo algunas líneas de código a tu proyecto.