Publicar atualizações de aplicações na Microsoft Store com GitHub Actions

Add the GitHub Action Workflow para invocar a ação Microsoft GitHub (microsoft-store-apppublisher) para publicar atualizações de metadados de pacotes e aplicativos na loja.

Para perceber como automatizar atualizações de pacotes e metadados usando o GitHub Actions, veja o seguinte vídeo:

Para atualizações de pacotes

Em .github/workflows/, crie AppPackageAutoUpdate.yml usando o trecho de fluxo de trabalho fornecido:

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>

Quando o package.msix é atualizado como parte do fluxo CI/CD na pasta de versão, o fluxo de trabalho AppPackageAutoUpdate.yml é acionado automaticamente.

Para atualizações de metadados

Antes de publicar atualizações de metadados pela primeira vez, obtenha o JSON de metadados básicos do Partner Center para o envio do seu aplicativo. Isso garante que você comece com a estrutura correta para seu aplicativo. Assim, crie um fluxo de trabalho GitHub Actions em .github/workflows/GetBaseMetadata.yml usando o excerto fornecido:

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>

Executa este fluxo de trabalho a partir do separador Ações no teu repositório GitHub. Selecione o fluxo de trabalho relevante e clique em Executar fluxo de trabalho.

Após a conclusão, o fluxo de trabalho obterá os metadados para seu aplicativo nos logs de compilação. Copie isso e crie um arquivo metadata.json na pasta de metadados.

Agora, em .github/workflows/, crie AppMetadataAutoUpdate.yml usando o trecho de fluxo de trabalho fornecido:

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>

Quando metadata.json é atualizado como parte do fluxo de CI/CD na pasta de metadados, ele aciona automaticamente o fluxo de trabalho AppMetadataAutoUpdate.yml.

Os fluxos de trabalho acima farão o seguinte em segundo plano:

• Invocar a ação do GitHub (microsoft-store-apppublisher)
• Autentique sua conta do Microsoft Store Partner Center usando os segredos que você configurou (ID do Locatário, ID do Cliente, Segredo do Cliente, ID do Vendedor).
• Use a Microsoft Store Developer CLI (msstore) para obter metadados básicos e publicar o pacote ou metadados atualizados na Microsoft Store.

Para obter mais informações sobre comandos, consulte Microsoft Store Developer CLI (MSIX).

Add the GitHub Action Workflow para invocar a ação Microsoft GitHub (microsoft-store-apppublisher) para publicar atualizações de metadados de pacotes e aplicativos na loja.

Para atualizações de pacotes

Antes de publicar atualizações pela primeira vez, obtenha o JSON do pacote base do Partner Center para o envio do seu aplicativo. Isso garante que você comece com a estrutura correta para seu aplicativo. Assim, crie um fluxo de trabalho GitHub Actions em .github/workflows/GetBasePackage.yml usando o excerto fornecido:

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>

Executa este fluxo de trabalho a partir do separador Ações no teu repositório GitHub. Selecione o fluxo de trabalho relevante e clique em Executar fluxo de trabalho.

Após a conclusão, o fluxo de trabalho obterá as informações do pacote para o seu aplicativo nos registos de construção. Copie isso e crie um arquivo package.json na pasta de versão.

Agora, em .github/workflows/, crie AppPackageAutoUpdate.yml usando o trecho de fluxo de trabalho fornecido:

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>

Quando o package.json é atualizado como parte do fluxo CI/CD na pasta de versão, o fluxo de trabalho AppPackageAutoUpdate.yml é acionado automaticamente.

Para atualizações de metadados

De seguida, para metadados, obtenha o JSON base dos metadados do Partner Center para a submissão da sua aplicação, criando um fluxo de trabalho de GitHub Actions no repositório .github/workflows/GetBaseMetadata.yml, usando o excerto fornecido.

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>

Executa este fluxo de trabalho a partir do separador Ações no teu repositório GitHub. Selecione o fluxo de trabalho relevante e clique em Executar fluxo de trabalho.

Após a conclusão, o fluxo de trabalho obterá os metadados para o módulo especificado para seu aplicativo nos logs de compilação. Copie isso e crie um arquivo metadata.json na pasta de metadados.

Agora, em .github/workflows/, crie AppMetadataAutoUpdate.yml usando o trecho de fluxo de trabalho fornecido:

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>

Quando metadata.json é atualizado como parte do fluxo de CI/CD na pasta de metadados, ele aciona automaticamente o fluxo de trabalho AppMetadataAutoUpdate.yml.

Os fluxos de trabalho acima farão o seguinte em segundo plano:

• Invocar a ação do GitHub (microsoft-store-apppublisher)
• Autentique sua conta do Microsoft Store Partner Center usando os segredos que você configurou (ID do Locatário, ID do Cliente, Segredo do Cliente, ID do Vendedor).
• Utilize o Microsoft Store Developer CLI (msstore) para obter informações do pacote base e metadados e publicar o pacote ou metadados atualizados na Microsoft Store.

Para obter mais informações sobre comandos, consulte Microsoft Store Developer CLI (MSI/EXE).