Publicación de App macOS
Útil para BlackBar, RepoBar, CodexBar, Trimmy y otras apps macOS que se actualizan mediante Sparkle.
Reglas
- Trabaja desde el repositorio de la app.
- Lee
.mac-release.env; es el manifiesto de release propiedad del repositorio. - Usa
scripts/mac-releasede este skill para tareas compartidas de release/appcast/verificación. - Mantén el comportamiento específico de compilación/empaquetado/firma de la app en scripts del repositorio, a menos que ya esté controlado por manifiesto.
- Nunca imprimas material de llave privada.
- Prefiere la firma Sparkle desde el Llavero.
SPARKLE_PRIVATE_KEY_FILEes una anulación explícita solo.
Comandos
/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...]
Manifiesto
Cada repositorio es dueño de .mac-release.env. No debe contener secretos.
Obligatorio:
MAC_RELEASE_APP_NAMEMAC_RELEASE_REPOMAC_RELEASE_BUNDLE_IDMAC_RELEASE_VERSION_FILEMAC_RELEASE_APPCASTMAC_RELEASE_FEED_URLMAC_RELEASE_DOWNLOAD_URL_PREFIXMAC_RELEASE_APP_ZIP- ya sea
MAC_RELEASE_INFO_PLISToMAC_RELEASE_SUPUBLIC_ED_KEY MAC_RELEASE_PACKAGE_CMD
Opcionales comunes:
MAC_RELEASE_PRECHECKMAC_RELEASE_SOURCE_FILES(archivos auxiliares de la app separados por espacios para cargar antes de expandir nombres de artefactos)MAC_RELEASE_DSYM_ZIPMAC_RELEASE_REQUIRE_DSYM=0para releases solo de appMAC_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(ruta de respaldo local únicamente; se usa el Llavero cuando el archivo no está presente)MAC_RELEASE_EXTRA_ASSET_PATTERNSMAC_RELEASE_EXTRA_ASSET_WAIT_SECONDSMAC_RELEASE_EXTRA_ASSET_WAIT_INTERVALMAC_RELEASE_OP_ITEM+MAC_RELEASE_OP_FIELDSpara secretos de empaquetado requeridos. El asistente de release lee el ítem conocido una vez medianteopdentro de una sesión tmux persistente, luego exporta los campos solicitados para el comando de empaquetado.MAC_RELEASE_OP_ACCOUNTpor defecto esmy.1password.com;MAC_RELEASE_OP_VAULT,MAC_RELEASE_OP_TMUX_SESSION,MAC_RELEASE_OP_WAIT_SECONDSson opcionales. Sin bóveda, el token de la cuenta de servicio se desactiva para esa única lectura deoppara que la cuenta de escritorio personal lo maneje.MAC_RELEASE_CODESIGN_IDENTITY+MAC_RELEASE_CODESIGN_OP_ITEM+MAC_RELEASE_CODESIGN_KEYCHAIN_MANAGED=1habilita la firma no interactiva de Developer ID. El llavero debe ser reemplazable, dedicado a la automatización de releases, separado del llavero predeterminado, no compartido con uso interactivo y contener exactamente una llave privada de firma. El asistente es dueño y puede normalizar permanentemente la ACL de partición de esa llave aapple-tool:,apple:,codesign:. Después de la preverificación, la misma sesión tmux leekeychain_pathykeychain_password, toma un bloqueo de release por usuario, suministra la contraseña a través de un descriptor de archivo privado a un PTY de CLI, antepone el llavero sin ocultar los llaveros existentes, verifica un canary de Developer ID Application, delimita la firma del paquete mediante un shim temporal decodesign --keychain, luego restaura el estado transitorio, vuelve a bloquear y libera el bloqueo.MAC_RELEASE_CODESIGN_OP_ACCOUNT,MAC_RELEASE_CODESIGN_OP_VAULT,MAC_RELEASE_CODESIGN_OP_USE_SERVICE_ACCOUNT,MAC_RELEASE_CODESIGN_OP_PATH_FIELDyMAC_RELEASE_CODESIGN_OP_PASSWORD_FIELDanulan los valores predeterminados del ítem de credenciales de codesign; de lo contrario, la cuenta, la bóveda y el modo de cuenta de servicio heredan la configuración del ítem principal. Establece la bóveda vacía y el modo de cuenta de servicio en0para un ítem de cuenta de escritorio personal.MAC_RELEASE_CODESIGN_KEYCHAIN+MAC_RELEASE_CODESIGN_KEYCHAIN_PASSWORDse pueden suministrar directamente en su lugar.MAC_RELEASE_RUN_LOGIN_SHELL=1hace que los hooks de comando vuelvan a usarbash -lc; los hooks predeterminados usanenv -u BASH_ENV bash -cpara que los archivos de inicio del shell no puedan anular los secretos de release exportados.
Reglas de 1Password:
- Prefiere variables de entorno ya exportadas primero; no llames a
opsi todos losMAC_RELEASE_OP_FIELDSestán presentes. - Si faltan campos, lee los ítems configurados de paquete y codesign en un solo comando tmux para todo el release.
- Usa el modo de cuenta de servicio solo con una bóveda explícita o
MAC_RELEASE_OP_USE_SERVICE_ACCOUNT=1. - No reintentes lecturas
open un shell nuevo; vuelve a ejecutar solo desde la misma sesión tmux después de una instrucción explícita del usuario. - Nunca permitas que un release llegue al empaquetado de la app con un llavero de Developer ID no preparado. Sin ventanas de contraseña de SecurityAgent durante el release; primero falla el canary de firma.
- Para scripts de release que no son de la app, usa
codesign-runen lugar de copiar la configuración del llavero en el repositorio. Proporciona los campos del manifiesto de codesign a través de.mac-release.envo configuración explícita de entornoMAC_RELEASE_CODESIGN_*. Carga solo credenciales de codesign por defecto; pasa--with-package-secretscuando el script de release envuelto también necesita los campos de paquete/notaría configurados en la misma pasada de 1Password. Ejecuta el canary de firma acotado, delimitacodesignmediante el shim de llavero gestionado y restaura/vuelve a bloquear antes de devolver el control. - Desactiva el modo xtrace y verbose del shell antes de cargar los secretos de release. Prepara la limpieza antes de las mutaciones del llavero/lista de búsqueda, restaura la política de bloqueo original del llavero dedicado y la lista de búsqueda del usuario, y vuelve a bloquearlo después del empaquetado.
Hecho
- La entrada del appcast tiene URL, tamaño, firma Sparkle.
- El enclosure descargado se verifica con Sparkle.
- La app extraída pasa
codesign,spctlystapler validate. - El release de GitHub tiene el zip de la app, el zip de dSYM cuando está configurado, y assets extra específicos de la app.
- Las notas de release coinciden con la sección del changelog.
- Después del release verificado, se incrementa el changelog a la próxima versión parche
Unreleaseden el repositorio de la app.