Publicando atualizações de aplicativos na Microsoft Store com GitHub Actions

Adicione o workflow do GitHub Action para invocar a ação do Microsoft GitHub (microsoft-store-apppublisher) para publicar atualizações de pacotes e metadados dos aplicativos na loja.

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

Para atualizações de pacote

Em .github/fluxos de trabalho/, crie AppPackageAutoUpdate.yml usando o snippet 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 lançamento, o fluxo de trabalho AppPackageAutoUpdate.yml é disparado automaticamente.

Para atualizações de metadados

Antes de publicar atualizações de metadados pela primeira vez, obtenha o JSON de metadados base do Partner Center para o envio do aplicativo. Isso garante que você comece com a estrutura correta para seu aplicativo. Portanto, crie um fluxo de trabalho GitHub Actions em .github/fluxos de trabalho/GetBaseMetadata.yml usando o snippet 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>

Execute esse fluxo de trabalho na guia Ações em seu 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 do aplicativo nos logs de build. Copie isso e crie um arquivo metadata.json na pasta de metadados.

Agora, em .github/fluxos de trabalho/, crie AppMetadataAutoUpdate.yml usando o snippet 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 for atualizado como parte do fluxo de CI/CD na pasta de metadados, ele disparará 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 configurados (ID do locatário, ID do cliente, segredo do cliente, ID do vendedor).
• Use a CLI do Desenvolvedor da Microsoft Store (msstore) para obter metadados base e publicar o pacote ou metadados atualizados na Microsoft Store.

Para obter mais informações sobre comandos, consulte a CLI do Desenvolvedor da Microsoft Store (MSIX).

Adicione o workflow do GitHub Action para invocar a ação do Microsoft GitHub (microsoft-store-apppublisher) para publicar atualizações de pacotes e metadados dos aplicativos na loja.

Para atualizações de pacote

Antes de publicar atualizações pela primeira vez, obtenha o JSON do pacote base no Partner Center para o envio do aplicativo. Isso garante que você comece com a estrutura correta para seu aplicativo. Portanto, crie um fluxo de trabalho GitHub Actions em .github/fluxos de trabalho/GetBasePackage.yml usando o snippet 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>

Execute esse fluxo de trabalho na guia Ações em seu 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 seu aplicativo nos logs de build. Copie isso e crie um arquivo package.json na pasta de lançamento.

Agora, em .github/fluxos de trabalho/, crie AppPackageAutoUpdate.yml usando o snippet 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 de CI/CD na pasta de lançamento, o fluxo de trabalho AppPackageAutoUpdate.yml é disparado automaticamente.

Para atualizações de metadados

Em seguida, para metadados, obtenha o JSON de metadados base do Partner Center para o envio do aplicativo criando um fluxo de trabalho GitHub Actions em .github/workflows/GetBaseMetadata.yml usando o snippet 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>

Execute esse fluxo de trabalho na guia Ações em seu 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 do módulo especificado para seu aplicativo nos logs de build. Copie isso e crie um arquivo metadata.json na pasta de metadados.

Agora, em .github/fluxos de trabalho/, crie AppMetadataAutoUpdate.yml usando o snippet 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 for atualizado como parte do fluxo de CI/CD na pasta de metadados, ele disparará 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 configurados (ID do locatário, ID do cliente, segredo do cliente, ID do vendedor).
• Use a CLI de desenvolvedor da Microsoft Store (msstore) para obter informações e metadados do pacote base e publicar o pacote ou os metadados atualizados na Microsoft Store.

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