Alkalmazásfrissítések közzététele a Microsoft Store-ban a GitHub Actions használatával

Megjegyzés:

Az alkalmazásfrissítési műveletek a GitHub-műveleteken keresztül jelenleg csak az ingyenes termékek esetében támogatottak. A fizetős termékek egy későbbi kiadásban támogatottak lesznek.

A GitHub Actions lehetővé teszi egy robusztus CI/CD-folyamat implementálását a Microsoft Store-alkalmazásokhoz. A buildelési, tesztelési és üzembe helyezési lépések közvetlenül a kódtárból történő automatizálásával biztosíthatja, hogy minden módosítás , legyen szó hibajavításról, funkciófrissítésről vagy metaadatok módosításáról, érvényesítve és biztonságosan közzé legyen téve a Microsoft Store-ban.

Az alkalmazásfrissítési folyamat előfeltételeinek beállításához tekintse meg az alábbi videót:

Előfeltétel

1. Regisztráljon Windows-alkalmazásfejlesztőként a Partnerközpontban.

2. Legyen egy bérlő társítva a Partnerközpont-fiókjához. Ezt úgy érheti el, hogy társít egy meglévő Microsoft Entra-azonosítót a Partnerközpontban , vagy létrehoz egy új Microsoft Entra-azonosítót a Partnerközpontban.

3. Regisztráljon egy alkalmazást a Microsoft Entra azonosítójában.

4. Ezután a Partnerközpont Fiókbeállítások szakaszÁnak Felhasználókezelés lapjának Microsoft Entra-alkalmazások lapján adja hozzá azt a Microsoft Entra-azonosító alkalmazást, amely azt az alkalmazást vagy szolgáltatást jelöli, amelyet a Partnerközpont-fiókhoz tartozó beküldések eléréséhez használni fog. Győződjön meg arról, hogy ezt az alkalmazást a Manager szerepkörhöz rendeli.

5. A frissíteni kívánt alkalmazásnak már közzétéve kell lennie, és elérhetőnek kell lennie a Microsoft Store-ban.

6. Szükséges azonosítók és titkos kódok:

   • Bérlőazonosító (Ez a Microsoft Entra-bérlő egyedi azonosítója. Ugrás a kívánt elemre https://entra.microsoft.com/. Lépjen az Azure Active Directory > áttekintésére. Másolja ki a "Bérlőazonosító" értéket.)
   • Ügyfélazonosító (Ez a létrehozott alkalmazásregisztráció alkalmazásazonosítója. Az Entra Felügyeleti központban nyissa meg az Azure Active Directory-alkalmazásregisztrációkat > . Válassza ki a regisztrált alkalmazást. Másolja ki az "alkalmazásazonosítót".) API-hozzáféréshez. Az Entra Felügyeleti központban nyissa meg az Azure Active Directory-alkalmazásregisztrációkat > . Válassza ki a regisztrált alkalmazást. Másolja ki az "alkalmazásazonosítót".)
   • Titkos ügyfélkód (Ez az alkalmazásregisztrációhoz létrehozott jelszóhoz hasonló érték, amelyet a biztonságos hitelesítéshez használnak. Az Entra Felügyeleti központban nyissa meg az Azure Active Directory-alkalmazásregisztrációkat > . Válassza ki a regisztrált alkalmazást, és lépjen a Tanúsítványok > titkos kódok elemre. Az "Ügyféltitkok" területen hozzon létre egy új titkos kulcsot, ha még nem tette meg. Másolja ki azonnal az értéket, mert az nem jelenik meg újra)
   • Eladó azonosítója (Ez a Microsoft Partnerközpontban található egyedi közzétevői/értékesítői azonosító. Jelentkezzen be a Partnerközpontba. Nyissa meg a Fiókbeállítások > fejlesztői beállításait vagy azonosítóit. Keresse meg a "Közzétevő azonosítója" vagy az "Eladó azonosítója" kifejezést.)

   Ezek titkos kulcsként lesznek használva a GitHub-adattárban.

A GitHub Actions beállítása alkalmazások frissítéséhez a Microsoft Store-ban

Ha a projekt már rendelkezik GitHub-adattárral, közvetlenül használhatja a Microsoft Store alkalmazásfrissítéseinek automatizálásához.

A GitHub-adattárban lépjen a Beállítások>titkos kulcsok és változók> ActionsNew Repository Secret (Új tárház titkos> elemre.

Adja hozzá a következő titkos kódokat:

• AZURE_AD_APPLICATION_CLIENT_ID
• AZURE_AD_APPLICATION_SECRET
• AZURE_AD_TENANT_ID
• SELLER_ID

Az alkalmazásfrissítéseket a GitHub Actions használatával automatizálhatja mindkét alkalmazástípushoz, az MSIX-hez és az MSI/EXE-hez. Válassza ki az alább frissíteni kívánt alkalmazástípust:

MSIX

Adja hozzá a GitHub Munkafolyamatot a Microsoft GitHub-művelet (microsoft-store-apppublisher) meghívásához, hogy a csomag- és alkalmazás metaadat-frissítéseket közzétegye az áruházban.

Ha szeretné megtudni, hogyan automatizálhatja a csomag- és metaadat-frissítéseket a GitHub Actions használatával, tekintse meg az alábbi videót:

Csomagfrissítések esetén

A .github/workflows/ területen hozzon létre AppPackageAutoUpdate.yml a megadott munkafolyamat-kódrészlet használatával:

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>

Ha a package.msix a ci/CD-folyamat részeként frissül a kiadási mappában, a AppPackageAutoUpdate.yml munkafolyamat automatikusan aktiválódik.

Metaadat-frissítések esetén

A metaadat-frissítések első közzététele előtt szerezze be az alapszintű JSON-metaadatokat a Partnerközpontból az alkalmazásbeküldéshez. Ez biztosítja, hogy az alkalmazás megfelelő struktúrájával kezdjen. Ezért hozzon létre egy GitHub Actions-munkafolyamatot a .github/workflows/GetBaseMetadata.yml alatt a megadott kódrészlet használatával:

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>

Futtassa ezt a munkafolyamatot a GitHub-adattár Műveletek lapján. Válassza ki a megfelelő munkafolyamatot, és kattintson a Munkafolyamat futtatása parancsra.

A folyamat befejezése után a munkafolyamat lekérte az alkalmazás metaadatait a buildnaplókban. Másolja ki ezt a fájlt, és hozzon létre egy metadata.json fájlt a metaadatmappában.

Most a .github/workflows/területen hozzon létre AppMetadataAutoUpdate.yml a megadott munkafolyamat-kódrészlet használatával:

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>

Ha metadata.json a metaadatok mappájában lévő CI/CD-folyamat részeként frissül, az automatikusan elindítja a AppMetadataAutoUpdate.yml munkafolyamatot.

A fenti munkafolyamatok a következő műveleteket hajtják végre a háttérben:

• Hívd meg a GitHub-műveletet (microsoft-store-apppublisher)
• Hitelesítse Microsoft Store Partnerközpont-fiókját a konfigurált titkos kulcsokkal (bérlőazonosító, ügyfélazonosító, ügyfélkód, eladóazonosító).
• A Microsoft Store fejlesztői parancssori felületével (msstore) szerezheti be az alap metaadatokat, és közzéteheti a frissített csomagot vagy metaadatokat a Microsoft Store-ban.

A parancsokkal kapcsolatos további információkért tekintse meg a Microsoft Store fejlesztői parancssori felületét (MSIX).

MSI/EXE

Adja hozzá a GitHub Munkafolyamatot a Microsoft GitHub-művelet (microsoft-store-apppublisher) meghívásához, hogy a csomag- és alkalmazás metaadat-frissítéseket közzétegye az áruházban.

Csomagfrissítések esetén

A frissítések első közzététele előtt szerezze be a JSON alapcsomagot a Partnerközpontból az alkalmazásbeküldéshez. Ez biztosítja, hogy az alkalmazás megfelelő struktúrájával kezdjen. Ezért hozzon létre egy GitHub Actions-munkafolyamatot a .github/workflows/GetBasePackage.yml alatt a megadott kódrészlet használatával:

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>

Futtassa ezt a munkafolyamatot a GitHub-adattár Műveletek lapján. Válassza ki a megfelelő munkafolyamatot, és kattintson a Munkafolyamat futtatása parancsra.

A folyamat befejezése után a munkafolyamat beolvasja az alkalmazás csomagadatait a buildnaplókban. Másolja ki ezt a fájlt, és hozzon létre egy package.json fájlt a kiadási mappában.

Most a .github/workflows/ területen hozzon létre AppPackageAutoUpdate.yml a megadott munkafolyamat-kódrészlet használatával:

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>

Ha a package.json a kiadási mappában lévő CI/CD-folyamat részeként frissül, a AppPackageAutoUpdate.yml munkafolyamat automatikusan aktiválódik.

Metaadat-frissítések esetén

Ezután a metaadatokhoz szerezze be a JSON alapszintű metaadatokat a Partnerközpontból az alkalmazásbeküldéshez, ha létrehoz egy GitHub Actions-munkafolyamatot a .github/workflows/GetBaseMetadata.yml alatt a megadott kódrészlet használatával:

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>

Futtassa ezt a munkafolyamatot a GitHub-adattár Műveletek lapján. Válassza ki a megfelelő munkafolyamatot, és kattintson a Munkafolyamat futtatása parancsra.

A folyamat befejezése után a munkafolyamat a buildnaplókban lekérte az alkalmazáshoz megadott modul metaadatait. Másolja ki ezt a fájlt, és hozzon létre egy metadata.json fájlt a metaadatmappában.

Most a .github/workflows/területen hozzon létre AppMetadataAutoUpdate.yml a megadott munkafolyamat-kódrészlet használatával:

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>

Ha metadata.json a metaadatok mappájában lévő CI/CD-folyamat részeként frissül, az automatikusan elindítja a AppMetadataAutoUpdate.yml munkafolyamatot.

A fenti munkafolyamatok a következő műveleteket hajtják végre a háttérben:

• Hívd meg a GitHub-műveletet (microsoft-store-apppublisher)
• Hitelesítse Microsoft Store Partnerközpont-fiókját a konfigurált titkos kulcsokkal (bérlőazonosító, ügyfélazonosító, ügyfélkód, eladóazonosító).
• A Microsoft Store fejlesztői parancssori felületével (msstore) beszerezheti az alapcsomag adatait és metaadatait, és közzéteheti a frissített csomagot vagy metaadatokat a Microsoft Store-ban.

A parancsokkal kapcsolatos további információkért tekintse meg a Microsoft Store fejlesztői parancssori felületét (MSI/EXE).

Miután a GitHub Actions-munkafolyamat sikeresen befejeződött, ellenőrizze a Microsoft Store-ban, hogy a módosítások élőben vannak-e. A frissítések a Partnerközpontban végzett minősítési folyamat befejezése után jelennek meg.

Bízunk benne, hogy ez a dokumentum jelentősen javítja a Microsoft Store frissítési folyamatának hatékonyságát és megbízhatóságát. Az ajánlott eljárások követésével egyszerűsítheti az alkalmazások közzétételét, és egységes, kiváló minőségű kiadási élményt biztosíthat.