Lançamento de Aplicativos macOS
Use para BlackBar, RepoBar, CodexBar, Trimmy e aplicativos macOS similares atualizados via Sparkle.
Regras
- Trabalhe a partir do repositório do aplicativo.
- Leia o arquivo
.mac-release.env; ele é o manifesto de lançamento de propriedade do repositório. - Use
scripts/mac-releasedesta skill para o trabalho compartilhado de lançamento/appcast/verificação. - Mantenha o comportamento de construção/empacotamento/assinatura específico do aplicativo em scripts do repositório, a menos que já seja orientado pelo manifesto.
- Nunca imprima material de chave privada.
- Prefira assinatura Sparkle via Keychain.
SPARKLE_PRIVATE_KEY_FILEé uma substituição explícita apenas.
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 [versão] [saída.md]
/Users/steipete/Projects/agent-scripts/skills/release-mac-app/scripts/mac-release changelog-html <versão> [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 [versão]
/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] -- <comando> [args...]
Manifesto
Cada repositório possui seu próprio .mac-release.env. Ele não deve conter segredos.
Obrigatórios:
MAC_RELEASE_APP_NAMEMAC_RELEASE_REPOMAC_RELEASE_BUNDLE_IDMAC_RELEASE_VERSION_FILEMAC_RELEASE_APPCASTMAC_RELEASE_FEED_URLMAC_RELEASE_DOWNLOAD_URL_PREFIXMAC_RELEASE_APP_ZIPMAC_RELEASE_INFO_PLISTouMAC_RELEASE_SUPUBLIC_ED_KEYMAC_RELEASE_PACKAGE_CMD
Opcionais comuns:
MAC_RELEASE_PRECHECKMAC_RELEASE_SOURCE_FILES(arquivos auxiliares do aplicativo, separados por espaço, para carregar antes de expandir nomes de artefatos)MAC_RELEASE_DSYM_ZIPMAC_RELEASE_REQUIRE_DSYM=0para lançamentos apenas do aplicativoMAC_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(caminho de fallback local apenas; o Keychain é usado quando o arquivo está ausente)MAC_RELEASE_EXTRA_ASSET_PATTERNSMAC_RELEASE_EXTRA_ASSET_WAIT_SECONDSMAC_RELEASE_EXTRA_ASSET_WAIT_INTERVALMAC_RELEASE_OP_ITEM+MAC_RELEASE_OP_FIELDSpara segredos de empacotamento necessários. O auxiliar de lançamento lê o item conhecido uma vez viaopdentro de uma sessão tmux persistente, então exporta os campos solicitados para o comando de empacotação.MAC_RELEASE_OP_ACCOUNTassume como padrãomy.1password.com;MAC_RELEASE_OP_VAULT,MAC_RELEASE_OP_TMUX_SESSION,MAC_RELEASE_OP_WAIT_SECONDSsão opcionais. Sem um cofre, o token de conta de serviço não é definido no ambiente para essa única leituraop, para que a conta pessoal da área de trabalho a manipule.MAC_RELEASE_CODESIGN_IDENTITY+MAC_RELEASE_CODESIGN_OP_ITEM+MAC_RELEASE_CODESIGN_KEYCHAIN_MANAGED=1habilita a assinatura não interativa de Developer ID. O keychain deve ser substituível, dedicado à automação de lançamentos, separado do keychain padrão, não compartilhado com uso interativo, e conter exatamente uma chave privada de assinatura. O auxiliar possui e pode normalizar permanentemente a ACL de partição dessa chave paraapple-tool:,apple:,codesign:. Após a pré-verificação, a mesma transmissão de credenciais tmux lêkeychain_pathekeychain_password, obtém um bloqueio de lançamento por usuário, fornece a senha através de um descritor de arquivo privado para um PTY CLI, adiciona o keychain sem ocultar keychains existentes, verifica um canary de Developer ID Application, define o escopo da assinatura do pacote através de um shim temporáriocodesign --keychain, então restaura o estado transitório, rebloqueia e libera o bloqueio.MAC_RELEASE_CODESIGN_OP_ACCOUNT,MAC_RELEASE_CODESIGN_OP_VAULT,MAC_RELEASE_CODESIGN_OP_USE_SERVICE_ACCOUNT,MAC_RELEASE_CODESIGN_OP_PATH_FIELDeMAC_RELEASE_CODESIGN_OP_PASSWORD_FIELDsubstituem os padrões do item de credencial codesign; conta, cofre e modo de conta de serviço, caso contrário, herdam as configurações do item principal. Defina o cofre vazio e o modo de conta de serviço como0para um item de conta pessoal da área de trabalho.MAC_RELEASE_CODESIGN_KEYCHAIN+MAC_RELEASE_CODESIGN_KEYCHAIN_PASSWORDpodem ser fornecidos diretamente como alternativa.MAC_RELEASE_RUN_LOGIN_SHELL=1faz os hooks de comando retornarem aobash -lc; os hooks padrão usamenv -u BASH_ENV bash -cpara que os arquivos de inicialização do shell não possam sobrescrever segredos de lançamento exportados.
Regras do 1Password:
- Prefira variáveis de ambiente já exportadas primeiro; nenhuma chamada
opse todos osMAC_RELEASE_OP_FIELDSestiverem presentes. - Se os campos estiverem faltando, leia os itens de pacote e codesign configurados em um comando tmux para todo o lançamento.
- Use o modo de conta de serviço apenas com um cofre explícito ou
MAC_RELEASE_OP_USE_SERVICE_ACCOUNT=1. - Não tente novamente leituras
opem um shell novo; execute novamente apenas a partir da mesma sessão tmux após direção explícita do usuário. - Nunca permita que um lançamento atinja o empacotamento do aplicativo com um keychain de Developer ID não preparado. Nenhuma janela de senha do SecurityAgent durante o lançamento; falhe primeiro no canary de assinatura.
- Para scripts de lançamento que não são de aplicativos, use
codesign-runem vez de copiar a configuração do keychain para o repositório. Forneça os campos do manifesto de codesign através de.mac-release.envou configuração explícita de ambienteMAC_RELEASE_CODESIGN_*. Ele carrega apenas credenciais de codesign por padrão; passe--with-package-secretsquando o script de lançamento encapsulado também precisar dos campos de pacote/notário configurados na mesma passagem do 1Password. Ele executa o canary de assinatura delimitado, define o escopo decodesignatravés do shim do keychain gerenciado e restaura/rebloqueia antes de retornar. - Desative o modo xtrace e verbose do shell antes de carregar segredos de lançamento. Arme a limpeza antes de mutações no keychain/lista de pesquisa, restaure a política de bloqueio original do keychain dedicado e a lista de pesquisa do usuário e rebloqueie-o após o empacotamento.
Concluído
- A entrada do appcast possui URL, tamanho e assinatura Sparkle.
- O anexo baixado verifica com o Sparkle.
- O aplicativo extraído passa por
codesign,spctlestapler validate. - O lançamento do GitHub possui o zip do aplicativo, o zip do dSYM quando configurado, além de ativos extras específicos do aplicativo.
- As notas de lançamento correspondem à seção do changelog.
- Após o lançamento verificado, incrementa o changelog para o próximo patch
Unreleasedno repositório do aplicativo.