Expo 本地打包 APK 文件指南
要在本地使用 Expo 打包 APK 文件,你需要使用 expo build:android 命令。以下是详细步骤:
准备工作
确保已安装:
Node.js (建议使用 LTS 版本)
Expo CLI (npm install -g expo-cli)
Java Development Kit (JDK 8 或更高版本)
Android Studio (用于设置 Android 开发环境)
在项目目录中运行 expo login 登录你的 Expo 账户
打包 APK 步骤
进入项目目录:
bash
cd your-project-directory
构建 APK:
bash
expo build:android
在提示中选择构建类型:
选择 APK (如果你想构建 app bundle 可以选择 Android App Bundle)
等待构建完成:
这可能需要几分钟时间
你可以在 Expo 构建仪表板 查看进度
下载 APK:
构建完成后,Expo 会提供下载链接
或者使用以下命令下载:
bash
expo build:status
本地构建选项(自 Expo CLI 5.0+)
如果你想完全在本地构建(不依赖 Expo 云服务):
安装 Turtle CLI(用于本地构建):
bash
npm install -g turtle-cli
设置环境变量:
bash
export EXPO_ANDROID_KEYSTORE_PASSWORD="your-keystore-password"
export EXPO_ANDROID_KEY_PASSWORD="your-key-password"
运行本地构建:
bash
expo build:android --local
注意事项
首次构建需要你提供或创建 keystore 文件(用于签名 APK)
请妥善保管你的 keystore 文件,丢失后将无法更新应用
构建的 APK 文件默认是调试版本,发布到商店需要构建发布版本
构建发布版本
要构建发布版本的 APK:
bash
expo build:android --release-channel production
问题排查
如果遇到问题,可以尝试:
更新 Expo CLI:npm install -g expo-cli
清除缓存:expo r -c
检查 app.json 中的 Android 配置是否正确
本作品采用 知识共享署名-相同方式共享 4.0 国际许可协议 进行许可。