SuperAPI AI 工具集

expo-dev-client

编程与开发

查看项目

更新于 10-15 23:44

技能介绍

用途:为需要自定义原生代码的 Expo 应用创建开发客户端(development client),在真机上测试原生改动,或为应用分支创建自定义客户端。

何时需要:仅当使用本地 Expo 模块(自定义原生代码)、Apple 目标(小组件、App Clip、扩展)或 Expo Go 不支持的第三方原生模块时才需要。建议先用 npx expo start 在 Expo Go 中测试,若一切正常则无需 dev client。

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

构建方式:构建 iOS 开发客户端并提交 TestFlight 可用 eas build -p ios --profile development --submit;本地构建用 eas build -p ios --profile development --local(需 Xcode)或 eas build -p android --profile development --local,产物为 iOS 的 .ipa、Android 的 .apk 或 .aab。也可指定平台:eas build -p ios --profile development、eas build -p android --profile development 或同时构建两平台。

安装本地构建:iOS 模拟器可解压 tar -xzf build-*.tar.gz 后用 xcrun simctl install booted ./path/to/App.app;iOS 真机(需签名)用 ideviceinstaller -i build.ipa;Android 用 adb install build.apk。

使用开发客户端:安装后提供开发服务器连接(输入 Metro URL 或扫码)、构建信息查看和启动器 UI(切换开发服务器)。连接本地开发用 npx expo start --dev-client,再扫码或手动输入 URL。

查看构建状态:eas build:list 列出近期构建,eas build:view 查看构建详情。

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

限制:本地 iOS 构建需 Xcode,真机安装需签名;具体收费、价格与平台支持细节暂未提供。