Mac App Release
BlackBar, RepoBar, CodexBar, Trimmy 및 이와 유사한 Sparkle 업데이트 macOS 앱에 사용합니다.
규칙
- 앱 리포지토리에서 작업합니다.
.mac-release.env를 읽습니다. 이 파일은 리포지토리가 소유한 릴리스 매니페스트입니다.- 이 스킬의
scripts/mac-release를 사용하여 공유 릴리스/앱캐스트/확인 작업을 수행합니다. - 앱별 빌드/패키징/서명 동작은 이미 매니페스트 기반이 아닌 경우 리포지토리 스크립트에 유지합니다.
- 개인 키 자료를 출력하지 마십시오.
- Keychain Sparkle 서명을 선호합니다.
SPARKLE_PRIVATE_KEY_FILE은 명시적인 재정의일 때만 사용합니다.
명령어
/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...]
매니페스트
각 리포지토리는 .mac-release.env를 소유합니다. 이 파일에는 비밀이 포함되어서는 안 됩니다.
필수:
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_PLIST또는MAC_RELEASE_SUPUBLIC_ED_KEY중 하나MAC_RELEASE_PACKAGE_CMD
일반적인 선택 사항:
MAC_RELEASE_PRECHECKMAC_RELEASE_SOURCE_FILES(공백으로 구분된 앱 헬퍼 파일로, 아티팩트 이름을 확장하기 전에 소싱됨)MAC_RELEASE_DSYM_ZIPMAC_RELEASE_REQUIRE_DSYM=0(앱 전용 릴리스의 경우)MAC_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(로컬 대체 경로만 해당; 파일이 없으면 Keychain 사용)MAC_RELEASE_EXTRA_ASSET_PATTERNSMAC_RELEASE_EXTRA_ASSET_WAIT_SECONDSMAC_RELEASE_EXTRA_ASSET_WAIT_INTERVALMAC_RELEASE_OP_ITEM+MAC_RELEASE_OP_FIELDS(필수 패키징 시크릿용). 릴리스 헬퍼는 하나의 지속적인 tmux 세션 내에서op를 통해 알려진 항목을 한 번 읽은 다음, 패키지 명령을 위해 요청된 필드를 내보냅니다.MAC_RELEASE_OP_ACCOUNT기본값은my.1password.com입니다.MAC_RELEASE_OP_VAULT,MAC_RELEASE_OP_TMUX_SESSION,MAC_RELEASE_OP_WAIT_SECONDS는 선택 사항입니다. 볼트가 없으면 해당 단일op읽기에 대해 서비스 계정 토큰 환경 변수가 설정 해제되어 개인 데스크톱 계정이 처리합니다.MAC_RELEASE_CODESIGN_IDENTITY+MAC_RELEASE_CODESIGN_OP_ITEM+MAC_RELEASE_CODESIGN_KEYCHAIN_MANAGED=1은 비대화형 Developer ID 서명을 활성화합니다. 키체인은 교체 가능해야 하고, 릴리스 자동화 전용이며, 기본 키체인과 별개여야 하고, 대화형 사용과 공유되지 않아야 하며, 정확히 하나의 서명 개인 키를 포함해야 합니다. 헬퍼는 해당 키의 파티션 ACL을apple-tool:,apple:,codesign:으로 영구적으로 정규화할 수 있습니다. 사전 점검 후, 동일한 tmux 자격 증명 패스가keychain_path와keychain_password를 읽고, 사용자별 릴리스 잠금을 획득하고, 비공개 파일 디스크립터를 통해 CLI PTY에 비밀번호를 제공하고, 기존 키체인을 숨기지 않고 전용 키체인을 앞에 추가하고, Developer ID Application canary를 확인하고, 임시codesign --keychain심을 통해 패키지 서명 범위를 지정한 다음, 일시적 상태를 복원하고, 다시 잠그고, 잠금을 해제합니다.MAC_RELEASE_CODESIGN_OP_ACCOUNT,MAC_RELEASE_CODESIGN_OP_VAULT,MAC_RELEASE_CODESIGN_OP_USE_SERVICE_ACCOUNT,MAC_RELEASE_CODESIGN_OP_PATH_FIELD,MAC_RELEASE_CODESIGN_OP_PASSWORD_FIELD는 코드사인 자격 증명 항목 기본값을 재정의합니다. account, vault 및 service-account 모드는 그렇지 않으면 기본 항목 설정을 상속합니다. 개인 데스크톱 계정 항목의 경우 볼트를 비우고 서비스 계정 모드를0으로 설정합니다.MAC_RELEASE_CODESIGN_KEYCHAIN+MAC_RELEASE_CODESIGN_KEYCHAIN_PASSWORD를 직접 대신 제공할 수 있습니다.MAC_RELEASE_RUN_LOGIN_SHELL=1은 명령어 후크를bash -lc로 되돌립니다. 기본 후크는env -u BASH_ENV bash -c를 사용하므로 셸 시작 파일이 내보낸 릴리스 시크릿을 재정의할 수 없습니다.
1Password 규칙:
- 이미 내보낸 환경 변수를 먼저 선호합니다. 모든
MAC_RELEASE_OP_FIELDS가 있으면op호출을 하지 않습니다. - 필드가 누락된 경우, 전체 릴리스에 대해 하나의 tmux 명령으로 구성된 패키지 및 코드사인 항목을 읽습니다.
- 명시적인 볼트 또는
MAC_RELEASE_OP_USE_SERVICE_ACCOUNT=1이 있는 경우에만 서비스 계정 모드를 사용합니다. - 새 셸에서
op읽기를 재시도하지 마십시오. 명시적인 사용자 지시 후에만 동일한 tmux 세션에서 다시 실행하십시오. - 준비되지 않은 Developer ID 키체인으로 앱 패키징에 도달하는 릴리스를 허용하지 마십시오. 릴리스 중 SecurityAgent 비밀번호 창이 나타나지 않아야 합니다. 먼저 서명 canary를 실패 처리하십시오.
- 앱 릴리스 스크립트가 아닌 경우, 키체인 설정을 리포지토리에 복사하는 대신
codesign-run을 사용하십시오..mac-release.env또는 명시적인MAC_RELEASE_CODESIGN_*환경 구성을 통해 코드사인 매니페스트 필드를 제공하십시오. 기본적으로 코드사인 자격 증명만 로드합니다. 래핑된 릴리스 스크립트가 동일한 1Password 패스에서 구성된 패키지/공증 필드도 필요로 하는 경우--with-package-secrets를 전달하십시오. 바운드 서명 canary를 실행하고, 관리형 키체인 심을 통해codesign범위를 지정하고, 반환하기 전에 복원/재잠금을 수행합니다. - 릴리스 시크릿을 로드하기 전에 셸 xtrace 및 verbose 모드를 비활성화하십시오. 키체인/검색 목록 변경 전에 정리를 준비하고, 전용 키체인의 원래 잠금 정책 및 사용자 검색 목록을 복원하고, 패키징 후 다시 잠급니다.
완료
- 앱캐스트 항목에 URL, 길이, Sparkle 서명이 있습니다.
- 다운로드된 enclosure가 Sparkle로 확인됩니다.
- 추출된 앱이
codesign,spctl및stapler validate를 통과합니다. - GitHub 릴리스에 앱 zip, 구성된 경우 dSYM zip 및 앱별 추가 자산이 있습니다.
- 릴리스 노트가 변경 로그 섹션과 일치합니다.
- 확인된 릴리스 후, 앱 리포지토리의 변경 로그를 다음 패치
Unreleased로 범프합니다.