syncfusion-maui-licensing

Syncfusion .NET MAUI のライセンス

Syncfusion .NET MAUI のライセンスを生成から登録、トラブルシューティングまで管理するための包括的なガイドです。

このスキルを使用するタイミング

次のような状況に遭遇したら、すぐにこのスキルを使用してください。

ライセンスエラー：

• 「このアプリケーションは試用版を使用してビルドされました」というメッセージ
• 「含まれている Syncfusion ライセンスキーは無効です」というエラー
• ライセンス検証の失敗
• プラットフォームの不一致エラー
• バージョンの不一致エラー
• 試用期間の終了メッセージ

ライセンスキーに関するタスク：

• Syncfusion アカウントからライセンスキーを生成する
• アプリケーションにライセンスキーを登録する
• 試用版とライセンス版のインストールの違いを理解する
• アンロックキーとライセンスキーを区別する
• ビルドサーバー用のライセンスを設定する
• CI/CD のライセンス検証を設定する

一般的なシナリオ：

• Syncfusion コンポーネントを使用したアプリの初期設定
• 開発中のライセンスに関する警告を解決する
• 適切なライセンスを設定してアプリケーションをデプロイする
• 試用版からライセンス版にアップグレードする
• 複数のプロジェクトのライセンスを管理する
• 「Syncfusion.Licensing.dll を読み込めませんでした」エラーのトラブルシューティング

ライセンスシステムの概要

バージョン 20.2.0.x 以降、Syncfusion は次のものに適用される新しいライセンスシステムを導入しました。

• nuget.org の NuGet パッケージ
• 評価版インストーラー
• 試用ライセンス

重要なポイント：

• ライセンスキーはバージョンおよびプラットフォーム固有です
• NuGet パッケージと試用版インストーラーでは登録が必要です
• ライセンス版インストーラーではライセンスキーの登録は不要です
• ライセンス検証はオフラインで行われます（インターネット接続は不要です）
• ライセンスキーはインストーラーのアンロックキーとは異なります

ドキュメントとナビゲーションガイド

ライセンスについて理解する

読むタイミング： 初回セットアップ時、ライセンス要件を理解する場合、または試用版とライセンス版のインストールの違いを確認する場合。

📄 参照： references/licensing-overview.md

• ライセンスシステムの概要（v20.2.0.x の変更点）
• ライセンスキーの登録が必要な場合
• 試用版とライセンス版のインストールの違い
• アンロックキーとライセンスキーの違い
• ビルドサーバーのライセンスに関するシナリオ
• NuGet パッケージのライセンス要件
• バージョンおよびプラットフォーム固有のライセンスキー

ライセンスキーを生成する

読むタイミング： 新しいライセンスキーを取得する場合、試用ライセンスを使用する場合、または異なるバージョンやプラットフォームのライセンスを管理する場合。

📄 参照： references/license-generation.md

• License & Downloads セクションへのアクセス
• Trial & Downloads セクションへのアクセス
• Claim License Key 機能の使用
• 有効なライセンスのキーを生成する
• 有効な試用ライセンスのキーを生成する
• 期限切れのライセンスに対応する（一時的な 5 日間のキー）
• NuGet.org ユーザー向けのアカウント設定
• プラットフォームおよびバージョン固有のキー生成

ライセンスキーを登録する

読むタイミング： アプリケーションにライセンスキーを登録する場合、登録場所を選ぶ場合、または適切なライセンスを実装する場合。

📄 参照： references/license-registration.md

• RegisterLicense() メソッドの構文
• App.xaml.cs コンストラクターでの登録
• MauiProgram.cs での登録
• Syncfusion.Licensing.dll の参照要件
• 登録場所に関するベストプラクティス
• 複数の登録シナリオ
• 各方法の完全なコード例

ライセンスエラーのトラブルシューティング

読むタイミング： ライセンス検証エラー、試用期間終了メッセージ、プラットフォームやバージョンの不一致、またはアセンブリの読み込みに関する問題が発生した場合。

📄 参照： references/licensing-errors.md

• ライセンスキーが登録されていないエラー
• 無効なキーに関するエラーメッセージ
• 試用期間終了のエラー
• プラットフォームの不一致エラー
• バージョンの不一致エラー
• 「Syncfusion.Licensing.dll を読み込めませんでした」という問題
• 各エラーの解決策
• バージョン固有のエラーの違い
• アセンブリの Copy Local 設定

高度なトピックと FAQ

読むタイミング： CI/CD パイプラインの設定、ライセンスのプログラムによる検証、オフライン展開に関する疑問、またはトライアルからのアップグレードを行う場合です。

📄 参照： references/licensing-faq.md

• CI/CD のライセンス検証（Azure Pipelines、GitHub Actions、Jenkins）
• プログラムによるチェックを行う ValidateLicense() メソッド
• ライセンス検証を使用したユニットテスト
• インターネット接続の要件（オフライン検証）
• トライアル版からライセンス版へのアップグレード
• NuGet.org ユーザーアカウントの登録
• ライセンスキーの入手先
• よくある質問

クイックスタートガイド

ステップ 1：ライセンスキーを生成する

1. Syncfusion アカウントにログインします
2. License & Downloads（ライセンス版）または Trial & Downloads（トライアル版）に移動します
3. .NET MAUI プラットフォームと使用するバージョンのライセンスキーを生成します
4. 生成したライセンスキーをコピーします

ステップ 2：ライセンスキーを登録する

次のいずれかの登録方法を選択します。

オプション A：App.xaml.cs に登録する

public App()
{
    // Register Syncfusion license
    string licenseKey = Environment.GetEnvironmentVariable("SYNCFUSION_LICENSE_KEY");
    if (!string.IsNullOrEmpty(licenseKey))
    {   
        Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense(licenseKey);
    }
    
    InitializeComponent();
    
    MainPage = new AppShell();
}

オプション B：MauiProgram.cs に登録する

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        // Register the Syncfusion license key
       string licenseKey = Environment.GetEnvironmentVariable("SYNCFUSION_LICENSE_KEY");
        if (!string.IsNullOrEmpty(licenseKey))
        {   
            Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense(licenseKey);
        }
 
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .ConfigureSyncfusionCore()
            .ConfigureFonts(fonts =>
            {
                fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
            });

        return builder.Build();
    }
}

ステップ 3：登録を確認する

アプリケーションを実行します。正しく登録されていれば、ライセンスに関する警告メッセージは表示されません。

よくあるパターン

パターン 1：新規プロジェクトの初期設定

シナリオ： NuGet から Syncfusion コンポーネントを使用する新しい .NET MAUI プロジェクトを開始します。

手順：

1. Syncfusion NuGet パッケージをインストールします
2. MAUI プラットフォームと使用するバージョンのライセンスキーを生成します
3. ConfigureSyncfusionCore() の前に、MauiProgram.cs でライセンスキーを登録します
4. Syncfusion.Licensing パッケージがインストールされていることを確認します
5. ビルドして実行し、ライセンスに関する警告が表示されないことを確認します

パターン 2：「Trial Version」警告を解決する

シナリオ： アプリケーションに「This application was built using a trial version」というメッセージが表示されます。

解決方法：

1. 有効なライセンスキーであること（有効期限が切れていないこと）を確認します
2. ライセンスキーが正しいプラットフォーム（MAUI）向けであることを確認します
3. ライセンスキーのバージョンがパッケージのバージョンと一致することを確認します
4. InitializeComponent() または ConfigureSyncfusionCore() の前にライセンスキーを登録します
5. アプリケーションをクリーンしてリビルドします

パターン 3：バージョン不一致エラー

シナリオ： エラーメッセージに「included Syncfusion license ({Registered Version}) is invalid for version {Required version}」と表示されます。

解決方法：

1. NuGet パッケージのバージョンを確認します（すべて同じバージョンにする必要があります）
2. 使用しているバージョンと完全に一致するライセンスキーを新たに生成します
3. 古いライセンスキーを新しいものに置き換えます
4. ソリューションをクリーンしてリビルドします

パターン 4：ビルドサーバー／CI/CD の設定

シナリオ： 継続的インテグレーション中にライセンスを検証する必要があります。

方法：

• CI パイプラインで LicenseKeyValidator ユーティリティを使用します
• ユニットテストで ValidateLicense() メソッドを実装します
• ライセンスキー用の環境変数を設定します
• 検証に失敗した場合はビルドを失敗させます

参照： CI/CD の詳細な設定手順については、references/licensing-faq.md を参照してください。

パターン 5：ソリューション内の複数のプロジェクト

シナリオ： ソリューションに Syncfusion コンポーネントを使用する複数の MAUI プロジェクトがあります。

解決方法：

1. 各プロジェクトの App.xaml.cs または MauiProgram.cs でライセンスキーを登録します
2. すべてのプロジェクトで同じライセンスキーを使用します（同じバージョンの場合）
3. すべてのプロジェクトが Syncfusion.Licensing.dll を参照していることを確認します
4. ライセンスキー文字列に共通の定数を使用することを検討します

主要な概念

ライセンスキーとアンロックキー

• アンロックキー： インストール中に Syncfusion インストーラーのロックを解除するために使用します
• ライセンスキー： NuGet パッケージまたはトライアルインストーラーを使用する際に、アプリケーションコードで必要です
• これらは用途の異なる別々のキーです

バージョンとプラットフォームの指定

ライセンスキーは次の項目に紐付けられています。

• プラットフォーム： MAUI、WPF、Blazor など（MAUI アプリには MAUI ライセンスを使用します）
• バージョン： Major.Minor.Patch（例：26.2.4）

MAUI 26.2.4 のライセンスキーは、次の場合には使用できません。

• 異なるプラットフォーム（例：Blazor）
• 異なるバージョン（例：26.1.0 または 27.0.0）

ライセンス登録が必要な場合

必要：

• nuget.org の NuGet パッケージ
• トライアル版インストーラーのアセンブリ
• 評価シナリオ

不要：

• ライセンス済みインストーラーのアセンブリ（ライセンスはアセンブリに埋め込まれています）

オフラインでの検証

• ライセンスの検証はアプリケーションの実行中にオフラインで行われます
• 検証にインターネット接続は不要です
• インターネットに接続できないシステムにもアプリをデプロイできます

よくあるユースケース

ユースケース 1：開発者の初回セットアップ

ユーザー：「NuGet から Syncfusion MAUI コンポーネントをインストールしたところ、トライアルライセンスの警告が表示されます。」

解決方法：

1. references/licensing-overview.md を読み、ライセンス要件を確認します
2. references/license-generation.md を読み、適切なキーを生成します
3. references/license-registration.md を読み、アプリに登録します

ユースケース 2：デプロイの問題

ユーザー：「開発環境ではアプリが正常に動作しますが、デプロイするとライセンスエラーが表示されます。」

解決方法：

1. Syncfusion.Licensing.dll がデプロイに含まれていることを確認します
2. Syncfusion アセンブリの Copy Local が True に設定されていることを確認します
3. 「Could not load」のトラブルシューティングについては、references/licensing-errors.md を読みます

ユースケース 3：トライアル版からライセンス版へのアップグレード

ユーザー：「ライセンスを購入しました。トライアル版の警告を消すにはどうすればよいですか？」

解決方法：

1. references/licensing-faq.md の「トライアル版からのアップグレード」セクションを読みます
2. 新しいライセンスキー（トライアルキーではありません）を生成します
3. RegisterLicense() の呼び出しで、トライアルキーをライセンスキーに置き換えます
4. アプリケーションをクリーンして再ビルドします

ユースケース 4：CI/CD との統合

ユーザー：「Azure DevOps パイプラインでライセンスを検証するにはどうすればよいですか？」

解決方法： CI/CD のセットアップ全体については、references/licensing-faq.md を読みます。以下が含まれます：

• Azure Pipelines（YAML と Classic）
• GitHub Actions
• Jenkins
• ValidateLicense() を使用したユニットテストの方法

重要な注意事項

• App.xaml.cs の InitializeComponent() より前、または MauiProgram.cs の ConfigureSyncfusionCore() より前に、必ずライセンスキーを登録してください
• ライセンスキーは安全に保管してください（公開リポジトリにコミットしないでください）
• プロジェクト内のすべての Syncfusion パッケージで同じライセンスキーを使用してください
• すべての Syncfusion パッケージのバージョンが同じであることを確認してください
• ライセンス検証エラーはコンパイル時ではなく、実行時に表示されます