Automatické vydání nové verze PHP SDK krok za krokem

1. Založíte si účet na Packagistu a zaregistrujete své SDK.
2. Bezpečně uložíte uživatelské jméno a API token z Packagistu do GitHubu.
3. Nastavíte GitHub Action, který každou novou verzi SDK vydá a zveřejní.

1. Otevřete sekci Profile na Packagistu. Uživatelské jméno najdete nahoře na stránce. Klikněte na Show API Token a token zkopírujte.
2. Otevřete svůj projekt na GitHubu. Přejděte do Settings > Security > Secrets and Variables > Actions a klikněte na „New repository secret“.
3. Do pole Name napište PACKAGIST_USERNAME.
4. Do pole Secret zadejte své uživatelské jméno z Packagistu. Potvrďte tlačítkem „Add secret“.
5. Vytvořte ještě jeden secret. Tentokrát do pole Name napište PACKAGIST_TOKEN a do pole Secret vložte token, který jste zkopírovali v kroku 1. Secret přidejte.

1. V repozitáři na GitHubu přejděte do Settings > Actions > General a zaškrtněte volbu „Allow GitHub Actions to create and approve pull requests“.

1. V kořenovém adresáři projektu vytvořte složku .github/workflows/. Sem patří konfigurační soubory pro GitHub Actions.
2. V této složce vytvořte nový YAML soubor. Pojmenujte ho release-and-publish.yml.
3. Do konfiguračního souboru zkopírujte následující kód:

# This workflow opens and updates a pull request with a new package version
# based on code changes. Merging the pull request updates the version in
# composer.json, updates the changelog and creates release tags.
# This workflow also publishes the package into the Packagist repository after
# a new version has been released.

# https://github.com/marketplace/actions/release-please-action

on:
  push:
    branches:
      - master

permissions:
  contents: write
  pull-requests: write

name: release-please

jobs:
  release-please:
    runs-on: ubuntu-22.04
    steps:
      - uses: google-github-actions/release-please-action@v3.7.10
        with:
          release-type: php
          package-name: release-please-action
          pull-request-title-pattern: "chore(release): ${version}"
          pull-request-header: ":robot: Merge this PR to release a new version"

  publish-package:
    # after merging the pull request, a release tag first has to be created
    # in the release-please job above, before the publish job starts
    needs: release-please
    if: contains(github.event.head_commit.message, 'chore(release)')
    runs-on: ubuntu-22.04
    steps:
      - uses: actions/checkout@v3.5.3
      - uses: hotaruma/packagist-sync@v1.0.1
        with:
          packagist-username: ${{ secrets.PACKAGIST_USERNAME }}
          api-token: ${{ secrets.PACKAGIST_TOKEN }}

1. Ujistěte se, že composer.json obsahuje vlastnost s verzí (například "version": "1.0.0"). release-please tuto vlastnost aktualizuje automaticky pokaždé, když mergnete pull request s novou verzí, takže aktuální verzi SDK přečtete přímo z kódu.

2. Tyto změny zacommitujte a nahrajte na GitHub. Tím je workflow hotové. Až příště někdo přidá něco vydatelného s commit zprávou podle konvence (prefix fix: nebo feat:), release-please otevře pull request. Jak přidáváte další kód, automaticky tento pull request aktualizuje. Až budete připraveni vydat novou verzi SDK, pull request mergnete. Verze se vydá a aktualizované SDK se zveřejní na Packagistu.

---

• Automatické vydání pro JavaScript
• Automatické vydání pro Ruby
• Prohlédněte si náš nástroj, který automatizuje všechny technologie najednou

---

• Co je to SDK a jak pomůže vašemu byznysu?
• Proč váš produkt potřebuje SDK