框架指南
React Native App Store 提交指南
React Native 应用在提交到 App Store 时需要额外注意一些细节。本指南涵盖从项目配置到成功发布的完整流程。
1 项目设置
准备工作清单
- 更新 React Native：确保使用最新稳定版本
- 运行 pod install：
cd ios && pod install - 检查 Info.plist：确保所有必需的键都已设置
- 更新版本号：在 Xcode 中更新 Version 和 Build 号
- 设置 Bundle ID：确保与 App Store Connect 匹配
提示：使用 npx react-native-version 可以同步更新 iOS 和 Android 版本号。
2 代码签名
React Native 项目使用与原生 iOS 相同的签名流程：
自动签名（推荐）
在 Xcode 中勾选 "Automatically manage signing"，选择您的团队
手动签名
需要配置 Distribution Certificate 和 App Store Provisioning Profile
注意：确保 Release scheme 使用正确的签名配置，Debug 和 Release 通常不同。
3 发布构建
构建步骤
- 在 Xcode 中打开
.xcworkspace文件（不是 .xcodeproj） - 选择 "Any iOS Device (arm64)" 作为构建目标
- 选择 Product → Scheme → Edit Scheme，确保 Run 使用 Release 配置
- Product → Archive
- 等待构建完成，Organizer 窗口会自动打开
CI/CD 提示：可以使用 xcodebuild archive 和 Fastlane 自动化构建流程。
4 上传到 App Store
- 在 Organizer 中选择您的 Archive
- 点击 "Distribute App"
- 选择 "App Store Connect" → "Upload"
- 选择签名选项（通常是自动管理）
- 等待上传完成
- 在 App Store Connect 中验证构建状态
⚠️ 常见问题
ITMS-90809：UIWebView 弃用
确保所有依赖都更新到不使用 UIWebView 的版本。运行 grep -r UIWebView node_modules 检查。
崩溃：找不到 bundle
确保在 Build Phases 中正确配置了 "Bundle React Native code and images" 脚本。
图标缺失
确保在 Images.xcassets 中提供了所有必需尺寸的 App Icon。