Uso di un file del programma di installazione app incorporato per aggiornare l'app

  • Articolo

Importante

L'uso di un file del programma di installazione app incorporato è disponibile in Windows versione 10.0.21300.0. Per usare questa funzionalità, assicurarsi che MaxVersionTested faccia riferimento a questa o a una versione più recente del sistema operativo Windows.

Il file del programma di installazione app fornisce un percorso di aggiornamento che un'app di Windows può attraversare la ricerca di aggiornamenti e riparazioni.

Quando usi Visual Studio per compilare e pubblicare l'app di Windows con un file del programma di installazione app incorporato, devi assicurarti che Windows 10 SDK 2104 (o versione successiva) sia stato installato e che le proprietà del progetto dispongano di Windows 10 21H1 (o versione successiva) come versioni targetted (MaxVersionTested e MinVersion). Se non è stato configurato, l'app di Windows non imposta le configurazioni appInstaller incorporate sul dispositivo quando l'app di Windows è installata.

Procedura - MSIX Packaging Tool

I passaggi seguenti illustrano come usare MSIX Packaging Tool per modificare un'app di Windows preesistente per includere un'app del programma di installazione app incorporata.

Nota

Le indicazioni seguenti presuppongono che il file del programma di installazione app sia stato creato in precedenza usando Visual Studio per automatizzare la creazione di un file del programma di installazione app, con l'uso di MSIX Toolkit o manualmente. Per indicazioni sulla creazione di un file del programma di installazione app, visitare uno dei seguenti articoli della documentazione:

Aprire l'app di Windows per la modifica

I passaggi seguenti illustrano come usare l'app Microsoft MSIX Packaging Tool per iniziare a modificare un'app di Windows.

  1. Avviare Microsoft MSIX Packaging Tool (disponibile in Microsoft Store: MSIX Packaging Tool).
  2. Selezionare il pulsante Editor pacchetti per modificare un pacchetto esistente.
  3. Selezionare il pulsante Sfoglia e nella finestra richiesta individuare l'app di Windows e selezionare il pulsante Apri .
  4. Selezionare il pulsante Apri pacchetto .

Importare il file del programma di installazione app nell'app di Windows

I passaggi seguenti illustrano come incorporare un file del programma di installazione app in un'app di Windows preesistente usando l'app Microsoft MSIX Packaging Tool. Questi passaggi presuppongono che l'app di Windows sia già stata aperta per la modifica usando l'app Microsoft MSIX Packaging Tool.

  1. Sul lato sinistro di MSIX Packaging Tool selezionare File di pacchetto.
  2. Espandere la voce Pacchetto all'interno della visualizzazione albero.
  3. Fare clic con il pulsante destro del mouse su Pacchetto e scegliere Aggiungi file dal menu a discesa.
  4. Selezionare il pulsante Sfoglia all'interno della finestra richiesta, passare a e selezionare il file del programma di installazione app e selezionare il pulsante Apri .
  5. Selezionare il pulsante Salva.

Aggiornare AppxManifest

I passaggi seguenti consentono di aggiornare AppxManifest in modo che punti al file del programma di installazione app aggiunto in precedenza all'app di Windows.

  1. Sul lato sinistro di MSIX Packaging Tool selezionare Informazioni sul pacchetto.
  2. Scorrere fino alla fine della sezione Informazioni pacchetto .
  3. Selezionare il pulsante Apri file per aprire AppxManifest in una finestra di Blocco note.
  4. Verificare che le <Package> proprietà includano gli spazi dei nomi seguenti e gli spazi dei nomi ignorabili: 
    <Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
    xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
    xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
    xmlns:uap13="http://schemas.microsoft.com/appx/manifest/uap/windows10/13" 
    xmlns:build="http://schemas.microsoft.com/developer/appx/2015/build"
    IgnorableNamespaces="uap mp uap13 build">
  5. All'interno di <Properties> includono i parametri figlio e seguenti <uap13:AutoUpdate> : 
    <Properties>
    ...
    <uap13:AutoUpdate>
        <uap13:AppInstaller File="Update.appinstaller" />
    </uap13:AutoUpdate>
</Properties>
  6. Salvare le modifiche apportate ad AppxManifest.
  7. Chiudere la finestra di Blocco note AppxManifest e tornare a MSIX Packaging Tool.

Nota

Le istruzioni precedenti presuppongono che il nome del file del programma di installazione app sia "Update.appinstaller".

Chiudere e creare il pacchetto dell'app di Windows

I passaggi seguenti ti guideranno attraverso la creazione di pacchetti dell'app di Windows come versione più recente. Questi passaggi presuppongono che le preferenze di firma siano state configurate per soddisfare i requisiti dell'organizzazione o del client.

  1. In MSIX Packaging Tool selezionare il pulsante Salva.
  2. Nella finestra richiesta selezionare il pulsante Sì, Increment .
  3. Passare al percorso in cui salvare l'app di Windows appena aggiornata e selezionare il pulsante Salva .
  4. Selezionare il pulsante Chiudi.
  5. Chiudere la finestra MSIX Packaging Tool .

Procedura - Visual Studio

Prima di iniziare, assicurarsi di lavorare su un dispositivo Windows 10 con Windows 10 SDK 2104 o versione successiva installato. Questo SDK è necessario per assicurarsi che le proprietà Versione di destinazione e Versione minima siano impostate con i valori appropriati durante la compilazione dell'app.

Incorporare il file del programma di installazione app

I passaggi seguenti ti guideranno attraverso l'incorporamento del file del programma di installazione app nel progetto di Visual Studio (UWP) dell'app Di Windows.

  1. Nel progetto di Visual Studio Esplora soluzioni fare clic con il pulsante destro del mouse sul nome dell'app di Windows.
  2. Selezionare Aggiungi>>elemento esistente dal menu a discesa.
  3. Passare al file del programma di installazione app, selezionarlo e selezionare il pulsante Aggiungi .
  4. Nella Esplora soluzioni fare doppio clic su Update.appinstaller per aprire il file da rivedere.
  5. Verificare che il file del programma di installazione app sia corretto e chiudere il file.

Aggiornamento di AppxManifest

La procedura seguente fornirà indicazioni su come aggiornare AppxManifest nel progetto di Visual Studio per specificare come destinazione il file del programma di installazione app appena incorporato.

Questa guida presuppone quanto segue:

  • È installato Windows 10 SDK 2104 o versione successiva
  • Le proprietà del progetto sono impostate su Windows 10, versione 2104 o successiva.
  • Il nome del file del programma di installazione app è Update.appinstaller
  1. Nel progetto di Visual Studio selezionare Compila dal menu in alto.
  2. Selezionare Compila soluzione dal menu a discesa. Assicurarsi che la compilazione dell'app di Windows abbia esito positivo.
  3. Selezionare Computer locale sulla barra multifunzione per testare la funzionalità dell'app di Windows.
  4. Chiudere l'app di Windows poco dopo l'avvio e arrestare il debug.
  5. Nel Esplora soluzioni fare clic con il pulsante destro del mouse su Package.appxmanifest
  6. Selezionare Visualizza codice dal menu a discesa.
  7. Verificare che le <Package> proprietà includano gli spazi dei nomi seguenti e gli spazi dei nomi ignorabili: 
    <Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
    xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
    xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
    xmlns:uap13="http://schemas.microsoft.com/appx/manifest/uap/windows10/13" 
    xmlns:build="http://schemas.microsoft.com/developer/appx/2015/build"
    IgnorableNamespaces="uap mp uap13 build">
  8. All'interno di <Properties> includono i parametri figlio e seguenti <uap13:AutoUpdate> : 
    <Properties>
    ...
    <uap13:AutoUpdate>
        <uap13:AppInstaller File="Update.appinstaller" />
    </uap13:AutoUpdate>
</Properties>
  9. Salvare le modifiche apportate al file e chiudere.

Compilazione dell'app di Windows

La procedura seguente illustra la creazione del pacchetto dell'app di Windows per l'installazione nei sistemi operativi supportati.

  1. Nel progetto di Visual Studio fare clic con il pulsante destro del mouse sul nome dell'app di Windows.
  2. Selezionare Pubblica crea>>pacchetti di app dal menu a discesa.
  3. Selezionare il pulsante di opzione Trasferimento locale nella nuova finestra di dialogo Crea pacchetti app.
  4. Seleziona il pulsante Avanti.
  5. Selezionare il pulsante di opzione Sì, usare il certificato corrente: .
  6. Importare un certificato esistente o generare automaticamente un certificato per firmare l'app di Windows.
  7. Seleziona il pulsante Avanti.
  8. Specificare la configurazione della soluzione, la versione e la build facoltativa di un bundle di app di Windows per l'app di Windows.
  9. Selezionare il pulsante Crea.