Publication d'application macOS
À utiliser pour BlackBar, RepoBar, CodexBar, Trimmy et applications macOS similaires mises à jour via Sparkle.
Règles
- Travailler depuis le dépôt de l'application.
- Lire
.mac-release.env; il s'agit du manifeste de publication appartenant au dépôt. - Utiliser
scripts/mac-releasede cette compétence pour le travail partagé de publication/appcast/vérification. - Conserver le comportement de construction/empaquetage/signature spécifique à l'application dans les scripts du dépôt, sauf s'il est déjà piloté par le manifeste.
- Ne jamais afficher le matériel de clé privée.
- Privilégier la signature Sparkle via le trousseau (Keychain).
SPARKLE_PRIVATE_KEY_FILEest un remplacement explicite uniquement.
Commandes
/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...]
Manifeste
Chaque dépôt possède .mac-release.env. Il ne doit contenir aucun secret.
Obligatoires :
MAC_RELEASE_APP_NAMEMAC_RELEASE_REPOMAC_RELEASE_BUNDLE_IDMAC_RELEASE_VERSION_FILEMAC_RELEASE_APPCASTMAC_RELEASE_FEED_URLMAC_RELEASE_DOWNLOAD_URL_PREFIXMAC_RELEASE_APP_ZIP- soit
MAC_RELEASE_INFO_PLISTsoitMAC_RELEASE_SUPUBLIC_ED_KEY MAC_RELEASE_PACKAGE_CMD
Optionnels courants :
MAC_RELEASE_PRECHECKMAC_RELEASE_SOURCE_FILES(fichiers d'aide de l'application séparés par des espaces à sourcer avant d'étendre les noms des artefacts)MAC_RELEASE_DSYM_ZIPMAC_RELEASE_REQUIRE_DSYM=0pour les publications sans dSYMMAC_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(chemin de repli local uniquement ; le trousseau est utilisé si le fichier est absent)MAC_RELEASE_EXTRA_ASSET_PATTERNSMAC_RELEASE_EXTRA_ASSET_WAIT_SECONDSMAC_RELEASE_EXTRA_ASSET_WAIT_INTERVALMAC_RELEASE_OP_ITEM+MAC_RELEASE_OP_FIELDSpour les secrets d'empaquetage requis. L'assistant de publication lit l'élément connu une fois viaopdans une session tmux persistante, puis exporte les champs demandés pour la commande de paquetage.MAC_RELEASE_OP_ACCOUNTpar défautmy.1password.com;MAC_RELEASE_OP_VAULT,MAC_RELEASE_OP_TMUX_SESSION,MAC_RELEASE_OP_WAIT_SECONDSsont optionnels. Sans coffre, le jeton de compte de service est désactivé pour cette unique lectureop, de sorte que le compte de bureau personnel le gère.MAC_RELEASE_CODESIGN_IDENTITY+MAC_RELEASE_CODESIGN_OP_ITEM+MAC_RELEASE_CODESIGN_KEYCHAIN_MANAGED=1activent la signature Developer ID non interactive. Le trousseau doit être remplaçable, dédié à l'automatisation des publications, séparé du trousseau par défaut, non partagé avec une utilisation interactive, et contenir exactement une clé privée de signature. L'assistant possède et peut normaliser de manière permanente la liste de contrôle de partition (ACL) de cette clé enapple-tool:,apple:,codesign:. Après la pré-vérification, la même passe d'identification de session tmux litkeychain_pathetkeychain_password, prend un verrou de publication par utilisateur, fournit le mot de passe via un descripteur de fichier privé à un PTY CLI, ajoute le trousseau sans masquer les trousseaux existants, vérifie un canary Developer ID Application, limite la signature du paquet via un shim temporairecodesign --keychain, puis restaure l'état transitoire, reverrouille et libère le verrou.MAC_RELEASE_CODESIGN_OP_ACCOUNT,MAC_RELEASE_CODESIGN_OP_VAULT,MAC_RELEASE_CODESIGN_OP_USE_SERVICE_ACCOUNT,MAC_RELEASE_CODESIGN_OP_PATH_FIELDetMAC_RELEASE_CODESIGN_OP_PASSWORD_FIELDremplacent les valeurs par défaut de l'élément d'identification codesign ; le compte, le coffre et le mode compte de service héritent sinon des paramètres de l'élément principal. Définir un coffre vide et le mode compte de service sur0pour un élément de compte de bureau personnel.MAC_RELEASE_CODESIGN_KEYCHAIN+MAC_RELEASE_CODESIGN_KEYCHAIN_PASSWORDpeuvent être fournis directement à la place.MAC_RELEASE_RUN_LOGIN_SHELL=1réactive les hooks de commande dansbash -lc; les hooks par défaut utilisentenv -u BASH_ENV bash -cafin que les fichiers de démarrage du shell ne puissent pas surcharger les secrets de publication exportés.
Règles 1Password :
- Privilégier les variables d'environnement déjà exportées ; aucun appel
opsi tous lesMAC_RELEASE_OP_FIELDSsont présents. - Si des champs sont manquants, lire les éléments de paquetage et de codesign configurés en une seule commande tmux pour toute la publication.
- Utiliser le mode compte de service uniquement avec un coffre explicite ou
MAC_RELEASE_OP_USE_SERVICE_ACCOUNT=1. - Ne pas relire
opdans un shell frais ; relancer uniquement depuis la même session tmux après une directive explicite de l'utilisateur. - Ne jamais permettre à une publication d'atteindre l'empaquetage de l'application avec un trousseau Developer ID non préparé. Pas de fenêtre de mot de passe SecurityAgent pendant la publication ; échouer d'abord le canary de signature.
- Pour les scripts de publication non applicatifs, utiliser
codesign-runau lieu de copier la configuration du trousseau dans le dépôt. Fournir les champs du manifeste de codesign via.mac-release.envou une configuration explicite de variable d'environnementMAC_RELEASE_CODESIGN_*. Il charge uniquement les identifiants de codesign par défaut ; passer--with-package-secretslorsque le script de publication encapsulé a également besoin des champs de paquetage/notaire configurés dans le même passage 1Password. Il exécute le canary de signature limité, encapsulecodesignvia le shim du trousseau géré, et restaure/reverrouille avant de revenir. - Désactiver les modes xtrace et verbose du shell avant de charger les secrets de publication. Armer le nettoyage avant les mutations du trousseau/de la liste de recherche, restaurer la politique de verrouillage originale du trousseau dédié et la liste de recherche utilisateur, et le reverrouiller après l'empaquetage.
Terminé
- L'entrée appcast a l'URL, la longueur et la signature Sparkle.
- L'enclosure téléchargée est vérifiée par Sparkle.
- L'application extraite passe les vérifications
codesign,spctletstapler validate. - La release GitHub contient le zip de l'application, le zip dSYM si configuré, ainsi que les ressources supplémentaires spécifiques à l'application.
- Les notes de version correspondent à la section du changelog.
- Après une publication vérifiée, mettre à jour le changelog en ajoutant
Unreleasedpour la prochaine version de correctif dans le dépôt de l'application.