GroupDocs.Viewer.UI.SelfHost.Api.CrossPlatform

GroupDocs.Viewer.UI.SelfHost.Api.CrossPlatform

GroupDocs.Viewer.UI.SelfHost.Api.CrossPlatform is a cross-platform self-hosted API implementation for GroupDocs.Viewer.UI that enables document viewing using GroupDocs.Viewer for .NET cross-platform version. It provides a local, self-contained solution for document viewing that works across different operating systems.

This package uses the GroupDocs.Viewer.CrossPlatform NuGet package which provides a cross-platform graphical engine that works reliably on Linux and other operating systems. For Linux deployments, this package is the recommended choice over the Windows-optimized GroupDocs.Viewer.UI.SelfHost.Api.

Installation

To use GroupDocs.Viewer.UI.SelfHost.Api.CrossPlatform in your ASP.NET Core project:

1. Add the required package to your project:

dotnet add package GroupDocs.Viewer.UI.SelfHost.Api.CrossPlatform

1. Configure the CrossPlatform SelfHost API in your Startup class:

using GroupDocs.Viewer.UI.Core;

var builder = WebApplication.CreateBuilder(args);

var viewerType = ViewerType.HtmlWithEmbeddedResources;

builder.Services
    .AddGroupDocsViewerUI();

builder.Services
    .AddControllers()
    .AddGroupDocsViewerSelfHostApi(config =>
    {
        config.SetViewerType(viewerType);
        config.SetLicensePath("GroupDocs.Viewer.lic"); // Path to the license file

        // Configure view options
        config.ConfigureHtmlViewOptions(options => {
            // Configure HTML view options
        });

        config.ConfigurePngViewOptions(options => {
            // Configure PNG view options
        });

        config.ConfigureJpgViewOptions(options => {
            // Configure JPG view options
        });

        config.ConfigurePdfViewOptions(options => {
            // Configure PDF view options
        });

        // Configure internal caching
        config.ConfigureInternalCaching(options => {
            // Configure caching options
        });
    })
    .AddLocalStorage("./Files");

var app = builder.Build();

app
    .UseRouting()
    .UseEndpoints(endpoints =>
    {
        endpoints.MapGroupDocsViewerUI(options =>
        {
            options.UIPath = "/viewer";
            options.ApiEndpoint = "/viewer-api";
        });
        endpoints.MapGroupDocsViewerApi(options =>
        {
            options.ApiPath = "/viewer-api";
        });
    });

await app.RunAsync();

Configuration Options

The CrossPlatform SelfHost API implementation provides the following configuration options:

• LicensePath (Optional): Path to your GroupDocs.Viewer license file.
• ViewerType (Optional): The type of viewer to use. Options include:
  • HtmlWithEmbeddedResources (default)
  • HtmlWithExternalResources
  • Png
  • Jpg

View Options Configuration

You can configure specific view options for different output formats:

config.ConfigureHtmlViewOptions(options => {
    // Configure HTML view options
});

config.ConfigurePngViewOptions(options => {
    // Configure PNG view options
});

config.ConfigureJpgViewOptions(options => {
    // Configure JPG view options
});

config.ConfigurePdfViewOptions(options => {
    // Configure PDF view options
});

Internal Caching

The internal caching mechanism stores rendered pages and document information in memory to improve performance:

• Uses memory cache to store rendered pages and document info
• Caches are keyed by document path and rendering parameters
• Default cache duration is 5 minutes (configurable)
• Automatically evicts old entries when memory is constrained
• Significantly improves performance for frequently accessed documents

The cache can be configured via the options shown in the example:

// Configure internal caching
config.ConfigureInternalCaching(options => {
    // Configure caching options
    options.DisableInternalCache(); // Disables internal caching
    options.SetCacheEntryExpirationTimeoutMinutes(60); // Default values is 5 minutes
});

Cross-Platform Support

This implementation is designed to work across different operating systems:

• Windows
• Linux
• macOS

Performance Considerations

When using GroupDocs.Viewer.UI.SelfHost.Api.CrossPlatform:

1. Processing is done locally on your server
2. Memory usage depends on document size and complexity
3. Internal caching can improve performance for repeated requests
4. Best suited for:
   • Cross-platform applications
   • Environments with limited internet connectivity
   • Scenarios where data privacy is important
5. Performance depends on:
   • Server hardware specifications
   • Document size and complexity
   • Chosen viewer type
   • Caching configuration
   • Operating system capabilities

License

This project is licensed under the MIT License - see the LICENSE.txt file for details.