17-4 RN之iOS端配置

52 阅读2分钟

课程目标

本节课程的目标是:

  1. 学习如何在 info.plist 中使用 .env 文件中的配置值。
  2. 配置 iOS 项目以支持 react-native-config
  3. 学习如何为 iOS 应用设置图标。

1. 在 info.plist 中使用 .env 配置值

1.1 配置前准备

在 iOS 端,如果仅在原生代码中使用 .env 配置值,无需额外配置即可使用。但如果希望在 Build Settingsinfo.plist 中使用 .env 的值,则需要进行以下配置。


1.2 配置步骤

第一步:创建 Config.xcconfig 文件

  1. 打开项目的 ios 目录,双击 ximalaya.xcworkspace,用 Xcode 打开项目。

  2. 右键项目名,选择 New File,创建一个配置文件。

  3. 将文件命名为 Config.xcconfig,并保存到 ios 文件夹中。

  4. 在 Config.xcconfig 中添加以下内容:

    #include? "tmp.xcconfig"
    

第二步:忽略临时配置文件

  1. 打开项目的 .gitignore 文件。

  2. 添加以下内容,忽略临时生成的 tmp.xcconfig 文件:

    # react-native-config codegen
    ios/tmp.xcconfig
    

第三步:应用 Config 配置

  1. 在 Xcode 中,点击项目名,进入 Project 的 Info 标签页。
  2. 在 Configurations 中,将 Debug 和 Release 都设置为使用 Config.xcconfig

第四步:添加脚本生成临时配置文件

  1. 点击项目中的 Targets,选择你的应用(如 ximalaya)。

  2. 打开 Build Phases

  3. 点击左上角的加号,选择 New Run Script Phase

  4. 添加以下脚本,用于生成 tmp.xcconfig

    "${SRCROOT}/../node_modules/react-native-config/ios/ReactNativeConfig/BuildXCConfig.rb" "${SRCROOT}/.." "${SRCROOT}/tmp.xcconfig"
    

第五步:在 info.plist 中使用配置值

  1. 打开项目的 info.plist 文件。

  2. 找到 Bundle display name 属性,将其值设置为:

    $(APP_NAME)
    
    • 这里的 APP_NAME 是 .env 文件中定义的变量。

2. 安装依赖并链接原生库

2.1 安装 CocoaPods 依赖

  1. 在项目根目录运行以下命令,重新安装 iOS 的依赖库:

    cd ios && pod install
    
  2. 安装完成后,确保 react-native-config 已正确链接到 iOS 项目。


3. 设置 iOS 应用图标

3.1 准备图标资源

  1. 如果有设计师,可以让设计师帮忙设计应用图标。

  2. 如果没有设计师,可以使用在线工具生成图标,推荐使用以下网站:

3.2 添加图标到项目

  1. 将生成的 iOS 图标资源(包含不同分辨率的图片)复制到项目的 ios 文件夹中。
  2. 打开 Xcode,选择 Assets.xcassets,将图标资源拖入到 AppIcon 中。
  3. 确保每个分辨率的图标都已正确配置。

4. 总结

4.1 本节内容总结

  1. 学习了如何在 info.plist 中使用 .env 文件中的值。
  2. 配置了 react-native-config,使其支持 iOS 项目。
  3. 学习了如何为 iOS 应用设置图标。

4.2 思想总结

  • 灵活性:通过 react-native-config,可以在 iOS 项目中动态使用不同环境的配置值。
  • 规范性:通过设置图标等资源,提升应用的整体质量。

5. 下一节预告

接下来,我们将学习如何打包 iOS 应用并发布到 App Store。