Veröffentlichen von App-Updates im Microsoft Store mit GitHub Actions

Hinweis

App-Aktualisierungsvorgänge über GitHub Aktionen werden derzeit nur für kostenlose Produkte unterstützt. Kostenpflichtige Produkte werden in einer zukünftigen Version unterstützt.

mit GitHub Actions können Sie eine robuste CI/CD-Pipeline für Ihre Microsoft Store-Apps implementieren. Indem Sie Build-, Test- und Bereitstellungsschritte direkt aus Ihrem Code-Repository automatisieren, stellen Sie sicher, dass jede Änderung, unabhängig davon, ob es sich um eine Fehlerkorrektur, Funktionsupdate oder Metadatenänderung handelt, überprüft und sicher im Microsoft Store veröffentlicht wird.

Informationen zum Einrichten von Voraussetzungen für den App-Updateprozess finden Sie im folgenden Video:

Voraussetzung

Registrieren Sie sich als Windows App-Entwickler im Partner Center.
Sie haben einen Mandanten, der Ihrem Partner Center-Konto zugeordnet ist. Sie können dies erreichen, indem Sie entweder eine vorhandene Microsoft Entra ID im Partner Center zuordnen oder eine neue Microsoft Entra ID im Partner Center erstellen.
Registrieren einer Anwendung in Microsoft Entra ID
Fügen Sie als Nächstes auf der Registerkarte Microsoft Entra Anwendungen auf der Seite "Benutzerverwaltung" im Abschnitt "Kontoeinstellungen" des Partner Center die Microsoft Entra ID Anwendung hinzu, die die App oder den Dienst darstellt, die Sie für den Zugriff auf Übermittlungen für Ihr Partner Center-Konto verwenden. Stellen Sie sicher, dass Sie dieser Anwendung die Rolle Manager zuweisen.
Die App, die Sie aktualisieren möchten, muss bereits im Microsoft Store veröffentlicht und live sein.
Erforderliche IDs und Geheime Schlüssel:
- Mandanten-ID (Dies ist der eindeutige Bezeichner für Ihren Microsoft Entra Mandanten. Wechseln Sie zu https://entra.microsoft.com/. Navigieren Sie zu Azure Active Directory > Overview. Kopieren Sie den Wert "Mandanten-ID".)
- Client-ID (Dies ist die Anwendungs-ID der App-Registrierung, die Sie erstellt haben. Wechseln Sie im Entra Admin Center zu Azure Active Directory > App registrations. Wählen Sie Ihre registrierte App aus. Kopieren Sie die "Anwendungs-ID".) für DEN API-Zugriff. Wechseln Sie im Entra Admin Center zu Azure Active Directory > Anwendungsregistrierungen. Wählen Sie Ihre registrierte App aus. Kopieren Sie die "Anwendungs-ID".)
- Geheimer Clientschlüssel (Dies ist ein kennwortähnlicher Wert, der für Ihre App-Registrierung generiert wird, die für die sichere Authentifizierung verwendet wird. Wechseln Sie im Entra Admin Center zu Azure Active Directory App registrations. Wählen Sie Ihre registrierte App aus, wechseln Sie zu Zertifikaten & Geheimnisse. Erstellen Sie unter "Geheime Clientschlüssel" einen neuen geheimen Schlüssel, falls noch nicht geschehen. Kopieren Sie den Wert sofort, da er nicht erneut angezeigt wird)
- Verkäufer-ID (Dies ist Ihre eindeutige Herausgeber-/Verkäufer-ID in Microsoft Partner Center. Melden Sie sich bei Partner Center an. Wechseln Sie zu "Kontoeinstellungen" > Entwicklereinstellungen oder -bezeichner. Suchen Sie nach "Herausgeber-ID" oder "Verkäufer-ID".)
Diese werden in Ihrem GitHub Repository als geheime Schlüssel verwendet.

Einrichten von GitHub Actions zum Aktualisieren von Apps im Microsoft Store

Wenn Ihr Projekt bereits über ein GitHub Repository verfügt, können Sie es direkt zum Automatisieren von Microsoft Store-App-Updates verwenden.

In Ihrem GitHub-Repository wechseln Sie zu Settings>Secrets and variables>Actions>New Repository Secret.

Fügen Sie die folgenden geheimen Schlüssel hinzu:

AZURE_AD_APPLICATION_CLIENT_ID
AZURE_AD_APPLICATION_SECRET
AZURE_AD_TENANT_ID
SELLER_ID

Sie können App-Updates mithilfe von GitHub Actions für beide Arten von Apps automatisieren, MSIX und MSI/EXE. Wählen Sie den App-Typ aus, den Sie unten aktualisieren möchten:

MSIX
MSI/EXE

Fügen Sie das GitHub-Action-Workflow hinzu, um die Microsoft-GitHub-Action (microsoft-store-apppublisher) zum Veröffentlichen von Paket- und App-Metadatenaktualisierungen im Store aufzurufen.

Informationen zum Automatisieren von Paket- und Metadatenupdates mithilfe von GitHub Actions finden Sie im folgenden Video:

Für Paketupdates

Erstellen Sie unter github/workflows/AppPackageAutoUpdate.yml mithilfe des bereitgestellten Workflowausschnitts:

name: AppPackageAutoUpdate 
 
on: 
  push: 
    paths: 
      - 'release/package.msix' 
 
jobs: 
  build: 
    runs-on: windows-latest 
 
    steps: 
      - name: Checkout repository 
        uses: actions/checkout@v4 
 
      - name: Configure Microsoft Store CLI 
        uses: microsoft/microsoft-store-apppublisher@v1.1 
 
      - name: Reconfigure store credentials 
        run: msstore reconfigure ` 
              --tenantId ${{ secrets.AZURE_AD_TENANT_ID }} ` 
              --sellerId ${{ secrets.SELLER_ID }} ` 
              --clientId ${{ secrets.AZURE_AD_APPLICATION_CLIENT_ID }} ` 
              --clientSecret ${{ secrets.AZURE_AD_APPLICATION_SECRET }} 
 
      - name: Publish App package 
        run: msstore publish '${{ github.workspace }}/release/package.msix' -id <Store product Id>

Wenn "package.msix" als Teil des CI/CD-Flusses im Releaseordner aktualisiert wird, wird der AppPackageAutoUpdate.yml Workflow automatisch ausgelöst.

Für Metadatenaktualisierungen

Rufen Sie vor der erstmaligen Veröffentlichung von Metadatenupdates das JSON-Basismetadaten aus dem Partner Center für Ihre App-Einreichung ab. Dadurch wird sichergestellt, dass Sie mit der richtigen Struktur für Ihre App beginnen. Erstellen Sie also einen GitHub Actions Workflow unter .github/workflows/GetBaseMetadata.yml mithilfe des bereitgestellten Codeausschnitts:

name: GetBaseMetadata 
 
on: 
  workflow_dispatch: 
 
jobs: 
  build: 
    runs-on: windows-latest 
 
    steps: 
    - uses: actions/checkout@v3 
 
    - uses: microsoft/microsoft-store-apppublisher@v1.1 
 
    - name: Configure MSStore CLI 
      run: | 
        msstore reconfigure ` 
          --tenantId ${{ secrets.AZURE_AD_TENANT_ID }} ` 
          --sellerId ${{ secrets.SELLER_ID }} ` 
          --clientId ${{ secrets.AZURE_AD_APPLICATION_CLIENT_ID }} ` 
          --clientSecret ${{ secrets.AZURE_AD_APPLICATION_SECRET }} 
 
    - name: Get base metadata  
      shell: pwsh 
      run: | 
        msstore submission get <Store product Id>

Führen Sie diesen Workflow über die Registerkarte "Aktionen" in Ihrem GitHub Repository aus. Wählen Sie den relevanten Workflow aus, und klicken Sie auf "Workflow ausführen".

Nach Abschluss erhält der Workflow die Metadaten für Ihre App in den Buildprotokollen. Kopieren Sie dies, und erstellen Sie eine metadata.json Datei im Metadatenordner.

Erstellen Sie nun unter ".github/workflows/" AppMetadataAutoUpdate.yml mithilfe des bereitgestellten Workflowausschnitts:

name: AppMetadataAutoUpdate 
 
on: 
  push: 
    paths: 
      - 'metadata/metadata.json' 
 
jobs: 
  build: 
    runs-on: windows-latest 
 
    steps: 
      - name: Checkout repository 
        uses: actions/checkout@v4 
 
      - name: Configure Microsoft Store CLI 
        uses: microsoft/microsoft-store-apppublisher@v1.1 
 
      - name: Reconfigure store credentials 
        run: msstore reconfigure ` 
              --tenantId ${{ secrets.AZURE_AD_TENANT_ID }} ` 
              --sellerId ${{ secrets.SELLER_ID }} ` 
              --clientId ${{ secrets.AZURE_AD_APPLICATION_CLIENT_ID }} ` 
              --clientSecret ${{ secrets.AZURE_AD_APPLICATION_SECRET }} 
 
      - name: Update metadata 
        run: | 
          $metadata = Get-Content -Raw "${{ github.workspace }}/metadata/metadata.json" 
          msstore submission updateMetadata <Store product Id> $metadata
      - name: Publish to Store 
        run: msstore submission publish <Store product Id>

Wenn metadata.json im Rahmen des CI/CD-Flusses im Metadatenordner aktualisiert wird, wird der AppMetadataAutoUpdate.yml Workflow automatisch ausgelöst.

Die obigen Workflows führen im Hintergrund die folgenden Aktionen aus:

Aufrufen der GitHub-Aktion (microsoft-store-apppublisher)
Authentifizieren Sie Ihr Microsoft Store Partner Center-Konto mit den geheimen Schlüsseln, die Sie konfiguriert haben (Mandanten-ID, Client-ID, Geheimer Clientschlüssel, Verkäufer-ID).
Verwenden Sie die Microsoft Store Developer CLI (msstore), um Basismetadaten abzurufen und das aktualisierte Paket oder die aktualisierten Metadaten im Microsoft Store zu veröffentlichen.

Weitere Informationen zu Befehlen finden Sie unter Microsoft Store Developer CLI (MSIX).For more information on commands, refer Microsoft Store Developer CLI (MSIX).

Fügen Sie das GitHub Action Workflow hinzu, um die Microsoft GitHub-Aktion (microsoft-store-apppublisher) zum Veröffentlichen von Paket- und App-Metadaten-Updates im Store auszulösen.

Für Paketupdates

Bevor Sie Updates zum ersten Mal veröffentlichen, rufen Sie das Basispaket-JSON aus Partner Center für Ihre App-Übermittlung ab. Dadurch wird sichergestellt, dass Sie mit der richtigen Struktur für Ihre App beginnen. Erstellen Sie also einen GitHub Actions Workflow unter .github/workflows/GetBasePackage.yml mithilfe des bereitgestellten Codeausschnitts:

name: GetBasePackage 
 
on: 
  workflow_dispatch: 
 
jobs: 
  build: 
    runs-on: windows-latest 
 
    steps: 
    - uses: actions/checkout@v3 
 
    - uses: microsoft/microsoft-store-apppublisher@v1.1 
 
    - name: Configure MSStore CLI 
      run: | 
        msstore reconfigure ` 
          --tenantId ${{ secrets.AZURE_AD_TENANT_ID }} ` 
          --sellerId ${{ secrets.SELLER_ID }} ` 
          --clientId ${{ secrets.AZURE_AD_APPLICATION_CLIENT_ID }} ` 
          --clientSecret ${{ secrets.AZURE_AD_APPLICATION_SECRET }} 
 
    - name: Get base package info 
      shell: pwsh 
      run: | 
        msstore submission get <Partner center Id>

Führen Sie diesen Workflow über die Registerkarte "Aktionen" in Ihrem GitHub Repository aus. Wählen Sie den relevanten Workflow aus, und klicken Sie auf "Workflow ausführen".

Nach Abschluss erhält der Workflow die Paketinformationen für Ihre App in den Buildprotokollen. Kopieren Sie dies, und erstellen Sie eine package.json Datei im Releaseordner.

Erstellen Sie nun unter ".github/workflows/" AppPackageAutoUpdate.yml mithilfe des bereitgestellten Workflowausschnitts:

name: AppPackageAutoUpdate 
 
on: 
  push: 
    paths: 
      - 'release/package.json' 
 
jobs: 
  build: 
    runs-on: windows-latest 
 
    steps: 
      - name: Checkout repository 
        uses: actions/checkout@v4 
 
      - name: Configure Microsoft Store CLI 
        uses: microsoft/microsoft-store-apppublisher@v1.1 
 
      - name: Reconfigure store credentials 
        run: msstore reconfigure ` 
              --tenantId ${{ secrets.AZURE_AD_TENANT_ID }} ` 
              --sellerId ${{ secrets.SELLER_ID }} ` 
              --clientId ${{ secrets.AZURE_AD_APPLICATION_CLIENT_ID }} ` 
              --clientSecret ${{ secrets.AZURE_AD_APPLICATION_SECRET }} 
       
      - name: Update package 
        run: |- 
            $updatedPackage = Get-Content -Raw "${{ github.workspace }}/release/package.json" 
            msstore submission update <Partner center Id> $updatedPackage 
      - name: Publish Submission 
        run: |- 
            msstore submission publish <Partner center Id>

Wenn die package.json im Rahmen des CI/CD-Flusses im Releaseordner aktualisiert wird, wird der AppPackageAutoUpdate.yml Workflow automatisch ausgelöst.

Für Metadatenaktualisierungen

Rufen Sie als Nächstes für die Metadaten die Basismetadaten-JSON im Partner Center für Ihre App-Einreichung ab, indem Sie einen GitHub Actions-Workflow unter .github/workflows/GetBaseMetadata.yml mithilfe eines bereitgestellten Codeausschnitts erstellen.

name: GetBaseMetadata 
 
on: 
  workflow_dispatch: 
 
jobs: 
  build: 
    runs-on: windows-latest 
 
    steps: 
    - uses: actions/checkout@v3 
 
    - uses: microsoft/microsoft-store-apppublisher@v1.1 
 
    - name: Configure MSStore CLI 
      run: | 
        msstore reconfigure ` 
          --tenantId ${{ secrets.AZURE_AD_TENANT_ID }} ` 
          --sellerId ${{ secrets.SELLER_ID }} ` 
          --clientId ${{ secrets.AZURE_AD_APPLICATION_CLIENT_ID }} ` 
          --clientSecret ${{ secrets.AZURE_AD_APPLICATION_SECRET }} 
 
    - name: Get base metadata for a specific module 
      shell: pwsh 
      run: | 
        msstore submission get <Partner center Id> -m <module name>

Führen Sie diesen Workflow über die Registerkarte "Aktionen" in Ihrem GitHub Repository aus. Wählen Sie den relevanten Workflow aus, und klicken Sie auf "Workflow ausführen".

Nach Abschluss erhält der Workflow die Metadaten für das angegebene Modul für Ihre App in den Buildprotokollen. Kopieren Sie dies, und erstellen Sie eine metadata.json Datei im Metadatenordner.

Erstellen Sie nun unter ".github/workflows/" AppMetadataAutoUpdate.yml mithilfe des bereitgestellten Workflowausschnitts:

name: AppMetadataAutoUpdate 
 
on: 
  push: 
    paths: 
      - 'metadata/metadata.json' 
 
jobs: 
  build: 
    runs-on: windows-latest 
 
    steps: 
      - name: Checkout repository 
        uses: actions/checkout@v4 
 
      - name: Configure Microsoft Store CLI 
        uses: microsoft/microsoft-store-apppublisher@v1.1 
 
      - name: Reconfigure store credentials 
        run: msstore reconfigure ` 
              --tenantId ${{ secrets.AZURE_AD_TENANT_ID }} ` 
              --sellerId ${{ secrets.SELLER_ID }} ` 
  --clientId ${{ secrets.AZURE_AD_APPLICATION_CLIENT_ID }} ` 
              --clientSecret ${{ secrets.AZURE_AD_APPLICATION_SECRET }} 
 
      - name: Update metadata 
        run: | 
          $metadata = Get-Content -Raw "${{ github.workspace }}/metadata/metadata.json" 
          msstore submission updateMetadata <Partner center Id> $metadata  
      - name: Publish updated metadata 
        run: | 
          msstore submission publish <Partner center Id>

Wenn metadata.json im Rahmen des CI/CD-Flusses im Metadatenordner aktualisiert wird, wird der AppMetadataAutoUpdate.yml Workflow automatisch ausgelöst.

Die obigen Workflows führen im Hintergrund die folgenden Aktionen aus:

Rufen Sie die GitHub-Aktion (microsoft-store-apppublisher) auf
Authentifizieren Sie Ihr Microsoft Store Partner Center-Konto mit den geheimen Schlüsseln, die Sie konfiguriert haben (Mandanten-ID, Client-ID, Geheimer Clientschlüssel, Verkäufer-ID).
Verwenden Sie die Microsoft Store Developer CLI (msstore), um Basispaketinformationen und Metadaten abzurufen und das aktualisierte Paket oder die aktualisierten Metadaten im Microsoft Store zu veröffentlichen.

Weitere Informationen zu Befehlen finden Sie unter Microsoft Store Developer CLI (MSI/EXE).For more information on commands, refer Microsoft Store Developer CLI (MSI/EXE).

Nachdem Ihr GitHub Actions Workflow erfolgreich abgeschlossen wurde, überprüfen Sie den Microsoft Store, um zu bestätigen, dass Ihre Änderungen live sind. Updates werden angezeigt, nachdem der Zertifizierungsprozess im Partner Center abgeschlossen ist.

Wir vertrauen darauf, dass dieses Dokument die Effizienz und Zuverlässigkeit Ihres Microsoft Store-Updateprozesses erheblich verbessern wird. Indem Sie diese bewährten Methoden ausführen, können Sie die Veröffentlichung von Apps optimieren und eine konsistente, qualitativ hochwertige Veröffentlichung sicherstellen.

Feedback

War diese Seite hilfreich?

Last updated on 2026-03-11

Veröffentlichen von App-Updates im Microsoft Store mit GitHub Actions

Voraussetzung

Einrichten von GitHub Actions zum Aktualisieren von Apps im Microsoft Store

Für Paketupdates

Für Metadatenaktualisierungen

Feedback

Zusätzliche Ressourcen