Manifestes des fonctionnalités d’application

Article
06/19/2023

Les manifestes de fonctionnalités d’application définissent l’emplacement des applications que vous souhaitez inclure dans une image. Comme d’autres manifestes de fonctionnalités, les manifestes de fonctionnalités d’application doivent être inclus dans l’élément dans le <AdditionalFMs> fichier OEMInput.xml de votre image pour que les applications définies dans l’application fm soient incluses dans une image.

Pour votre première image, vous pouvez ajouter toutes les applications du dossier des applications de votre espace de travail à la fois à votre image à l’aideCreateWSKAppsFM de et UpdateWSKAppsFM.

Exemple de manifeste OEMAppsFM.xml

<?xml version="1.0" encoding="utf-8"?>
<FeatureManifest 
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
  xmlns="http://schemas.microsoft.com/embedded/2004/10/ImageUpdate" Revision="1" SchemaVersion="1.2">
  <AppX>
    <AppXPackages>
      <PackageFile Path="%WSKWorkspaceRoot%\Apps\Calculator" Name="Microsoft.WindowsCalculator_8wekyb3d8bbwe.appxbundle" LicenseFile="Microsoft.WindowsCalculator_8wekyb3d8bbwe.xml" ID="Microsoft.WindowsCalculator_8wekyb3d8bbwe" Optional="false" />
      <PackageFile Path="%WSKWorkspaceRoot%\Apps\Frameworks" CPUType="x86" Name="Microsoft.VCLibs.x86.14.00.appx" ID="Microsoft.VCLibs.140.00_8wekyb3d8bbwe" Optional="false" />
      <PackageFile Path="%WSKWorkspaceRoot%\Apps\Frameworks" CPUType="amd64" Name="Microsoft.VCLibs.x64.14.00.appx" ID="Microsoft.VCLibs.140.00_8wekyb3d8bbwe" Optional="false" />
      <PackageFile Path="%WSKWorkspaceRoot%\Apps\Frameworks" CPUType="arm" Name="Microsoft.VCLibs.arm.14.00.appx" ID="Microsoft.VCLibs.140.00_8wekyb3d8bbwe" Optional="false" />
      <PackageFile Path="%WSKWorkspaceRoot%\Apps\ContosoApp" Name="Contoso.Sampleapp_8wekyb3d8bbwe.appxbundle" LicenseFile="Contoso.Sampleapp_8wekyb3d8bbwe.xml" ID="Contoso.Sampleapp_8wekyb3d8bbwe" Optional="false" />
    </AppXPackages>
  </AppX>
</FeatureManifest>

Applications facultatives

Les scripts du kit système Windows configurent chaque application d’une application FM afin qu’elles soient incluses dans une image. Vous pouvez modifier une application FM afin que certaines applications doivent être ajoutées spécifiquement à un OEMInput.xml à inclure dans une image.

Chaque application incluse dans une application FM a un Optional attribut qui contrôle si l’application sera incluse automatiquement dans une image ou si l’application doit être incluse manuellement dans une image en ajoutant son ID à la OEMInput.xml.

Si vous utilisez un seul ensemble de garanties pour plusieurs images, le fait de marquer les applications comme facultatives vous permet d’inclure les applications dans des configurations d’images spécifiques. Dans ce scénario, un fm d’application peut inclure toutes les applications dans votre ensemble de garanties, tout en spécifiant :

Ensemble d’applications de base à inclure dans toutes les images
Ensemble d’applications facultatives que vous pouvez ajouter manuellement à des fichiers OEMInput.xml spécifiques

Les applications marquées comme facultatives ne seront incluses dans aucune image, sauf si vous les incluez spécifiquement dans une conception d’image. Cela vous permet de réutiliser votre manifeste de fonctionnalité d’application pour plusieurs images.

Utiliser des applications facultatives

Pour spécifier une application comme facultative et l’ajouter manuellement à une image :

Choisissez une application à marquer comme facultative.

Dans votre application FM, remplacez l’attribut de l’application Optional par "true". Cela marque l’application comme facultative et l’application ne sera plus incluse dans toutes les images.

<PackageFile Path="%WSKWorkspaceRoot%\Apps\ContosoApp" Name="Contoso.Sampleapp_8wekyb3d8bbwe.appxbundle" LicenseFile="Contoso.Sampleapp_8wekyb3d8bbwe.xml" ID="Contoso.Sampleapp_8wekyb3d8bbwe" Optional="true" />

Notez l’ID d’application, par exemple . ID="Contoso.Sampleapp_8wekyb3d8bbwe" Ne modifiez pas cet ID, sinon la génération de l’image échoue.

Si vous avez acquis l’application à partir du Microsoft Store, vous trouverez le nom de la famille de package dans la licence de l’application. Ouvrez le fichier de licence à l’aide d’un éditeur de texte et utilisez la valeur entre les balises PFM.
Ajoutez l’application facultative à une image en ajoutant l’ID en tant que <AppXID> valeur dans votre OEMInput.xml:
```
<AppXOptionalPackages> 
  <AppXID>Contoso.Sampleapp_8wekyb3d8bbwe</AppXID>
</AppXOptionalPackages> 
```

Vous pouvez également spécifier une application comme spécifique à l’architecture en ajoutant CPUType="(arch)." Lorsque vous générez votre image, les fichiers qui ne correspondent pas au type d’architecture sont exclus.

Syntaxe de ligne de commande SetAppsRegion

SetAppsRegion -AppName <AppName> -Region <Region> [-OEMAppsFMPath <path>]
SetAppsRegion -AppName HelloWorld_1.0.0.0_x64.appx -Region en-us,de-de

Paramètre	Description
-Appname	Nom de fichier de l’application. Utilisez l’attribut `Name` dans l’élément `<PackageFile>` pour l’application.
-Région	Région ou régions dans lesquelles vous souhaitez que l’application soit disponible. Si vous spécifiez plusieurs régions, séparez les régions par un `,`: `-Region en-us,de-de`
-OEMAppsFMPath	Chemin d’accès à l’application FM. La valeur par défaut est `%WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml`

Voir aussi

Manifestes des fonctionnalités de pilote

Partager via