SuperAPI AI 工具集

dev-client

编程与开发

查看项目

更新于 10-15 21:52

技能介绍

用途:使用 EAS Build 创建 Expo 开发客户端,用于在物理设备上测试原生代码改动,或为应用分支创建自定义 Expo Go 客户端。

何时需要:仅当应用需要自定义原生代码时才创建开发客户端。大多数应用在 Expo Go 中即可正常运行。需要开发客户端的情况包括:使用本地 Expo 模块(自定义原生代码)、Apple 目标(小组件、App Clip、扩展)、Expo Go 中不包含的第三方原生模块。建议先用 npx expo start 尝试 Expo Go,若一切正常则无需开发客户端。

EAS 配置:确保 eas.json 含 development 配置,关键设置包括 developmentClient: true(打包 expo-dev-client)、autoIncrement: true(自动递增构建号)、appVersionSource: "remote"(以 EAS 为版本号来源)。

构建到 TestFlight:使用 eas build -p ios --profile development --submit 一条命令完成云端构建并自动提交到 App Store Connect,构建就绪后会收到邮件。之后在设备上从 TestFlight 下载并启动,即可看到 expo-dev-client UI,连接本地 Metro 打包器或扫描二维码。

本地构建:iOS 使用 eas build -p ios --profile development --local(需 Xcode),Android 使用 eas build -p android --profile development --local。本地构建输出 iOS 为 .ipa,Android 为 .apk 或 .aab。

安装本地构建:iOS 模拟器可用 tar -xzf build-*.tar.gz 后执行 xcrun simctl install booted ./path/to/App.app;iOS 真机需签名,可用 Xcode Devices 窗口或 ideviceinstaller -i build.ipa;Android 使用 adb install build.apk。

按平台构建:iOS 用 eas build -p ios --profile development,Android 用 eas build -p android --profile development,双平台用 eas build --profile development。查看构建状态可用 eas build:list 和 eas build:view。

使用开发客户端:安装后提供开发服务器连接(输入 Metro 打包器 URL 或扫描二维码)、构建信息查看、启动器 UI(在多个开发服务器间切换)。连接本地开发时先运行 npx expo start --dev-client,再用开发客户端扫描二维码或手动输入 URL。

故障排查:签名错误可用 eas credentials;清除构建缓存用 eas build -p ios --profile development --clear-cache;检查 EAS CLI 版本用 eas --version 和 eas update。

限制:资料未提供收费、价格、平台支持范围等更多信息。