Manifesti delle funzionalità dell'app

Articolo
06/19/2023

I manifesti delle funzionalità dell'app definiscono la posizione delle app da includere in un'immagine. Come altri manifesti delle funzionalità, i manifesti delle funzionalità dell'app devono essere inclusi nell'elemento <AdditionalFMs> nel file di OEMInput.xml dell'immagine per le app definite nell'app fm da includere in un'immagine.

Per la prima immagine, è possibile aggiungere tutte le app nella cartella delle app dell'area di lavoro contemporaneamente all'immagine usando CreateWSKAppsFM e UpdateWSKAppsFM.

Manifesto di esempio 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>

App facoltative

Gli script nel kit di sistema di Windows configurano ogni app in un'app FM in modo che siano inclusi in un'immagine. È possibile modificare un'app FM in modo che alcune app devono essere aggiunte in modo specifico a un OEMInput.xml da includere in un'immagine.

Ogni app inclusa in un'app FM ha un Optional attributo che controlla se l'app verrà inclusa automaticamente in un'immagine o se l'app deve essere inclusa manualmente in un'immagine aggiungendone il relativo ID al OEMInput.xml.

Se si usa un singolo set collaterale per più immagini, contrassegnare le app come facoltativo consente di includere le app in configurazioni di immagini specifiche. Un'app FM in questo scenario può includere tutte le app nel set collaterale, specificando anche:

Set di base di app da includere in tutte le immagini
Set di app facoltative che è possibile aggiungere manualmente a file di OEMInput.xml specifici

Le app contrassegnate facoltative non verranno incluse in alcuna immagine, a meno che non vengano incluse in modo specifico in una progettazione di immagini. In questo modo è possibile riutilizzare il manifesto delle funzionalità dell'app per più immagini.

Usare app facoltative

Per specificare un'app come facoltativa e aggiungerla manualmente a un'immagine:

Scegliere un'app da contrassegnare come facoltativa.

Nell'app FM modificare l'attributo dell'app Optional in "true". Questo contrassegna l'app come facoltativo e l'app non sarà più inclusa in tutte le immagini.

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

Si noti l'ID app, ID="Contoso.Sampleapp_8wekyb3d8bbwe"ad esempio . Non modificare questo ID o l'immagine non riuscirà a compilare.

Se l'app è stata acquisita da Microsoft Store, è possibile trovare il nome della famiglia di pacchetti nella licenza dell'app. Aprire il file di licenza usando un editor di testo e usare il valore tra i tag PFM.

Aggiungere l'app facoltativa a un'immagine aggiungendo l'ID come <AppXID> valore nel OEMInput.xml:

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

È anche possibile specificare un'app come specifica dell'architettura aggiungendo CPUType="(arch)." Quando si compila l'immagine, i file che non corrispondono al tipo di architettura vengono esclusi.

Sintassi della riga di comando SetAppsRegion

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

Parametro	Descrizione
-Appname	Nome file dell'app. Usare l'attributo `Name` nell'elemento `<PackageFile>` per l'app.
-Regione	Area o aree in cui si vuole che l'app sia disponibile. Se si specificano più aree, separare le aree con :`,-Region en-us,de-de`
-OEMAppsFMPath	Percorso dell'app FM. Il valore predefinito è `%WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml`

Vedi anche

Manifesti delle funzionalità del driver

Condividi tramite