SuperAPI AI 工具集

add-app-clip

编程与开发

查看项目

更新于 10-16 04:32

技能介绍

用途:为 Expo 应用添加 iOS App Clip 目标。当用户提到 App Clip、AASA、apple-app-site-association、appclips、Smart App Banner,或希望随主应用一起发布由 URL 唤起的轻量 iOS Clip 时使用。Clip 位于 targets/clip/,随主应用发布,通过域名上的 Apple App Site Association(AASA)文件由 URL 唤起。主应用 bundle ID 为 com.<username>.<app-name>,Clip 自动派生为 <parent>.clip。

主要能力与用法:先在 app.json 设置 ios.bundleIdentifier 与 appleTeamId,再运行 bun create target clip 安装 @bacons/apple-targets 并生成 targets/clip/ 下的配置、Info.plist、AppDelegate.swift 等。随后在主应用与 Clip 中配置 Associated Domains(applinks: 与 appclips:),在 targets/clip/expo-target.config.js 声明 Clip 的 associated-domains entitlement。运行 bunx setup-safari 注册 bundle ID、创建 App Store Connect 条目并输出 AASA 起始 JSON 与 apple-itunes-app 标签。将 AASA 托管在 https://<domain>/.well-known/apple-app-site-association,并补充 appclips 块(<TeamID>.<ClipBundleID>)。通过 src/app/+html.tsx 添加 Smart App Banner meta 标签,可用 app-clip-bundle-id 与 app-clip-display=card 显示 Clip 卡片。用 bunx expo export -p web 与 eas deploy --prod 部署网站,curl 验证 AASA 可访问。用 npx expo config --type introspect 检查主应用权限并在 Clip 的 Info.plist 中镜像;设置 deploymentTarget: "17.6";如需推送或定位,添加 NSAppClip 相关键。运行 bunx testflight 生成 eas.json、配置双 target 凭据、构建并提交 TestFlight。最后用 eas metadata:pull 拉取元数据,在 store.config.json 添加 apple.appClip(最多 3 个 invocationUrls,headerImage 须为 1800x1200 无透明度 PNG),再 eas metadata:push。可选:创建本地 Expo 模块检测 App Clip 上下文并调用 SKOverlay 安装提示。

限制:仅在上游产品与 API 范围内使用;命令、API 行为、配额、凭据与部署效果需以官方最新文档为准;示例不能替代环境测试、安全审查或对破坏性/高成本操作的用户批准。