MSIX-Paketerweiterung

Im Folgenden finden Sie ein Beispiel, das zeigt, wie die Build- und Paketaufgabe in der YAML-Datei konfiguriert wird:

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

• Anzeigename – Passen Sie Ihren Aufgabennamen an
• Ausgabepfad : Geben Sie den Ausgabepfad für das MSIX-Paket an, das von dieser Aufgabe erstellt wird. Der Pfad im obigen Beispiel verwendet die vordefinierte VariableBuild.ArtifactStagingDirectory , die der lokale Pfad auf dem Agent zum Speichern von Artefakten ist, und wird hier zum Speichern von Aufgabenausgabedateien verwendet, die später mit einer Aufgabe zum Veröffentlichen von Artefakten veröffentlicht werden können.
• Projektmappe mit MSBuild erstellen : Wählen Sie diese Option aus, um Ihre Projektmappe mit msbuild für die angegebene Zielplattform zu erstellen. Lassen Sie das Kontrollkästchen deaktiviert, wenn Sie bereits Binärdateien haben, die nur noch verpackt werden müssen. Wenn Sie das Kontrollkästchen nicht aktivieren, werden Sie aufgefordert, den Pfad zu Ihren Binärdateien anzugeben.
• Zu erstellendes Projekt: Geben Sie den Pfad zu Ihrer Projekt- oder Projektmappendatei an, die erstellt werden muss.
• Vor dem Erstellen bereinigen : Aktivieren Sie dieses Kontrollkästchen, wenn der Task vor dem Build einen sauberen Build ausführen soll.
• MSIX-Bundle generieren – Aktivieren Sie dieses Kontrollkästchen, um ein MSIX-Bundle anstelle eines Pakets zu generieren. Stellen Sie sicher, dass Sie Ihre Ausgabedatei in der Option Ausgabepfad mit der Erweiterung .msixbundle anstelle von .msix benennen.
• Konfiguration : Wählen Sie zwischen Debug - und Release-Buildkonfigurationen .
• Plattform: Geben Sie die Zielbuildplattform an, z. B. x64, x86, Beliebige CPU.
• App-Version im Manifest aktualisieren : Aktivieren Sie dieses Kontrollkästchen, um die App-Version von der in der .appxmanifest-Datei der App angegebenen Version zu ändern. Dadurch wird die APPXMANIFEST-Datei nicht überschrieben, sondern die App-Version im generierten MSIX-Ausgabepaket geändert. Wenn diese Option ausgewählt ist, werden Sie aufgefordert, den Pfad zur Manifestdatei und die App-Versionsnummer anzugeben, die für die App festgelegt werden soll.
• Verteilungsmodus für Anwendungspakete : Wählen Sie den Modus aus dem Dropdown-Menü aus, um ein Store-App-Paket oder ein Nicht-Store-App-Paket zu generieren.
• MSBuild-Version und -Architektur – Passen Sie Ihre MSBuild an, indem Sie erweiterte Optionen angeben.

Im Folgenden finden Sie ein Beispiel, das zeigt, wie Sie die Paketsignaturaufgabe in der YAML-Datei konfigurieren:

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

In diesem Beispiel wird die Aufgabe veranschaulicht, wenn die Quelle des Zertifikats die Secure Files Library ist.

In diesem Beispiel wird die Aufgabe veranschaulicht, wenn die Quelle des Zertifikats ein Azure Key Vault ist.

• Anzeigename – Passen Sie Ihren Aufgabennamen an
• Zu signierendes Paket: Die MSIX-Paketsignieraufgabe verwendet SignTool, um alle Dateien zu signieren, die diesem Pfad entsprechen, unabhängig davon, ob es sich um MSIX-Pakete oder -Pakete handelt.
• Zertifikatdateityp - Wählen Sie die Quelle der zu verwendenden Zertifikatsdatei aus.
• Zeitstempelserver : Eine URL, die die Adresse eines Zeitstempelservers angibt. Dieser Parameter ist optional.

Im Folgenden finden Sie ein Beispiel, das zeigt, wie Sie die AppInstaller-Dateiaufgabe in der YAML-Datei konfigurieren:

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

• Anzeigename – Passen Sie Ihren Aufgabennamen an
• Paket : Dies ist der Pfad zu dem Paket oder Paket, für das Sie einen App-Installer erstellen möchten.
• Pfad der Ausgabedatei : Dies ist der Pfad der App Installer-Datei, die geschrieben werden soll.
• Methode zum Erstellen einer App-Installer-Datei : Wählen Sie aus, ob eine neue App-Installer-Datei erstellt oder eine vorhandene aktualisiert werden soll. Wenn Sie sich dafür entscheiden, eine vorhandene Datei zu aktualisieren, werden Sie aufgefordert, den Pfad zur vorhandenen App-Installer-Datei anzugeben.
• Version für App-Installer-Datei - Die Versionsnummer, die angegeben wird. Muss die Form (Dur) annehmen. (geringfügig). (Bauen). (Überarbeitung).
• URI – Web-URI zur umgeleiteten App Installer-Datei.
• Main Package/Bundle URI – URI zum Speicherort des App-Pakets/Bundles.
• Update On Launch : Wählen Sie diese Option aus, um die App so einzustellen, dass sie beim Start nach Updates sucht. Wenn dieses Kontrollkästchen aktiviert ist, werden Sie aufgefordert, Details wie Stunden zwischen Update-Überprüfungen anzugeben, ob die Benutzeroberfläche beim Update für den Benutzer angezeigt werden soll und ob das Update die App-Aktivierung blockieren soll.

Im Folgenden finden Sie ein Beispiel, das zeigt, wie Sie die Aufgabe so konfigurieren, dass eine VHDX-Datei für die App-Anlage in der YAML-Datei erstellt wird:

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'

• Anzeigename - Passen Sie den Namen Ihrer Aufgabe an.
• Paketpfad : Dies ist der Pfad zum MSIX-Paket/-Paket.
• VHDX-Ausgabepfad : Dies ist der Pfad der VHDX-Datei, die von der Aufgabe erstellt wird.
• VHDX-Größe : Die maximale Größe der VHDX in MB.

Nachdem Sie alle Aufgaben konfiguriert haben, können Sie eine Aufgabe zum Veröffentlichen von Buildartefakten verwenden, um alle Artefakte vom temporären Speicherort in Azure Pipelines-Artefakte oder eine Dateifreigabe Ihrer Wahl abzulegen.

Im Folgenden finden Sie ein Beispiel, das zeigt, wie Sie die avd-App-Anfügeaufgabe in der YAML-Datei konfigurieren:

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' 

• Anzeigename - Passen Sie den Namen Ihrer Aufgabe an.

• Paketpfad : Dies ist der Pfad zum MSIX-Paket/-Paket.

• VHDX-Ausgabepfad : Dies ist der Pfad der VHDX-Datei, die von der Aufgabe erstellt wird.

• VHDX-Größe : Die maximale Größe der VHDX in MB.

• Anzeigename - Passen Sie den Namen Ihrer Aufgabe an.

• VHDX-Pfad : Dies ist der Pfad der VHDX-Datei, die von der App an Azure Virtual Desktop (AVD) angefügt (veröffentlicht) wird.

• Azure-Abonnement : Dies ist die Dienstverbindung mit dem Azure-Zielabonnement, an das Ihre Anwendung angefügt werden muss. In der Dropdownliste werden alle Azure-Abonnements aufgelistet, die für den aktuell angemeldeten ADO-Benutzer verfügbar sind, und der Benutzer kann eines dieser Abonnements auswählen und eine Dienstverbindung damit herstellen.

• Ressourcengruppe : Wählen Sie die Ressourcengruppe aus, die Ihre App veröffentlichen soll. Diese Ressourcengruppe sollte alle Zielressourcen enthalten, die für die App-Anfügung erforderlich sind, z. B. Speicherkonto, Hostpool, Arbeitsbereich und Anwendungsgruppe. In dieser Dropdownliste werden alle Ressourcengruppen aufgelistet, die unter dem ausgewählten Azure-Abonnement verfügbar sind.

• Speicherkonto : Wählen Sie das Speicherkonto aus, das von der Anwendung (oder VHDX) hochgeladen werden soll. In dieser Dropdownliste werden alle Speicherkonten aufgelistet, die in der ausgewählten Ressourcengruppe verfügbar sind.

• Dateifreigabe : Wählen Sie die Dateifreigabe im ausgewählten Speicherkonto aus, in das Ihre Anwendung (oder VHDX) hochgeladen werden soll. In dieser Dropdownliste werden alle Dateifreigaben aufgelistet, die unter dem ausgewählten Speicherkonto verfügbar sind.

• Hostpool : Wählen Sie den Hostpool aus, der für das Anfügen der Anwendung durch die App verwendet werden soll. In dieser Dropdownliste werden alle Hostpools aufgelistet, die unter der ausgewählten Ressourcengruppe verfügbar sind.

• Arbeitsbereich : Wählen Sie den Arbeitsbereich aus, der für das Anfügen der Anwendung durch die App verwendet werden soll. In dieser Dropdownliste werden alle Arbeitsbereiche aufgelistet, die unter der ausgewählten Ressourcengruppe verfügbar sind.

• Anwendungsgruppe : Wählen Sie die Anwendungsgruppe aus, die für das Anfügen der Anwendung durch die App verwendet werden soll. In dieser Dropdownliste werden alle Anwendungsgruppen aufgelistet, die unter der ausgewählten Ressourcengruppe verfügbar sind.

Nachdem Sie alle Aufgaben konfiguriert haben, können Sie eine Aufgabe zum Veröffentlichen von Buildartefakten verwenden, um alle Artefakte vom temporären Speicherort in Azure Pipelines-Artefakte oder eine Dateifreigabe Ihrer Wahl abzulegen.