Liste des propriétés d’informations

Un fichier de liste de propriétés d’informations est un fichier XML encodé à l’aide de l’UTF-8 Unicode qui contient des informations de configuration pour votre application d’interface utilisateur d’application multiplateforme .NET (.NET MAUI) sur iOS et Mac Catalyst. Le nœud racine du fichier est un dictionnaire, qui contient un ensemble de clés et de valeurs qui définissent votre configuration d’application. Le nom du fichier de liste de propriétés d’informations est Info.plist et respecte la casse. Toutes les applications .NET MAUI iOS et Mac Catalyst doivent contenir un fichier Info.plist qui décrit l’application.

.NET MAUI crée des fichiers Info.plist pour iOS et Mac Catalyst lorsque vous créez une application .NET MAUI à partir d’un modèle de projet. Ces fichiers se trouvent dans les dossiers Plateformes/iOS et Plateformes/Mac Catalyst , et sont renseignés avec une liste initiale de clés de liste de propriétés.

Lorsque vous générez votre application, .NET MAUI copie votre fichier Info.plist dans le bundle compilé, avant de signer le bundle. Pendant l’opération de copie, .NET MAUI utilise des propriétés de build pour effectuer une substitution de variable. Il peut également insérer des clés supplémentaires représentant la configuration spécifiée de différentes façons. En raison de cela, le fichier de liste des propriétés d’informations fourni dans votre ensemble d’applications n’est pas identique au fichier source de votre projet.

Modifier la liste des propriétés d’informations dans l’éditeur

Le double-clic d’un fichier Info.plist l’ouvre dans l’éditeur Info.plist de Visual Studio.

L’éditeur Info.plist de Visual Studio contient deux vues des données :

  • Application, qui vous permet de définir les propriétés courantes de l’application :

    Screenshot of application tab in Visual Studio Info.plist editor.

    Remarque

    Les valeurs des champs Nom de l’application, Identificateur de bundle, Version et Build sont récupérées à partir du fichier projet de votre application. Pour plus d’informations, consultez Fournir des informations sur l’application.

  • Avancé, qui vous permet de spécifier les types de documents pris en charge, les identificateurs de type universels (UTIs) et les types d’URL :

    Screenshot of advanced tab in Visual Studio Info.plist editor.

Modifier la source de la liste des propriétés d’informations

Le fichier Info.plist peut également être ouvert dans un éditeur externe pour modifier sa source XML. Les clés et les valeurs permettant de configurer l’application peuvent être ajoutées pour les catégories suivantes :

  • Configuration du bundle pour configurer les caractéristiques de base d’un bundle, telles que son nom, son type et sa version. Pour plus d’informations, consultez La configuration de bundle sur developer.apple.com.
  • Interface utilisateur pour configurer les scènes, les icônes et les polices d’une application. Pour plus d’informations, consultez l’interface utilisateur sur developer.apple.com.
  • Exécution de l’application, pour configurer le lancement, l’exécution et l’arrêt de l’application. Pour plus d’informations, consultez l’exécution de l’application sur developer.apple.com.
  • Ressources protégées, pour contrôler l’accès d’une application aux services protégés et aux données utilisateur. Pour plus d’informations, consultez Ressources protégées sur developer.apple.com.
  • Données et stockage pour configurer les fonctionnalités de gestion des données de votre application. Pour plus d’informations, consultez Données et stockage sur developer.apple.com.
  • Services d’application, pour configurer les services fournis par votre application. Pour plus d’informations, consultez App Services sur developer.apple.com.
  • Noyau et pilotes, pour configurer les pilotes de périphérique fournis par votre application. Pour plus d’informations, consultez Noyau et pilotes sur developer.apple.com.

Fournir des informations sur l’application

L’éditeur Info.plist récupère les données d’application de base du fichier projet de l’application, plutôt que de la stocker directement dans le fichier Info.plist . Au moment de la génération, .NET MAUI copie ces données dans le fichier Info.plist fourni dans votre ensemble d’applications.

Nom de l’application

Le nom de l’application pour une application .NET MAUI est stocké dans le fichier projet de l’application en tant que ApplicationTitle propriété de build :

Dans Explorateur de solutions, cliquez avec le bouton droit sur votre projet d’application .NET MAUI, puis sélectionnez Propriétés. Ensuite, accédez à l’onglet Général partagé > MAUI. Le champ Titre de l’application répertorie le nom de l’application.

Lorsque la valeur du champ Titre de l’application est mise à jour, la valeur du champ Nom de l’application dans l’affichage application dans le fichier Info.plist est automatiquement mise à jour.

ID de l'application

L’identificateur de bundle d’une application .NET MAUI est stocké dans le fichier projet de l’application en tant que ApplicationId propriété de build :

Dans Explorateur de solutions, cliquez avec le bouton droit sur votre projet d’application .NET MAUI, puis sélectionnez Propriétés. Ensuite, accédez à l’onglet Général partagé > MAUI. Le champ ID d’application répertorie l’identificateur de bundle.

Lorsque la valeur du champ ID d’application est mise à jour, la valeur du champ Identificateur de bundle dans l’affichage de l’application dans le fichier Info.plist est automatiquement mise à jour.

Version d’affichage de l’application

La version d’affichage de l’application pour une application .NET MAUI est stockée dans le fichier projet de l’application en tant que ApplicationDisplayVersion propriété de build :

Dans Explorateur de solutions, cliquez avec le bouton droit sur votre projet d’application .NET MAUI, puis sélectionnez Propriétés. Ensuite, accédez à l’onglet Général partagé > MAUI. Le champ Version d’affichage de l’application répertorie la version d’affichage de l’application.

Lorsque la valeur du champ Version d’affichage de l’application est mise à jour, la valeur du champ Version dans l’affichage de l’application dans le fichier Info.plist est automatiquement mise à jour.

Version de l’application

La version de l’application d’une application .NET MAUI est stockée dans le fichier projet de l’application en tant que ApplicationVersion propriété de build :

Dans Explorateur de solutions, cliquez avec le bouton droit sur votre projet d’application .NET MAUI, puis sélectionnez Propriétés. Ensuite, accédez à l’onglet Général partagé > MAUI. Le champ Version de l’application répertorie la version de l’application.

Lorsque la valeur du champ Version de l’application est mise à jour, la valeur du champ Build dans l’affichage de l’application dans le fichier Info.plist est automatiquement mise à jour.

Voir aussi