Mac App Release
Verwenden für BlackBar, RepoBar, CodexBar, Trimmy und ähnliche macOS-Apps, die mit Sparkle aktualisiert werden.
Regeln
- Arbeite im App-Repository.
- Lese
.mac-release.env; es ist das repositoreigene Release-Manifest. - Verwende
scripts/mac-releaseaus dieser Fähigkeit für gemeinsame Release-/Appcast-/Verifizierungsarbeiten. - Behalte app-spezifisches Build-/Package-/Signierverhalten in Repo-Skripten, es sei denn, es wird bereits durch das Manifest gesteuert.
- Gib niemals privates Schlüsselmaterial aus.
- Bevorzuge das Signieren mit dem macOS-Schlüsselbund.
SPARKLE_PRIVATE_KEY_FILEist nur eine explizite Überschreibung.
Befehle
/Users/steipete/Projects/agent-scripts/skills/release-mac-app/scripts/mac-release status
/Users/steipete/Projects/agent-scripts/skills/release-mac-app/scripts/mac-release notes [version] [output.md]
/Users/steipete/Projects/agent-scripts/skills/release-mac-app/scripts/mac-release changelog-html <version> [CHANGELOG.md]
/Users/steipete/Projects/agent-scripts/skills/release-mac-app/scripts/mac-release make-appcast <zip> [feed-url]
/Users/steipete/Projects/agent-scripts/skills/release-mac-app/scripts/mac-release verify-appcast [version]
/Users/steipete/Projects/agent-scripts/skills/release-mac-app/scripts/mac-release check-assets [tag]
/Users/steipete/Projects/agent-scripts/skills/release-mac-app/scripts/mac-release release
/Users/steipete/Projects/agent-scripts/skills/release-mac-app/scripts/mac-release codesign-run [--with-package-secrets] -- <command> [args...]
Manifest
Jedes Repository besitzt .mac-release.env. Es darf keine Geheimnisse enthalten.
Erforderlich:
MAC_RELEASE_APP_NAMEMAC_RELEASE_REPOMAC_RELEASE_BUNDLE_IDMAC_RELEASE_VERSION_FILEMAC_RELEASE_APPCASTMAC_RELEASE_FEED_URLMAC_RELEASE_DOWNLOAD_URL_PREFIXMAC_RELEASE_APP_ZIP- entweder
MAC_RELEASE_INFO_PLISToderMAC_RELEASE_SUPUBLIC_ED_KEY MAC_RELEASE_PACKAGE_CMD
Häufig optional:
MAC_RELEASE_PRECHECKMAC_RELEASE_SOURCE_FILES(durch Leerzeichen getrennte App-Helferdateien, die vor der Erweiterung von Artefaktnamen geladen werden sollen)MAC_RELEASE_DSYM_ZIPMAC_RELEASE_REQUIRE_DSYM=0für reine App-ReleasesMAC_RELEASE_ARTIFACT_PREFIXMAC_RELEASE_TAG_SIGNEDMAC_RELEASE_TAG_FORCEMAC_RELEASE_RELEASE_BRANCHMAC_RELEASE_SPARKLE_ACCOUNTMAC_RELEASE_SPARKLE_CHANNELMAC_RELEASE_GENERATE_APPCAST_ARGSMAC_RELEASE_RUN_SPARKLE_UPDATE_TESTMAC_RELEASE_SIGNING_KEY_FILE(nur lokaler Fallback-Pfad; der Schlüsselbund wird verwendet, wenn die Datei nicht vorhanden ist)MAC_RELEASE_EXTRA_ASSET_PATTERNSMAC_RELEASE_EXTRA_ASSET_WAIT_SECONDSMAC_RELEASE_EXTRA_ASSET_WAIT_INTERVALMAC_RELEASE_OP_ITEM+MAC_RELEASE_OP_FIELDSfür erforderliche Paketierungsgeheimnisse. Der Release-Helfer liest das bekannte Element einmal überopinnerhalb einer persistenten tmux-Sitzung und exportiert dann die angeforderten Felder für den Paketierungsbefehl.MAC_RELEASE_OP_ACCOUNTstandardmäßigmy.1password.com;MAC_RELEASE_OP_VAULT,MAC_RELEASE_OP_TMUX_SESSION,MAC_RELEASE_OP_WAIT_SECONDSsind optional. Ohne einen Tresor wird das Service-Account-Token-Umgebungsvariable für diesen einzelnenop-Lesevorgang entfernt, sodass das persönliche Desktop-Konto dies übernimmt.MAC_RELEASE_CODESIGN_IDENTITY+MAC_RELEASE_CODESIGN_OP_ITEM+MAC_RELEASE_CODESIGN_KEYCHAIN_MANAGED=1ermöglichen nicht-interaktives Developer-ID-Signing. Der Schlüsselbund muss austauschbar, für die Release-Automatisierung reserviert, vom Standard-Schlüsselbund getrennt, nicht für die interaktive Nutzung freigegeben sein und genau einen privaten Signierschlüssel enthalten. Der Helfer besitzt und kann die Partitions-ACL dieses Schlüssels dauerhaft aufapple-tool:,apple:,codesign:normalisieren. Nach der Vorprüfung liest derselbe tmux-Anmelde-Passkeychain_pathundkeychain_password, nimmt eine benutzerspezifische Release-Sperre, übergibt das Passwort über einen privaten Dateideskriptor an ein CLI-PTY, stellt den Schlüsselbund voran, ohne vorhandene Schlüsselbünde zu verstecken, verifiziert eine Developer-ID-Application-Canary, begrenzt das Paketsignieren durch einen temporärencodesign --keychain-Shim, stellt dann den transienten Zustand wieder her, verriegelt den Schlüsselbund erneut und gibt die Sperre frei.MAC_RELEASE_CODESIGN_OP_ACCOUNT,MAC_RELEASE_CODESIGN_OP_VAULT,MAC_RELEASE_CODESIGN_OP_USE_SERVICE_ACCOUNT,MAC_RELEASE_CODESIGN_OP_PATH_FIELDundMAC_RELEASE_CODESIGN_OP_PASSWORD_FIELDüberschreiben die Standardeinstellungen für das Codesign-Anmeldeelement; Konto, Tresor und Service-Account-Modus erben andernfalls die Einstellungen des primären Elements. Setze Tresor leer und Service-Account-Mode auf0für ein persönliches Desktop-Konto-Element.MAC_RELEASE_CODESIGN_KEYCHAIN+MAC_RELEASE_CODESIGN_KEYCHAIN_PASSWORDkönnen stattdessen direkt angegeben werden.MAC_RELEASE_RUN_LOGIN_SHELL=1schaltet Befehlshooks zurück aufbash -lc; Standard-Hooks verwendenenv -u BASH_ENV bash -c, sodass Shell-Startup-Dateien exportierte Release-Geheimnisse nicht überschreiben können.
1Password-Regeln:
- Bevorzuge bereits exportierte Umgebungsvariablen; kein
op-Aufruf, wenn alleMAC_RELEASE_OP_FIELDSvorhanden sind. - Wenn Felder fehlen, lese die konfigurierten Paket- und Codesign-Elemente in einem tmux-Befehl für das gesamte Release.
- Verwende den Service-Account-Modus nur mit einem expliziten Tresor oder
MAC_RELEASE_OP_USE_SERVICE_ACCOUNT=1. - Wiederhole
op-Lesevorgänge nicht in einer neuen Shell; führe sie nur aus derselben tmux-Sitzung nach expliziter Benutzeranweisung erneut aus. - Erlaube niemals, dass ein Release die App-Paketierung mit einem unvorbereiteten Developer-ID-Schlüsselbund erreicht. Keine SecurityAgent-Passwortfenster während des Releases; schlage zuerst bei der Signatur-Canary fehl.
- Verwende für Nicht-App-Release-Skripte
codesign-runanstatt die Schlüsselbund-Einrichtung in das Repository zu kopieren. Gib die Codesign-Manifest-Felder über.mac-release.envoder expliziteMAC_RELEASE_CODESIGN_*-Umgebungskonfiguration an. Es lädt standardmäßig nur Codesign-Anmeldeinformationen; übergib--with-package-secrets, wenn das eingebundene Release-Skript auch die konfigurierten Paket-/Notar-Felder im selben 1Password-Durchlauf benötigt. Es führt die gebundene Signatur-Canary aus, begrenztcodesignüber den verwalteten Schlüsselbund-Shim und stellt den Zustand wieder her/verriegelt erneut, bevor es zurückkehrt. - Deaktiviere Shell-xtrace und verbose-Modus vor dem Laden von Release-Geheimnissen. Rüste Bereinigung vor Schlüsselbund-/Suchlisten-Mutationen, stelle die ursprüngliche Sperrrichtlinie und die Benutzersuchliste des dedizierten Schlüsselbunds wieder her und verriegele ihn nach der Paketierung erneut.
Erledigt
- appcast-Eintrag hat URL, Länge, Sparkle-Signatur.
- heruntergeladener Anhang wird mit Sparkle verifiziert.
- extrahierte App besteht
codesign,spctlundstapler validate. - GitHub-Release enthält App-Zip, dSYM-Zip (wenn konfiguriert) sowie app-spezifische zusätzliche Assets.
- Release-Notes stimmen mit dem Changelog-Abschnitt überein.
- Nach verifiziertem Release: Erhöhe Changelog auf nächsten Patch
Unreleasedim App-Repository.