diff --git a/xamarin-android/Licensing/how-to-generate.md b/xamarin-android/Licensing/how-to-generate.md index 0c2f839a..8be6a7e6 100644 --- a/xamarin-android/Licensing/how-to-generate.md +++ b/xamarin-android/Licensing/how-to-generate.md @@ -17,6 +17,35 @@ License keys for Xamarin can be generated from the [License & Downloads](https:/ I> * Syncfusion license keys are **version and platform specific**, refer to the [KB](https://www.syncfusion.com/kb/8976/how-to-generate-license-key-for-licensed-products) to generate the license key for the required version and platform. * Refer this [KB](https://www.syncfusion.com/kb/8951/which-version-syncfusion-license-key-should-i-use-in-my-application) to know about which version of the Syncfusion license key should be used in the application. +## Claim License key + +Syncfusion License keys can also be generated from the **"Claim License Key"** page based on the trial or valid license associated with your Syncfusion account. + +You can get the license key, based on license availability in your Syncfusion account. + +### Active License + +If you have a Syncfusion account associated with valid license, license key will be generated from claim license key page. + +![Active License](licensing-images/active-license.png) + +### Active Trial + +If you have a Syncfusion account associated with valid trial license, license key will be generated from claim license key page with expiry date. + +![Active Trial](licensing-images/active-trial.png) + +### Expired License + +If you have a Syncfusion account with an expired license, your license subscription must be renewed in order to obtain a valid license key for the latest Essential Studio version. Meanwhile, a temporary license key with a 5-day validity period will be generated. + +![Expired License](licensing-images/expired-license.png) + +### No Trial or No License or Expired trial + +If the Syncfusion account is not associated with a trial, license, or expired trial, you can try to claim either a trial or a valid license from claim license page. + +![No Trial or No License](licensing-images/no-active-trial-or-license.png) ## See Also diff --git a/xamarin-android/Licensing/licensing-errors.md b/xamarin-android/Licensing/licensing-errors.md index 5d89debe..d164a3b8 100644 --- a/xamarin-android/Licensing/licensing-errors.md +++ b/xamarin-android/Licensing/licensing-errors.md @@ -11,7 +11,39 @@ documentation: ug Licensing error popup is displayed with various messages under different circumstances. Here are some ways to resolve different issues. -## License key not registered +## Licensing errors + +### License key not registered\Trial Expired + +The following error message will be shown if a Syncfusion license key has not been registered in your application or if the trial key has expired after 30 days. + +**Error message:** This application was built using a trial version of Syncfusion Essential Studio. You should include the valid license key to remove the license validation message permanently. + +**Solution:** + +* Generate a valid license key from here [Licensed users](https://www.syncfusion.com/account/downloads) or [Trial users](https://www.syncfusion.com/account/manage-trials/downloads) for a specific version and platform or License keys can also be generated from the Claim License Key page by clicking the **"Claim License"** button click from Syncfusion licensing warning message. Refer to this [help topic](https://help.syncfusion.com/xamarin-android/licensing/how-to-generate#Claim-License-Key) for more details. + +* In your application, register the generated license key. Please refer to this [help topic](https://help.syncfusion.com/xamarin-android/licensing/how-to-register-in-an-application) for information on registering the license key. + +![License key not registered](licensing-images/new-licensing-alert.png) + +### Invalid key + +If the application is registered with an invalid key, another version of license key, or another platform's license key, the following error message will pop up when launching the application. + +**Error Message:** The included Syncfusion license key is invalid. + +**Solution:** + +* Generate a valid license key from here [Licensed users](https://www.syncfusion.com/account/downloads) or [Trial users](https://www.syncfusion.com/account/manage-trials/downloads) for a specific version and platform or License keys can also be generated from the Claim License Key page by clicking the **"Claim License"** button click from Syncfusion licensing warning message. Refer to this [help topic](https://help.syncfusion.com/xamarin-android/licensing/how-to-generate#Claim-License-Key) for more details. + +* In your application, register the generated license key. Please refer to this [help topic](https://help.syncfusion.com/xamarin-android/licensing/how-to-register-in-an-application) for information on registering the license key. + +![License key not registered](licensing-images/new-invalid-key.png) + +## Licensing errors from version 16.2.0* to 20.3.0* + +### License key not registered The following error message will be shown if a Syncfusion license key has not been registered in your application. @@ -25,7 +57,7 @@ The following error message will be shown if a Syncfusion license key has not be ![License key not registered](licensing-images/licensing-alert.png) -## Invalid key +### Invalid key If the application is registered with an invalid key, another version of license key, or another platform's license key, the following error message will pop up when launching the application. @@ -39,7 +71,7 @@ If the application is registered with an invalid key, another version of license ![License key not registered](licensing-images/invalid-key.png) -## Trial Expired +### Trial Expired The following error message will be shown if the trial key has expired after 30 days. @@ -49,7 +81,7 @@ The following error message will be shown if the trial key has expired after 30 ![License key not registered](licensing-images/trial-expired.png) -## Platform Mismatch +### Platform Mismatch If the application is registered with another platform's license key, the following error message will pop up when launching the application. @@ -63,7 +95,7 @@ If the application is registered with another platform's license key, the follow ![License key not registered](licensing-images/platform-mismatch.png) -## Version Mismatch +### Version Mismatch If the application is registered with another version's license key, the following error message will pop up when launching the application. @@ -77,7 +109,7 @@ If the application is registered with another version's license key, the followi ![License key not registered](licensing-images/version-mismatch.png) -## Could not load Syncfusion.Licensing.dll assembly version...? +### Could not load Syncfusion.Licensing.dll assembly version...? Make sure that all the referenced Syncfusion assembles are of the same version. Try cleaning and rebuilding the application to resolve assembly conflict issues. diff --git a/xamarin-android/Licensing/licensing-images/active-license.png b/xamarin-android/Licensing/licensing-images/active-license.png new file mode 100644 index 00000000..18f2f2f9 Binary files /dev/null and b/xamarin-android/Licensing/licensing-images/active-license.png differ diff --git a/xamarin-android/Licensing/licensing-images/active-trial.png b/xamarin-android/Licensing/licensing-images/active-trial.png new file mode 100644 index 00000000..72acc1eb Binary files /dev/null and b/xamarin-android/Licensing/licensing-images/active-trial.png differ diff --git a/xamarin-android/Licensing/licensing-images/expired-license.png b/xamarin-android/Licensing/licensing-images/expired-license.png new file mode 100644 index 00000000..989db829 Binary files /dev/null and b/xamarin-android/Licensing/licensing-images/expired-license.png differ diff --git a/xamarin-android/Licensing/licensing-images/java-license-key.png b/xamarin-android/Licensing/licensing-images/java-license-key.png new file mode 100644 index 00000000..a880b8cc Binary files /dev/null and b/xamarin-android/Licensing/licensing-images/java-license-key.png differ diff --git a/xamarin-android/Licensing/licensing-images/java-license.png b/xamarin-android/Licensing/licensing-images/java-license.png new file mode 100644 index 00000000..85b2a06d Binary files /dev/null and b/xamarin-android/Licensing/licensing-images/java-license.png differ diff --git a/xamarin-android/Licensing/licensing-images/new-invalid-key.png b/xamarin-android/Licensing/licensing-images/new-invalid-key.png new file mode 100644 index 00000000..3b96d381 Binary files /dev/null and b/xamarin-android/Licensing/licensing-images/new-invalid-key.png differ diff --git a/xamarin-android/Licensing/licensing-images/new-licensing-alert-claim.png b/xamarin-android/Licensing/licensing-images/new-licensing-alert-claim.png new file mode 100644 index 00000000..c5c4c45e Binary files /dev/null and b/xamarin-android/Licensing/licensing-images/new-licensing-alert-claim.png differ diff --git a/xamarin-android/Licensing/licensing-images/new-licensing-alert.png b/xamarin-android/Licensing/licensing-images/new-licensing-alert.png new file mode 100644 index 00000000..764ea057 Binary files /dev/null and b/xamarin-android/Licensing/licensing-images/new-licensing-alert.png differ diff --git a/xamarin-android/Licensing/licensing-images/no-active-trial-or-license.png b/xamarin-android/Licensing/licensing-images/no-active-trial-or-license.png new file mode 100644 index 00000000..b90d01da Binary files /dev/null and b/xamarin-android/Licensing/licensing-images/no-active-trial-or-license.png differ diff --git a/xamarin-android/Licensing/overview.md b/xamarin-android/Licensing/overview.md index 799fb3d2..dbf33164 100644 --- a/xamarin-android/Licensing/overview.md +++ b/xamarin-android/Licensing/overview.md @@ -33,6 +33,13 @@ This application was built using a trial version of Syncfusion Essential Studio. +## Registering Syncfusion license keys in Build server + +| Source of Syncfusion assemblies | Details | License Key needs to be registered? | Where to get license key from | +| ------------- | ------------- | ------------- | ------------- | +| **NuGet package** | If the Syncfusion assemblies used in Build Server were from the Syncfusion NuGet packages, then no need to install any Syncfusion installer. We can directly use the required Syncfusion NuGet packages at [nuget.org](http://nuget.org/).

But, if using NuGet packages from the [nuget.org](https://www.nuget.org/packages?q=syncfusion), then we should register the Syncfusion license key in the application.| Yes | Use any developer license to [generate](https://help.syncfusion.com/xamarin-android/licensing/how-to-generate) keys for Build Environments as well. | +| **Trial installer** | If the Syncfusion assemblies used in Build Server were from Trial Installer, we should register the license key in the application for the corresponding version and platforms, to avoid trial license warning. | Yes | Use any developer trial license to [generate](https://help.syncfusion.com/xamarin-android/licensing/how-to-generate) keys for Build Environments as well. | +| **Licensed installer** |If the Syncfusion assemblies used in Build Server were from Licensed Installer, then there is no need to register the license keys.

You can [download](https://help.syncfusion.com/xamarin-android/installation/web-installer/how-to-download#download-the-license-version) and [install](https://help.syncfusion.com/xamarin-android/installation/web-installer/how-to-install) the licensed version of our installer. | No | Not applicable | ## See Also