Installation

The Sheetize SDK can be installed using various methods, each suited to different development environments and preferences. Below are the recommended installation options:

The NuGet package manager is the easiest and most preferred method to install Sheetize, ensuring that you have access to the latest updates directly from your development environment. Learn more about this method at How to install Sheetize SDKs using NuGet.

2. MSI Installer

The MSI Installer is a convenient option for those who prefer having Sheetize DLLs installed directly on their system. This approach is ideal for developers needing Sheetize across multiple projects without manually managing DLL files. Learn more about this method at How to install Sheetize SDKs using MSI.

3. ZIP Archive

If you prefer a manual installation, the ZIP Archive provides Sheetize DLLs that can be extracted and added directly to your project. Learn more about this method at How to install Sheetize SDKs using ZIP.

Nov 1, 2024

Subsections of Installation

System Requirements

Sheetize SDKs are designed to integrate seamlessly with .NET applications, supporting a variety of operating systems and development environments. Below are the key system requirements:

Supported Operating Systems

Windows

  • Windows 7 (x64, x86)
  • Windows 8, 8.1 (x64, x86)
  • Windows 10 (x64, x86)
  • Windows 11 (x64, x86)
  • Windows Server 2003 to Windows Server 2022 (x64, x86)
  • Microsoft Azure

macOS

  • macOS 10.12 (Sierra) and later

Linux

  • Compatible with multiple Linux distributions:
    • Ubuntu (16.04, 18.04, 20.04, 22.04)
    • CentOS (7, 8)
    • Debian (9, 10)
    • OpenSUSE (Leap 15+, SLES 12+)

Android

  • Supports Android 8.0 (Oreo) and later

Development Environments

  • Microsoft Visual Studio:
    • Visual Studio 2010 and later (including 2019 and 2022)
  • Supports any development environment targeting .NET platforms

Supported .NET Frameworks

  • .NET Framework 4.0 and higher
  • .NET Standard 2.0 (.NET Core 3.1+)
  • .NET 6.0, .NET 7.0, .NET 8.0

Additional Notes

  • Adobe Acrobat is not required to use Sheetize SDKs, but is recommended for viewing spreadsheet documents.
Nov 1, 2024

Declaration

Sheetize SDKs require a Full Trust permission set when used within .NET applications. This level of permission is necessary to perform critical system-level operations, such as accessing registry settings, system files, and managing fonts.

Why Full Trust is Necessary

The Sheetize SDKs rely on core .NET system classes, which often need elevated permissions for the following reasons:

  • Registry Access: Some operations may require reading or writing to the system registry for configuration purposes.
  • System Files: Tasks such as handling fonts or file operations may need access to system files beyond the application’s virtual directory.

Limitations in Medium Trust Environments

In hosting environments that enforce Medium Trust security, several critical permissions are restricted or unavailable, which could hinder the functionality of the SDKs. The following limitations apply under Medium Trust:

  • OleDbPermission: Prevents the use of ADO.NET managed OLE DB data providers to access databases.
  • EventLogPermission: Blocks access to the Windows Event Log, limiting diagnostic capabilities.
  • ReflectionPermission: Restricts reflection, affecting certain dynamic operations.
  • RegistryPermission: Denies access to the system registry.
  • WebPermission: Limits communication to predefined addresses or ranges, as configured in the <trust> element.
  • FileIOPermission: Limits access to files within the application’s virtual directory.

To ensure full functionality, Sheetize SDKs should be used in a Full Trust environment.

Nov 1, 2024

Non-Windows Environment

Sheetize SDKs support .NET Standard 2.0, enabling them to be used in .NET Core applications running on Linux or other non-Windows environments. To ensure optimal performance and accurate text rendering, follow the steps below:

1. Install libgdiplus Package

The libgdiplus package provides essential GDI+ functionality, critical for rendering and processing spreadsheets. Install it by running the following command in your terminal:

sudo apt-get install libgdiplus

2. Install Microsoft Compatible Fonts

To ensure correct text rendering, install Microsoft TrueType fonts using:

sudo apt-get install ttf-mscorefonts-installer

These fonts should be located in the /usr/share/fonts/truetype/msttcorefonts directory. If your system uses a different directory, update the path in your code before performing any operations with Sheetize SDKs:

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

By installing these packages and configuring the font path correctly, you can maximize the performance of Sheetize SDKs on Linux or other non-Windows systems.

Nov 1, 2024

Evaluation

You can easily download Sheetize SDKs for evaluation purposes. The evaluation version is fully functional, with the only difference being how you activate the license.

Evaluation Version Limitations

The evaluation version provides full access to all features, but includes the following limitations until a license is applied:

  • An evaluation watermark is added to all generated output.
  • Only the first four pages of any spreadsheet can be viewed or edited.

To remove these limitations and unlock the full capabilities of Sheetize, simply apply a license by adding a few lines of code to your project.

 English