Creare manualmente un file del programma di installazione app

Questo articolo illustra come creare manualmente un file di App Installer che definisce un set correlato con funzionalità di aggiornamento automatico e riparazione. Un set correlato non è un'entità, ma piuttosto una combinazione di un pacchetto principale e di pacchetti facoltativi.

Per poter installare un set correlato come un'entità, è necessario essere in grado di specificare il pacchetto principale e il pacchetto facoltativo come uno. A tale scopo, sarà necessario creare un file XML con estensione appinstaller per definire un set correlato. Il programma di installazione app usa il file *.appinstaller e consente all'utente di installare tutti i pacchetti definiti con un solo clic.

Durante la distribuzione, il file App Installer:

• Il pacchetto dell'app Windows a cui viene fatto riferimento nell'attributo URI dell'elemento < MainPackage > convaliderà gli attributi Name, Publisher e Version del pacchetto dell'app Windows di destinazione. Se l'elemento Package/Identity nel manifesto del pacchetto dell'app Windows non corrisponde, l'installazione avrà esito negativo.
• Creare un riferimento agli URI di aggiornamento e ripristino per la famiglia del pacchetto.

Come creare un file del programma di installazione app

Per distribuire il set correlato come un'entità, è necessario creare un file del programma di installazione app contenente gli elementi richiesti dallo schema del programma di installazione dell'app.

1. Crea il file *.AppInstaller.
2. Specificare gli attributi del file del programma di installazione app.
3. Specificare il principale app Package di Windows.
4. Specificare il pacchetto opzionale correlato.
5. Specificare la dipendenza dal pacchetto Framework di app Windows.
6. Specificare le impostazioni di aggiornamento.
7. Specificare i percorsi URI di aggiornamento.
8. Specificare i percorsi URI di ripristino.

Esempio di file del programma di installazione app

Seguendo i passaggi descritti in precedenza, verrà creato correttamente un file del programma di installazione app simile al seguente:

<?xml version="1.0" encoding="utf-8"?>
<AppInstaller
    xmlns="http://schemas.microsoft.com/appx/appinstaller/2017/2"
    Version="1.0.0.0"
    Uri="http://mywebservice.azurewebsites.net/appset.appinstaller" >

    <MainBundle
        Name="Contoso.MainApp"
        Publisher="CN=Contoso"
        Version="2.23.12.43"
        Uri="http://mywebservice.azurewebsites.net/mainapp.msixbundle" />

    <OptionalPackages>
        <Bundle
            Name="Contoso.OptionalApp1"
            Publisher="CN=Contoso"
            Version="2.23.12.43"
            Uri="http://mywebservice.azurewebsites.net/OptionalApp1.msixbundle" />

        <Bundle
            Name="Contoso.OptionalApp2"
            Publisher="CN=Contoso"
            Version="2.23.12.43"
            Uri="http://mywebservice.azurewebsites.net/OptionalApp2.msixbundle" />

        <Package
            Name="Fabrikam.OptionalApp3"
            Publisher="CN=Fabrikam"
            Version="10.34.54.23"
            Uri="http://mywebservice.azurewebsites.net/OptionalApp3.msix"
            ProcessorArchitecture="x64" />
    </OptionalPackages>

    <UpdateURIs>
        <UpdateURI>http://mywebservice.azurewebsites.net/appset.appinstaller</UpdateURI>
        <UpdateURI>http://mywebservice2.azurewebsites.net/appset.appinstaller</UpdateURI>
    </UpdateURIs>

    <RepairURIs>
        <RepairURI>http://mywebservice.azurewebsites.net/appset.appinstaller</RepairURI>
        <RepairURI>http://mywebservice2.azurewebsites.net/appset.appinstaller</RepairURI>
    </RepairURIs>

    <UpdateSettings>
        <OnLaunch HoursBetweenUpdateChecks="0"/>   
    </UpdateSettings>

</AppInstaller>

Passaggio 1: Creare il file *.appinstaller

Usando un editor di testo (Notepad.exe), creare un nuovo file con estensione del nome file *. AppInstaller

Procedura:

1. Aprire il menu Start.
2. Digitare quanto segue: notepad.exe.
3. Aprire il menu File .
4. Selezionare Salva con nome dal menu a discesa.

Passaggio 2: Aggiungere il modello di base

Includere l'elemento AppInstaller nel file App Installer specificando la versione, il percorso e la posizione di rete del file App Installer. Le informazioni nell'elemento AppInstaller verranno utilizzate durante l'installazione delle app Windows associate.

Procedura:

1. Aprire il file creato nel passaggio 1.

2. Copiare il contenuto XML seguente nel file *.AppInstaller.

   <?xml version="1.0" encoding="utf-8"?>
   <AppInstaller
       xmlns="http://schemas.microsoft.com/appx/appinstaller/2021"
       Version=""
       Uri="" >
   </AppInstaller>
   

3. Aggiornare l'attributo Version con la versione del file del programma di installazione app

4. Aggiornare l'attributo URI con il percorso di rete da cui sarà accessibile il file .AppInstaller.

Passaggio 3: Aggiungere le informazioni principali sul pacchetto

I <MainPackage> e <MainBundle> vengono usati per identificare l'app Windows primaria che verrà installata usando il file del programma di installazione app. Il <MainPackage> viene usato quando il programma di installazione dell'app Windows è *.msix o *.appx. Usare il <MainBundle> quando il programma di installazione dell'app Windows è un programma di installazione app in bundle Windows, con un'estensione di *.msixbundle o *.appxbundle.

Le informazioni nell'attributo <MainBundle> o <MainPackage> devono corrispondere rispettivamente all'elemento Package/Identity nel manifesto del bundle dell'app o nel manifesto del pacchetto dell'app.

programma di installazione dell'app Windows

Se il pacchetto principale dell'app è un file con estensione msix o .appx, usare <MainPackage>, come illustrato di seguito. Assicurarsi di includere ProcessorArchitecture, perché è obbligatorio per i pacchetti non bundle.

<?xml version="1.0" encoding="utf-8"?>
<AppInstaller
    xmlns="http://schemas.microsoft.com/appx/appinstaller/2021"
    Version="1.0.0.0"
    Uri="http://mywebservice.azurewebsites.net/appset.appinstaller" >

    <MainPackage
        Name="Contoso.MainApp"
        Publisher="CN=Contoso"
        Version="2.23.12.43"
        ProcessorArchitecture="x64"
        Uri="http://mywebservice.azurewebsites.net/mainapp.msix" />

</AppInstaller>

Installer del bundle dell'app Windows

Se il pacchetto principale dell'app è un file con estensione .msixbundle, .appxbundle, o un altro tipo di file, utilizzare <MainBundle> al posto di <MainPackage> come illustrato di seguito. Per i bundle, ProcessorArchitecture non è obbligatorio.

<?xml version="1.0" encoding="utf-8"?>
<AppInstaller
    xmlns="http://schemas.microsoft.com/appx/appinstaller/2021"
    Version="1.0.0.0"
    Uri="http://mywebservice.azurewebsites.net/appset.appinstaller" >

    <MainBundle
        Name="Contoso.MainApp"
        Publisher="CN=Contoso"
        Version="2.23.12.43"
        Uri="http://mywebservice.azurewebsites.net/mainapp.msixbundle" />

</AppInstaller>

Passaggio 4: Aggiungere i pacchetti facoltativi

Analogamente all'attributo principale del pacchetto dell'app, se il pacchetto facoltativo può essere un pacchetto dell'app o un bundle dell'app, l'elemento figlio all'interno dell'attributo <OptionalPackages> deve essere <Package> o <Bundle> rispettivamente. Le informazioni sul pacchetto negli elementi figlio devono corrispondere all'elemento Identity nel bundle o nel manifest del pacchetto.

<?xml version="1.0" encoding="utf-8"?>
<AppInstaller
    xmlns="http://schemas.microsoft.com/appx/appinstaller/2021"
    Version="1.0.0.0"
    Uri="http://mywebservice.azurewebsites.net/appset.appinstaller" >

    <MainBundle
        Name="Contoso.MainApp"
        Publisher="CN=Contoso"
        Version="2.23.12.43"
        Uri="http://mywebservice.azurewebsites.net/mainapp.msixbundle" />

    <OptionalPackages>
        <Bundle
            Name="Contoso.OptionalApp1"
            Publisher="CN=Contoso"
            Version="2.23.12.43"
            Uri="http://mywebservice.azurewebsites.net/OptionalApp1.msixbundle" />

        <Package
            Name="Fabrikam.OptionalApp3"
            Publisher="CN=Fabrikam"
            Version="10.34.54.23"
            ProcessorArchitecture="x64"
            Uri="http://mywebservice.azurewebsites.net/OptionalApp3.msix" />

    </OptionalPackages>

</AppInstaller>

Passaggio 5: Aggiungere dipendenze

Nell'elemento dependencies è possibile specificare i pacchetti framework necessari per il pacchetto principale o i pacchetti facoltativi.

<?xml version="1.0" encoding="utf-8"?>
<AppInstaller
    xmlns="http://schemas.microsoft.com/appx/appinstaller/2021"
    Version="1.0.0.0"
    Uri="http://mywebservice.azurewebsites.net/appset.appinstaller" >

    <MainBundle
        Name="Contoso.MainApp"
        Publisher="CN=Contoso"
        Version="2.23.12.43"
        Uri="http://mywebservice.azurewebsites.net/mainapp.msixbundle" />

    <Dependencies>
        <Package 
            Name="Microsoft.VCLibs.140.00" 
            Publisher="CN=Microsoft Corporation, O=Microsoft Corporation, L=Redmond, S=Washington, C=US" 
            Version="14.0.24605.0" ProcessorArchitecture="x86" Uri="http://foobarbaz.com/fwkx86.appx" />
        <Package 
            Name="Microsoft.VCLibs.140.00" 
            Publisher="CN=Microsoft Corporation, O=Microsoft Corporation, L=Redmond, S=Washington, C=US" 
            Version="14.0.24605.0" 
            ProcessorArchitecture="x64" 
            Uri="http://foobarbaz.com/fwkx64.appx" />
    </Dependencies>

</AppInstaller>

Passaggio 6: Aggiungere l'impostazione di aggiornamento

Il file del programma di installazione app può anche specificare l'impostazione di aggiornamento in modo che i set correlati possano essere aggiornati automaticamente quando viene pubblicato un file del programma di installazione app più recente. <UpdateSettings> è un elemento facoltativo. In <UpdateSettings> l'opzione OnLaunch specifica che i controlli di aggiornamento devono essere eseguiti all'avvio dell'app e HoursBetweenUpdateChecks="12" specifica che deve essere eseguito un controllo degli aggiornamenti ogni 12 ore. Se HoursBetweenUpdateChecks non è specificato, l'intervallo predefinito usato per verificare la disponibilità di aggiornamenti è di 24 ore. Altri tipi di aggiornamenti, ad esempio gli aggiornamenti in background, sono disponibili nello schema Delle impostazioni di aggiornamento; Altri tipi di aggiornamenti all'avvio, ad esempio gli aggiornamenti con un prompt, sono disponibili nello schema OnLaunch

<?xml version="1.0" encoding="utf-8"?>
<AppInstaller
    xmlns="http://schemas.microsoft.com/appx/appinstaller/2021"
    Version="1.0.0.0"
    Uri="http://mywebservice.azurewebsites.net/appset.appinstaller" >

    <MainBundle
        Name="Contoso.MainApp"
        Publisher="CN=Contoso"
        Version="2.23.12.43"
        Uri="http://mywebservice.azurewebsites.net/mainapp.msixbundle" />

    <UpdateSettings>
        <OnLaunch 
            HoursBetweenUpdateChecks="12"
            UpdateBlocksActivation="true"
            ShowPrompt="true" />
        <AutomaticBackgroundTask />
        <ForceUpdateFromAnyVersion>true</ForceUpdateFromAnyVersion>
    </UpdateSettings>

</AppInstaller>

Passaggio 7: Aggiungere le impostazioni di aggiornamento automatico

Queste impostazioni consentono di aggiornare l'app Windows dall'URI del programma di installazione app, rispettando le configurazioni impostate nel passaggio precedente. Gli URI di aggiornamento configurati in questo passaggio fungeranno da URI di fallback che possono essere usati se l'URI originale del programma di installazione app non è più accessibile. È possibile configurare un massimo di 10 URI di aggiornamento per qualsiasi app Windows.

Gli URI di aggiornamento devono essere destinati ai file del programma di installazione app.

<?xml version="1.0" encoding="utf-8"?>
<AppInstaller
    xmlns="http://schemas.microsoft.com/appx/appinstaller/2021"
    Version="1.0.0.0"
    Uri="http://mywebservice.azurewebsites.net/appset.appinstaller" >

    <MainBundle
        Name="Contoso.MainApp"
        Publisher="CN=Contoso"
        Version="2.23.12.43"
        Uri="http://mywebservice.azurewebsites.net/mainapp.msixbundle" />

    <UpdateSettings>
        <OnLaunch 
            HoursBetweenUpdateChecks="12" />
    </UpdateSettings>

    <UpdateUris>
        <UpdateUri>https://www.contoso.com/Installers/MainApp.AppInstaller</UpdateUri>
        <UpdateUri>\\ServerName\Share\Installers\MainApp.AppInstaller</UpdateUri>
    </UpdateUris>

</AppInstaller>

Passaggio 8: Aggiungere le impostazioni di ripristino automatico

Queste impostazioni abilitano la riparazione dell'app Windows quando viene manomessa. Il programma di installazione di origine usato per ripristinare l'app può essere configurato usando la <RepairURIs> proprietà . L'app Windows tenterà di ripristinarsi in base all'URI del programma di installazione app. Se inaccessibile, userà gli URI di ripristino per identificare un'origine di ripristino. È possibile configurare un massimo di 10 URI di ripristino per qualsiasi app Windows.

Gli URI di ripristino possono essere destinati ad app Windows o a file di App Installer. Questa impostazione non richiede che l'app Windows sia stata installata usando un file del programma di installazione app.

<?xml version="1.0" encoding="utf-8"?>
<AppInstaller
    xmlns="http://schemas.microsoft.com/appx/appinstaller/2021"
    Version="1.0.0.0"
    Uri="http://mywebservice.azurewebsites.net/appset.appinstaller" >

    <MainBundle
        Name="Contoso.MainApp"
        Publisher="CN=Contoso"
        Version="2.23.12.43"
        Uri="http://mywebservice.azurewebsites.net/mainapp.msixbundle" />

    <UpdateSettings>
        <OnLaunch 
            HoursBetweenUpdateChecks="12" />
    </UpdateSettings>

    <RepairUris>
        <RepairUri></RepairUri>
        <RepairUri></RepairUri>
    </RepairUris>

</AppInstaller>

Per tutti i dettagli sullo schema XML, vedere Riferimento al file di App Installer.