Plugin: updater-pubspec

Aktualisiert das oberste version:-Feld in pubspec.yaml für Dart- und Flutter-Projekte und unterstützt konfigurierbare Strategien für das Flutter-+build-Suffix (none, increment oder release-count).

Installation

Binärdatei

semrel plugin install @semrel/updater-pubspec

semrel plugin install lädt die Binärdatei nach .semrel/plugins/ herunter und aktualisiert .semrel.lock. Committe .semrel.lock, um die Version für dein Team festzuschreiben.

Docker

Vorgefertigte, signierte Multi-Plattform-Images (linux/amd64, linux/arm64) werden bei jedem Release veröffentlicht:

docker pull ghcr.io/semrels/updater-pubspec:latest

Überprüfe die Image-Signatur mit cosign:

cosign verify ghcr.io/semrels/updater-pubspec:latest \
  --certificate-identity-regexp 'https://github.com/SemRels/updater-pubspec/.github/workflows/release.yml.*' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

Konfiguration

version: 1
plugins:
  - uses: @semrel/updater-pubspec
    phase: pre-tag
    args:
      pubspec_path: pubspec.yaml
      pubspec_build_strategy: increment

Umgebungsvariablen

Name	Erforderlich	Standard	Beschreibung
`SEMREL_PLUGIN_PUBSPEC_PATH`	nein	`./pubspec.yaml`	Pfad zur zu aktualisierenden `pubspec.yaml`-Datei.
`SEMREL_PLUGIN_PUBSPEC_BUILD_STRATEGY`	nein	`none`	Strategie für das Build-Suffix: `none`, `increment` oder `release-count`.
`SEMREL_PLUGIN_PUBSPEC_BUILD_NUMBER`	nein	`—`	Explizite Build-Nummer (`<semver>+<nummer>`).

Release-Kontextvariablen

SEMREL_VERSION
SEMREL_NEXT_VERSION
SEMREL_DRY_RUN
SEMREL_RELEASE_COUNT
SEMREL_BUILD_NUMBER

Verhalten

Das Plugin ersetzt gezielt nur die oberste version:-Zeile, sodass Kommentare, Einrückungen und Abhängigkeitsblöcke in pubspec.yaml unverändert bleiben:

none (Standard): Schreibt die reine SemVer-Version (z. B. version: 1.5.0).
increment: Erhöht das bestehende +build-Suffix um 1 (z. B. 1.4.0+42 → 1.5.0+43) oder startet bei +1.
release-count: Verwendet SEMREL_PLUGIN_PUBSPEC_BUILD_NUMBER, SEMREL_RELEASE_COUNT oder SEMREL_BUILD_NUMBER (mit Fallback auf bestehend + 1).

Quelle

SemRels/updater-pubspec