Manifestos do recurso de aplicativo

Artigo
06/19/2023

Os manifestos do recurso de aplicativo definem o local dos aplicativos que você deseja incluir em uma imagem. Assim como outros manifestos de recursos, os manifestos do recurso de aplicativo precisam ser incluídos no <AdditionalFMs> elemento no arquivo OEMInput.xml da imagem para que os aplicativos definidos no aplicativo fm sejam incluídos em uma imagem.

Para sua primeira imagem, você pode adicionar todos os aplicativos na pasta de aplicativos do workspace de uma vez à sua imagem usando CreateWSKAppsFM e UpdateWSKAppsFM.

Exemplo de manifesto de 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>

Aplicativos opcionais

Os scripts no kit do sistema Windows configuram todos os aplicativos em um aplicativo FM para que eles sejam incluídos em uma imagem. Você pode modificar um fm de aplicativo para que determinados aplicativos precisem ser adicionados especificamente a um OEMInput.xml para serem incluídos em uma imagem.

Cada aplicativo incluído em um aplicativo FM tem um Optional atributo que controla se o aplicativo será incluído automaticamente em uma imagem ou se o aplicativo precisa ser incluído manualmente em uma imagem adicionando-o ID ao OEMInput.xml.

Se você estiver usando um único conjunto de garantias para várias imagens, marcar aplicativos como opcionais permitirá que você inclua os aplicativos em configurações de imagem específicas. Um aplicativo FM nesse cenário pode incluir todos os aplicativos em seu conjunto de garantias, ao mesmo tempo em que especifica:

O conjunto base de aplicativos a serem incluídos em todas as imagens
Um conjunto de aplicativos opcionais que você pode adicionar manualmente a arquivos OEMInput.xml específicos

Os aplicativos marcados como opcionais não serão incluídos em nenhuma imagem, a menos que você os inclua especificamente em um design de imagem. Isso permite reutilizar o manifesto do recurso do aplicativo para várias imagens.

Trabalhar com aplicativos opcionais

Para especificar um aplicativo como opcional e adicioná-lo manualmente a uma imagem:

Escolha um aplicativo para marcar como opcional.

Em seu aplicativo FM, altere o atributo do Optional aplicativo para "true". Isso marca o aplicativo como opcional e o aplicativo não será mais incluído em todas as imagens.

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

Observe a ID do aplicativo, por exemplo, ID="Contoso.Sampleapp_8wekyb3d8bbwe". Não altere essa ID ou a imagem falhará ao ser criada.

Se você adquiriu o aplicativo da Microsoft Store, poderá encontrar o nome da família de pacotes na licença do aplicativo. Abra o arquivo de licença usando um editor de texto e use o valor entre as marcas PFM.

Adicione o aplicativo opcional a uma imagem adicionando a ID como um <AppXID> valor em seu OEMInput.xml:

<AppXOptionalPackages> 
  <AppXID>Contoso.Sampleapp_8wekyb3d8bbwe</AppXID>
</AppXOptionalPackages>

Você também pode especificar um aplicativo como específico da arquitetura adicionando CPUType="(arch)". Quando você cria sua imagem, os arquivos que não correspondem ao tipo de arquitetura são excluídos.

Sintaxe de linha de comando SetAppsRegion

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

Parâmetro	Descrição
-Appname	O nome do nome do arquivo do aplicativo. Use o `Name` atributo no `<PackageFile>` elemento para o aplicativo.
-Região	A região ou regiões em que você deseja que o aplicativo esteja disponível. Se especificar várias regiões, separe as regiões com um `,`: `-Region en-us,de-de`
-OEMAppsFMPath	Caminho para o aplicativo FM. O padrão é `%WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml`

Confira também

Manifestos do recurso de driver

Compartilhar via