PKR-Lab

Releases

Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ios/releases.md

Releases

Releases entstehen automatisch aus den Commit-Nachrichten. Der Prozess ist in allen Repos von pkr-lab gleich und läuft über die wiederverwendbaren Workflows im Repo pkr-lab/.github, beschrieben unter github-workflows.

Ablauf

  1. Änderungen kommen per Pull Request nach main. Der Check commitlint prüft, dass alle Commits des Pull Requests dem Format Conventional Commits folgen.
  2. Jeder Push auf main startet .github/workflows/release.yml. Der Workflow ruft den zentralen Release-Workflow auf (semantic-release).
  3. semantic-release bestimmt aus den Commits seit dem letzten Tag die nächste Version nach SemVer, schreibt CHANGELOG.md fort (Commit chore(release): X.Y.Z [skip ci]), setzt den Git-Tag vX.Y.Z und veröffentlicht ein GitHub-Release mit Release Notes.
Commit Wirkung
fix: Patch (1.2.3 → 1.2.4)
feat: Minor (1.2.3 → 1.3.0)
feat!: oder BREAKING CHANGE: im Footer Major (1.2.3 → 2.0.0)
docs:, chore:, refactor:, test:, ci:, build:, perf:, style: kein Release

Format: <typ>(<scope>): <beschreibung>, Der Typ und der Scope sind kleingeschrieben, die Beschreibung endet ohne Punkt, die Kopfzeile ist höchstens 120 Zeichen lang. Lokal prüft der Hook .githooks/commit-msg dasselbe; aktivieren mit git config core.hooksPath .githooks.

Versionen

Die Versionierung beginnt bei v1.0.0. Die Marketing-Version der App kommt aus dem letzten Tag: Das Build-Skript „Version aus Git-Tag“ (postBuildScripts in project.yml) schreibt ihn in CFBundleShortVersionString. Ohne Tag (z. B. flacher Klon) bleibt MARKETING_VERSION (1.0.0) stehen; die CI holt deshalb die volle Historie.

Artefakte

Keine Dateien am Release. Eine signierte App-Datei (.ipa) entsteht nicht in der CI, weil Signaturschlüssel und Apple-Developer-Zugang fehlen; der Build für TestFlight läuft lokal in Xcode.

Änderungsprotokoll

CHANGELOG.md im Repo und die GitHub Releases.