Use a license in your app

Production licenses can be applied in one of two ways:

  • Using a .
  • Using a workflow.

The option you choose will depend on the nature of your app and whether your app's users will sign in to your app using an ArcGIS account.

License string

A is a text string provided by Esri that is used to enable a production license.

Your app must include code to apply the license string. See how to use a license string in your app for more details.

Use a if your users or the app fall under one of the following categories:

  • Users do not have an ArcGIS account with an organization or on-premises portal.
  • Your app makes use of SDK capabilities before a user signs in with their ArcGIS account.
  • Your app will remain offline indefinitely, or will function if offline for a duration of more than 30 days.

Your free Lite level license string is obtained from the ArcGIS Location Platform site (sign in required). Basic, Standard, and Advanced license strings are purchased as ArcGIS Runtime license deployment packs. See get a license for more information.

A Lite license string includes unlimited production deployments.

For Basic, Standard, and Advanced license strings, the ArcGIS Runtime license deployment pack defines how many production deployments are permitted (a deployment is counted per app, install, and user).

User authentication

is an authentication method where a user signs in to your app with an in or The ArcGIS account of the user can be assigned a production license.

Your app should allow a user to sign in using their ArcGIS account, and must include code to read and apply the license associated with their authenticated account. See how to use user authentication in your app for more information.

The administrator of the ArcGIS organization to which your app user belongs must assign a suitable ArcGIS Runtime license to your app user's ArcGIS account. See get a license for more information.

The production license obtained from user authentication travels with the user, not the app, allowing a user to license many apps.

How to use a license string in your app

You can get your Lite license string for free by signing into your .

Your Runtime Lite license string


You must sign in with an ArcGIS Location Platform account or ArcGIS Online account to retrieve your Runtime Lite license string.

Sign inSign up for an ArcGIS Location Platform accountGet a free ArcGIS Online trial

Using a license string involves adding code to set the license level at compile time so that the license string is built into the application.

  1. Find a location in your code that runs before any SDK functionality is used.
  2. Call the setlicenseUsingKey() method on the ArcGISEnvironment singleton object to license the app with a license string and any extension licenses.

The following example shows how to set a license string without extensions.

Flutter
1
2
3
ArcGISEnvironment.setLicenseUsingKey(
    'runtimelite,1000,rud#########,day-month-year,####################',
);

Your app is now licensed for production use.

How to use user authentication in your app

Use of involves adding code to enable sign in with an . At runtime, a user must successfully sign in to return their license information, which is used by the app to set the license level. Follow these steps to license your app using the member's account:

  1. Find a location in your code that runs before any SDK functionality is used.
  2. Allow the app user to authenticate with an ArcGIS organizational account. Upon loading the Portal obtain the LicenseInfo and use this to license the app. As part of the process, save the license information in preparation for the app being used in an offline environment for up to 30 days.

The following example shows how to get a license for an ArcGIS Online member.

Flutter
1
2
3
4
5
6
7
8
9
10
11
12
  // Constructs the portal and requests that the user logs in with their credentials.
  const url = 'https://myportal.com';
  final portal = Portal(Uri.parse(url), connection: PortalConnection.authenticated);

  // Loads the portal.
  await portal.load();

  // Gets the member's license info from the portal.
  final licenseInfo = await portal.fetchLicenseInfo();

  // Sets the license using the member's licenseInfo.
  final licenseResult = ArcGISEnvironment.setLicenseUsingInfo(licenseInfo);

Your app is now licensed for production use.

If you saved the license information on local storage, your app can be started and licensed in an offline environment using the saved license information. Retrieve the license from storage and license your app.

Flutter
1
2
3
4
5
6
7
    // Get the LicenseInfo as JSON formatted text.
    final licenseJson = licenseInfo.toJson();
    // ... save the JSON to the device ...

    // (on startup) ... get the license JSON stored on the device ...
    // Set the license info from the retrieved JSON.
    final licenseInfoFromJson = LicenseInfo.fromJson(licenseJson);

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close