Uso di un file Programma di installazione app incorporato per aggiornare l'app

Importante

L'uso di un file 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 Windows operativo.

Il Programma di installazione app file fornisce un percorso di aggiornamento che un Windows app può attraversare alla ricerca di aggiornamenti e riparazioni.

Quando si usa Visual Studio per compilare e pubblicare l'app Windows con un file Programma di installazione app incorporato, è necessario assicurarsi che sia installato Windows 10 SDK 2104 (o versione successiva) e che le proprietà del progetto siano Windows 10 21H1 (o versioni successive) come versioni target (MaxVersionTested e MinVersion). Se non è stato configurato, l'app Windows non imposta le configurazioni di AppInstaller incorporate sul dispositivo quando viene installata Windows app.

Procedura : MSIX Packaging Tool

La procedura seguente illustra come usare MSIX Packaging Tool per modificare un'app Windows esistente in modo da includere un'app Programma di installazione app incorporata.

Nota

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

Aprire l'app Windows per la modifica

La procedura seguente illustra come usare l'app Microsoft MSIX Packaging Tool per iniziare a modificare un Windows app.

  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 Windows e selezionare il pulsante Apri.
  4. Selezionare il pulsante Apri pacchetto.

Importare il file Programma di installazione app nell'app Windows

La procedura seguente illustra come incorporare un file Programma di installazione app in un'app Windows esistente usando l'app Microsoft MSIX Packaging Tool. Questi passaggi presuppongono che l'app Windows per la modifica usando l'app Microsoft MSIX Packaging Tool.

  1. Sul lato sinistro di MSIX Packaging Toolselezionare File 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 al file Programma di installazione app e selezionare il pulsante Apri.
  5. Fare clic sul pulsante Salva.

Aggiornare AppxManifest

La procedura seguente illustra come aggiornare AppxManifest in modo che punti al file Programma di installazione app aggiunto in precedenza all'app Windows app.

  1. Sul lato sinistro di MSIX Packaging Toolselezionare Informazioni pacchetto.
  2. Scorrere fino alla fine della sezione Informazioni sul pacchetto.
  3. Selezionare il pulsante Apri file per aprire AppxManifest in una Blocco note finestra.
  4. Verificare che <Package> le proprietà includano gli spazi dei nomi e gli spazi dei nomi ignorabili seguenti:
    <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 <Properties> di includere i parametri figlio e <uap13:AutoUpdate> seguenti:
    <Properties>
        ...
        <uap13:AutoUpdate>
            <uap13:AppInstaller File="Update.appinstaller" />
        </uap13:AutoUpdate>
    </Properties>
    
  6. Salvare le modifiche apportate in AppxManifest.
  7. Chiudere la finestra appxManifest Blocco note e tornare a MSIX Packaging Tool.

Nota

Le istruzioni precedenti presuppongono che Programma di installazione app file sia "Update.appinstaller".

Chiudere e creare un pacchetto dell Windows app

I passaggi seguenti illustrano come creare un pacchetto dell Windows app 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ì, Incremento.
  3. Passare alla posizione in cui si vuole salvare l'app Windows 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 Programma di installazione app file

La procedura seguente illustra come incorporare il file di Programma di installazione app nel progetto Windows app Visual Studio (UWP).

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

Aggiornamento di AppxManifest

I passaggi seguenti forniscono indicazioni su come aggiornare AppxManifest nel progetto Visual Studio per il file Programma di installazione app appena incorporato.

In questa guida si presuppone che:

  • È installato Windows 10 SDK 2104 o versione successiva
  • Le proprietà del progetto sono impostate sulla destinazione Windows 10 versione 2104 o successiva.
  • Il nome del file Programma di installazione app è Update.appinstaller
  1. Nel progetto Visual Studio selezionareCompila dal menu in alto.
  2. Selezionare Compila soluzione dal menu a discesa. Assicurarsi che la compilazione Windows'app sia stata completata correttamente.
  3. Selezionare Computer locale dalla barra multifunzione per testare le funzionalità dell'app Windows locale.
  4. Chiudere l Windows app subito dopo l'avvio e arrestare il debug.
  5. Nella finestra Esplora soluzioni fare clic con il pulsante destro del mouse su Package.appxmanifest
  6. Selezionare Visualizza codice dal menu a discesa.
  7. Verificare che <Package> le proprietà includano gli spazi dei nomi e gli spazi dei nomi ignorabili seguenti:
    <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 <Properties> di includere i parametri figlio e <uap13:AutoUpdate> seguenti:
    <Properties>
        ...
        <uap13:AutoUpdate>
            <uap13:AppInstaller File="Update.appinstaller" />
        </uap13:AutoUpdate>
    </Properties>
    
  9. Salvare le modifiche apportate al file e chiudere.

Creazione dell'app Windows predefinita

La procedura seguente illustra come creare il pacchetto dell Windows app per l'installazione nei sistemi operativi supportati.

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