License Guide¶

ThinkGeo MAUI projects can target Android, iOS, Windows and MacCatalyst. This guide will show you how to set up a license for iOS/MacCatalyst and Android, and how to set up a RUNTIME license for Windows.

NOTE: Due to Visual Studio restrictions, iOS/MacCatalyst and Android applications require a runtime license to run and debug in an emulator. Further details can be found on our Licensing Overview.

Step 1: Install your Dev License - Required for all platforms¶

Whether you're developing for Windows, Mac, iOS or Android, you will need a developer license. Please navigate to https://helpdesk.thinkgeo.com/register to download the latest ProductCenter, and run it.

Sign into your account, click on Maui tab, then click the “Start Evaluation” button to get a free trial license, or click the “Activate” button if you've purchased the product.

Android_iOS Runtime License Image

Step 2: Setup License - Required for Android and iOS/Mac Catalyst¶

In order to run your Android or iOS/Mac Catalyst application in the emulator or production environment, you will need a license that can be generated in the Product Center.

Step 2-1: Generate License File¶

Get the Android Package Name from Platforms->Android->AndroidManifest.xml.

Android Package Name Image

Get the iOS Bundle Identifier from Platforms->iOS->Info.plist (You can get the MacCatalyst Bindle Identifier from Platforms->MacCatalyst->Info.plist, and generate/apply the license similar to iOS)

iOS Bundle Identifier Image

NOTE: If your package name is the default 'com.mycompany.myapp', you must change it to a new package name. The default Visiual Studio generated package name will not work with the licensing process.

Copy and paste them in the textboxes on the right of the product center. Click the “Create” button to generate the licenses. The license files can be named to anything.

Android/iOS ID TextBox Image

Step 2-2: Apply the license¶

Copy these license files to the \Resources\Raw folder in Visual Studio, and set the "Build Action" to "MauiAsset" as following:
Android/iOS Build Action Image

Step 2-3: Load the license¶

Call the following code to load the license, it could be anywhere before rendering the map. For example, it can be within App.OnStart()

await LicenseLoader.LoadLicense("thinkgeo.howdoi.maui.android.mapsuitelicense");
await LicenseLoader.LoadLicense("thinkgeo.howdoi.maui.ios.mapsuitelicense");

Now the licenses are ready for Android/iOS/MacCatalyst development and deployment.

Step 3: Setup a Runtime License for Windows¶

Once your application is ready to deploy to Production or a QA environment without a debugger, you will need to follow the steps below to generate a perpetual runtime license to deploy with your application.

Step 3-1: Generate Runtime License file¶

Copy the executable name and paste it in the textbox under WINDOWS RUNTIME LICENSE section, click the “Create” button to generate the runtime licenses. NOTE: Do not include extension in the name, For example use "HowDoISample" instead of "HowDoISample.exe".

Windows ID TextBox Image

Step 3-2: Apply the license¶

Copy this license file to the project root folder in Visual Studio, and change the "Copy to Output Directory" to "Copy if newer" as following:
Windows Runtime License Setup Image

And now your desktop is good to go for runtime.