React Native 0.69 版本支持

[zhiqingchen]

• 提案时间: (2022-07-27)
• 影响版本: (3.x)

概述

将默认的 RN 版本切换至 0.69，expo 版本切换至 46。
参考React Native 0.68 版本支持

动机

React Native 0.69 版本已于 2022-6-21 正式发布。0.69 是首个支持 React 18 的版本。expo 也已提供了最新的 46 版本，支持了 react native 69。
Taro 将与 RN 社区保持同步，将默认的 RN 版本设置为 0.69。

使用案例

将 Taro 升级至最新版，将原生代码根据相关pr进行变更。

详细设计

优先将兼容 0.68 的依赖升级，以便平滑升级

0. react-native-gesture-handler
1. react-native-svg
2. react-native-safe-area-context

Taro 主仓库升级至 0.69

升级内容：

0. 将不兼容的RN依赖库进行升级，并验证其功能可用性。
1. 将 @types/react-native 及 react-native 进行版本更新。
2. 将 metro、@react-native-community/cli-plugin-metro 相关依赖与 0.69 使用的版本进行同步。
3. 将默认安装的RN版本进行更新 https://github.com/NervJS/taro/blob/next/packages/taro-cli/src/presets/platforms/rn.ts#L33

Taro Native Shell 升级至 0.69

分支：https://github.com/NervJS/taro-native-shell/tree/0.69.0

参考 upgrade-helper

Taro Project Template 升级至 0.69

由于 RN 版本的升级，会导致兼容性变更，如 iOS 系统不再支持 12.4 以下版本。考虑保留 0.68 模板，将当前 v3.5 分支 fork 至 v3.5-rn68。默认版本使用 0.69。

0. 更新代码同 Taro Native Shell 升级至 0.69。

Taro Playground 升级至 0.69

分支：

https://github.com/wuba/taro-playground/tree/releases/v1.7.0

升级内容：

0. 版本号改为 v1.7.0。
1. 更新代码同 Taro Native Shell 升级至 0.69。

缺陷

• 0.69 版本发布时间较短，及时跟进 0.69 问题。
• IPHONEOS_DEPLOYMENT_TARGET 由 12.0 改为 12.4。 需要向下兼容的开发者，需要保留在低版本。

替代选择

N/A

适配策略

无法兼容的依赖说明：

0. react-native-gesture-handler 会升级至 2.5.0，若使用 Playground 调试，需要版本对应。

0.68 兼容，需要使用 react 17

{
  "dependencies": {
    "expo-av": "~11.2.3"
  },
  "resolutions": {
    "expo-av": "~11.2.3"
  }
}

0.69 兼容，建议使用 react 18

{
  "dependencies": {
    "expo-av": "~12.0.3"
  },
  "resolutions": {
    "expo-av": "~12.0.3"
  }
}

• Taro 主工程默认使用 0.69，保证旧版本 RN 仍正常使用新版本的 Taro。
• 有些包（如 metro）可能无法向下兼容，则需要用户使用 resolution 进行版本锁定，需要在版本更新时说明。

[zhiqingchen]

Taro Project Template 升级至 0.69 测试

对应分支

https://github.com/zhiqingchen/taro-project-templates/tree/v3.5

# 全局安装beta版本cli
yarn global add @tarojs/cli@alpha

# 通过模板进行初始
taro init --template-source github:zhiqingchen/taro-project-templates#v3.5

# 初始化后安装依赖
yarn upgradePeerdeps

1. 修改 assemble_ios_debug.yml 配置
   1. APP_ID: ${{secrets.APP_ID}}
   2. TEAM_ID: ${{secrets.TEAM_ID}}
   3. PROVISIONING_PROFILE_SPECIFIER: ${{secrets.DEBUG_PROVISIONING_PROFILE_SPECIFIER}}
   4. CODE_SIGN_IDENTITY: Apple Development
2. 修改 assemble_ios_release.yml 配置
   1. APP_ID: ${{secrets.APP_ID}}
   2. TEAM_ID: ${{secrets.TEAM_ID}}
   3. PROVISIONING_PROFILE_SPECIFIER: ${{secrets.RELEASE_PROVISIONING_PROFILE_SPECIFIER}}
   4. CODE_SIGN_IDENTITY: Apple Distribution

# 将源设置为 shell 工程
git remote add origin git@github.com:NervJS/taro-native-shell.git

# 10 为自增数字
git tag v0.69.3-beta.0
git push origin v0.69.3-beta.0

查看打包是否正常进行

https://github.com/NervJS/taro-native-shell/actions

参考分支

https://github.com/NervJS/taro-native-shell/tree/test/template-0.69-0

[zhiqingchen]

Taro Native Shell 升级至 0.69 测试

对应分支

https://github.com/NervJS/taro-native-shell/commits/0.69.0

下载现有包进行验证

https://github.com/NervJS/taro-native-shell/releases/tag/v0.69.3-3

修改代码后

# 10 为自增数字
git tag 0.69.3-10
git push origin v0.69.3-10

查看打包是否正常进行

https://github.com/NervJS/taro-native-shell/actions

[zhiqingchen]

Taro 主仓库升级至 0.69

对应分支

https://github.com/NervJS/taro/tree/feat/react-native

pr
#12314

包安装

3.5.4-alpha.1

测试点

0. metro 启动正常，远程加载正常，打包 bundle 正常
1. 跨端文件处理正常 .rn.
2. alias 配置正常
3. 文件修改热更新
4. app 或 page 配置更新后 reload
5. 组件（picker、richtext、audio、video）

[zhiqingchen]

Taro Playground 升级至 0.69 测试

对应分支

https://github.com/wuba/taro-playground/tree/releases/v1.7.0

包下载
https://github.com/wuba/taro-playground/releases/tag/v1.7.0-beta.3

Taro Playground 0.68 使用新版 taro 测试

对应分支

https://github.com/wuba/taro-playground/tree/releases/v1.6.5

包下载
https://github.com/wuba/taro-playground/releases/tag/v1.6.5-beta.0