Manifiestos de características de la aplicación

Artículo
06/19/2023

Los manifiestos de características de la aplicación definen la ubicación de las aplicaciones que desea incluir en una imagen. Al igual que otros manifiestos de características, los manifiestos de características de la aplicación deben incluirse en el <AdditionalFMs> elemento del archivo OEMInput.xml de la imagen para que las aplicaciones definidas en la aplicación fm se incluyan en una imagen.

Para la primera imagen, puede agregar todas las aplicaciones de la carpeta apps del área de trabajo a la vez a la imagen mediante CreateWSKAppsFM y UpdateWSKAppsFM.

Manifiesto de OEMAppsFM.xml de ejemplo

<?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>

Aplicaciones opcionales

Los scripts del kit de sistema de Windows configuran todas las aplicaciones de una aplicación FM para que se incluyan en una imagen. Puedes modificar una aplicación FM para que determinadas aplicaciones tengan que agregarse específicamente a una OEMInput.xml que se incluirán en una imagen.

Cada aplicación incluida en una aplicación FM tiene un Optional atributo que controla si la aplicación se incluirá automáticamente en una imagen, o si la aplicación debe incluirse manualmente en una imagen agregando su ID a la OEMInput.xml.

Si usa un único conjunto de garantías para varias imágenes, marcar las aplicaciones como opcionales le permite incluirlas en configuraciones de imagen específicas. Una aplicación FM en este escenario puede incluir todas las aplicaciones del conjunto de material adjunto, al mismo tiempo que especifica lo siguiente:

Conjunto base de aplicaciones que se van a incluir en todas las imágenes
Un conjunto de aplicaciones opcionales que se pueden agregar manualmente a archivos de OEMInput.xml específicos

Las aplicaciones marcadas como opcionales no se incluirán en ninguna imagen a menos que las incluyas específicamente en un diseño de imagen. Esto le permite reutilizar el manifiesto de características de la aplicación para varias imágenes.

Trabajar con aplicaciones opcionales

Para especificar una aplicación como opcional y agregarla manualmente a una imagen:

Elija una aplicación para marcar como opcional.

En la aplicación FM, cambie el atributo de la Optional aplicación a "true". Esto marca la aplicación como opcional y la aplicación ya no se incluirá en todas las imágenes.

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

Anote el identificador de aplicación, por ejemplo, ID="Contoso.Sampleapp_8wekyb3d8bbwe". No cambie este identificador o la imagen no se compilará.

Si adquiriste la aplicación de Microsoft Store, puedes encontrar el nombre de familia del paquete en la licencia de la aplicación. Abra el archivo de licencia mediante un editor de texto y use el valor entre las etiquetas PFM.
Agregue la aplicación opcional a una imagen agregando el identificador como un <AppXID> valor en el OEMInput.xml:
```
<AppXOptionalPackages> 
  <AppXID>Contoso.Sampleapp_8wekyb3d8bbwe</AppXID>
</AppXOptionalPackages> 
```

También puede especificar una aplicación como específica de la arquitectura agregando CPUType="(arch)." Al compilar la imagen, se excluyen los archivos que no coinciden con el tipo de arquitectura.

Sintaxis de la línea de comandos SetAppsRegion

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

Parámetro	Descripción
-Appname	Nombre de nombre de archivo de la aplicación. Use el `Name` atributo en el `<PackageFile>` elemento para la aplicación.
-Región	Región o regiones en las que quiere que la aplicación esté disponible. Si especifica varias regiones, separe las regiones con :`,-Region en-us,de-de`
-OEMAppsFMPath	Ruta de acceso a la aplicación FM. Valor predeterminado: `%WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml`

Consulte también

Manifiestos de características de controlador

Compartir a través de