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 tenga la última versión y actualizaciones directamente en su entorno de desarrollo. Consulte más detalles sobre este método de instalación en Cómo instalar SDKs de Documentize usando NuGet.

2. Instalador MSI

El instalador MSI es una opción conveniente si prefiere tener las DLLs de Documentize instaladas directamente en su sistema. Este método es ideal para desarrolladores que puedan querer usar Documentize en múltiples proyectos sin necesidad de gestionar manualmente los archivos DLL. Consulte más detalles sobre este método de instalación en Cómo instalar 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 agregadas directamente a su proyecto. Consulte más detalles sobre este método de instalación en Cómo instalar SDKs de Documentize usando ZIP.

Requisitos del Sistema

Los SDKs de Documentize están diseñados para integrarse con aplicaciones .NET y admitir varios sistemas operativos y entornos de desarrollo. A continuación se presentan los requisitos clave del sistema:

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)
Cloud: 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

Compatible con 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 orientado 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 necesario para ejecutar los SDKs de Documentize, pero se recomienda para ver 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 de sistema, como el acceso a configuraciones del registro, archivos del sistema y el análisis de fuentes.

Por qué se Requiere Confianza Total

Los SDKs de Documentize utilizan clases del sistema .NET core, 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: El acceso a archivos del sistema más allá del directorio virtual de la aplicación puede ser necesario para ciertas tareas, como manejar fuentes o realizar operaciones con archivos.

Limitaciones del Entorno de Confianza Media

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

OleDbPermission: No se puede utilizar 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 la reflexión, lo que puede afectar ciertas operaciones dinámicas.
RegistryPermission: El acceso al registro del sistema está denegado.
WebPermission: La comunicación está restringida a direcciones o rangos predefinidos según lo configurado en el elemento <trust>.
FileIOPermission: El acceso a archivos se limita a aquellos dentro del directorio virtual de la aplicación.

Entorno No-Windows

Los SDKs 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 un correcto renderizado de 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 el renderizado y procesamiento de PDFs. Puede instalarlo ejecutando el siguiente comando en su terminal:

sudo apt-get install libgdiplus

2. Instalar Fuentes Compatibles de Microsoft

Para un correcto renderizado de 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 SDKs de Documentize:

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

Consejo

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

Evaluación

Puedes 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 cómo aplicas la licencia.

Limitaciones de la Versión de Evaluación

Mientras que 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 visualizar o editar las primeras cuatro páginas de cualquier documento PDF.

Para eliminar estas limitaciones y desbloquear la versión completa, simplemente aplica una licencia añadiendo unas pocas líneas de código a tu proyecto.