Condividi tramite


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 di Windows a cui si fa 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 di 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 pacchetto principale dell'app di Windows.
  4. Specificare il pacchetto opzionale correlato.
  5. Specificare il pacchetto Framework delle app Windows come dipendenza.
  6. Specificare i percorsi URI di aggiornamento.
  7. Specificare i percorsi URI di ripristino.
  8. Specificare le impostazioni di aggiornamento.
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. L'informazione nel AppInstaller elemento verrà consumata durante l'installazione delle app associate di Windows.

Elemento Descrizione
xmlns Spazio dei nomi XML
Versione Versione del file di installazione dell'app in notazione a quattro cifre (1.0.0.0).
URI Il percorso URI del file corrente dell'App Installer, accessibile dal dispositivo.
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

<MainPackage> e <MainBundle> sono utilizzati per identificare l'app Windows primaria che verrà installata tramite il file di installazione dell'app. Il <MainPackage> viene usato quando l'installer app di Windows è un *.msix o un *.appx. Usa <MainBundle> quando il programma di installazione delle app di Windows è un Installer di app di Windows in bundle, con un'estensione *.msixbundle o *.appxbundle.

Elemento Descrizione
Nome Nome dell'applicazione primaria distribuita tramite il file del programma di installazione app. Questa operazione è disponibile eseguendo il cmdlet di PowerShell seguente: $(Get-AppxPackage [AppName]).Name.
Editore Nome canonico del certificato dell'editore usato per firmare il programma di installazione principale dell'app di Windows. Questa operazione è disponibile eseguendo il cmdlet di PowerShell seguente: $(Get-AppxPackage [AppName]).Publisher.
Versione La versione del programma di installazione principale dell'app di Windows in una notazione a quattro punti (1.0.0.0). Questa operazione è disponibile eseguendo il cmdlet di PowerShell seguente: $(Get-AppxPackage [AppName]).Version.
ArchitetturaDelProcessore Architettura in cui viene installato il programma di installazione principale dell'app di Windows.
URI (Identificatore Uniforme delle Risorse) Percorso URI del supporto di installazione principale dell'app di Windows.

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 app di 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>
Programma di installazione del pacchetto di 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.

Elemento Descrizione
Nome Nome dell'applicazione facoltativa da distribuire tramite il file del programma di installazione app. Questa operazione è disponibile eseguendo il cmdlet di PowerShell seguente: $(Get-AppxPackage [AppName]).Name.
Editore Nome canonico del certificato dell'editore usato per firmare il programma di installazione facoltativo dell'app di Windows. Questa operazione è disponibile eseguendo il cmdlet di PowerShell seguente: $(Get-AppxPackage [AppName]).Publisher.
Versione Versione del programma di installazione facoltativo delle app di Windows in una notazione a quattro punti (1.0.0.0). Questa operazione è disponibile eseguendo il cmdlet di PowerShell seguente: $(Get-AppxPackage [AppName]).Version.
ArchitetturaDelProcessore Architettura in cui viene installato il programma di installazione facoltativo dell'app di Windows.
URI (Identificatore Uniforme delle Risorse) Percorso URI del supporto di installazione principale dell'app di Windows.
<?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.

Elemento Descrizione
Nome Il nome dell'applicazione di dipendenza a cui viene destinata la distribuzione tramite il file App Installer. Questa operazione è disponibile eseguendo il cmdlet di PowerShell seguente: $(Get-AppxPackage [AppName]).Name.
Editore Nome canonico del certificato del publisher usato per firmare l'installer delle app di Windows relative alle dipendenze. Questa operazione è disponibile eseguendo il cmdlet di PowerShell seguente: $(Get-AppxPackage [AppName]).Publisher.
Versione Versione del programma di installazione delle app di Windows di dipendenza in una notazione con punti quad (1.0.0.0). Questa operazione è disponibile eseguendo il cmdlet di PowerShell seguente: $(Get-AppxPackage [AppName]).Version.
ArchitetturaDelProcessore Architettura su cui il programma di installazione di app di Windows sta installando la dipendenza.
URI (Identificatore Uniforme delle Risorse) Percorso URI dell'immagine di installazione dell'app Windows dipendente.
<?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

Elementi Descrizione
OreTraControlliAggiornamenti Definisce il divario minimo nei controlli degli aggiornamenti delle app di Windows.
AggiornamentoBlocchiAttivazione Definisce l'esperienza quando viene verificato un aggiornamento dell'app.
Mostra prompt Definisce se viene visualizzata una finestra quando vengono installati gli aggiornamenti e quando vengono verificati gli aggiornamenti.
ForzaAggiornamentoDaQualsiasiVersione Specifica che la versione dell'applicazione successiva potrebbe corrispondere a una versione più recente o precedente. Se True, tutti per entrambi, se False (impostazione predefinita), verranno installate solo le nuove versioni.
<?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

Importante

Le impostazioni seguenti sono disponibili solo quando si usa lo schema 2021 in una build Di Windows Insider di Windows 10.

Per impostazione predefinita, le app di Windows installate con un file del programma di installazione app verranno aggiornate dall'URI del programma di installazione app, aderendo alle 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 di Windows.

Gli URI di aggiornamento devono essere destinati ai file di App Installer.

Annotazioni

Queste impostazioni funzionano solo quando lo schema è configurato come 2021 o versione successiva.

<?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

Importante

Le impostazioni seguenti sono disponibili solo quando si usa lo schema 2021 in una build Di Windows Insider di Windows 10.

Le app di Windows installate su un dispositivo possono supportare il ripristino automatico dell'app di Windows quando viene compromessa. Il programma di installazione di origine che verrà usato per ripristinare l'app di Windows può essere configurato usando la <RepairURIs> proprietà . L'app di Windows tenterà di ripristinarsi in base all'URI del programma di installazione app; se questo risulta inaccessibile, allora l'app di Windows utilizzerà l'URI di ripristino per identificare un'origine di ripristino. È possibile configurare un massimo di 10 URI di ripristino per qualsiasi app di Windows.

Gli URI di riparazione possono puntare ad app di Windows o ai file di App Installer. Questa impostazione non richiede che l'app di 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.

Annotazioni

Il tipo di file del programma di installazione app è nuovo in Windows 10 versione 1709 (Windows 10 Fall Creators Update). Non è disponibile alcun supporto per la distribuzione di app di Windows 10 usando un file del programma di installazione app nelle versioni precedenti di Windows 10. L'elemento HoursBetweenUpdateChecks è disponibile a partire da Windows 10 versione 1803.