最近初次使用 React Native (以下简称 RN ) 开发了一个简单的应用，途中踩了几个坑，记录下来希望能给后来人一些帮助。

推荐的入门资料

初次接触一个框架，最重要的两点就是：搭建环境、运行最小的实例。

一般情况下，因为框架的官网是第一手资料来源，且一直保持更新，推荐直接到框架的官网查看上手文档。

但 RN 比较特殊，框架本身还处在开发阶段（没有发布稳定版本），最新的版本可能会有重大问题，比如 0.56.0 的版本在 windows 平台下根本跑不起来，详见 issues/19953；

而且 RN 的开发环境分为简易的沙盒环境和完整的原生环境。

前者不需要安装 Android Studio 或者 Xcode ，但需要通过一个叫做 Expo 的应用以扫码或者打开链接的方式运行应用，而由于众所周知的原因，这个应用在国内非常难安装，从用户反馈来看，也非常难用。

后者需要安装 Android Studio 或 Xcode ，可以编译出平台原生代码，还可以通过模拟器或者连接真实设备运行代码。

综上，建议刚入门的朋友到 React Native 中文网查看上手文档。

搭建环境

以开发 Android 应用为例，JDK/Node/react-native-cli 都不难对付（现在安装 SDK 不需要翻墙，如果你下载 SDK 失败，可以用站长工具反查 SDK Update Sites 中网站的 ip ，然后设置相应的 host ）。

需要特别注意的是在 windows 平台下 Android 开发环境的搭建。

中文网的文档已经更新到 0.56.0 版本的 RN ，而这个版本有致命问题，在选择 Android Studio 的 SDK 时，得安装与 0.55.0 的相应版本：

  • 需要指定 SDK Platform 为 Android 6.0 (Marshmallow)
  • 如果你使用自带的模拟器，还需要安装 Intel x86 Atom_64 System Image
  • 需要安装版本为 23.0.1 的 Android SDK Build-Tools

一个最小的应用实例

按照中文网的文档，运行 react-native init AwesomeProject ，等待一段时间之后就可以初始化一个最小的应用。要注意的是，整个应用的入口不是 App.js 文件，而是 index.js 文件，在 index.js 文件中可以看到有这样一行：

AppRegistry.registerComponent(appName, () => App);

RN 需要调用 AppRegistry.registerComponent 注册作为应用根组件的 App ，其他组件是不需要注册的。

在 App.js 文件中可以看到，RN 的代码书写跟 react 是非常相似的，不一样的就是 RN 的 JSX 不支持所有的原生标签，在 RN 可以近似把 View 组件比作 div 标签。

因为 Android Studio 使用 gradle 编译 Android 代码、打包资源、安装应用，初次运行 react-native run android 启动应用时，都需要安装 gradle ，而国内安装 gradle 速度非常慢，常常导致这一步耗时严重（你还看不到进度条！）。

解决办法是人工下载相应的 gradle 版本，然后放到合适的目录下，具体方法可以看这里。

使用模拟器

如果你使用 Android 模拟器运行代码，在创建模拟器，选择 Emulated Performance 时建议尽量选择硬件，这样会快很多。所有的模拟器在启用硬件加速时都需要显卡支持 OpenGL 2.0 ，如果你的显卡不支持，设法更新驱动。

在 Android 模拟器上连按两下键盘的 r 键，会刷新代码；在 windows 下按下 Ctrl + m 会调出设置菜单，在 macOS 下对应的是 Cmd + m 。在菜单中可以设置 自动刷新、开启元素查看器、 JS 远程调试器。

开启 JS 远程调试时需要特别注意的是，模拟器会在浏览器自动打开一个预设的网址，但这个网址显然是没有运行着 debug 服务器的，这时你需要再次打开设置菜单，点击 Dev Settings，在 Debug server host & port for device 中设置本机的 ip 和端口，具体来说填写的是：localhost:8081。

8081 端口号是 react-native run-android 这个命令决定的，因为是在本机调试，理论上填 127.0.0.1 或者 localhost 都行，但实际上 127.0.0.1 会连接不上。

一些技巧

  • 屏幕适配问题

原生应用不像网页，一般来说就算 view 的尺寸过长也不会自动出现滚动条的，而是被截断。所以开发前尽量先明确要适配的屏幕大小，对其他尺寸的屏幕大体来说采用固定某个维度，按一定比例缩放另一维度的方式适配。

本人对这方面研究不多，所说不一定正确，可以参考这个实现。

  • 使用 svg

RN 官方不支持 svg ，而第三方对 svg 的支持又很有限。暂时能找到比较好的实现在这里。原理大致上是通过 react-native-svg-uri 组件的 svgXmlData 属性加载以 xml 形式保存下来的 svg 文件。

  • 抓包调试

要抓包调试，得先设置代理。如果使用官方的模拟器，可以点击工具条上最边缘的那个按钮(more)，打开 extended controls，然后依次点击： Settings -> Proxy -> Manual proxy configuration ，填入代理地址，最后点击 Apply 。

  • 编译 APK 报错

使用命令 cd android && ./gradlew assembleRelease 编译 apk 时，会遇到多种报错的情况，这些错都有相应的打印信息。

其中一种错误是，执行某个第三方组件的编译任务时，报 Failed to execute aapt 错，具体一点是找不到某个资源，比如

error: resource android:style/TextAppearance.Material.Widget.Button.Borderless.Colored not found

原因是 RN 本身升级比较频繁，它设置的 compileSdkVersion 版本升级也比较频繁，在引入第三方组件，而且这个组件需要更改 gradle 配置来实现编译原生代码时，组件所设置的 compileSdkVersion 往往比 RN 项目里的早，这样可能导致项目用到一些组件中没有的 API 。

上面的例子中， android:style/TextAppearance.Material.Widget.Button.Borderless.Colored 是 API 24 才添加的（意味着项目设置的 compileSdkVersion 大于等于 24），只要组件的 compileSdkVersion 比 24 小就有可能出现问题。

解决的办法有两个：

  • 降低项目的 compileSdkVersion 。但这样就用不到最新的 API 了。
  • 升级组件的 compileSdkVersion/buildToolsVersion/supportLibVersion。

实现后者也有两种办法：

  • 修改 node_modules/组件名/android/build.gradle。（直接暴力，但不推荐）
  • 修改项目的 build.gradle。

后者往 build.gradle 中加入如下代码，出处：

subprojects {
    afterEvaluate {project ->
        if (project.hasProperty("android")) {
            android {
                compileSdkVersion 27 // 与 buildscript 中的保持一致
                buildToolsVersion '27.0.3' // 与 buildscript 中的保持一致
            }
        }
    }
}

上面代码做的事情：在解释完所有的 build.grandle 之后，执行 task 之前，修改所有带有 android 属性的子 project ，设置它们的 android 属性中的 compileSdkVersion/buildToolsVersion 为指定值。（第三方组件如果需要在 npm install 后，运行 react-native link xxx，link 做的事情就是修改 settings.gradle/build.gradle 文件，把自己当成子 project 引入、编译）

一些坑

  • 修改后的代码不生效

如果你发现修改后的代码不生效，先看终端里打印的编译信息，很多时候代码不生效是因为编译时遇到语法错误。

  • 避免使用 console.error

与 javascript 开发不一样，RN 在开发环境中，一旦执行这句 console.error ，会显示 red screen error ，让你误以为应用崩溃了。

  • Modal

Modal 是官方弹窗组件。在使用模拟器开发时要注意，不要在 Modal 弹出时按两下 r 刷新应用，一定要先关闭 Modal 再刷新应用，否则 Modal 刷新后也不会消失。如果你已经这么做了，一个解决办法是点击模拟器的“多任务按钮”，把应用杀掉再重启。

  • AsyncStorage.getItem

当你需要使用本地持久化功能时，就会使用到 AsyncStorage 这个模块。而在调用 AsyncStorage.getItem 获取之前保存的信息时，非常有意思的是，写在这行代码的下一行代码不生效。如下：

let info = AsyncStorage.getItem('key')
console.log('info: ', info) // 这行代码不会执行
console.log('funny!') // 而这行代码会执行

0.57 已解决这个问题。如果不能升级，或许可以这样做：

let info = AsyncStorage.getItem('key')
// 别手欠删掉这行注释，否则后果自负！https://github.com/facebook/react-native/issues/18372
console.log('info: ', info)
  • display: ‘none’ 与 position: ‘absolute’ 同时使用

这样做会导致前者失效。这个问题在 0.57 上仍然存在，坊间的解决办法是拆分两个属性，前者应用在父元素上，后者用在子元素上。

  • 运行打包出来的 app-release.apk 闪退

这个问题出现在 0.56 和 0.57 两个版本上。

闪退通常是因为抛出来的异常没有被捕获，异常的来源又分为 javascript 和 原生系统 。为了让 app 表现得友好一点，可以安装一个异常捕获的组件，如 react-native-exception-handler。

有时候异常捕获组件不一定起作用，比如这个闪退问题。这时需要调试、看日志：找一根 usb 连接设备，在项目根目录运行 react-native log-android (如果是 iOS，则运行 react-native log-android)，然后运行 apk 。详细文档在此。

闪退的原因是这两个版本的 RN 打包出来的 apk 不包含 @babel/proposal-decorators 需要用到的两个方法： initializerDefineProperty 和 applyDecoratedDescriptor。解决思路是手动注入这两个方法。

具体办法见这里提到的 Workaround 2 。

TO Be Continued / つづく / 未完待续