react native如何打包
打包 React Native 应用(Android/iOS)
Android 打包步骤
生成签名密钥(如果尚未创建):
keytool -genkey -v -keystore my-release-key.keystore -alias my-key-alias -keyalg RSA -keysize 2048 -validity 10000
在 android/gradle.properties 添加密钥配置:
MYAPP_RELEASE_STORE_FILE=my-release-key.keystore
MYAPP_RELEASE_KEY_ALIAS=my-key-alias
MYAPP_RELEASE_STORE_PASSWORD=yourpassword
MYAPP_RELEASE_KEY_PASSWORD=yourpassword
修改 android/app/build.gradle 签名配置:
android {
...
signingConfigs {
release {
storeFile file(MYAPP_RELEASE_STORE_FILE)
storePassword MYAPP_RELEASE_STORE_PASSWORD
keyAlias MYAPP_RELEASE_KEY_ALIAS
keyPassword MYAPP_RELEASE_KEY_PASSWORD
}
}
buildTypes {
release {
...
signingConfig signingConfigs.release
}
}
}
生成 APK/AAB:
cd android && ./gradlew assembleRelease
# 或生成 App Bundle
cd android && ./gradlew bundleRelease
输出文件路径:
- APK:
android/app/build/outputs/apk/release/app-release.apk - AAB:
android/app/build/outputs/bundle/release/app-release.aab
iOS 打包步骤
配置 Xcode 项目:
- 打开
ios/YourProject.xcworkspace(注意是.xcworkspace而非.xcodeproj) - 在 Xcode 顶部菜单选择
Product > Scheme > Edit Scheme,确保Run和Archive的构建配置均为Release
设置应用图标和启动屏:
在 Xcode 中配置 Assets.xcassets 中的 AppIcon 和 LaunchScreen
生成归档文件:
- 在 Xcode 中选择
Product > Archive - 等待编译完成后,在 Organizer 窗口中选择生成的归档文件
- 点击
Distribute App选择发布方式(App Store/Ad Hoc/Development)
通用优化建议
减小包体积:
- 启用 ProGuard(Android)或混淆(iOS)
- 使用
react-native bundle生成离线资源包 - 移除未使用的依赖库
环境配置:
- 确保
react-native.config.js正确配置资源文件夹 - 检查
metro.config.js中的资源扩展配置
版本管理:
- 同步更新
package.json和原生端的版本号 - Android:
android/app/build.gradle中的versionCode和versionName - iOS:
Info.plist中的CFBundleShortVersionString和CFBundleVersion
调试包与发布包区别
开发模式:
- 包含完整的错误提示和警告
- 支持 Hot Reloading
- 未优化的 JavaScript 代码
发布模式:

- 移除所有开发工具
- 启用代码压缩和优化
- 使用 AOT 编译(iOS)
- 需要手动处理异常捕获






