Application (schéma de package pour Windows 8)

Article
07/20/2023

Représente une application qui comprend une partie ou la totalité des fonctionnalités fournies dans le package.

Hiérarchie d’éléments

<Applications>: <Application>

Syntaxe

<Application Id          = An ASCII string between 1 and 64 characters in length. See the Attributes table for more information on character restrictions.
             Executable? = A string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, %, ", |, ?, or *. It specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If that EntryPoint property isn't specified, the EntryPoint defined for the app is used.
             EntryPoint? = A string between 1 and 256 characters in length, representing the task  handling the extension. This is normally the fully namespace-qualified name of a Windows Runtime type.
If EntryPoint is not specified, the EntryPoint defined for the app is used instead.

             StartPage?  = A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, %, ", |, ?, or *. >

  <!-- Child elements -->
  ( VisualElements
  & ApplicationContentUriRules?
  & Extensions?
  )

</Application>

Clé

? facultatif (zéro ou un)

& connecteur entrelacé (peut se produire dans n’importe quel ordre)

Attributs et éléments

Attributs

Attribut	Description	Type de données	Obligatoire
EntryPoint	L’ID de classe activable, tel que «» Office. Winword. class ". Pour les applications de bureau, cette valeur doit être le point d’entrée réel de l’exécutable, tel que « principal », « WinMain » ou « wWinMain ». Si vous spécifiez cet attribut, vous devez également spécifier l’attribut exécutable . Si vous spécifiez cet attribut, vous ne devez pas spécifier l’attribut StartPage .	Chaîne d’une longueur comprise entre 1 et 256 caractères représentant la tâche qui gère l’extension. Il s’agit généralement du nom complet de l’espace de noms d’un type Windows Runtime. Si EntryPoint n’est pas spécifié, le point d’entrée défini pour l’application est utilisé à la place.	No
Exécutable	Exécutable de lancement par défaut pour l’application. Ce fichier doit être présent dans le package. Si vous spécifiez cet attribut, vous devez spécifier l’attribut entryPoint . Si vous spécifiez cet attribut, vous ne devez pas spécifier l’attribut StartPage .	Chaîne contenant entre 1 et 256 caractères qui doivent se terminer par « .exe » et ne peuvent pas contenir les caractères suivants : < , > , :,%, ", \|, ? ou *. Il spécifie l’exécutable par défaut pour l’extension. S’il n’est pas spécifié, l’exécutable défini pour l’application est utilisé. S’il est spécifié, la propriété EntryPoint est également utilisée. Si cette propriété EntryPoint n’est pas spécifiée, le point d’entrée défini pour l’application est utilisé.	No
Id	Identificateur unique de l’application dans le package. Elle est parfois appelée « identificateur relatif au package d’application » (ou PRAID, Package-Relative App Identifier). L’ID est unique dans le package, mais pas globalement. Il peut y avoir un autre package sur le système qui utilise le même ID. Le même ID ne peut pas être utilisé plusieurs fois dans le même package. Cette chaîne contient des champs alphanumériques séparés par des points. Chaque champ doit commencer par un caractère alphabétique ASCII. Vous ne pouvez pas les utiliser comme valeurs de champ : « CON », « PRN », « aux », « NUL », « COM1 », « COM2 », « COM3 », « COM4 », « COM5 », « COM6 », « COM7 », « COM8 », « COM9 », « LPT1 », « LPT2 », « », «LPT4 », « lpt5 », « lpt6 », « lpt7 », « LPT8 » et « LPT9 ». lors de l’utilisation d’un modèle de Visual Studio, la valeur par défaut de cet attribut est « App ». Les développeurs doivent modifier manuellement ce fichier dans le manifeste. l’identificateur de l’application ne doit pas être modifié une fois que l’application a été publiée sur le Microsoft Store ; cela perturbe la position de la vignette sur l’écran d’accueil.	Chaîne ASCII comprise entre 1 et 64 caractères.	Oui
StartPage	Page HTML de lancement par défaut pour l’application. Ce fichier doit être présent dans le package. Si vous spécifiez cet attribut, vous ne pouvez pas spécifier l’attribut entryPoint ou l’attribut executable .	Chaîne de longueur comprise entre 1 et 256 caractères qui ne peuvent pas contenir les caractères suivants : < , > , :,%, ", \|, ? ou *.	No

Éléments enfants

Élément enfant	Description
ApplicationContentUriRules	Spécifie les pages du contexte Web qui ont accès aux périphériques de géolocalisation du système (si l’application a l’autorisation d’accéder à cette fonctionnalité) et l’accès au Presse-papiers.
Extensions (type : CT_ApplicationExtensions)	Définit un ou plusieurs points d’extensibilité pour l’application.
VisualElements	Décrit les aspects visuels de l’application UWP : sa vignette par défaut, les images de logo, le texte et les couleurs d’arrière-plan, l’orientation initiale de l’écran, l’écran de démarrage et l’apparence de la vignette de l’écran de verrouillage.

Éléments parents

Élément parent	Description
Applications	Représente une ou plusieurs applications qui composent le package.

Notes

L’élément application contient des attributs qui sont communs aux points d’extensibilité qui se rapportent à l’application. Ces informations sont utilisées par d’autres points d’extensibilité pour obtenir des informations sur l’application. En outre, les attributs d' application sont utilisés lors du démarrage et de la gestion d’une instance de l’application.

si l’attribut StartPage est spécifié, il s’agit d’une application Windows à l’aide de JavaScript. si StartPage n’est pas spécifié, les attributs executable et EntryPoint doivent être spécifiés, et il s’agit d’une application UWP utilisant C# ou VB et XAML.

Exemples

L’exemple suivant est extrait du manifeste de package de l’un des exemples du kit de développement logiciel (SDK).

                    
<Applications>
  <Application Id="App" StartPage="default.html">

    <VisualElements DisplayName="Assocation launching sample" 
         Logo="images\squareTile-sdk.png" SmallLogo="images\smallTile-sdk.png" 
         Description="SDK sample" 
         ForegroundText="dark" BackgroundColor="#FFFFFF" ToastCapable="false">
      <DefaultTile ShowName="allLogos" />
      <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png" />
    </VisualElements>

    <Extensions>
      <Extension Category="windows.fileTypeAssociation">
        <FileTypeAssociation Name=".alsdkjs">
          <SupportedFileTypes>
            <FileType>.alsdkjs</FileType>
          </SupportedFileTypes>
        </FileTypeAssociation>
      </Extension>

      <Extension Category="windows.protocol">
        <Protocol Name="alsdkjs" />
      </Extension>
    </Extensions>
  </Application>
</Applications>

Spécifications

	Valeur
Espace de noms	`http://schemas.microsoft.com/appx/2010/manifest`