Applications du Windows Store sur Windows 8.1 : Contenu du manifeste de package
Lorsque vous créez un projet d'application, Visual Studio génère un manifeste de package, qui contient les informations requises pour inscrire l'application auprès du Store. Cette rubrique décrit le contenu du package.
Notes
Si ces sections ne mentionnent pas le champ que vous recherchez, il est généré à partir des données que vous avez configurées séparément ou d'une valeur par défaut dans le schéma manifeste.
Identité
La section Identity
du manifeste d'application contient les champs suivants.
Champ | Description |
---|---|
Name |
Le nom du package, qui est renseigné différemment dans les scénarios suivants : -Par défaut, la valeur de ce champ est un GUID généré. -Si vous associez l’application le Store ou appelez le créer un Package d’application commande, puis connectez-vous avec un compte de développeur, la valeur de ce champ est extraite de l’application associée dans le Store. -Si vous appelez le créer un Package d’application commande mais ne vous connectez pas un compte de développeur Microsoft, la valeur de ce champ est obtenue à partir du manifeste source. |
ProcessorArchitecture |
Valeur générée selon la configuration de build que vous avez spécifiée pour le projet. Le tableau suivant résume le mappage entre les valeurs de plateforme dans le gestionnaire de configurations et la valeur insérée dans le manifeste d'application : x86 ou Win32 : x86 x64 : x64 N’importe quelle UC : neutre ARM : ARM Si les références de projet ou les références de fichier dans le projet ciblent une architecture spécifique différente (autrement dit, pas un composant Neutre) de celle du package d'application, une erreur de build est levée, et vous devez modifier l'architecture cible du package d'application afin qu'il convienne à toutes les références. |
Publisher |
Nom de l'éditeur. Ce nom est renseigné différemment dans les scénarios suivants : -Par défaut, la valeur de ce champ est votre nom d’utilisateur. -Si vous associez l’application le Store ou appelez le créer un Package d’application commande, puis connectez-vous avec votre compte de développeur, la valeur de ce champ est la chaîne Publisher associé à ce compte. -Si vous appelez le créer un Package d’application commande mais ne vous connectez pas avec un compte de développeur, la valeur de ce champ correspond au champ de sujet du certificat de test avec lequel vous êtes le package d’application. Pour plus d’informations, consultez gérer les certificats que Visual Studio utilise pour signer votre application Remarque : Visual Studio prend en charge uniquement la forme de nom (CN) commun pour le serveur de publication et ajoute le préfixe CN = au nom dans le manifeste. |
Voici un exemple de sortie XML :
<Identity
Name="Microsoft.CoolWindowsStoreApp"
ProcessorArchitecture="x86"
Publisher="CN=Microsoft Corporation"
/>
Propriétés
La section Propriétés du manifeste d'application contient les champs dans le tableau suivant.
Champ | Description |
---|---|
PublisherDisplayName |
Cette chaîne est renseignée différemment dans les scénarios suivants : -Par défaut, la valeur de ce champ est votre nom d’utilisateur. -Si vous associez l’application le Store ou appelez le créer un Package d’application commande et connectez-vous avec un compte de développeur, la valeur de ce champ correspond à la chaîne PublisherDisplayName associée à votre compte de développeur. -Si vous appelez le créer un Package d’application commande mais ne vous connectez pas avec un compte de développeur, la valeur de ce champ est votre nom d’utilisateur, sauf indication contraire. |
DisplayName |
Cette chaîne est renseignée différemment dans les scénarios suivants : -Par défaut, la valeur de ce champ est le nom du projet. -Si vous associez l’application le Store ou appelez le créer un Package d’application commande et connectez-vous avec un compte de développeur, la valeur de ce champ est renseignée selon les règles suivantes : -Si vous spécifiez cette valeur dans le manifeste source et la valeur commence par (ce qui indique que vous souhaitez localiser cette valeur), la valeur de ce champ correspondra à ce que vous avez spécifié. -Si l’application sélectionnée n’a qu’un seul nom, la valeur sera de ce nom. -Si l’application sélectionnée a plusieurs noms, mais le manifeste source n’est pas localisé : -Dans le cas contraire, la valeur est définie pour le premier nom réservé. -Si vous appelez le créer un Package d’application commande mais ne vous connectez pas avec un compte de développeur, la valeur de ce champ est obtenue à partir du manifeste source. |
Application
Un manifeste d’application peut contenir plusieurs < application> éléments, chacun d’eux possède un nom d’affichage qui s’affiche sur la vignette dans le client. La section Application du manifeste d'application contient les champs dans le tableau suivant.
Champ | Description |
DisplayName |
Cette chaîne est renseignée différemment dans les scénarios suivants : -Par défaut, la valeur de ce champ est le nom du projet. -Si vous associez l’application le Store ou appelez le créer un Package d’application commande et connectez-vous avec un compte de développeur, la valeur de ce champ est le nom de l’application de l’application sélectionnée si le /Properties [@DisplayName] et/Applications/Application [@DisplayName] dans la correspondance de manifeste source. Sinon, la valeur reste la même que dans le manifeste source. -Si vous appelez le créer un Package d’application commande mais ne vous connectez pas avec un compte de développeur, la valeur de ce champ est la même que dans le manifeste source. |
Executable |
La valeur de ce champ est le nom de sortie de l'assembly du projet. Le jeton exécutable $targetnametoken$.exe utilisé dans le fichier manifeste source (package.appxmanifest) est remplacé par le nom de fichier réel lorsque le manifeste est généré. |
PackageDependencies
La section PackageDependencies
contient toutes les dépendances de la bibliothèque de composants Windows pour ce package. Par exemple, si votre projet a une référence à WinJS, Visual Studio extrait les informations d'identité de package des dépendances lorsque le manifeste est généré. Visual Studio remplit ensuite cette section avec les champs Nom et MinVersion pour chaque package dépendant.
Extensions d'inscription Windows RunTime
Vous pouvez implémenter les composants Windows RunTime pour vos applications, mais vous devez inscrire ces composants auprès du système d'exploitation pour qu'ils s'exécutent correctement. Pour inscrire un composant Windows RunTime, vous devez placer les informations d'inscription dans les fichiers WinMD et dans le manifeste d'application. Si un projet implémente un composant Windows RunTime, la sortie de la génération du projet contient un fichier WinMD. Visual Studio extrait les informations d'inscription Windows RunTime du fichier WinMD et génère les éléments Extensions appropriés dans le manifeste d'application.
Le système prend en charge deux formes de serveurs : les serveurs .dll (in-process) et les serveurs .exe (out-of-process). Ces serveurs nécessitent des informations d'inscription semblables, mais différentes, qui doivent être copiées dans le manifeste d'application. Visual Studio prend en charge la génération de manifeste uniquement pour les serveurs .dll, et l'extension DLLServer est nécessaire pour inscrire les serveurs .dll. Les valeurs suivantes dans le manifeste d'application sont extraites des fichiers WinMD pour générer l'extension DLLServer :
DllPath
ActivatableClassId
ThreadingModel
ActivatableClass (attribut ActivatableClassId)
Voici un exemple de sortie XML :
<extension category=”Microsoft.Windows.ActivatableClass”>
<dllServer>
<dllPath>Fabrikam.dll</dllPath>
<activatableClass activatableClassId="Fabrikam.MyClass" threadingModel="sta" />
</dllServer>
</extension>
Ressources
La section Resources
contient une entrée pour chaque langue prise en charge par l'application. Au moins une langue de ressource doit être spécifiée dans le manifeste d'application. Visual Studio génère automatiquement la liste des langues prises en charge en fonction des informations de localisation dans le projet. Le jeton de langue pour les ressources « x-generate » utilisé dans le fichier manifeste source (package.appxmanifest) est remplacé par le code de langue réel lorsque le manifeste est généré. Voici un exemple de sortie XML :
<Resources>
<Resource Language=”en-us”>
<Resource Language=”fr-fr”>
</Resources>
La première entrée de la liste est la langue par défaut de l'application.
Composants requis
La section Composants requis contient les champs suivants :
OSMinVersion
OSMaxVersionTested
Les deux éléments sont remplis à partir des propriétés MSBuild (AppxOSMinVersion et AppxOSMaxVersionTested, respectivement). La valeur par défaut pour les deux éléments est 6.3.0.