Impliquer les clients avec Microsoft Store Services SDK

Le Kit de développement logiciel (SDK) microsoft Store Services fournit des fonctionnalités qui vous aident à communiquer avec les clients dans vos applications de plateforme Windows universelle (UWP), telles que l’envoi de notifications ciblées à vos applications et l’exécution d’expériences A/B dans vos applications. Ce Kit de développement logiciel (SDK) est une extension pour Visual Studio 2015 et versions ultérieures de Visual Studio.

Scénarios pris en charge par le Kit de développement logiciel (SDK) microsoft Store Services

Le Kit de développement logiciel (SDK) microsoft Store Services prend actuellement en charge les scénarios suivants pour les applications UWP. Pour consulter la documentation de référence de l’API, voir les informations de référence de l’API du Kit de développement logiciel (SDK) Microsoft Store Services.

Conditions préalables

Le Kit de développement logiciel (SDK) microsoft Store Services nécessite les éléments suivants :

• Visual Studio 2015 ou une version ultérieure.
• Visual Studio Tools pour les applications Windows universelles installées avec votre version de Visual Studio.

Installer le SDK

Il existe deux options pour installer le Kit de développement logiciel (SDK) microsoft Store Services sur votre ordinateur de développement :

• Programme d’installation MSI Vous pouvez installer le Kit de développement logiciel (SDK) via le programme d’installation MSI disponible ici.
• Package NuGet Vous pouvez installer le Kit de développement logiciel (SDK) en tant que package NuGet.

Microsoft publie régulièrement de nouvelles versions du Kit de développement logiciel (SDK) microsoft Store Services avec des améliorations des performances et de nouvelles fonctionnalités. Si vous avez des projets existants qui utilisent le Kit de développement logiciel (SDK) et que vous souhaitez utiliser la dernière version, téléchargez et installez la dernière version du Kit de développement logiciel (SDK) sur votre ordinateur de développement.

Installer via MSI

Pour installer le Kit de développement logiciel (SDK) microsoft Store Services via le programme d’installation MSI :

1. Fermez toutes les instances de Visual Studio.

2. Si vous avez précédemment installé le Kit de développement logiciel (SDK) Microsoft Store Engagement et Monétisation, le Kit de développement logiciel (SDK) universal ad client ou l’extension Ad Mediator, désinstallez maintenant ces KITS SDK. Si vous le souhaitez, ouvrez l'Invite de commandes et exécutez ces commandes pour supprimer les anciennes versions du SDK qui pourraient avoir été installées avec Visual Studio, mais qui pourraient ne pas apparaître dans la liste des programmes installés sur votre ordinateur :

   MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
   MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
   MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}
   

3. Téléchargez et installez le Kit de développement logiciel (SDK) microsoft Store Services. L’installation peut prendre quelques minutes. Veillez à attendre jusqu'à ce que le processus soit terminé.

4. Redémarrez Visual Studio.

5. Si vous disposez d’un projet existant qui fait référence à des bibliothèques à partir de n’importe quelle version antérieure du Kit de développement logiciel (SDK) microsoft Store Services, du Kit de développement logiciel (SDK) Microsoft Advertising, du Kit de développement logiciel (SDK) Du client ad universel ou du Kit de développement logiciel (SDK) Microsoft Store Engagement et monétisation, nous vous recommandons d’ouvrir votre projet dans Visual Studio et de nettoyer et de reconstruire votre projet (dans l’Explorateur de solutions, cliquez avec le bouton droit sur votre nœud de projet, puis choisissez Nettoyer, puis cliquez avec le bouton droit sur votre nœud de projet, puis choisissez Reconstruire).

Par ailleurs, si vous utilisez le Kit de développement logiciel (SDK) pour la première fois dans votre projet, vous êtes maintenant prêt à ajouter la référence d'assemblage à votre projet.

Installer via NuGet

Pour installer les bibliothèques du Kit de développement logiciel (SDK) microsoft Store Services via NuGet :

1. Fermez toutes les instances de Visual Studio.

2. Si vous avez précédemment installé le Kit de développement logiciel (SDK) Microsoft Store Engagement et Monétisation, le Kit de développement logiciel (SDK) universal ad client ou l’extension Ad Mediator, désinstallez maintenant ces KITS SDK. Si vous le souhaitez, ouvrez l'Invite de commandes et exécutez ces commandes pour supprimer les anciennes versions du SDK qui pourraient avoir été installées avec Visual Studio, mais qui pourraient ne pas apparaître dans la liste des programmes installés sur votre ordinateur :

   MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
   MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
   MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}
   

3. Démarrez Visual Studio et ouvrez le projet dans lequel vous souhaitez utiliser le Kit de développement logiciel (SDK) microsoft Store Services.

   Remarque

   Si votre projet inclut déjà des références de bibliothèque à partir d’une installation MSI antérieure du Kit de développement logiciel (SDK), supprimez ces références de votre projet. Ces références auront des icônes d’avertissement en regard d’elles, car les bibliothèques qu’ils référencent ont été supprimées dans les étapes précédentes.

4. Dans Visual Studio, cliquez sur Projet et Gérer les paquets NuGet.

5. Dans la zone de recherche, tapez Microsoft.Services.Store.Engagement et installez le package Microsoft.Services.Store.Engagement. Une fois le package installé, enregistrez votre solution.

   Remarque

   Si la fenêtre Sortie signale une erreur Install-Package indiquant que le chemin spécifié est trop long, vous devrez peut-être configurer NuGet pour extraire des packages à un autre emplacement avec un chemin plus court que l’emplacement par défaut. Pour ce faire, ajoutez la valeur repositoryPath à un fichier nuget.config sur votre ordinateur et affectez-le à un chemin d’accès de dossier court où les packages NuGet peuvent être extraits. Pour plus d’informations, consultez cet article dans la documentation NuGet. Vous pouvez également essayer de déplacer votre projet Visual Studio vers un autre dossier avec un chemin plus court. Le problème peut également être dû au fait que votre chemin d’accès aux packages globaux est trop long. Dans ce cas, ajoutez la globalPackagesFolder valeur dans votre fichier nuget.config.

6. Fermez la solution Visual Studio qui contient votre projet, puis rouvrez la solution.

7. Si votre projet référence déjà des bibliothèques à partir d’une version antérieure du Kit de développement logiciel (SDK) microsoft Store Services installé via NuGet et que vous avez mis à jour votre projet vers une version plus récente du SDK, nous vous recommandons de nettoyer et de reconstruire votre projet (dans l’Explorateur de solutions, de cliquer avec le bouton droit sur votre nœud de projet, puis de cliquer avec le bouton droit sur votre nœud de projet et de régénérer).

Par ailleurs, si vous utilisez le Kit de développement logiciel (SDK) pour la première fois dans votre projet, vous êtes maintenant prêt à ajouter la référence d'assemblage à votre projet.

Ajoutez la référence d'assemblage à votre projet

Après avoir installé le Kit de développement logiciel (SDK) microsoft Store Services via le programme d’installation MSI ou NuGet, suivez ces instructions pour référencer l’assembly sdk dans votre projet UWP.

1. Ouvrez votre projet dans Visual Studio.

   Remarque

   Si votre projet est une application JavaScript qui cible n'importe quel processeur, mettez à jour votre projet pour utiliser une sortie de build spécifique à l'architecture (par exemple, x86).

2. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur Références, puis sélectionnez Ajouter une référence…

3. Dans Gestionnaire de références, développez Windows universel, cliquez sur Extensions, puis cochez la case située à côté de Microsoft Engagement Framework. Cela vous permet d’utiliser les API dans l’espace de noms Microsoft.Services.Store.Engagement .

4. Cliquez sur OK.

Présentation des packages d’infrastructure dans le Kit de développement logiciel (SDK)

La bibliothèque Microsoft.Services.Store.Engagement.dll dans le Kit de développement logiciel (SDK) microsoft Store Services est configurée en tant que package d’infrastructure. Cette bibliothèque contient les API de l’espace de noms Microsoft.Services.Store.Engagement .

Étant donné que cette bibliothèque est un package d’infrastructure, cela signifie qu’une fois qu’un utilisateur installe une version de votre application qui utilise cette bibliothèque, cette bibliothèque est automatiquement mise à jour sur son appareil via Windows Update chaque fois que nous publions une nouvelle version de la bibliothèque avec des correctifs et des améliorations des performances. Cela permet de s’assurer que vos clients disposent toujours de la dernière version disponible de la bibliothèque installée sur leurs appareils.

Si nous publions une nouvelle version du Kit de développement logiciel (SDK) qui introduit de nouvelles API ou fonctionnalités dans cette bibliothèque, vous devez installer la dernière version du Kit de développement logiciel (SDK) pour utiliser ces fonctionnalités. Dans ce scénario, vous devez également publier votre application mise à jour dans le Windows Store.

Rubriques connexes

• Informations de référence sur l'API du SDK Microsoft Store Services
• Mener des expériences de test A/B
• Lancer le Hub de commentaires à partir de votre application
• Configurer votre application pour recevoir des notifications Push de l’Espace partenaires
• Journaliser des événements personnalisés pour l’Espace partenaires