Instalación

El visor base Doconut para .NET Standard se entrega como un único paquete NuGet que se integra en cualquier aplicación ASP.NET Core. Los complementos opcionales utilizan paquetes separados. Esta página instala el paquete base, confirma que su host puede consumirlo y registra el middleware — lo mínimo necesario antes de su primera renderización.

Verifique primero el framework del host

La biblioteca tiene como objetivo netstandard2.1. Ese es un contrato más estrecho que la compilación anterior netstandard2.0, y es lo primero que hay que verificar:

Si la aplicación se ejecuta en .NET Framework, este no es el paquete correcto. Use Doconut.NETFramework en su lugar; a partir de la versión 26.9.0 requiere .NET Framework 4.7.2. Las aplicaciones de referencia incluidas en esta versión tienen como objetivo net8.0.

Instalar el paquete

dotnet add package Doconut.NETStandard

El comando sin versión instala la última versión estable. Para reproducir exactamente la versión 26.8.0 actual, pase la versión como una opción separada:

dotnet add package Doconut.NETStandard --version 26.8.0

Doconut.NETStandard es el ID del paquete. El sufijo .26.8.0 pertenece al nombre de archivo descargado Doconut.NETStandard.26.8.0.nupkg y no forma parte del ID.

El número de versión es la generación

Esto es más importante aquí que el nombre del paquete. Ambas generaciones de la biblioteca .NET Standard se publican bajo el mismo ID de paquete, y solo la versión las diferencia:

No hay una capa de compatibilidad ni paquetes instalados lado a lado. Incrementar la versión es la actualización, y el compilador informará de inmediato las diferencias de API.

No seleccione la documentación solo por el nombre del paquete:

• new Viewer(_cache, _accessor, …), UnSafeMode, OpenDocument(...) sincrónico, viewer.InitCache(), UseDoconutWebFarm y scripts del visor copiados manualmente identifican la integración anterior;
• AddDoconut(), UseDoconutResources(), un Viewer inyectado y OpenDocumentAsync(...) identifican la integración actual documentada aquí.

El manual de configuración anterior traducido sigue disponible. Use la guía de migración para cambiar de generación; una actualización del paquete no convierte automáticamente el inicio, la vida útil del visor o los recursos del navegador.

Registrar Doconut

AddDoconut() es el único punto de entrada de registro — hay una única sobrecarga, y conecta el servicio Viewer, el servicio de licencia y la infraestructura de renderizado al contenedor DI.

Dos llamadas de middleware completan la configuración, y su orden es importante: UseDoconutResources() debe ejecutarse antes que UseDoconut(). UseDoconut() es middleware terminal, por lo que llamarlo primero hace que cada solicitud a un recurso /doconut-res nunca llegue al manejador de recursos y devuelva 404. El cableado de sesión también es necesario — la seguridad de documentos predeterminada de Doconut valida cada solicitud de página contra el estado de sesión de ASP.NET.

builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // el estado de sesión necesita una caché (MVC/Razor Pages ya añaden una)
builder.Services.AddSession(); // La seguridad de documentos de Doconut se basa en el estado de sesión de ASP.NET

app.UseSession();          // llame a UseSession() antes de UseDoconut()
app.UseDoconutResources(); // debe registrarse antes de UseDoconut()
app.UseDoconut();

Espacios de nombres

Los tipos de configuración ya no están repartidos en cuatro espacios de nombres. En esta versión, casi todo reside en el espacio de nombres raíz Doconut:

using Doconut;                       // Viewer, DoconutOptions, DocOptions, todas las configuraciones de formato
using Doconut.Middleware;            // métodos AddDoconut, UseDoconut, UseDoconutResources
using Doconut.Clouds;                // configuraciones de nube y de uso compartido de archivos
using Doconut.Configs.Conversion;    // ConversionTarget

Los nombres de los tipos en sí no cambiaron — PdfConfig, WordConfig, ExcelConfig, CssConfig, ScriptConfig y los demás siguen presentes. Si está migrando una aplicación existente, la mayoría de los archivos solo necesitan eliminar dos líneas using; consulte la guía de migración.

Todas las opciones

DoconutOptions acepta las siguientes propiedades configurables. Cada una es opcional — los valores predeterminados a continuación se aplican cuando una propiedad no se establece.

Prioridad de licencia cuando se establece más de una fuente: LicenseStream supera a LicenseContent, que supera a LicensePath, que supera a la búsqueda automática — vea la Configuración de licencia.

builder.Services.AddDoconut(options =>
{
    options.LicensePath     = "Doconut.Viewer.lic";
    options.MiddlewarePath  = "/doconut";     // coordinar con el mapeo de la aplicación y el BasePath del cliente
    options.ResourcesPath   = "/doconut-res"; // donde se sirven los JS/CSS/imágenes del visor
    options.UnsafeMode      = false;          // mantener la seguridad de sesión activada
    options.ShowDoconutInfo = false;
});

Próximos pasos

• Inicio rápido — abra su primer documento y rinda en el navegador.
• Configuración de licencia — dónde Doconut busca su archivo de licencia.