Mã nguồn mở · Giấy phép MIT

App Store Connect,
từ terminal của bạn.

CLI Swift để quản lý ứng dụng iOS và macOS trên App Store Connect. Gửi phiên bản, quản lý ảnh chụp màn hình, theo dõi bản build — với hỗ trợ tác nhân AI đầy đủ qua CAEOAS.

$ brew install tddworks/tap/asccli
130+
Lệnh
CAEOAS
Sẵn sàng cho AI
MIT
Mã nguồn mở
100+
API Endpoints
zsh — 80×24

Tính năng

Mọi thứ bạn cần, không hơn không kém

Xây dựng trên API App Store Connect chính thức, với kiến trúc ba tầng rõ ràng và đầu ra affordance đầy đủ cho quy trình làm việc của tác nhân AI.

Sẵn sàng cho tác nhân AI (CAEOAS)

Mỗi phản hồi nhúng các lệnh sẵn sàng chạy trong trường affordances. Tác nhân không cần biết toàn bộ cây lệnh — chỉ cần theo các liên kết.

App
├─ AppStoreVersion
│  └─ Localization
│     └─ ScreenshotSet
├─ AppInfo
│  └─ AppInfoLocalization
├─ Build
└─ TestFlight

Hệ thống phân cấp tài nguyên đầy đủ

Quản lý toàn bộ cây tài nguyên App Store Connect: Ứng dụng → Phiên bản → Bản địa hóa → Bộ ảnh chụp → Ảnh chụp. Cộng thêm Builds và TestFlight.

$ asc versions submit \
  --version-id a9657737
// 4 API calls, 1 command:
1. GET /appStoreVersions/{id}
2. POST /reviewSubmissions
3. POST /reviewSubmissionItems
4. PATCH /reviewSubmissions/{id}
state: WAITING_FOR_REVIEW

Gửi bằng một lệnh

Gửi bất kỳ phiên bản iOS hoặc macOS nào để xem xét App Store bằng một lệnh duy nhất. CLI tự động xử lý toàn bộ quy trình gửi xem xét nhiều bước.

Kiểm tra trước khi gửi

Chạy tất cả kiểm tra trước khi gửi bằng một lệnh. Phát hiện bản build thiếu, giá chưa cấu hình và bản địa hóa chưa hoàn chỉnh — với mức độ MUST FIX và SHOULD FIX. Hành động gửi chỉ xuất hiện khi mọi thứ đều xanh.

$ asc iris status
source: browser · cookies: 5
$ asc iris apps create \
  --name "My App" \
  --bundle-id com.example.app \
  --sku MYSKU
id: 1234567890

Iris (API Riêng)

Truy cập API riêng vận hành giao diện web App Store Connect. Tạo ứng dụng mới, liệt kê tất cả ứng dụng — những tính năng không có trong API REST công khai. Xác thực bằng cookie trình duyệt, không cần cấu hình thêm.

# lưu khóa một lần
$ asc app-shots config \
  --gemini-api-key KEY
# đặt PNG vào .asc/app-shots/ → chạy
$ asc app-shots generate
# bản địa hóa trong một lệnh
$ asc app-shots translate \
  --to zh --to ja
screen-0.png · 1320×2868
zh/ ja/ ← localized

Tạo Ảnh Chụp Màn Hình AI

Tạo ảnh App Store 1320×2868 với Gemini AI. Bản địa hóa trong một lệnh — asc app-shots translate --to zh --to ja. Đảm bảo kích thước chính xác.

$ asc version-localizations list \
  --version-id v1
$ asc version-localizations update \
  --localization-id id \
  --whats-new "Bug fixes"
en-US · zh-Hans · ja · ko

Bản địa hóa phiên bản

Cập nhật văn bản «Có gì mới», mô tả, từ khóa và URL quảng bá theo ngôn ngữ cho bất kỳ phiên bản app nào. CRUD đầy đủ — liệt kê, tạo và cập nhật trên tất cả các ngôn ngữ được hỗ trợ.

$ asc screenshot-sets create \
  --localization-id id \
  --display-type APP_IPHONE_67
$ asc screenshots upload \
  --set-id id --file screen.png
3-step ASC upload flow

Ảnh chụp màn hình

Tạo bộ ảnh chụp màn hình cho bất kỳ kích thước màn hình nào và tải lên ảnh PNG qua quy trình tải lên ASC 3 bước. Hỗ trợ tất cả các loại màn hình iPhone, iPad, Mac và Apple TV.

$ asc app-preview-sets create \
  --localization-id id \
  --preview-type IPHONE_67
$ asc app-previews upload \
  --set-id id --file preview.mp4 \
  --preview-frame-time-code 00:00:05

Xem trước app

Tải lên video xem trước (.mp4, .mov, .m4v) với mã thời gian thumbnail tùy chọn. CLI xử lý toàn bộ quy trình 3 bước: đặt trước, tải lên theo phần và xác nhận MD5.

$ asc app-info-localizations list \
  --app-info-id id
$ asc app-info-localizations update \
  --localization-id id \
  --name "My App" \
  --subtitle "Do things faster"

Bản địa hóa thông tin app

Đọc và ghi metadata app theo ngôn ngữ: tên, phụ đề và URL chính sách quyền riêng tư. Metadata ở cấp app áp dụng cho tất cả các phiên bản — tách biệt với bản địa hóa phiên bản.

# thiết lập một lần
$ asc auth login \
  --key-id KEY \
  --private-key-path ~/.asc/Key.p8
đã lưu vào ~/.asc/credentials.json
# không cần biến môi trường từ giờ
$ asc apps list

Xác thực bền vững

Đăng nhập một lần với asc auth login. Thông tin đăng nhập được lưu vào ~/.asc/credentials.json và được mọi lệnh sử dụng tự động — không cần biến môi trường mỗi phiên.

$ asc builds upload \
  --app-id id --file MyApp.ipa \
  --version 1.2.0 --build-number 55
// 5-step flow:
1. Reserve slot
2. Upload chunks
3. Confirm MD5
state: processing

Tải lên bản build

Tải lên IPA/PKG qua quy trình ASC 5 bước: đặt trước slot, tải lên theo phần, xác nhận MD5 và chờ xử lý. Bao gồm liệt kê, lấy và xóa bản ghi tải lên.

$ asc testflight groups list \
  --app-id id
$ asc testflight testers add \
  --beta-group-id id \
  --email [email protected]
$ asc testflight testers import \
  --beta-group-id id --file testers.csv

TestFlight

Quản lý nhóm beta và người kiểm thử: thêm hoặc xóa theo email, nhập/xuất hàng loạt qua CSV, phân phối bản build cho nhóm và cập nhật ghi chú Có gì mới theo ngôn ngữ.

Nhiều định dạng đầu ra

Thiết kế cho cả con người và máy móc. Đầu ra dạng JSON (mặc định), bảng hoặc markdown. Dễ dàng pipe vào jq, script hoặc tác nhân AI.

$ asc iap create --app-id id \
  --type consumable \
  --reference-name "Coins 100"
$ asc iap prices set \
  --iap-id id --base-territory USA \
  --price-point-id id
$ asc iap submit --iap-id id

Mua hàng trong ứng dụng

Tạo IAP tiêu hao, không tiêu hao và đăng ký không gia hạn. Đặt giá theo lãnh thổ từ các điểm giá App Store, quản lý tên và mô tả theo ngôn ngữ và gửi để xem xét.

$ asc subscription-groups create \
  --app-id id --reference-name "Pro"
$ asc subscriptions create \
  --group-id id --period ONE_MONTH
$ asc subscription-offers create \
  --subscription-id id \
  --mode FREE_TRIAL --periods 7

Đăng ký tự gia hạn

Tạo nhóm đăng ký và cấp bậc (hàng tuần đến hàng năm). Quản lý ưu đãi giới thiệu (dùng thử miễn phí, trả theo sử dụng, trả trước), metadata theo ngôn ngữ và gửi để xem xét.

$ asc bundle-ids create \
  --name "My App" \
  --identifier com.example.app \
  --platform ios
$ asc profiles create \
  --type IOS_APP_STORE \
  --bundle-id-id id --certificate-ids id

Ký mã

Quản lý chuỗi ký đầy đủ: đăng ký Bundle ID, tạo chứng chỉ từ CSR, đăng ký thiết bị theo UDID và tạo hoặc xóa hồ sơ cấp phép — tất cả từ terminal.

$ asc tui
┌─ Apps ─────────────────────────┐
▶ AppNexus
│  My Other App
└────────────────────────────────┘
↑↓ navigate · Enter · Esc back

Chế độ TUI tương tác

Chạy asc tui để mở trình duyệt TUI đầy đủ trong terminal. Điều hướng qua Apps, Phiên bản, Builds và TestFlight bằng phím mũi tên — không cần ghi nhớ lệnh.

Bắt đầu nhanh

Hoạt động trong vài phút

1
$ brew install tddworks/tap/asccli
🍺 Pouring asc...
asc installed
$ asc --version
asc 1.0.0

Cài đặt qua Homebrew

Một lệnh cài đặt phiên bản mới nhất. Không cần Xcode hoặc chuỗi công cụ Swift.

2
$ asc auth login \
  --key-id YOUR_KEY_ID \
  --issuer-id YOUR_ISSUER \
  --private-key-path ~/.asc/Key.p8
$ asc auth check
source: "file" · key: YOUR_KEY_ID
# đã lưu vào ~/.asc/credentials.json

Đăng nhập một lần, sử dụng mãi

Lưu khóa API của bạn với asc auth login. Thông tin đăng nhập được lưu trữ trong ~/.asc/credentials.json — không cần biến môi trường mỗi phiên.

3
$ asc apps list
$ asc versions list --app-id <id>
$ asc screenshots upload \
  --set-id <id> --file shot.png
$ asc versions submit \
  --version-id <id>
Submitted for review

Bắt đầu quản lý ứng dụng của bạn

Liệt kê ứng dụng, kiểm tra phiên bản, tải ảnh chụp màn hình và gửi để xem xét — tất cả từ terminal hoặc qua tác nhân AI.

Kỹ năng Tác nhân

Tăng sức mạnh cho tác nhân AI của bạn

Cài đặt hơn 26 kỹ năng dựng sẵn giúp tác nhân lập trình AI của bạn biết cách sử dụng mọi lệnh asc — từ tải lên đến gửi duyệt.

$ asc skills install --all

asc-builds-upload

Tải lên bản build IPA/PKG và quản lý phân phối TestFlight

asc-app-shots

Tạo và dịch ảnh chụp màn hình App Store bằng AI

asc-check-readiness

Kiểm tra trước khi gửi để xem xét

asc-auth

Thiết lập và quản lý thông tin xác thực API App Store Connect

asc-testflight

Quản lý nhóm beta và người kiểm thử cho TestFlight

asc-release-workflow

Phát hành từ đầu đến cuối: tăng phiên bản, lưu trữ, tải lên, gửi

Hơn 26 kỹ năng sẵn có — tương thích với Claude Code, Cursor, Windsurf và nhiều hơn nữa

Sẵn sàng thử asc?

Tự động hóa quy trình App Store Connect của bạn

$ brew install tddworks/tap/asccli

Cộng đồng

App Wall

Ứng dụng thực tế trên App Store được xuất bản bởi các nhà phát triển dùng asc CLI.

$ asc app-wall submit --app-id <your-app-id>

Một lệnh duy nhất để gửi ứng dụng và mở pull request →

Built for real apps

Sponsors