Obtenir les informations de licence des applications et des modules complémentaires

  • Article

Cet article explique comment utiliser les méthodes de la classe StoreContext dans l’espace de noms Windows.Services.Store pour obtenir des informations de licence pour l’application actuelle et ses modules complémentaires. Par exemple, vous pouvez utiliser ces informations pour déterminer si les licences de l’application ou de ses modules complémentaires sont actives ou s’il s’agit de licences d’évaluation.

Notes

L’espace de noms Windows.Services.Store a été introduit dans Windows 10, version 1607, et il ne peut être utilisé que dans les projets qui ciblent Windows 10 Édition anniversaire (10.0 ; Build 14393) ou une version ultérieure dans Visual Studio. Si votre application cible une version antérieure de Windows 10, vous devez utiliser l’espace de noms Windows.ApplicationModel.Store à la place de l’espace de noms Windows.Services.Store. Pour plus d’informations, consultez cet article.

Prérequis

La configuration requise pour cet exemple est la suivante :

  • Un projet Visual Studio pour une application plateforme Windows universelle (UWP) qui cible Windows 10 édition anniversaire (10.0 ; Build 14393) ou une version ultérieure.
  • Vous avez créé une soumission d’application dans l’Espace partenaires et cette application est publiée dans le Windows Store. Vous pouvez éventuellement configurer l’application afin qu’elle ne soit pas détectable dans le Store pendant que vous la testez. Pour plus d’informations, consultez nos conseils de test.
  • Si vous souhaitez obtenir des informations de licence pour un module complémentaire pour l’application, vous devez également créer le module complémentaire dans l’Espace partenaires.

Le code de cet exemple se base sur les hypothèses suivantes :

  • Le code s’exécute dans le contexte d’une Page qui contient un ProgressRing nommé workingProgressRing et un TextBlock nommé textBlock. Ces objets sont utilisés pour respectivement indiquer qu’une opération asynchrone est en cours et afficher les messages de sortie.
  • Le fichier de code contient une instruction using pour l’espace de noms Windows.Services.Store.
  • Cette application mono-utilisateur ne s’exécute que dans le contexte de l’utilisateur qui l’a lancée. Pour plus d’informations, consultez Versions d’évaluation et achats in-app.

Notes

Si vous disposez d’une application de bureau qui utilise le Pont du bureau, vous devrez peut-être ajouter du code supplémentaire non illustré dans cet exemple pour configurer l’objet StoreContext. Pour plus d’informations, voir Utilisation de la classe StoreContext dans une application de bureau qui utilise Desktop Bridge.

Exemple de code

Pour récupérer les informations de licence pour l’application actuelle, utilisez la méthode GetAppLicenseAsync. Il s’agit d’une méthode asynchrone qui retourne un objet StoreAppLicense qui fournit des informations de licence pour l’application, y compris des propriétés qui indiquent si l’utilisateur dispose actuellement d’une licence valide pour utiliser l’application (IsActive) et si la licence est pour une version d’évaluation (IsTrial).

Pour accéder aux licences des modules complémentaires durables de l’application actuelle pour lesquelles l’utilisateur a le droit d’utiliser, utilisez la propriété AddOnLicenses de l’objet StoreAppLicense . Cette propriété retourne une collection d’objets StoreLicense qui représentent les licences du module complémentaire.

private StoreContext context = null;

public async void GetLicenseInfo()
{
    if (context == null)
    {
        context = StoreContext.GetDefault();
        // If your app is a desktop app that uses the Desktop Bridge, you
        // may need additional code to configure the StoreContext object.
        // For more info, see https://aka.ms/storecontext-for-desktop.
    }

    workingProgressRing.IsActive = true;
    StoreAppLicense appLicense = await context.GetAppLicenseAsync();
    workingProgressRing.IsActive = false;

    if (appLicense == null)
    {
        textBlock.Text = "An error occurred while retrieving the license.";
        return;
    }

    // Use members of the appLicense object to access license info...

    // Access the valid licenses for durable add-ons for this app.
    foreach (KeyValuePair<string, StoreLicense> item in appLicense.AddOnLicenses)
    {
        StoreLicense addOnLicense = item.Value;
        // Use members of the addOnLicense object to access license info
        // for the add-on.
    }
}

Pour obtenir un exemple d’application complète, consultez Exemple Windows Store.