Instalación

El SDK de Documentize se puede instalar a través de múltiples métodos, cada uno adaptado a diferentes entornos de desarrollo y preferencias. A continuación se presentan las formas recomendadas de instalar Documentize:

1. NuGet (Método Preferido)

NuGet es el método más sencillo y preferido para instalar Documentize, asegurando que siempre tengas la versión más reciente y actualizaciones directamente en tu entorno de desarrollo. Consulta más detalles sobre este método de instalación en Cómo instalar los SDKs de Documentize usando NuGet.

2. Instalador MSI

El instalador MSI es una opción conveniente si prefieres tener las DLLs de Documentize instaladas directamente en tu sistema. Este método es ideal para desarrolladores que pueden querer utilizar Documentize en varios proyectos sin necesidad de gestionar manualmente los archivos DLL. Consulta más detalles sobre este método de instalación en Cómo instalar los SDKs de Documentize usando MSI.

3. Archivo ZIP

Para los desarrolladores que prefieren un enfoque manual, el archivo ZIP contiene las DLLs de Documentize, que pueden ser extraídas y añadidas a tu proyecto directamente. Consulta más detalles sobre este método de instalación en Cómo instalar los SDKs de Documentize usando ZIP.

Requisitos del Sistema

Los SDKs de Documentize están diseñados para integrarse con aplicaciones .NET y soportan varios 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)
Nube: 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 destinado a plataformas .NET.

Frameworks .NET Soportados

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

Notas Adicionales

Adobe Acrobat no es necesario para ejecutar los SDKs de Documentize, pero se recomienda para visualizar PDFs.

Declaración

Los SDKs de Documentize.com requieren un conjunto de permisos de Confianza Total cuando se utilizan dentro de aplicaciones .NET. Este nivel de permiso es esencial para que los SDKs realicen ciertas operaciones a nivel del sistema, como acceder a configuraciones del registro, archivos del sistema y procesar fuentes.

Por qué se Requiere Confianza Total

Los SDKs de Documentize utilizan clases centrales del sistema .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.
Archivos del Sistema: Puede ser necesario acceder a archivos del sistema más allá del directorio virtual de la aplicación para ciertas tareas, como manejar fuentes o realizar operaciones de archivos.

Limitaciones del Entorno de Confianza Media

En entornos de hosting que imponen seguridad de Confianza Media, se restringen o no están disponibles varios permisos importantes. Esto podría impedir que los SDKs funcionen correctamente en tales entornos. Las siguientes restricciones se aplican bajo Confianza Media:

OleDbPermission: No se puede usar el proveedor de datos OLE DB administrado de ADO.NET para acceder a bases de datos.
EventLogPermission: Se prohíbe el acceso al Registro de Eventos de Windows.
ReflectionPermission: Se impide el uso de reflexión, lo que puede afectar ciertas operaciones dinámicas.
RegistryPermission: Se niega el acceso al registro del sistema.
WebPermission: La comunicación está restringida a direcciones o rangos predefinidos según lo configurado en el elemento <trust>.
FileIOPermission: El acceso a archivos está limitado a los que se encuentran dentro del directorio virtual de la aplicación.

Entorno No Windows

Los SDK de Documentize son compatibles con .NET Standard 2.0, lo que permite su uso en aplicaciones .NET Core que se ejecutan en Linux u otros entornos no Windows. Para garantizar un rendimiento óptimo y una correcta representación del texto, siga los pasos a continuación:

Configuración Recomendada para Linux

1. Instalar el Paquete libgdiplus

Este paquete proporciona la funcionalidad GDI+ necesaria, que es crítica para la representación y el procesamiento de PDFs. Puede instalarlo ejecutando el siguiente comando en su terminal:

sudo apt-get install libgdiplus

2. Instalar Fuentes Compatibles con Microsoft

Para una correcta representación del texto, instale las fuentes TrueType de Microsoft utilizando el comando:

sudo apt-get install ttf-mscorefonts-installer

Estas fuentes deben colocarse en el directorio /usr/share/fonts/truetype/msttcorefonts. Si su sistema almacena fuentes en un directorio diferente, actualice la ruta en su código antes de realizar cualquier operación con los SDK de Documentize:

Documentize.Text.FontRepository.Sources.Add(new FolderFontSource("<ruta a las fuentes ms>"));

Consejo

Al asegurarse de que estas instalaciones estén completas y de configurar correctamente la ruta de las fuentes, puede maximizar el rendimiento de los SDK de Documentize en Linux u otros sistemas no Windows.

Evaluación

Puede descargar fácilmente los SDKs de Documentize para fines de evaluación. La versión de evaluación es idéntica a la versión comprada, siendo la única diferencia la forma en que se aplica la licencia.

Limitaciones de la Versión de Evaluación

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

Se inserta una marca de agua de evaluación en todos los documentos de salida.
Solo se pueden ver o editar las primeras cuatro páginas de cualquier documento PDF.

Para eliminar estas limitaciones y desbloquear la versión completa, simplemente aplique una licencia agregando algunas líneas de código a su proyecto.