React Native Starter Kit 项目部署指南:从开发到上架全流程
前言
本文将详细介绍如何将基于 React Native Starter Kit 开发的应用部署到苹果 App Store 和 Google Play 商店。作为一款优秀的 React Native 项目模板,React Native Starter Kit 已经为我们提供了完善的部署工具链和配置方案,我们需要理解并正确执行这些部署流程。
一、新项目初始化配置
在首次部署前,我们需要完成一些一次性配置工作。
1.1 通用配置
首先确保:
- 拥有目标应用商店的开发者账号管理员权限
- 正确设置应用名称和唯一包标识符(Bundle ID)
推荐使用 react-native-rename 工具修改应用名称和包名:
react-native-rename "你的应用名称" -b com.你的公司.应用名称
修改后需在 Xcode 中验证 Bundle ID 是否已更新。
1.2 Android 特有配置
1.2.1 生成签名密钥
使用 keytool 生成发布密钥:
cd android/app && keytool -genkeypair -v -keystore android-release-key.keystore -alias 你的应用-release-key -keyalg RSA -keysize 2048 -validity 10000
请妥善保管生成的密钥文件,切勿提交到代码仓库。
1.2.2 配置 Gradle
在 android/gradle.properties
中配置签名信息:
MYAPP_RELEASE_STORE_FILE=android-release-key.keystore
MYAPP_RELEASE_KEY_ALIAS=你的应用-release-key
MYAPP_RELEASE_STORE_PASSWORD=你的密码
MYAPP_RELEASE_KEY_PASSWORD=你的密码
1.3 iOS 特有配置
首次部署 iOS 应用时,Xcode 会生成私有分发密钥。务必保存此密钥,以便团队其他成员也能分发应用。
1.4 Fastlane 配置
Fastlane 是自动化部署的强大工具,需要完成以下配置:
- 生成 Google Play API 凭证并保存为
android/app/google-play-android-developer.json
- 更新
fastlane/Appfile
中的包名和 App Store Connect 团队 ID - 修改
fastlane/Fastfile
中的相关配置项
二、开发环境部署准备
2.1 Android 环境
- 将密钥文件放置到正确位置:
android/app/android-release-key.keystore
android/app/google-play-android-developer.json
- 确保已安装所有必要的 Android 依赖项
2.2 iOS 环境
- 在 Xcode 中登录开发者账号
- 安装分发私钥(从密码管理器中获取)
2.3 Fastlane 安装
brew cask install fastlane
xcode-select --install
三、应用部署流程
3.1 版本更新
部署前必须更新应用版本号:
bash fastlane/update-app-version.sh
3.2 代码合并与标记
- 将 develop 分支合并到 master 分支(使用合并提交)
- 为合并提交打上版本号标签
3.3 自动化部署(推荐)
使用 Fastlane 可以一键完成构建和部署:
- iOS 部署到 TestFlight:
fastlane ios beta
- Android 部署到 Google Play Beta:
fastlane android beta
3.4 手动部署方案
3.4.1 iOS 手动部署
- 在 Xcode 中将构建配置改为 Release
- 选择 "Generic iOS Device" 作为目标设备
- 执行 Product > Archive
- 在 Organizer 中验证并上传归档
3.4.2 Android 手动部署
- 生成发布包:
cd android && ./gradlew app:bundleRelease
- 上传生成的 AAB 文件到 Google Play
四、部署注意事项
- 密钥安全:所有签名密钥和 API 凭证必须妥善保管,建议使用专业密码管理器
- 版本管理:每次部署前必须更新版本号并打标签
- 测试验证:建议先在测试渠道发布,验证无误后再上架正式版
- 构建系统:某些情况下可能需要切换回 Xcode 旧版构建系统
结语
通过 React Native Starter Kit 提供的部署工具链,我们可以高效地完成应用的构建和发布工作。自动化部署能显著减少人为错误,建议团队优先采用 Fastlane 方案。希望本指南能帮助你顺利完成应用部署流程。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考