Preinstallare le app usando il modulo di protezione dati

Articolo
06/19/2023

Nota

Interessato alla preinstallazione delle app di Microsoft Store, ma non si è un OEM? Per informazioni sul sideload delle app per le organizzazioni, vedere Sideload Apps with DISM ( Sideload Apps with DISM).

Questo argomento illustra come preinstallare le app in modo che siano incluse come parte di un'immagine di Windows.

Suggerimento

Le app di supporto hardware (HSAs) sono App di Microsoft Store e si applicano le istruzioni seguenti.

Usare i pacchetti dell'app

Usare DISM per effettuare il provisioning offline di un'app in un'immagine. È possibile usare GESTIONE dei dati dal prompt dei comandi o dai cmdlet DISM in Windows PowerShell.

Nelle versioni precedenti di Windows 10, le app universali preinstallate e le app di Microsoft Store devono essere aggiunte al menu Start. Windows rimuove le app preinstallate ma non aggiunte al menu Start.

A partire da Windows 10, versione 1803, le app possono essere preinstallate senza essere aggiunte al menu Start quando si usa DISM /add-provisionedappxpackage con l'opzione /region . Quando si preinstalla un'app, è possibile scegliere di lasciare l'app fuori dal LayoutModification.xml e l'app verrà installata correttamente senza essere visualizzata come riquadro menu Start. Quando non viene specificato un elenco di aree, l'app verrà effettuato il provisioning solo se viene aggiunto al layout di avvio.

Estrarre i file del pacchetto

Passare alla cartella in cui sono stati salvati i pacchetti dell'app scaricati dal dashboard partner.
Fare clic con il pulsante destro del mouse su ogni .zip cartella contenente i file del pacchetto dell'app. Fare clic su Estrai tutto e selezionare un percorso per salvare le cartelle dei file del pacchetto.

La cartella contiene tutti i file non compressi per il pacchetto, incluso un pacchetto principale, tutti i pacchetti di dipendenza e il file di licenza.

Importante

Non modificare la cartella dopo aver estratto i file del pacchetto. Se si modifica, si aggiunge o si rimuove qualsiasi file nella cartella, l'app avrà esito negativo durante l'installazione o l'avvio. Anche l'esplorazione della cartella può causare problemi.

È necessario usare il file di licenza dai file di pacchetto per testare l'immagine di cui è stato effettuato il provisioning. La creazione di un file di dati personalizzato non consente di testare in modo accurato un'app preinstallata da un OEM.

Per il provisioning offline di un'app in un'immagine, è possibile usare lo strumento di Dism.exe o i cmdlet DISM in Windows PowerShell per aggiungere un'app da una cartella di file non compressi.

Preinstallare un'app con firma di Microsoft Store con DISM

Aprire il prompt dei comandi come amministratore.

Montare un'immagine di Windows per cui si vuole eseguire il servizio:

Dism /Mount-Image /ImageFile:c:\images\myimage.wim /Index:1 /mountdir:c:\test\offline

Aggiungere l'app all'immagine montata. Usare le /PackagePath opzioni e /DependencyPackagePath .
- Packagepath è il percorso del bundle appx o del file del pacchetto
- DependencyPackagePath è il percorso per specificare ogni pacchetto di dipendenza. È possibile disporre di più dipendenze per ogni comando.
- Novità in Windows 10 versione 1803: usare l'opzione Region quando si aggiungono app. Region consente di aggiungere un'app senza dover aggiungere l'app al menu Start.
```
Dism /Image:c:\test\offline /Add-ProvisionedAppxPackage /PackagePath:c:\downloads\package.appxbundle /DependencyPackagePath:c:\downloads\dependency1.appx /DependencyPackagePath:c:\downloads\dependency2.appx /LicensePath=c:\downloads\package_License1.xml /region=all"
```
Per informazioni sull'uso dei pacchetti di app DISM, vedere Opzioni della riga di comando per informazioni sull'uso dei pacchetti dell'app , inclusa la nuova opzione /region.
Aggiungere l'app al menu Start.
- Se non è stato specificato /region durante la preinstallazione dell'app, aggiungere l'app al menu Start con LayoutModification.xml.
  
  or
- Se si specifica /region quando si preinstalla l'app e si vuole aggiungere l'app al menu Start per aree specifiche, usare l'elementoRequiredStartGroups Region="region1|region2" in LayoutModification.xml per specificare le aree in cui si vuole che l'app venga visualizzata.
Salvare le modifiche e smontare l'immagine. Al prompt dei comandi digitare:
```
Dism /Unmount-Image /mountdir:c:\test\offline /commit
```

Nota

Le app di Microsoft Store non vengono eseguite in modalità di controllo. Per testare la distribuzione, eseguire Windows e creare un nuovo profilo utente. Per altre informazioni sulla modalità di controllo, vedere Panoramica della modalità di controllo.

Importante Se si sta preinstallando un'app per dispositivi a banda larga mobile, è necessario inserire la scheda SIM nel PC prima di eseguire la fase specializzata di Sysprep. Per altre informazioni sulla preinstallazione di un'app per dispositivi a banda larga mobile, vedere Preinstallare i componenti necessari per un'esperienza applicazione mobile a banda larga.

Aggiornare o rimuovere pacchetti

È possibile rimuovere un'app preinstallata, incluse le licenze e i file di dati personalizzati, da un'immagine di Windows usando lo strumento DISM.exe o i cmdlet DISM in Windows PowerShell. È necessario rimuovere la versione precedente dell'app prima di installare una nuova.

Rimuovere un'app preinstallata tramite GESTIONE dei dati

Aprire il prompt dei comandi degli strumenti di distribuzione, installato con Windows ADK, con privilegi di amministratore. Nella schermata Start digitare Distribuzione e ambiente strumenti di creazione immagini, fare clic con il pulsante destro del mouse sull'icona e selezionare Esegui come amministratore.

Montare l'immagine offline per la manutenzione. Al prompt dei comandi digitare:

Dism /Mount-Image /ImageFile:c:\images\myimage.wim /Index:1 /mountdir:c:\test\offline

Trovare il nome completo del pacchetto dell'app da rimuovere. Al prompt dei comandi digitare:
```
Dism /Image:C:\test\offline /Get-ProvisionedAppxPackages
```

Rimuovere l'app dall'immagine montata. Al prompt dei comandi, ad esempio, digitare:

Dism /Image:c:\test\offline /Remove-ProvisionedAppxPackage /PackageName:microsoft.devx.appx.app1_1.0.0.0_neutral_en-us_ac4zc6fex2zjp

Se si vuole aggiornare l'app, è possibile preinstallare la versione aggiornata dell'app con firma di Microsoft Store. Al prompt dei comandi digitare:
```
Dism /Image:c:\test\offline /Add-ProvisionedAppxPackage/FolderPath:c:\downloads\appxpackage
```
Salvare le modifiche e smontare l'immagine. Al prompt dei comandi digitare:
```
Dism /Unmount-Image /mountdir:c:\test\offline /commit
```

Usare file di dati personalizzati

Le app preinstallate in un PC possono accedere ai dati personalizzati specifici dell'installazione. Questi dati personalizzati vengono aggiunti all'app durante la preinstallazione e diventano disponibili in fase di esecuzione. I dati personalizzati consentono agli sviluppatori di personalizzare le funzionalità e le funzionalità di un'app, inclusa la fornitura di funzionalità di creazione di report.

Aggiungere un file di dati personalizzato a un'immagine di Windows

È necessario specificare il file di dati personalizzato quando si preinstalla l'app usando lo strumento DISM e tramite Windows PowerShell usando il cmdlet Add-AppxProvisionedPackage. Il comando seguente illustra come eseguire questa operazione usando lo strumento DISM:

Dism /Image:C:\test\offline /Add-ProvisionedAppxPackage / FolderPath:f:\Apps\Fabrikam_KnowMyPC /CustomDataPath:f:\Contoso_Promotion.xml

Se un file di dati personalizzato esiste già nell'archivio dati per un'app, ad esempio se il pacchetto è già stato aggiunto all'immagine, il file esistente viene sovrascritto. Se l'installazione ha esito negativo, il file non viene ripristinato.

Nota È possibile rilasciare gli aggiornamenti a un'app tramite Microsoft Store senza perdere il file di dati personalizzato. Tuttavia, se un utente elimina l'app, il file di dati personalizzato non è più disponibile, anche se l'utente reinstalla l'app.

Testare i dati personalizzati per le app preinstallate

Le app preinstallate in un PC possono accedere ai dati personalizzati specifici dell'installazione. Questi dati personalizzati vengono aggiunti all'app durante la preinstallazione e diventano disponibili per l'app in fase di esecuzione. I dati personalizzati consentono agli sviluppatori di personalizzare le funzionalità e le funzionalità di un'app, inclusa la fornitura di funzionalità di creazione di report.

Il file Custom.data viene visualizzato nel percorso installato dell'app. Il nome Custom.data è hardcoded e non può essere modificato. L'app può verificare l'esistenza di questo file per determinare se l'app è stata preinstallata nel PC. Ecco un esempio di come accedere al file Custom.data.

var outputDiv = document.getElementById("CustomData");
Windows.ApplicationModel.Package.current.installedLocation.getFileAsync
     ("microsoft.system.package.metadata\\Custom.data").then(function (file) {
         // Read the file
         Windows.Storage.FileIO.readTextAsync(file).done(function (fileContent) {
            outputDiv.innerHTML = 
                 "App is preinstalled. CustomData contains:<br /><br />"
                 + fileContent;
         },
         function (error) {
             outputDiv.innerText = "Error reading CustomData " + error;
         });
     },
     function (error) {
         outputDiv.innerText = "CustomData was not available. App not preinstalled";
     });

Il file Custom.data può includere qualsiasi contenuto e essere in qualsiasi formato richiesto dall'app. Il processo di preinstallazione rende semplicemente disponibile l'app. Gli sviluppatori possono fornire il file di dati al partner di preinstallazione oppure è possibile accettare un formato che consente al partner di generare il contenuto.

Testare i dati personalizzati

Quando si compila e si esegue il debug dell'app in Microsoft Visual Studio, non è possibile accedere al file Custom.data dalla posizione installata dell'app perché l'app non è ancora preinstallata. È possibile simulare l'uso del file Custom.data inserendo un file Custom.data test nell'app stessa e quindi caricando e testando il file locale dell'app. A tale scopo, modificare l'esempio di codice da:

("microsoft.system.package.metadata\\Custom.data").then(function (file) {

in:

("Custom.data").then(function (file) {

Dopo aver verificato il formato e il contenuto del file, è possibile modificare il percorso del file Custom.data nel percorso finale, come illustrato nell'esempio originale precedente.

Per testare il file Custom.data

Aprire il prompt dei comandi degli strumenti di distribuzione, installato con Windows ADK, con privilegi di amministratore. Nella schermata Start digitare Distribuzione e ambiente strumenti di creazione immagini, fare clic con il pulsante destro del mouse sull'icona e selezionare Esegui come amministratore.
Aggiungere l'applicazione con il file di dati personalizzato:
```
dism /online /Add-ProvisionedAppxPackage /PackagePath:.\CustomData_1.0.0.1_AnyCPU_Debug.appx /CustomDataPath:.\Test.txt /SkipLicense
```
Dove /PackagePath:.\CustomData_1.0.0.1_AnyCPU_Debug.appx punta al pacchetto di test dell'app locale e dove /CustomDataPath:.\Test.txt punta al file Custom.data. Tenere presente che il nome del file specificato qui non viene usato dopo l'installazione dei dati nell'app.

L'app ora ha un riquadro nella schermata Start del PC usato per testare l'app. L'app deve essere in grado di accedere al file Custom.data. Se è necessario un debug aggiuntivo, collegare un debugger dopo l'avvio dell'app dalla schermata Start .

Nota Potrebbe essere necessario disconnettersi e accedere di nuovo per visualizzare l'app nella schermata Start .
Dopo aver eseguito il test dell'app, è necessario rimuovere il pacchetto preinstallato per continuare a usare l'ambiente Dev. Per rimuovere il pacchetto preinstallato usando Windows PowerShell, è possibile usare il cmdlet Get-AppxPackage per fornire il nome completo del pacchetto dell'app tramite la pipeline al cmdlet Remove-ProvisionedAppxPackage:

Get-AppxPackage *CustomData* | Remove-ProvisionedAppxPackage

Dove *CustomData* è la parte nota del nome dell'app

Preinstallare un'app per dispositivi Microsoft Store o un'app a banda larga per dispositivi mobili

È possibile preinstallare i componenti necessari per un'app per dispositivi Microsoft Store o un'app a banda larga per dispositivi mobili usando la piattaforma Gestione e manutenzione immagini distribuzione.

Nota Questo articolo è destinato alle macchine virtuali, che supportano un'app per dispositivi Di Microsoft Store o l'app a banda larga per dispositivi mobili nei propri dispositivi.

Per ogni tipo di app, due elementi devono essere preinstallati per fornire l'app per dispositivi Microsoft Store corretta o l'app a banda larga mobile:

App per dispositivi di Microsoft Store, preinstallazione:
1. Pacchetto di metadati del dispositivo
2. L'app
App a banda larga per dispositivi mobili di Microsoft Store, preinstallazione:
1. Pacchetto di metadati del servizio
2. L'app

Importante Anche se i pacchetti di metadati e le app corrispondenti vengono analizzate immediatamente dopo il completamento del processo OOBE, un utente potrebbe essere in grado di avviare l'app prima che venga analizzato il pacchetto di metadati. In questo caso, l'utente visualizzerà un errore di accesso negato. Per evitare questo problema, applicare sia il pacchetto di metadati che l'app all'immagine di sistema.

Preinstallare i metadati del dispositivo o il pacchetto di metadati del servizio

Per preinstallare un pacchetto di metadati del dispositivo o metadati del servizio

Se si sta preinstallando un'app per dispositivi di Microsoft Store, è necessario aver acquisito il pacchetto di metadati del dispositivo. Se si sta preinstallando un'app a banda larga per dispositivi mobili, è necessario aver acquisito il pacchetto di metadati del servizio.

Nota I pacchetti di metadati del dispositivo e i pacchetti di metadati del servizio usano lo stesso estensione del nome file (.devicemetadata-ms).
Copiare i metadati del dispositivo o il pacchetto di metadati del servizio (file devicemetadata-ms) nell'immagine di sistema nella cartella %ProgramData%\Microsoft\Windows\DeviceMetadataStore . È possibile eseguire questa operazione in uno dei modi seguenti:
- Online prima di eseguire Sysprep
- Offline dopo aver eseguito Sysprep usando DISM. Per eseguire questa operazione:
  1. Montare l'immagine offline per la manutenzione.
```
Dism /Mount-Image /ImageFile:C:\test\images\myimage.wim /index:1 /MountDir:C:\test\offline
```
  2. Copiare i file del pacchetto di metadati nell'archivio metadati del dispositivo dell'immagine montata. Ad esempio, per copiare il file del pacchetto di metadati 0ECF2029-2C6A-41AE-9E0A-63FFC9EAD877.devicemetadata-ms nel archivio metadati del dispositivo, ProgramData\Microsoft\Windows\DeviceMetadataStore:
```
copy 0ECF2029-2C6A-41AE-9E0A-63FFC9EAD877.devicemetadata-ms C:\test\offline\ProgramData\Microsoft\Windows\DeviceMetadataStore
```
  3. Salvare le modifiche e smontare l'immagine.
```
dism /Unmount-Image /mountdir: c:\test\offline /commit
```
  Per altre informazioni sulla manutenzione delle immagini offline, vedere Panoramica di GESTIONE delle immagini.

Per altre informazioni sui metadati del servizio, vedere Metadati del servizio.

Preinstallare l'app per dispositivi Microsoft Store o l'app a banda larga per dispositivi mobili

Per preinstallare l'app per dispositivi Microsoft Store o l'app a banda larga per dispositivi mobili

Montare l'immagine offline per la manutenzione.

Dism /Mount-Image /ImageFile:C:\test\images\myimage.wim /index:1 /MountDir:C:\test\offline

Aggiungere l'app per dispositivi Microsoft Store o l'app a banda larga mobile all'immagine.
```
dism /Image:<mounted folder> /Add-ProvisionedAppxPackage /FolderPath:<appxpackage path>
```

Salvare le modifiche e smontare l'immagine.

dism /Unmount-Image /mountdir: c:\test\offline /commit