Instalación

Instalación del SDK de Documentize

Documentize se puede instalar mediante varios 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, garantizando que siempre tengas la versión más reciente y las actualizaciones directamente en tu entorno de desarrollo. Consulta más detalles sobre este método de instalación en Cómo instalar los SDK de Documentize usando NuGet.

2. Instalador MSI

El instalador MSI es una opción cómoda si prefieres que los DLL de Documentize se instalen directamente en tu sistema. Este método es ideal para desarrolladores que quieren usar 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 SDK de Documentize usando MSI.

3. Archivo ZIP

Para los desarrolladores que prefieren un enfoque manual, el archivo ZIP contiene los DLL de Documentize, que pueden extraerse y añadirse directamente a tu proyecto. Consulta más detalles sobre este método de instalación en Cómo instalar los SDK de Documentize usando ZIP.

3 nov. 2026

Subsecciones de Instalación

Installing Documentize via NuGet

Consejo

NuGet es un gestor de paquetes gratuito y de código abierto para .NET que simplifica la adición, eliminación y actualización de bibliotecas en proyectos de Visual Studio. Gestiona automáticamente los archivos de la biblioteca, referencias y cambios de configuración.

Cómo instalar mediante la Consola del Administrador de paquetes NuGet

  1. Abra su proyecto:

    • Inicie Visual Studio y abra su aplicación .NET.
  2. Acceda a la Consola del Administrador de paquetes:

    • Navegue a Herramientas > Administrador de paquetes NuGet > Consola del Administrador de paquetes.
  3. Instale el paquete:

    • Para instalar la última versión completa, introduzca el comando Install-Package Documentize.
    • Para instalar la última versión que incluya correcciones, use Install-Package Documentize -prerelease.
    • Pulse Enter para ejecutar el comando.

Cómo actualizar el paquete mediante la Consola del Administrador de paquetes NuGet

Si ya ha instalado Documentize mediante NuGet y desea actualizar a la versión más reciente:

  1. Abra su proyecto:

    • Inicie Visual Studio y abra su aplicación .NET.
  2. Acceda a la Consola del Administrador de paquetes:

    • Navegue a Herramientas > Administrador de paquetes NuGet > Consola del Administrador de paquetes.
  3. Actualice el paquete:

    • Para actualizar a la última versión completa, introduzca Update-Package Documentize.
    • Para actualizar a la última versión que incluya correcciones, use Update-Package Documentize -prerelease.
    • Pulse Enter para ejecutar el comando.

Cómo instalar mediante la interfaz gráfica del Administrador de paquetes NuGet

  1. Abra su proyecto:

    • Inicie Visual Studio y abra su aplicación .NET.
  2. Vaya a Administrar paquetes NuGet:

    • En el menú Proyecto, seleccione Administrar paquetes NuGet.
  3. Busque Documentize:

    • Diríjase a la pestaña Examinar y escriba Documentize en el cuadro de búsqueda.
  4. Instale el paquete:

    • Haga clic en Instalar/Actualizar junto a la última versión de Documentize.
    • Confirme haciendo clic en Aceptar en la ventana emergente.

Ventajas de usar NuGet

  • Gestión automática de dependencias:

    • NuGet maneja automáticamente las dependencias, asegurando que todas las bibliotecas requeridas se incluyan y actualicen correctamente. Esto reduce el riesgo de dependencias faltantes o incompatibles.
  • Actualizaciones simplificadas:

    • Actualizar paquetes es sencillo con NuGet, ya sea a través de la Consola del Administrador de paquetes o de la interfaz gráfica. Esto facilita mantener sus bibliotecas al día con las últimas funciones y correcciones de errores.
  • Integrado con Visual Studio:

    • NuGet está totalmente integrado en Visual Studio, ofreciendo una interfaz fácil de usar para gestionar paquetes sin salir del entorno de desarrollo.
  • Control de versiones:

    • NuGet le permite especificar y gestionar distintas versiones de las bibliotecas, permitiéndole revertir a versiones anteriores o probar nuevas versiones sin interrumpir su desarrollo.

Desventajas de usar NuGet

  • Limitado a Visual Studio:

    • NuGet está diseñado principalmente para su uso dentro de Visual Studio. Aunque puede usarse en otros entornos, la integración es más robusta en Visual Studio.
  • Posibles conflictos de versiones:

    • En proyectos grandes con muchas dependencias, la gestión de versiones y la resolución de conflictos pueden volverse complejas. NuGet ofrece herramientas para gestionarlo, pero requiere atención cuidadosa.
  • Dependencia de la red:

    • Instalar y actualizar paquetes requiere una conexión a Internet. Si trabaja en un entorno con acceso restringido o sin Internet, es posible que necesite usar métodos offline o pre‑descargar los paquetes.
  • Complejidad para proyectos grandes:

    • Para proyectos muy extensos con árboles de dependencias extensos, la sobrecarga de gestionar paquetes mediante NuGet puede resultar engorrosa. En tales casos, pueden ser necesarias herramientas o estrategias adicionales para gestionar las dependencias de manera eficaz.

Instalando Documentize via MSI

Consejo

El instalador MSI es una opción cómoda y fácil de usar para instalar Documentize, particularmente si prefieres que los DLL se instalen a nivel del sistema. Este método simplifica el proceso de instalación al automatizar muchos de los pasos involucrados.

Cómo instalar mediante el instalador MSI

  1. Descargar el instalador MSI:

    • Haz clic en el v26.11 MSI para descargar el instalador MSI de la última versión de Documentize.
  2. Ejecutar el instalador:

    • Haz doble clic en el archivo MSI descargado para iniciar el asistente de instalación.
  3. Seguir el asistente de instalación:

    • Sigue las instrucciones en pantalla proporcionadas por el instalador. Es posible que necesites aceptar el acuerdo de licencia y seleccionar opciones de instalación.
  4. Completar la instalación:

    • Una vez finalizada la instalación, los DLL de Documentize se instalarán en la Caché Global de Ensamblados (GAC) del sistema o en otra ubicación especificada.
  5. Verificar la instalación:

    • Comprueba que los DLL se hayan instalado correctamente verificando su presencia en el directorio de instalación designado o en el GAC.

Ventajas de usar el instalador MSI

  • Facilidad de uso:

    • El instalador MSI proporciona un proceso de instalación sencillo y guiado. Gestiona todas las configuraciones necesarias y coloca los DLL en una ubicación central, facilitando el uso de Documentize en varios proyectos.
  • Instalación a nivel del sistema:

    • El método MSI instala Documentize en la Caché Global de Ensamblados (GAC) del sistema o en otra ubicación central. Esto permite que cualquier aplicación del sistema acceda a los DLL sin necesidad de referenciarlos individualmente en cada proyecto.
  • Actualizaciones automáticas:

    • Si Documentize ofrece un instalador actualizado, puedes actualizar tu instalación fácilmente ejecutando el nuevo archivo MSI, que generalmente gestiona el proceso de actualización sin problemas.
  • Consistencia:

    • Usar el instalador MSI asegura que todos los archivos requeridos se instalen correctamente y de forma consistente en diferentes entornos, reduciendo el riesgo de DLL faltantes o mal ubicados.

Desventajas de usar el instalador MSI

  • Flexibilidad limitada:

    • El instalador MSI coloca Documentize en una ubicación a nivel del sistema, lo que puede no ser adecuado para todos los entornos de desarrollo. Puede carecer de la flexibilidad necesaria para acomodar configuraciones o versiones específicas de proyecto.
  • Sobrecarga potencial:

    • Instalar DLL en el GAC puede introducir sobrecarga y complejidad, especialmente en escenarios donde se necesiten simultáneamente varias versiones de Documentize.
  • Desinstalación manual:

    • Si necesitas desinstalar Documentize, debes usar el desinstalador proporcionado por el MSI, lo que puede dejar archivos o configuraciones residuales si no se gestiona adecuadamente.
  • Conflictos de versiones:

    • Las instalaciones a nivel del sistema pueden generar conflictos de versiones si diferentes proyectos requieren distintas versiones de Documentize. Gestionar estos conflictos puede requerir configuraciones adicionales o limpieza.

Installing Documentize via ZIP

Consejo

El archivo ZIP es ideal para desarrolladores que prefieren un enfoque manual para gestionar librerías. Este método le permite descargar y extraer directamente los archivos DLL necesarios sin depender de un gestor de paquetes o instalador.

Cómo instalar mediante archivo ZIP

  1. Descargar el archivo ZIP:

    • Haga clic en el v26.11 ZIP para descargar la última versión de Documentize en formato de archivo.
  2. Extraer el contenido:

    • Después de la descarga, extraiga el contenido del archivo ZIP en el directorio que prefiera. Puede optar por mantener estos archivos en un directorio compartido o dentro de la estructura de su proyecto.
  3. Añadir referencias a su proyecto:

    • Abra su proyecto en su IDE (p. ej., Visual Studio).
    • Vaya a Proyecto > Agregar referencia > Examinar y navegue hasta el directorio donde extrajo los DLL.
    • Seleccione los archivos DLL correspondientes y añádalos como referencias a su proyecto.
  4. Actualizaciones manuales:

    • Si se publica una nueva versión de Documentize, deberá descargar manualmente el archivo ZIP actualizado y reemplazar los archivos DLL antiguos en su proyecto con los nuevos.

Ventajas de usar el archivo ZIP

  • Control total:

    • Tiene control completo sobre dónde y cómo se almacenan y referencian los DLL en su proyecto. Esto puede ser beneficioso si prefiere una configuración personalizada o necesita gestionar dependencias de forma manual.
  • Sin dependencia de gestores de paquetes:

    • A diferencia de NuGet, no depende de un gestor de paquetes para manejar la instalación. Esto puede ser ventajoso en entornos donde los gestores de paquetes no están disponibles o no se desean usar.
  • Portabilidad:

    • El archivo ZIP puede compartirse y trasladarse fácilmente entre diferentes sistemas, lo que lo hace ideal para proyectos que necesitan ser portables o distribuidos sin depender de herramientas externas.

Desventajas de usar el archivo ZIP

  • Gestión manual:

    • A diferencia de NuGet, donde las actualizaciones y la gestión de dependencias están automatizadas, con el archivo ZIP debe gestionar manualmente las actualizaciones y asegurarse de que todos los DLL requeridos estén correctamente referenciados.
  • Riesgo de conflictos de versiones:

    • Si gestiona varios proyectos o trabaja en equipo, existe el riesgo de conflictos de versiones si diferentes proyectos usan distintas versiones de los DLL. Esto requiere un seguimiento cuidadoso de las versiones entre proyectos.
  • Sin actualizaciones automáticas:

    • No recibirá actualizaciones o notificaciones automáticas cuando esté disponible una nueva versión. Esto puede generar el riesgo de usar librerías obsoletas a menos que verifique regularmente la disponibilidad de actualizaciones.

Entorno no Windows

Trabajando con DLL de .NET Core en Entorno no Windows

Como Documentize for .NET brinda soporte para .NET Standard 2.0 (.NET Core 2.0), se puede usar en aplicaciones Core que se ejecutan en sistemas operativos tipo Linux. Estamos trabajando continuamente en mejorar el soporte para .NET Core en nuestra API. Sin embargo, hay algunas operaciones que recomendamos a nuestros clientes realizar para obtener mejores resultados al usar las funciones de Documentize for .NET. Por favor, instala:

  • paquete libgdiplus
  • Paquete con fuentes compatibles con Microsoft: ttf‑mscorefonts‑installer (por ejemplo, sudo apt-get install ttf-mscorefonts-installer). Estas fuentes deben ubicarse en el directorio /usr/share/fonts/truetype/msttcorefonts, ya que Documentize for .NET escanea esta carpeta en sistemas operativos tipo Linux. En caso de que el sistema operativo tenga otra carpeta/directorio predeterminado para fuentes, deberías usar la siguiente línea de código antes de realizar cualquier operación que utilice Documentize:
Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<ruta del usuario a las fuentes ms>"));
 Español