Estensione per la creazione di pacchetti MSIX

Ecco un esempio che illustra come configurare l'attività di compilazione e pacchetto nel file yaml:

steps:
- task: MSIX.msix-ci-automation-task-dev.msix-packaging.MsixPackaging@1
  displayName: 'MSIX build and package'
  inputs:
    outputPath: '$(Build.ArtifactStagingDirectory)\MyApp.msix'
    solution: MyUWPApp.sln
    buildPlatform: x64
    updateAppVersion: true
    manifestFile: MyUWPApp/Package.appxmanifest
    appVersion: 2.0.0.0
    appPackageDistributionMode: SideloadOnly
    msbuildArchitecture: x64

• Nome visualizzato - Personalizzare il nome dell'attività
• Percorso di output: specificare il percorso di output per il pacchetto MSIX che verrà creato da questa operazione. Il percorso nell'esempio precedente usa la variabile predefinitaBuild.ArtifactStagingDirectory , ovvero il percorso locale dell'agente per archiviare gli artefatti e viene usato qui per archiviare i file di output delle attività che possono essere pubblicati in un secondo momento usando un'attività pubblica artefatti.
• Compila soluzione con MSBuild : selezionare questa opzione per compilare la soluzione con msbuild per la piattaforma di destinazione specificata. Lasciare deselezionata la casella se sono già presenti file binari che devono essere inseriti in un pacchetto. Se si lascia deselezionata la casella, verrà chiesto di specificare il percorso dei file binari.
• Progetto da compilare : specificare il percorso del progetto o del file di soluzione che deve essere compilato.
• Pulire prima della compilazione - Spunta questa casella se si vuole che l'attività esegua una compilazione pulita prima della compilazione.
• Genera bundle MSIX : selezionare questa casella di controllo per generare un bundle MSIX anziché un pacchetto. Assicurati di denominare correttamente il file di output nell'opzione Percorso di output con estensione .msixbundle anziché .msix.
• Configurazione : scegliere tra configurazioni di debug e build di rilascio .
• Piattaforma : specificare la piattaforma di compilazione di destinazione, ad esempio x64, x86, Qualsiasi CPU.
• Aggiorna versione dell'app nel manifesto: selezionare questa casella di controllo per modificare la versione dell'app da quella specificata nel file appxmanifest dell'app. Questo non sovrascriverà il file con estensione appxmanifest, ma cambierà la versione dell'app nel pacchetto MSIX di output generato. Se questa opzione è selezionata, verrà chiesto di specificare il percorso del file manifesto e il numero di versione dell'app da impostare per l'app.
• Modalità di distribuzione pacchetti dell'applicazione : selezionare la modalità dal menu a discesa per generare un pacchetto dell'app dello Store o un pacchetto di app non nello Store.
• Versione e architettura di MSBuild : personalizzare MSBuild specificando le opzioni avanzate.

Di seguito è riportato un esempio che illustra come configurare l'attività di firma del pacchetto nel file yaml:

steps:
- task: MSIX.msix-ci-automation-task-dev.msix-signing.MsixSigning@1
  displayName: 'Sign MSIX package'
  inputs:
    certificateType: base64
    encodedCertificate: '$(kvtestcert)'

Questo esempio mostra l'attività quando l'origine del certificato è la libreria di file protetti.

Questo esempio mostra l'attività quando l'origine del certificato è un Azure Key Vault.

• Nome visualizzato - Personalizzare il nome dell'attività
• Pacchetto da firmare : l'attività di firma del pacchetto MSIX usa SignTool per firmare tutti i file corrispondenti a questo percorso, indipendentemente dal fatto che si tratti di pacchetti MSIX o bundle.
• Tipo di file di certificato: selezionare l'origine del file di certificato da usare.
• TimeStamp Server : URL che specifica l'indirizzo di un server di timestamp. Questo è un parametro opzionale.

Di seguito è riportato un esempio che illustra come configurare l'attività file AppInstaller nel file yaml:

steps:
- task: MSIX.msix-ci-automation-task-dev.app-installer-file.AppInstallerFile@1
  displayName: 'Create App Installer file'
  inputs:
    package: '$(Build.ArtifactStagingDirectory)\MyApp.msix'
    outputPath: '$(Build.ArtifactStagingDirectory)\MyApp.appinstaller'
    uri: 'https://myuwpapp-demo.azurewebsites.net/MyApp.appinstaller'
    mainItemUri: 'https://myuwpapp-demo.azurewebsites.net/MyApp.msix'
    showPromptWhenUpdating: true
    updateBlocksActivation: true

• Nome visualizzato - Personalizzare il nome dell'attività
• Pacchetto : percorso del pacchetto o del bundle per cui si vuole creare un programma di installazione app.
• Percorso File di Output - Questo è il percorso del file di installazione dell'applicazione da scrivere.
• Metodo per creare il file del programma di installazione app: scegliere se creare un nuovo file del programma di installazione app o aggiornare un file esistente. Se si sceglie di aggiornare un file esistente, verrà chiesto di specificare il percorso del file del programma di installazione app esistente.
• Versione per il file di installazione dell'app - Il numero di versione che sarà assegnato. Deve assumere la forma (principale).(minore).(compilazione).(revisione).
• URI: URI Web al file del programma di installazione dell'app reindirizzato.
• URI del pacchetto/bundle principale - URI al percorso del pacchetto/bundle dell'app.
• Aggiorna all'avvio : selezionare questa opzione per impostare l'app per verificare la disponibilità di aggiornamenti all'avvio. Se questa casella di controllo è selezionata, ti verrà chiesto di specificare dettagli come Ore tra i controlli degli aggiornamenti, se mostrare l'interfaccia utente all'utente durante l'aggiornamento e se vuoi che l'aggiornamento blocchi l'attivazione dell'app.

Ecco un esempio che illustra come configurare l'attività per creare un file VHDX per il collegamento dell'app nel file yaml:

steps:
- task: MSIX.msix-ci-automation-task-dev.msix-app-attach.MsixAppAttach@1
  displayName: 'Create package for MSIX app attach'
  inputs:
    package: '$(Build.ArtifactStagingDirectory)\MyApp.msix'
    vhdxOutputPath: '$(Build.ArtifactStagingDirectory)\MyApp.vhdx'

• Nome visualizzato - personalizza il nome dell'attività.
• Percorso pacchetto : percorso del pacchetto MSIX/bundle.
• Percorso di output VHDX : percorso del file VHDX che verrà creato dall'attività.
• Dimensioni VHDX : dimensioni massime in MB del VHDX.

Dopo aver configurato tutte le attività, è possibile usare un'attività Pubblica artefatti di compilazione per trasferire tutti gli artefatti dalla posizione temporanea agli artefatti di Azure Pipelines o a una condivisione file a scelta.

Ecco un esempio che illustra come configurare l'attività di collegamento dell'app avd nel file yaml:

steps:
- task: MSIX.msix-ci-automation-task-dev.avd-app-attach-publish.AVDAppAttachPublish@0
  displayName: 'Publish MSIX app attach package to AVD'
  inputs:
    vhdxPath: '$(Build.ArtifactStagingDirectory)/App.vhdx' 
    connectedServiceNameARM: 'ed1db943-1e1c-4eac-8683-ead2abc281b5' 
    resourceGroupName: 'appattach-test-rg' 
    storageAccount: 'appattachteststorage' 
    fileShare: 'appattach-test-fs' 
    hostPool: 'appattach-hostpool' 
    workSpace: 'appattach-test-ws' 
    applicationGroup: 'appattach-test-ag-rail' 

• Nome visualizzato - personalizza il nome dell'attività.

• Percorso pacchetto : percorso del pacchetto MSIX/bundle.

• Percorso di output VHDX : percorso del file VHDX che verrà creato dall'attività.

• Dimensioni VHDX : dimensioni massime in MB del VHDX.

• Nome visualizzato - personalizza il nome dell'attività.

• Percorso VHDX - Questo è il percorso del file VHDX che verrà collegato (pubblicato) al Desktop virtuale Azure (AVD).

• Sottoscrizione di Azure : si tratta della connessione al servizio per la sottoscrizione di Azure di destinazione a cui deve essere collegata l'applicazione. Nell'elenco a discesa sono elencate tutte le sottoscrizioni di Azure disponibili per l'utente ad accesso ADO corrente e l'utente può selezionare una di queste sottoscrizioni e stabilire una connessione al servizio.

• Gruppo di risorse : scegliere il gruppo di risorse che deve essere pubblicato dall'app. Questo gruppo di risorse deve contenere tutte le risorse di destinazione necessarie per il collegamento dell'app, ad esempio l'account di archiviazione, il pool di host, l'area di lavoro, il gruppo di applicazioni. Questo elenco a discesa elenca tutti i gruppi di risorse disponibili nella sottoscrizione di Azure selezionata.

• Account di archiviazione - Scegli l'account di archiviazione a cui caricare l'applicazione (o VHDX). Questo elenco a discesa elenca tutti gli account di archiviazione disponibili nel gruppo di risorse selezionato.

• Condivisione file : scegliere la condivisione file nell'account di archiviazione selezionato che l'applicazione (o VHDX) deve essere caricata. Questo elenco a discesa elenca tutte le condivisioni file disponibili nell'account di archiviazione selezionato.

• Host pool - scegliere l'host pool da usare per l'associazione dell'applicazione. Questo elenco a discesa elenca tutti i pool di host disponibili nel gruppo di risorse selezionato.

• Area di lavoro: scegliere l'area di lavoro da usare per collegare l'applicazione. Questo elenco a discesa elenca tutte le aree di lavoro disponibili nel gruppo di risorse selezionato.

• Gruppo di applicazioni: scegliere il gruppo di applicazioni da usare per il collegamento dell'applicazione. Questo elenco a discesa elenca tutti i gruppi di applicazioni disponibili nel gruppo di risorse selezionato.

Dopo aver configurato tutte le attività, è possibile usare un'attività Pubblica artefatti di compilazione per trasferire tutti gli artefatti dalla posizione temporanea agli artefatti di Azure Pipelines o a una condivisione file a scelta.