Agent Skills › RSSNext/Folo › installing-mobile-preview-builds

installing-mobile-preview-builds

GitHub

自动化构建iOS预览版并安装到连接iPhone，用于生产环境测试。支持指定或自动选择设备，执行本地EAS构建、IPA解压及应用安装启动，并提供失败处理与状态反馈。

.agents/skills/installing-mobile-preview-builds/SKILL.md RSSNext/Folo

Trigger Scenarios

用户请求在iPhone上安装iOS预览版本需要为内部测试构建并部署最新iOS应用

Install

npx skills add RSSNext/Folo --skill installing-mobile-preview-builds -g -y

More Options

Non-standard path

npx skills add https://github.com/RSSNext/Folo/tree/dev/.agents/skills/installing-mobile-preview-builds -g -y

Use without installing

npx skills use RSSNext/Folo@installing-mobile-preview-builds

指定 Agent (Claude Code)

npx skills add RSSNext/Folo --skill installing-mobile-preview-builds -a claude-code -g -y

安装 repo 全部 skill

npx skills add RSSNext/Folo --all -g -y

预览 repo 内 skill

npx skills add RSSNext/Folo --list

SKILL.md

Frontmatter

{
    "name": "installing-mobile-preview-builds",
    "description": "Builds and installs the iOS preview build for apps\/mobile using EAS local build and devicectl. Use when the user asks to install a preview\/internal iOS build on a connected iPhone for production-like testing.",
    "allowed-tools": "Bash, Read, Glob, Grep",
    "argument-hint": "[device-udid-or-name(optional)]",
    "disable-model-invocation": true
}

Install Mobile Preview Build (iOS)

Use this skill to create a fresh local preview iOS build and install it on a connected iPhone.

Inputs

Optional $ARGUMENTS: device identifier (UDID or exact device name).
If no argument is provided, auto-select the first paired iPhone from xcrun devicectl list devices.

Workflow

Validate repo and tooling.
- Run from repo root and ensure apps/mobile exists.
- Verify pnpm, xcrun, xcodebuild, and eas-cli are available.
- Verify EAS login:
```
cd apps/mobile
pnpm dlx eas-cli whoami
```
Resolve target device.
- List paired devices:
```
xcrun devicectl list devices
```
- Choose device in this order:
  - $ARGUMENTS if provided and matches exactly one device.
  - Otherwise, first paired iPhone.

Trigger local preview iOS build.

mkdir -p .context/preview-install
cd apps/mobile
pnpm dlx eas-cli build -p ios --profile preview --non-interactive --local --output=./build-preview.ipa
cd ../..
cp apps/mobile/build-preview.ipa .context/preview-install/folo-preview.ipa

Install to device locally.

unzip -q -o .context/preview-install/folo-preview.ipa -d .context/preview-install/unpacked
APP_PATH=$(find .context/preview-install/unpacked/Payload -maxdepth 1 -name '*.app' -type d | head -n 1)
xcrun devicectl device install app --device "<device-id>" "$APP_PATH"

Try launching app.
```
xcrun devicectl device process launch --device "<device-id>" is.follow --activate
```
- If launch fails due to locked device, instruct the user to unlock iPhone and open Folo manually.

Failure Handling

If local build fails, report:
- build mode (local)
- failing command
- key error message from command output
If app config fails with Assets source directory not found ... /out/rn-web, prebuild assets then retry once:
```
pnpm --filter @follow/rn-micro-web-app build --outDir out/rn-web/html-renderer
```