Apple Developer Toolkit

集成文档搜索、App Store 管理与多平台应用生成的苹果开发工具。

已扫描
适合谁
Apple 平台移动应用开发者、需要自动化发布流程的团队
不适合谁
非 Apple 平台开发者、无 Xcode 或 LLM API 资源的用户
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
中等(★★☆)。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @abdullah4ai/apple-developer-toolkit

Skill 说明

命令、参数、文件名以原文为准

Apple Developer Toolkit

一个二进制文件内集成三大工具。每个功能模块独立运行,具有不同的凭证要求。

架构设计

以单一统一的二进制文件 appledev 发布,支持多命令调用:

appledev build ...    # iOS 应用构建器(SwiftShip)
appledev store ...    # App Store Connect 命令行工具
appledev b ...        # 快捷别名
appledev s ...        # 快捷别名

一个二进制文件,三个工具,零冗余。

功能所需凭证

功能所需凭证是否无需配置即可使用
文档搜索(第1部分)
App Store Connect(第2部分)App Store Connect API 密钥(.p8 文件)
iOS 应用构建器(第3部分)LLM API 密钥 + Xcode

安装与配置

第1部分:文档搜索(无需配置)

可直接使用 Node.js 运行:

node cli.js search "NavigationStack"

第2部分:App Store Connect 命令行工具

通过 Homebrew 安装:

brew install Abdullah4AI/tap/appledev

使用 App Store Connect API 密钥进行认证:

appledev store auth login --name "MyApp" --key-id "KEY_ID" --issuer-id "ISSUER_ID" --private-key /path/to/AuthKey.p8

或设置环境变量:

export APPSTORE_KEY_ID="your-key-id"
export APPSTORE_ISSUER_ID="your-issuer-id"
export APPSTORE_PRIVATE_KEY_PATH="/path/to/AuthKey.p8"

API 密钥可在 https://appstoreconnect.apple.com/access/integrations/api 创建。

第3部分:iOS 应用构建器

前置条件:Xcode(含 iOS 模拟器)、XcodeGen,以及用于代码生成的 LLM API 密钥。

appledev build setup    # 检查并安装前置依赖

从源码构建

bash scripts/setup.sh

第1部分:文档搜索

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](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"
发布 TestFlightappledev store publish testflight --app "APP_ID" --ipa "app.ipa" --group "Beta" --wait
提交 App Storeappledev store publish appstore --app "APP_ID" --ipa "app.ipa" --submit --confirm --wait
预提交验证appledev store validate --app "APP_ID" --version-id "VERSION_ID"
列出证书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
IAP(家庭共享)appledev store iap create --app "APP_ID" --family-sharable
订阅(家庭共享)appledev store subscriptions create --app "APP_ID" --family-sharable

环境变量

所有环境变量均为可选。当设置时,会覆盖命令行参数。

变量描述
APPSTORE_KEY_IDAPI 密钥 ID
APPSTORE_ISSUER_IDAPI 发行者 ID
APPSTORE_PRIVATE_KEY_PATH.p8 密钥文件路径
APPSTORE_PRIVATE_KEY原始私钥字符串
APPSTORE_PRIVATE_KEY_B64Base64 编码的私钥
APPSTORE_APP_ID默认应用 ID
APPSTORE_PROFILE默认认证配置文件
APPSTORE_DEBUG启用调试输出
APPSTORE_TIMEOUT请求超时时间(秒)
APPSTORE_BYPASS_KEYCHAIN跳过系统钥匙串

第3部分:多平台应用构建器

支持 iOS、watchOS、tvOS 和 iPad。通过 AI 驱动的代码生成,从自然语言描述生成完整的 Swift/SwiftUI 应用。

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               # 查看令牌使用情况和成本

支持平台

平台状态
iOS完全支持
iPad完全支持
macOS支持
watchOS支持
tvOS支持
visionOS支持

工作流程

描述 > 分析 > 规划 > 构建 > 修复 > 运行

技能:Apple Developer Toolkit

版本:3.5.0

分块:2/2

功能说明

  1. 分析(Analyze) - 从描述中提取应用名称、功能特性、核心流程和目标平台
  2. 规划(Plan) - 生成文件级别的构建计划:数据模型、导航结构、设计规范
  3. 构建(Build) - 生成 Swift 源代码文件、project.yml 配置文件和资源目录
  4. 修复(Fix) - 编译并自动修复错误,直至构建成功
  5. 运行(Run) - 启动模拟器并启动应用

交互命令

命令说明
/run构建并在模拟器中启动应用
/fix自动修复编译错误
/open在 Xcode 中打开项目
/ask [question]询问关于项目的任何问题
/model [name]切换模型(sonnet、opus、haiku)
/info显示项目信息
/usage查看令牌使用情况与成本

参考资料

参考资料内容
[references/app-store-connect.md](references/app-store-connect.md)完整的 App Store Connect CLI 命令列表
[references/ios-rules/](references/ios-rules/)38 条 iOS 开发规范
[references/swiftui-guides/](references/swiftui-guides/)12 个 SwiftUI 最佳实践指南
[references/ios-app-builder-prompts.md](references/ios-app-builder-prompts.md)应用构建系统提示词集合

iOS 规范(共 38 项)

accessibility, app_clips, app_review, apple_translation, biometrics, camera, charts, color_contrast, components, dark_mode, design-system, feedback_states, file-structure, forbidden-patterns, foundation_models, gestures, haptics, healthkit, live_activities, localization, maps, mvvm-architecture, navigation-patterns, notification_service, notifications, safari_extension, share_extension, siri_intents, spacing_layout, speech, storage-patterns, swift-conventions, timers, typography, view-composition, view_complexity, website_links, widgets

SwiftUI 指南(共 12 项)

animations, forms-and-input, layout, liquid-glass, list-patterns, media, modern-apis, navigation, performance, scroll-patterns, state-management, text-formatting

A
@abdullah4ai

已收录 1 个 Skill

相关推荐