$npx -y skills add syncfusion/maui-ui-components-skills --skill syncfusion-maui-licensingSets up and validates Syncfusion .NET MAUI licensing, including license key registration, generation, and error resolution. Use when encountering trial license warnings ("This application was built using a trial version"), licensing errors, license key registration, unlock key vs
| 1 | # Licensing for Syncfusion .NET MAUI |
| 2 | |
| 3 | Comprehensive guide for managing Syncfusion .NET MAUI licenses, from generation to registration and troubleshooting. |
| 4 | |
| 5 | ## When to Use This Skill |
| 6 | |
| 7 | Use this skill immediately when you encounter: |
| 8 | |
| 9 | **Licensing Errors:** |
| 10 | - "This application was built using a trial version" message |
| 11 | - "The included Syncfusion license key is invalid" error |
| 12 | - License validation failures |
| 13 | - Platform mismatch errors |
| 14 | - Version mismatch errors |
| 15 | - Trial expired messages |
| 16 | |
| 17 | **License Key Tasks:** |
| 18 | - Generating license keys from Syncfusion account |
| 19 | - Registering license keys in applications |
| 20 | - Understanding trial vs licensed installations |
| 21 | - Differentiating unlock key from license key |
| 22 | - Configuring licensing for build servers |
| 23 | - Setting up CI/CD license validation |
| 24 | |
| 25 | **Common Scenarios:** |
| 26 | - Initial app setup with Syncfusion components |
| 27 | - Resolving license warnings during development |
| 28 | - Deploying applications with proper licensing |
| 29 | - Upgrading from trial to licensed version |
| 30 | - Managing licenses for multiple projects |
| 31 | - Troubleshooting "Could not load Syncfusion.Licensing.dll" errors |
| 32 | |
| 33 | ## Licensing System Overview |
| 34 | |
| 35 | Starting with version **20.2.0.x**, Syncfusion introduced a new licensing system that applies to: |
| 36 | - NuGet packages from nuget.org |
| 37 | - Evaluation installers |
| 38 | - Trial licenses |
| 39 | |
| 40 | **Key Points:** |
| 41 | - License keys are **version and platform specific** |
| 42 | - Registration is required for NuGet packages and trial installers |
| 43 | - Licensed installers do NOT require license key registration |
| 44 | - License validation is **offline** (no internet required) |
| 45 | - License keys are different from installer unlock keys |
| 46 | |
| 47 | ## Documentation and Navigation Guide |
| 48 | |
| 49 | ### Understanding Licensing |
| 50 | |
| 51 | **When to Read:** First-time setup, understanding licensing requirements, or clarifying trial vs licensed installations. |
| 52 | |
| 53 | 📄 **Read:** [references/licensing-overview.md](references/licensing-overview.md) |
| 54 | - Licensing system introduction (v20.2.0.x changes) |
| 55 | - When license key registration is required |
| 56 | - Trial vs licensed installation differences |
| 57 | - Unlock key vs license key distinction |
| 58 | - Build server licensing scenarios |
| 59 | - NuGet package licensing requirements |
| 60 | - Version and platform specificity |
| 61 | |
| 62 | ### Generating License Keys |
| 63 | |
| 64 | **When to Read:** Need to obtain a new license key, working with trial licenses, or managing license for different versions/platforms. |
| 65 | |
| 66 | 📄 **Read:** [references/license-generation.md](references/license-generation.md) |
| 67 | - Accessing License & Downloads section |
| 68 | - Accessing Trial & Downloads section |
| 69 | - Using Claim License Key feature |
| 70 | - Generating keys for active licenses |
| 71 | - Generating keys for active trials |
| 72 | - Handling expired licenses (temporary 5-day keys) |
| 73 | - Setting up accounts for NuGet.org users |
| 74 | - Platform and version-specific key generation |
| 75 | |
| 76 | ### Registering License Keys |
| 77 | |
| 78 | **When to Read:** Need to register a license key in your application, choosing registration location, or implementing proper licensing. |
| 79 | |
| 80 | 📄 **Read:** [references/license-registration.md](references/license-registration.md) |
| 81 | - RegisterLicense() method syntax |
| 82 | - Registration in App.xaml.cs constructor |
| 83 | - Registration in MauiProgram.cs |
| 84 | - Syncfusion.Licensing.dll reference requirements |
| 85 | - Best practices for registration location |
| 86 | - Multiple registration scenarios |
| 87 | - Complete code examples for each approach |
| 88 | |
| 89 | ### Troubleshooting Licensing Errors |
| 90 | |
| 91 | **When to Read:** Encountering license validation errors, trial expiration messages, platform/version mismatches, or assembly loading issues. |
| 92 | |
| 93 | 📄 **Read:** [references/licensing-errors.md](references/licensing-errors.md) |
| 94 | - License key not registered error |
| 95 | - Invalid key error messages |
| 96 | - Trial expired errors |
| 97 | - Platform mismatch errors |
| 98 | - Version mismatch errors |
| 99 | - "Could not load Syncfusion.Licensing.dll" issues |
| 100 | - Solutions for each error type |
| 101 | - Version-specific error variations |
| 102 | - Copy Local configuration for assemblies |
| 103 | |
| 104 | ### Advanced Topics and FAQ |
| 105 | |
| 106 | **When to Read:** Setting up CI/CD pipelines, programmatic license validation, offline deployment questions, or upgrading from trial. |
| 107 | |
| 108 | 📄 **Read:** [references/licensing-faq.md](references/licensing-faq.md) |
| 109 | - CI/CD license validation (Azure Pipelines, GitHub Actions, Jenkins) |
| 110 | - ValidateLicense() method for programmatic checks |
| 111 | - Unit testing with license validation |
| 112 | - Internet connection requirements (offline validation) |
| 113 | - Upgrading from trial to licensed version |
| 114 | - NuGet.org user account registration |
| 115 | - Where to obtain license keys |
| 116 | - Common frequently asked questions |
| 117 | |
| 118 | ## Quick Start Guide |
| 119 | |
| 120 | # |