# React Native学习之适配Android IOS总结篇|博客系列

> 本文系统总结了React Native在Android和iOS平台的环境搭建、适配技巧、常见问题及解决方案，帮助开发者高效实现跨平台移动应用开发与优化。

- 原文：https://feinterview.poetries.top/docs/fe-blog-docs/blog-docs/react-native/-React%20Native%E5%AD%A6%E4%B9%A0%E4%B9%8B%E9%80%82%E9%85%8DAndroid%20IOS%E6%80%BB%E7%BB%93%E7%AF%87
- 来源：前端进阶之旅（feinterview.poetries.top）
- 更新：2025.10.25
- 可见范围：免费部分

---

## 一、环境搭建

### 1.1 React Native环境搭建

#### 1.1.1 IOS环境搭建

> 环境：`MacOS`

```bash
# 如果你已经安装了 Node，请检查其版本是否在 v8.3 以上
brew install node 

# Watchman则是由 Facebook 提供的监视文件系统变更的工具。安装此工具可以提高开发时的性能
brew install watchman
```

- **注意**：不要使用 `cnpm`！`cnpm` 安装的模块路径比较奇怪，`packager` 不能正常识别！

```
npm install -g yarn react-native-cli
```

**1. 创建新项目**

> `init` 命令默认会创建最新的版本，而目前最新的`0.45` 及以上版本需要下载 `boost` 等几个第三方库编译。这些库在国内即便翻墙也很难下载成功，导致很多人无法运行`iOS`项目。可以暂时创建`0.44.3`的版本

```
react-native init MyApp --version 0.44.3
```

**2. 编译并运行 React Native 应用**

1). **运行方式一** 在你的项目目录中运行`react-native run-ios`

```
cd MyApp
react-native run-ios
```

2). **运行方式二** 在`xCode`中运行

> 打开`xcode`选择项目中`myApp/ios/myApp.xcodeproj`，然后点击左上角运行即可

> 更多详情 https://reactnative.cn/docs/getting-started.html

**3. 远程调试**

- `ctrl + R`刷新
- `ctrl + D` 选择对应的工具调试

![](https://s.poetries.top/gitee/2019/10/513.png)

**Enable Live Reload**

> 当你的js代码发生变化后，`React Native`会自动生成bundle然后传输到模拟器或手机上

![](https://s.poetries.top/gitee/2019/10/514.gif)

> 在浏览器中打开 http://localhost:8081/debugger-ui

![](https://s.poetries.top/gitee/2019/10/515.png)

**巧用Sources面板**

![](https://s.poetries.top/images/202202211655559.png)

**指定模拟的设备类型**

- 你可以使用`--simulator`参数，在其后加上要使用的设备名称来指定要模拟的设备类型（目前默认为`"iPhone X"`）。如果你要模拟 `iPhone 4s`，那么这样运行命令即可：`react-native run-ios --simulator "iPhone 4s"`。
- 你可以在终端中运行`xcrun simctl list devices`来查看具体可用的设备名称

![](https://s.poetries.top/gitee/2019/10/516.png)

#### 1.1.2 安卓环境搭建

**安装依赖**

> 必须安装的依赖有：`Node`、`Watchman` 和 `React Native` 命令行工具以及 JDK 和 `Android Studio`

```
brew install node
brew install watchman
```

```
npm install -g yarn react-native-cli
```

**Java Development Kit**

> `React Native` 需要 `Java Development Kit [JDK] 1.8`（暂不支持 `1.9` 及更高版本）。你可以在命令行中输入

- `javac -version`来查看你当前安装的 `JDK `版本。如果版本不合要求，则可以到 [官网](https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)上下载

**1. 安装 Android Studio**

> 首先下载和安装 [`Android Studio`](https://developer.android.com/studio/index.html)，国内用户可能无法打开官方链接，请自行使用搜索引擎搜索可用的下载链接。安装界面中选择"Custom"选项，确保选中了以下几项

- `Android SDK`
- `Android SDK Platform`
- `Performance (Intel ® HAXM)`
- `Android Virtual Device`

> 然后点击"`Next`"来安装选中的组件。安装完成后，看到欢迎界面时，就可以进行下面的操作了

**2. 安装 Android SDK**

> `Android Studio` 默认会安装最新版本的 `Android SDK`。目前编译 `React Native` 应用需要的是`Android 8.1 (Oreo)`版本的 `SDK`。你可以在 `Android Studio` 的 `SDK Manager` 中选择安装各版本的 `SDK`

你可以在 `Android Studio` 的欢迎界面中找到 `SDK Manager`。点击"`Configure`"，然后就能看到"`SDK Manager`"。

![](https://s.poetries.top/gitee/2019/10/517.png)

> 在 `SDK Manager `中选择"`SDK Platforms`"选项卡，然后在右下角勾选"`Show Package Details`"。展开`Android 8.1 (Oreo)`选项，确保勾选了下面这些组件（重申你必须使用稳定的翻墙工具，否则可能都看不到这个界面）：

- `Android SDK Platform 27`
- `Intel x86 Atom_64 System Image`（官方模拟器镜像文件，使用非官方模拟器不需要安装此组件）

![](https://s.poetries.top/gitee/2019/10/518.png)

> `SDK Manager` 还可以在` Android Studio` 的"Preferences"菜单中找到。具体路径是`Appearance & Behavior → System Settings → Android SDK`

- 然后点击"`SDK Tools`"选项卡，同样勾中右下角的"`Show Package Details`"。展开"`Android SDK Build-Tools`"选项，确保选中了 `React Native` 所必须的`27.0.3`版本。你可以同时安装多个其他版本

![](https://s.poetries.top/gitee/2019/10/519.png)

> 最后点击"`Apply`"来下载和安装这些组件。

**3. 配置 ANDROID_HOME 环境变量**

> `React Native` 需要通过环境变量来了解你的 `Android SDK` 装在什么路径，从而正常进行编译

- 具体的做法是把下面的命令加入到`~/.bash_profile`文件中

```bash
# 如果你不是通过Android Studio安装的sdk，则其路径可能不同，请自行确定清楚。
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/tools/bin
export PATH=$PATH:$ANDROID_HOME/platform-tools
export PATH=$PATH:$ANDROID_HOME/emulator
```

> 如果你的命令行不是 `bash`，而是例如 `zsh` 等其他，请使用对应的配置文件

> 使用`source $HOME/.bash_profile`命令来使环境变量设置立即生效（否则重启后才生效）。可以使用`echo $ANDROID_HOME`检查此变量是否已正确设置

**4. 编译并运行 React Native 应用**

> 确保你先运行了模拟器或者连接了真机，然后在你的项目目录中运行`react-native run-android`

**Android Studio自带工具运行**

![](https://s.poetries.top/gitee/2019/10/520.png)

**使用genymotion模拟器**

> 去官网需要注册并下载https://www.genymotion.com/，需要注册登录再下载的。注意下载`with virtualBox`版本，然后安装完成后需要登录，就是刚才注册的账号。登录后进入这个页面做两个操作

![](https://s.poetries.top/gitee/2019/10/521.png)

> 点击`settings`，选择`adb`设置`sdk`就是刚才一直用的`sdk`安装路径,如下

![](https://s.poetries.top/gitee/2019/10/522.png)

> 启动项目，点击`genymotion`里的`start`启动我们刚才安装好的的虚拟设备，是这个样子的，此时我们刚才初始化的项目还没连上虚拟设备

![](https://s.poetries.top/gitee/2019/10/523.png)

> 然后在我们的工程项目里执行`adb devices`会列出当前启动的虚拟设备，能检测到说明没问题，如下图里最后一行显示的就是刚才我们开启的`genymotion`那台虚拟设备

![](https://s.poetries.top/gitee/2019/10/524.png)

最后项目目录里执行

```
react-native run-android
```

> 打开`genymotion`，欢迎页面出来了，成功，修改一下文字，重新加载一遍，成功

- 第一次默认不是热加载形式，就是改变文件内容需要手动刷新的，这里设置一下热加载，以后内容这里就会自动刷新，`mac`是执行`command+r`，选择第四个`hot reloading`

![](https://s.poetries.top/gitee/2019/10/525.png)

> 运行`react-native run-andriod` 会下载很多东西，然后出现这个标志说明编译没有问题，还缺少一个模拟设备

![](https://s.poetries.top/gitee/2019/10/526.png)
![](https://s.poetries.top/gitee/2019/10/527.png)
![](https://s.poetries.top/gitee/2019/10/528.png)

**如果是安卓5.0以下需要配置一下IP**

![](https://s.poetries.top/gitee/2019/10/529.png)

### 1.2 安卓设备真机调试

**1. 开启 USB 调试**

> 在默认情况下 `Android` 设备只能从应用市场来安装应用。你需要开启 `USB` 调试才能自由安装开发版本的 `APP`

**2. 通过 USB 数据线连接设备**

> 下面检查你的设备是否能正确连接到 `ADB（Android Debug Bridge）`，使用`adb devices`命令：

![](https://s.poetries.top/gitee/2019/10/530.png)

**3. 运行应用**

> 现在你可以运行`react-native run-android`来在设备上安装并启动应用了

**从设备上访问开发服务器**

- 运行`adb reverse tcp:8081 tcp:8081`
- 在命令行执行 `adb shell input keyevent 82`弹出开发者工具。打开热更新和远程调试

![](https://s.poetries.top/gitee/2019/10/531.png)

### 1.3 移除vscode装饰器报错

> 点击`Visual Studio Code`左下角的配置按钮。在搜索框内输入“experimentalDecorators”，发现竟然能够找到选项，如下

```
"javascript.implicitProjectConfig.experimentalDecorators": false
```

试着将`false`改为`true`，重启`Visual Studio Code`

> https://blog.csdn.net/yiifaa/article/details/78862507

## 二、矢量图标的运用

https://github.com/oblador/react-native-vector-icons

> `react-native-vector-icons` 是可以直接使用图片名就能加载图片的第三方,类似于`web的 iconfont`矢量图，使用很方便, 你不需要在工程文件夹里塞各种图片, 节省很多空间,下面就来看看怎么使用吧

```
npm install react-native-vector-icons --save
npm install rnpm -g
```

### 2.1 android平台

**1. 自动配置**

```bash
react-native link react-native-vector-icons
# 或者
npm install -g rnpm
rnpm link react-native-vector-icons
```

> 会为你配置好所有，但是这是成功的情况下，你不需要操心任何事，但是往往不能如愿。如果你这步成功了，而且能够正常运行，下面这些你就可以跳过

**2. 手动配置**

- 第一步：复制字体文件（这一步千万不能忘记，不然就算运行成功你也看不到图标）

> 找到项目`node_modules/react-native-vector-icons/Fonts`，里面有很多已经内置的图标库字体文件，依照自己的需求，复制你需要的字体文件到 `android/app/src/main/assets/fonts`，（如果没有这个目录就自行创建）

![](https://s.poetries.top/gitee/2019/10/532.png)

- 第二步：配置 `android/settings.gradle`

在现有的代码基础上添加如下代码

```
include ':react-native-vector-icons'
project(':react-native-vector-icons').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-vector-icons/android')
```

- 第三步：配置`android/app/build.gradle`

```js
dependencies {
    compile project(':react-native-vector-icons') //添加
    compile fileTree(dir: "libs", include: ["*.jar"])
    compile "com.android.support:appcompat-v7:23.0.1"
    compile "com.facebook.react:react-native:+"  // From node_modules
    compile project(':react-native-navigation')
}
```

- 第四步：配置 `android/app/src/main/java/com/xxxx/MainApplication.java`

```js
import com.oblador.vectoricons.VectorIconsPackage;
@Override
  protected List<ReactPackage> getPackages() {
    return Arrays.<ReactPackage>asList(
      new MainReactPackage()
+   , new VectorIconsPackage()
    );
  }
```

> 到这里配置就全部完成，接下来就可以在`rn`项目中使用`iconfont`

![](https://s.poetries.top/gitee/2019/10/533.png)

### 2.2 IOS平台

> 打开你的`Xcode`项目工程，右键工程文件，选择`react`项目下的`node_modules/react-native-vector-icons/Fonts`文件

![](https://s.poetries.top/gitee/2019/10/534.png)

**在xcode的Info.plist文件中,加入: Fonts provided by application数组**

![](https://s.poetries.top/gitee/2019/10/535.png)

> 打开终端，输入：`rnpm link`，回车后会看到`Fonts provided by application`下加入如下字体

![](https://s.poetries.top/gitee/2019/10/536.png)

> 重新运行`react`项目，终端输入：`react-native run-ios`，可以看到效果了

## 三、react-native-router-flux的使用

> https://github.com/aksonov/react-native-router-flux

### 3.1 简介

**特性**

> `react-native-router-flux` 是一个路由包.在一个中心区域定义可切换`scene`模块。在使用过程中，跟`react-native`提供的`navigator`的区别是你不需要有`navigator`对象。你可以在任意地方使用简单的语法去控制`scene`的切换，如：` Actions.login({username, password})`  or `Actions.profile({profile})` or 甚至`Actions.profile(123)` ,其中`login` `profile`等是路由的`key`，通过调用`key`来切换路由

- 所有的参数将被注入到`this.props`中给`Sene`组件使用

**功能和亮点**

- 可定制的导航条：由`Scene`或者`Scene`的`state`去控制导航条的`show`／`hide`
- 嵌套导航：每一个`tab`都可以有自己的导航，该导航被嵌套在`root`导航中
- 使用`Action sheet` 来自定义场景渲染器
- 动态路由：动态路由将允许你通过应用的`state`去选着哪个`scene`将被渲染
- `Reset History stack`重置历史栈：新的`reset` 类型将提供清除历史栈河消除导航的返回按钮的功能
- 更加强大的状态控制：在多个`scene`中可以有不同的`state`

```
npm i react-native-router-flux --save
```

**使用方式一**

> 在你的`src/index.js`级别的文件中使用`Scene`组件定义你的`scenes`，并且`Scene`组件作为`Router`的子节点。定义好的`Scene`将由`Router`来控制其行为

```js
import {Scene, Router, Actions} from 'react-native-router-flux';

import {Router, Scene} from "react-native-router-flux";
import PageOne from "./Component/PageOne"; 
import PageTwo from "./Component/PageTwo";

const Root = () => {
  return (
    <Router>
      {/* 这种写法是将全部的跳转页面都放在Root下面 */}
      <Scene key="root">
        {/* key 就是给页面的标签,供Actions使用 */}
        {/* component 设置关联的页面 */}
        {/* title 就是给页面标题 */}
        {/* initial 就是设置默认页面*/}
        <Scene
          key="one"
          component={PageOne}
          title="PageOne"
          initial={true}
        />
        <Scene key="two" component={PageTwo} title="PageTwo" />

      </Scene>
    </Router>
  );
};
```

**第二种使用方式**

> 你可以在编译期定义你所有的`scenes`，并在后面的`Router`里面使用

```jsx
import {Actions, Scene, Router} from 'react-native-router-flux';

const scenes = Actions.create(
  <Scene key="root">
    <Scene key="login" component={Login} title="Login"/>
    <Scene key="register" component={Register} title="Register"/>
    <Scene key="home" component={Home}/>
  </Scene>
);

/* ... */

class App extends React.Component {
  render() {
    return <Router scenes={scenes}/>
  }
}
 {Actions, Scene, Router} from 'react-native-router-flux';

const scenes = Actions.create(
  <Scene key="root">
    <Scene key="login" component={Login} title="Login"/>
    <Scene key="register" component={Register} title="Register"/>
    <Scene key="home" component={Home}/>
  </Scene>
);

/* ... */

class App extends React.Component {
  render() {
    return <Router scenes={scenes}/>
  }
}
```

在任意地方通过导入

```js
import {Actions} from 'react-native-router-flux'
```

> 获得`Actions` 对象，`Actions`对象将是我们操作`Scenes`的遥控器。通过`Actions`我们可以向`Router`发出动作让`Router`控制`Scene`变化。

---

> 以上是免费部分。完整内容需要「前端进阶之旅」会员，原文：https://feinterview.poetries.top/docs/fe-blog-docs/blog-docs/react-native/-React%20Native%E5%AD%A6%E4%B9%A0%E4%B9%8B%E9%80%82%E9%85%8DAndroid%20IOS%E6%80%BB%E7%BB%93%E7%AF%87
