Updating your GdPicture.NET version

Keep your Nutrient .NET SDK integration up to date to get current fixes, format support, and product improvements. This guide explains what to expect when you update from an older GdPicture.NET version, which NuGet packages to add, and how to register your license.

Plan your update

Most applications can update to the latest version without changing existing code. Nutrient .NET SDK is designed for backward compatibility, so most updates, including major-version updates, don’t require broad API changes.

If you use a version that’s more than 10 years old, such as V9 or earlier, you may need to make some code changes. The core concepts remain similar, but older versions have less documentation and a less direct update path.

Update your NuGet packages

The packages you need depend on the version you’re updating to. The ORPALIS NuGet profile(opens in a new tab) lists the available GdPicture packages.

V14.4.0 and later

Starting with V14.4.0, Nutrient .NET SDK uses focused NuGet packages. Add only the packages your application needs.

Add the following packages to your project:

• GdPicture.NET, or GdPicture.API for non-UI applications.
• One runtime package for your target platform:
  • GdPicture.Runtime.Windows — For Windows.
  • GdPicture.Runtime.Linux — For Linux.
  • GdPicture.Runtime.macOS — For macOS.
• If your application uses UI controls, add one UI package for your framework:
  • GdPicture.WinForms — For Windows Forms applications.
  • GdPicture.WPF — For WPF applications.
  • GdPicture.MAUI — For cross-platform .NET MAUI applications.

If your application uses optical character recognition (OCR), also add:

• GdPicture.Resources — Contains the language data and assets required for OCR.

Register your license key in code to unlock the SDK. For more information, refer to the licensing section.

V14.2.X and V14.3.X

For V14.2.X and V14.3.X, the package structure is simpler. Add one of these packages:

• GdPicture.NET
• GdPicture.API

If your application uses OCR, also add:

• GdPicture.Resources

Register your license key in code to unlock the SDK.

V14.1.X and earlier

For V14.1.X, use the GdPicture.NET NuGet package.

Licensing for V14.1.X works differently from later versions. Register your license key in two places:

• The LicenseManager.exe tool included with the downloaded installer.
• Your application code, using the standard license registration call.

For V9 through V12, the process is broadly similar to V14.1.X. These versions have reached end of life, and documentation for them is limited. We recommend updating to a more recent version so you can receive full support.

If you can’t update right away, contact our Support team(opens in a new tab). We’ll do our best to help, but our ability to diagnose issues in these older versions is limited.

Licensing

Register your license key early in your application’s startup sequence, before you initialize any GdPicture components.

// Register your GdPicture license key at application startup.
GdPicture14.LicenseManager.RegisterKEY("YOUR-LICENSE-KEY-HERE");

For V14.2.X and later, this code registration is the only licensing step. You don’t need an external tool or installer step.

For V14.1.X, also register the license key in LicenseManager.exe. You need both registrations for the SDK to work.

Summary

Get help

When you contact Support about an update issue, include the following information:

• Your current version and the version you’re updating to.
• The NuGet packages and versions you referenced.
• Any error messages or unexpected behavior.
• An isolated project that reproduces the issue as-is. Narrow it down to the problem instead of sharing your full project.
• Screenshots, if they add useful context.

Contact our Support team(opens in a new tab) and we’ll help you resolve the issue.