课程目标
本节课程的目标是:
- 学习如何在
info.plist
中使用.env
文件中的配置值。 - 配置 iOS 项目以支持
react-native-config
。 - 学习如何为 iOS 应用设置图标。
1. 在 info.plist 中使用 .env 配置值
1.1 配置前准备
在 iOS 端,如果仅在原生代码中使用 .env
配置值,无需额外配置即可使用。但如果希望在 Build Settings
和 info.plist
中使用 .env
的值,则需要进行以下配置。
1.2 配置步骤
第一步:创建 Config.xcconfig 文件
-
打开项目的
ios
目录,双击ximalaya.xcworkspace
,用 Xcode 打开项目。 -
右键项目名,选择 New File,创建一个配置文件。
-
将文件命名为
Config.xcconfig
,并保存到ios
文件夹中。 -
在
Config.xcconfig
中添加以下内容:#include? "tmp.xcconfig"
第二步:忽略临时配置文件
-
打开项目的
.gitignore
文件。 -
添加以下内容,忽略临时生成的
tmp.xcconfig
文件:# react-native-config codegen ios/tmp.xcconfig
第三步:应用 Config 配置
- 在 Xcode 中,点击项目名,进入 Project 的 Info 标签页。
- 在 Configurations 中,将
Debug
和Release
都设置为使用Config.xcconfig
。
第四步:添加脚本生成临时配置文件
-
点击项目中的 Targets,选择你的应用(如
ximalaya
)。 -
打开 Build Phases。
-
点击左上角的加号,选择 New Run Script Phase。
-
添加以下脚本,用于生成
tmp.xcconfig
:"${SRCROOT}/../node_modules/react-native-config/ios/ReactNativeConfig/BuildXCConfig.rb" "${SRCROOT}/.." "${SRCROOT}/tmp.xcconfig"
第五步:在 info.plist 中使用配置值
-
打开项目的
info.plist
文件。 -
找到
Bundle display name
属性,将其值设置为:$(APP_NAME)
- 这里的
APP_NAME
是.env
文件中定义的变量。
- 这里的
2. 安装依赖并链接原生库
2.1 安装 CocoaPods 依赖
-
在项目根目录运行以下命令,重新安装 iOS 的依赖库:
cd ios && pod install
-
安装完成后,确保
react-native-config
已正确链接到 iOS 项目。
3. 设置 iOS 应用图标
3.1 准备图标资源
-
如果有设计师,可以让设计师帮忙设计应用图标。
-
如果没有设计师,可以使用在线工具生成图标,推荐使用以下网站:
3.2 添加图标到项目
- 将生成的 iOS 图标资源(包含不同分辨率的图片)复制到项目的
ios
文件夹中。 - 打开 Xcode,选择 Assets.xcassets,将图标资源拖入到
AppIcon
中。 - 确保每个分辨率的图标都已正确配置。
4. 总结
4.1 本节内容总结
- 学习了如何在
info.plist
中使用.env
文件中的值。 - 配置了
react-native-config
,使其支持 iOS 项目。 - 学习了如何为 iOS 应用设置图标。
4.2 思想总结
- 灵活性:通过
react-native-config
,可以在 iOS 项目中动态使用不同环境的配置值。 - 规范性:通过设置图标等资源,提升应用的整体质量。
5. 下一节预告
接下来,我们将学习如何打包 iOS 应用并发布到 App Store。