使用您的私有 API 密钥访问 App Store Connect API。这个工具的强大之处在于它可以操作一个或多个团队的所有应用程序（如果您愿意），例如，它可以非常容易地打印出您所有应用程序的线上版本，甚至跨多个团队。
asc app-store-versions list -k <key_id_1> \
asc app-store-versions list -k <key_id_2> \
asc app-store-versions list -k <key_id_3>
通过 Homebrew 安装
brew tap Blackjacx/asc
brew install asc
通过 Mint 安装
只需使用 Homebrew 通过 brew install mint 安装 Mint 即可。
mint install Blackjacx/Assist
您也可以在不事先安装的情况下使用 Mint 运行命令行工具。 Mint 将自动克隆并安装它。
mint run git@github.com:Blackjacx/Assist.git asc apps
git clone https://github.com/blackjacx/assist.git AppStoreConnect
cd AppStoreConnect
swift run asc -h
身份验证由工具本身处理。唯一需要的是您的私有 API 密钥。在 App Store Connect 帐户 生成一个，然后执行以下命令，该命令会将您提供的确切参数存储在用户默认设置中。
asc api-keys register -n "name" -k "key-id" -i "issuer-id" -p "path-to-private-key-file"
⚠️ 这里不执行密钥生成。JWT 仅在使用此工具时按需生成。如果您注册了多个密钥，该工具将询问您要使用哪个密钥。
执行以下子命令之一就像将它及其参数附加到基本命令一样简单
# list all registered API keys
asc api-keys list
# register API key for specific team
asc api-keys register -n "name" -k "key-id" -i "issuer-id" -p "path-to-private-key-file"
# delete API key for specific team
asc api-keys delete -k "key-id"
# list is the default
asc beta-groups
# list only beta groups with a specific name
asc beta-groups -g "group-name"
# list apps of your team
asc apps
# add beta tester to all groups matching `group-name`
asc beta-testers add -e "john@doe.com" -n "John" -l "Doe" -g "group-name"
# add beta tester to all groups matching all specified group names
asc beta-testers add -e "john@doe.com" -n "John" -l "Doe" -g "group-name-1" -g "group-name-2"
# delete beta tester from all groups found
asc beta-testers delete -e "john@doe.com"
# lists all your teams apps with their live version or if not live with their current status
asc app-store-versions
OVERVIEW: Lists, registers and deletes App Store Connect API keys on your Mac.
USAGE: asc api-keys <subcommand>
OPTIONS:
--version Show the version.
-h, --help Show help information.
SUBCOMMANDS:
list (default) List locally stored App Store Connect API keys keys.
register Registers App Store Connect API keys locally.
delete Delete locally stored App Store Connect API keys.
See 'asc help api-keys <subcommand>' for detailed help.
OVERVIEW: Manage groups of beta testers that have access to one or more builds.
USAGE: asc beta-groups <subcommand>
OPTIONS:
--version Show the version.
-h, --help Show help information.
SUBCOMMANDS:
list (default) Find and list beta testers for all apps, builds, and beta groups.
See 'asc help beta-groups <subcommand>' for detailed help.
OVERVIEW: Manage people who can install and test prerelease builds.
USAGE: asc beta-testers <subcommand>
OPTIONS:
--version Show the version.
-h, --help Show help information.
SUBCOMMANDS:
list (default) Find and list beta testers for all apps, builds, and
beta groups.
invite Send or resend an invitation to a beta tester to test
specified apps.
add Create a beta tester assigned to a group, a build, or
an app.
delete Remove a beta tester's ability to test all or
specific apps.
See 'asc help beta-testers <subcommand>' for detailed help.
OVERVIEW: Manage your apps in App Store Connect.
USAGE: asc apps <subcommand>
OPTIONS:
--version Show the version.
-h, --help Show help information.
SUBCOMMANDS:
list (default) Find and list apps added in App Store Connect.
See 'asc help apps <subcommand>' for detailed help.
OVERVIEW: Manage versions of your app that are available in App Store.
USAGE: asc app-store-versions <subcommand>
OPTIONS:
--version Show the version.
-h, --help Show help information.
SUBCOMMANDS:
list (default) Get a list of all App Store versions of an app across
all platforms.
See 'asc help app-store-versions <subcommand>' for detailed help.
OVERVIEW: Manage builds for testers and submit builds for review.
USAGE: asc builds <subcommand>
OPTIONS:
--version Show the version.
-h, --help Show help information.
SUBCOMMANDS:
list (default) Find and list builds for all apps in App Store Connect.
See 'asc help builds <subcommand>' for detailed help.
OVERVIEW: Manage the bundle IDs that uniquely identify your apps.
USAGE: asc bundle-ids <subcommand>
OPTIONS:
--version Show the version.
-h, --help Show help information.
SUBCOMMANDS:
list (default) Find and list bundle IDs that are registered to your
team.
register Register a new bundle ID for app development.
See 'asc help bundle-ids <subcommand>' for detailed help.
ASC、Push 和 Snap 的代码文档由 Swift Package Index 生成和托管（由 DocC 提供支持）
要发布此 Swift 包，必须执行以下步骤
- 增加
Core.Constants.version中的版本号 - 运行以下命令以更新到最新的共享开发文件
bash <(curl -H -s https://raw.githubusercontent.com/Blackjacx/Scripts/master/frameworks/bootstrap.sh) - 运行
bundle update以更新所有 Ruby gem - 运行
swift package update以更新所有 SPM 依赖项 - 使用以下消息提交
develop上的所有更改
Release version `x.y.z`
-
运行以下命令以发布新版本
bundle exec fastlane release framework:"Assist" version:"x.y.z" formula:"blackjacx/formulae/asc"
-
合并在 https://github.com/Blackjacx/homebrew-formulae 上创建的 PR
-
在 Twitter 上发布以下内容
Assist (ASC, Push, Snap) release x.y.z 🎉 ▸ 🚀 Tools asc, snap, push (x.y.z) successfully published ▸ 📅 September 2nd ▸ 🌎 https://swiftpackageindex.cn/Blackjacx/Assist ▸ 🌎 https://github.com/Blackjacx/Assist/releases/latest ▸ 👍 Tell your friends! #SPM #Automated #Snapshots #Push #Firebase #APNS #ASC #AppStoreConnectAPI
- 如果您发现一个 bug，请打开一个 issue。
- 如果您有 功能请求，请打开一个 issue。
- 如果您想 贡献，请提交一个 pull request。
Stefan Herold • 🐦 @Blackjacxxx
感谢所有参与者
ASC 在 MIT 许可证下可用。有关更多信息，请参阅 LICENSE 文件。