Apple Developer Toolkit
Three tools in one binary. Each part works independently with different credential requirements.
Architecture
Ships as a single unified binary appledev with multi-call support:
CODEBLOCK0
One binary, three tools, zero duplication.
Credential Requirements by Feature
| Feature | Credentials Needed | Works Without Setup |
|---|
| Documentation Search (Part 1) | None | Yes |
| App Store Connect (Part 2) |
App Store Connect API key (.p8) | No |
| iOS App Builder (Part 3) | LLM API key + Xcode | No |
Setup
Part 1: Documentation Search (no setup needed)
Works immediately with Node.js:
CODEBLOCK1
Part 2: App Store Connect CLI
Install via Homebrew:
CODEBLOCK2
Authenticate with your App Store Connect API key:
CODEBLOCK3
Or set environment variables:
CODEBLOCK4
API keys are created at https://appstoreconnect.apple.com/access/integrations/api
Part 3: iOS App Builder
Prerequisites: Xcode (with iOS Simulator), XcodeGen, and an LLM API key for code generation.
CODEBLOCK5
Build from source
CODEBLOCK6
Part 1: Documentation Search
CODEBLOCK7
Part 2: App Store Connect
Full reference: references/app-store-connect.md
| Task | Command |
|---|
| List apps | INLINECODE1 |
| Upload build |
appledev store builds upload --app "APP_ID" --ipa "app.ipa" --wait |
| Find build by number |
appledev store builds find --app "APP_ID" --build-number "42" |
| Wait for build processing |
appledev store builds wait --build "BUILD_ID" |
| Publish TestFlight |
appledev store publish testflight --app "APP_ID" --ipa "app.ipa" --group "Beta" --wait |
| Submit App Store |
appledev store publish appstore --app "APP_ID" --ipa "app.ipa" --submit --confirm --wait |
| Pre-submission validation |
appledev store validate --app "APP_ID" --version-id "VERSION_ID" |
| List certificates |
appledev store certificates list |
| Reviews |
appledev store reviews --app "APP_ID" --output table |
| Update localizations |
appledev store localizations update --app "APP_ID" --locale "en-US" --name "My App" |
| Sales report |
appledev store analytics sales --vendor "VENDOR" --type SALES --subtype SUMMARY --frequency DAILY --date "2024-01-20" |
| Xcode Cloud |
appledev store xcode-cloud run --app "APP_ID" --workflow "CI" --branch "main" --wait |
| Notarize |
appledev store notarization submit --file ./MyApp.zip --wait |
| Status dashboard |
appledev store status --app "APP_ID" --output table |
| Weekly insights |
appledev store insights weekly --app "APP_ID" --source analytics |
| Metadata pull |
appledev store metadata pull --app "APP_ID" --version "1.2.3" --dir ./metadata |
| Release notes |
appledev store release-notes generate --since-tag "v1.2.2" |
| Diff localizations |
appledev store diff localizations --app "APP_ID" --path ./metadata |
| Nominations |
appledev store nominations create --app "APP_ID" --name "Launch" |
| Price point filter |
appledev store pricing price-points --app "APP_ID" --price 0.99 |
| IAP (family sharable) |
appledev store iap create --app "APP_ID" --family-sharable |
| Subscription (family sharable) |
appledev store subscriptions create --app "APP_ID" --family-sharable |
Environment Variables
All environment variables are optional. They override flags when set.
| Variable | Description |
|---|
| INLINECODE23 | API Key ID |
| INLINECODE24 |
API Issuer ID |
|
APPSTORE_PRIVATE_KEY_PATH | Path to .p8 key file |
|
APPSTORE_PRIVATE_KEY | Raw private key string |
|
APPSTORE_PRIVATE_KEY_B64 | Base64-encoded private key |
|
APPSTORE_APP_ID | Default app ID |
|
APPSTORE_PROFILE | Default auth profile |
|
APPSTORE_DEBUG | Enable debug output |
|
APPSTORE_TIMEOUT | Request timeout |
|
APPSTORE_BYPASS_KEYCHAIN | Skip system keychain |
Part 3: Multi-Platform App Builder
Supports iOS, watchOS, tvOS, and iPad. Generates complete Swift/SwiftUI apps from natural language with AI-powered code generation.
CODEBLOCK8
Supported Platforms
| Platform | Status |
|---|
| iOS | Full support |
| iPad |
Full support |
| macOS | Supported |
| watchOS | Supported |
| tvOS | Supported |
| visionOS | Supported |
How it works
CODEBLOCK9
- 1. Analyze - Extracts app name, features, core flow, target platform from description
- Plan - Produces file-level build plan: data models, navigation, design
- Build - Generates Swift source files, project.yml, asset catalog
- Fix - Compiles and auto-repairs until build succeeds
- Run - Boots Simulator and launches the app
Interactive commands
| Command | Description |
|---|
| INLINECODE33 | Build and launch in simulator |
| INLINECODE34 |
Auto-fix compilation errors |
|
/open | Open project in Xcode |
|
/ask [question] | Ask a question about the project |
|
/model [name] | Switch model (sonnet, opus, haiku) |
|
/info | Show project info |
|
/usage | Token usage and cost |
References
38 iOS development rules |
|
references/swiftui-guides/ | 12 SwiftUI best practice guides |
|
references/ios-app-builder-prompts.md | System prompts for app building |
iOS Rules (38 files)
accessibility, appclips, appreview, appletranslation, biometrics, camera, charts, colorcontrast, components, darkmode, design-system, feedbackstates, file-structure, forbidden-patterns, foundationmodels, gestures, haptics, healthkit, liveactivities, localization, maps, mvvm-architecture, navigation-patterns, notificationservice, notifications, safariextension, shareextension, siriintents, spacinglayout, speech, storage-patterns, swift-conventions, timers, typography, view-composition, viewcomplexity, website_links, widgets
SwiftUI Guides (12 files)
animations, forms-and-input, layout, liquid-glass, list-patterns, media, modern-apis, navigation, performance, scroll-patterns, state-management, text-formatting
Apple Developer Toolkit
一个二进制文件包含三个工具。每个部分独立工作，具有不同的凭证要求。
架构
以单一统一二进制文件 appledev 形式发布，支持多调用：
appledev build ... # iOS 应用构建器 (SwiftShip)
appledev store ... # App Store Connect CLI
appledev b ... # 短别名
appledev s ... # 短别名
一个二进制文件，三个工具，零重复。
各功能凭证要求
| 功能 | 所需凭证 | 无需设置即可工作 |
|---|
| 文档搜索（第1部分） | 无 | 是 |
| App Store Connect（第2部分） |
App Store Connect API 密钥 (.p8) | 否 |
| iOS 应用构建器（第3部分） | LLM API 密钥 + Xcode | 否 |
设置
第1部分：文档搜索（无需设置）
使用 Node.js 即可立即工作：
bash
node cli.js search NavigationStack
第2部分：App Store Connect CLI
通过 Homebrew 安装：
bash
brew install Abdullah4AI/tap/appledev
使用 App Store Connect API 密钥进行身份验证：
bash
appledev store auth login --name MyApp --key-id KEYID --issuer-id ISSUERID --private-key /path/to/AuthKey.p8
或设置环境变量：
bash
export APPSTOREKEYID=your-key-id
export APPSTOREISSUERID=your-issuer-id
export APPSTOREPRIVATEKEY_PATH=/path/to/AuthKey.p8
API 密钥在 https://appstoreconnect.apple.com/access/integrations/api 创建
第3部分：iOS 应用构建器
前提条件：Xcode（含 iOS 模拟器）、XcodeGen 和用于代码生成的 LLM API 密钥。
bash
appledev build setup # 检查并安装前提条件
从源码构建
bash
bash scripts/setup.sh
第1部分：文档搜索
bash
node cli.js search NavigationStack
node cli.js symbols UIView
node cli.js doc /documentation/swiftui/navigationstack
node cli.js overview SwiftUI
node cli.js samples SwiftUI
node cli.js wwdc-search concurrency
node cli.js wwdc-year 2025
node cli.js wwdc-topic swiftui-ui-frameworks
第2部分：App Store Connect
完整参考：references/app-store-connect.md
| 任务 | 命令 |
|---|
| 列出应用 | appledev store apps |
| 上传构建 |
appledev store builds upload --app APP_ID --ipa app.ipa --wait |
| 按编号查找构建 | appledev store builds find --app APP_ID --build-number 42 |
| 等待构建处理 | appledev store builds wait --build BUILD_ID |
| 发布 TestFlight | appledev store publish testflight --app APP_ID --ipa app.ipa --group Beta --wait |
| 提交 App Store | appledev store publish appstore --app APP_ID --ipa app.ipa --submit --confirm --wait |
| 提交前验证 | appledev store validate --app APP
ID --version-id VERSIONID |
| 列出证书 | appledev store certificates list |
| 评论 | appledev store reviews --app APP_ID --output table |
| 更新本地化 | appledev store localizations update --app APP_ID --locale en-US --name My App |
| 销售报告 | appledev store analytics sales --vendor VENDOR --type SALES --subtype SUMMARY --frequency DAILY --date 2024-01-20 |
| Xcode Cloud | appledev store xcode-cloud run --app APP_ID --workflow CI --branch main --wait |
| 公证 | appledev store notarization submit --file ./MyApp.zip --wait |
| 状态仪表板 | appledev store status --app APP_ID --output table |
| 每周洞察 | appledev store insights weekly --app APP_ID --source analytics |
| 元数据拉取 | appledev store metadata pull --app APP_ID --version 1.2.3 --dir ./metadata |
| 发布说明 | appledev store release-notes generate --since-tag v1.2.2 |
| 比较本地化 | appledev store diff localizations --app APP_ID --path ./metadata |
| 提名 | appledev store nominations create --app APP_ID --name Launch |
| 价格点筛选 | appledev store pricing price-points --app APP_ID --price 0.99 |
| 内购（家庭共享） | appledev store iap create --app APP_ID --family-sharable |
| 订阅（家庭共享） | appledev store subscriptions create --app APP_ID --family-sharable |
环境变量
所有环境变量均为可选。设置后将覆盖标志。
| 变量 | 描述 |
|---|
| APPSTOREKEYID | API 密钥 ID |
| APPSTOREISSUERID |
API 签发者 ID |
| APPSTORE
PRIVATEKEY_PATH | .p8 密钥文件路径 |
| APPSTORE
PRIVATEKEY | 原始私钥字符串 |
| APPSTORE
PRIVATEKEY_B64 | Base64 编码的私钥 |
| APPSTORE
APPID | 默认应用 ID |
| APPSTORE_PROFILE | 默认认证配置文件 |
| APPSTORE_DEBUG | 启用调试输出 |
| APPSTORE_TIMEOUT | 请求超时 |
| APPSTORE
BYPASSKEYCHAIN | 跳过系统钥匙串 |
第3部分：多平台应用构建器
支持 iOS、watchOS、tvOS 和 iPad。通过 AI 驱动的代码生成，从自然语言生成完整的 Swift/SwiftUI 应用。
bash
appledev build # 交互模式
appledev build setup # 安装前提条件（Xcode、XcodeGen、AI 后端）
appledev build fix # 自动修复构建错误
appledev build run # 构建并在模拟器中启动
appledev build open # 在 Xcode 中打开项目
appledev build chat # 交互式聊天模式（编辑/提问）
appledev build info # 显示项目状态
appledev build usage # Token 使用量和成本
支持的平台
完全支持 |
| macOS | 支持 |
| watchOS | 支持 |
| tvOS | 支持 |
| visionOS | 支持 |
工作原理
描述 > 分析 > 规划 > 构建 > 修复 > 运行
- 1. 分析 - 从描述中提取应用名称、功能、核心流程、目标平台
- 规划 - 生成文件级构建计划：数据模型、导航、设计
- 构建 - 生成 Swift 源文件、project.yml、资源目录
- 修复 - 编译并自动修复直到构建成功
- 运行 - 启动模拟器并运行应用
交互命令
自动修复编译错误 |
| /open | 在 Xcode 中打开项目 |
| /ask [question] | 询问关于项目的问题 |
| /model [name] | 切换模型（sonnet、opus、haiku） |
| /info | 显示项目信息 |
| /usage | Token 使用量和成本 |
参考
38 条 iOS 开发规则 |
|
references/swiftui-guides/ | 12 个 SwiftUI 最佳实践指南 |
|
references/ios-app-builder-prompts.md | 应用构建的系统提示 |
iOS 规则（38 个文件）
accessibility
