ReactNative 实战之QuickStart

时间 2020-02-02

标签 reactnative 实战 quickstart 繁體版

原文原文链接

Quick Start

Installation

Requirements

OS X - 目前ReactNative只支持Mac系统javascript
Homebrewjava
安装NodeJs 4.0或以上版本，推荐使用NVM版本管理器安装：node
```
```nvm install node && nvm alias default node```
```

4.brew install watchmanreact

5.brew install flowandroid

Create New Application(建立新的应用)

$ npm install -g react-native-cli 
$ react-native init FirstProject 
$ cd FirstProject/

建立新的应用以后，能够在iOS的文件夹内看到以下的文件部署：webpack

Build

若是是在Xcode中选择运行该项目，或者手动容许编译命令：npm start，既能够看到以下的界面：ios

一旦编译打包完成，iOS的模拟器中会启动默认的应用程序，呈现出以下的界面：git

常见错误github

TypeError: Cannot read property 'root' of nullweb

能够尝试使用brew update & brew update watchman

或者

npm install --registry=http://registry.npm.taobao.org

JavaScript Environment(JavaScript运行环境)

在React Native 0.5.0版本以后，React Native已经迁移到了Babel编译器，能够直接查看Babel的官方文档来获取其编译支持的状况。

ES5

Reserved Words: promise.catch(function() { });

ES6

Arrow functions: this.setState({pressed: true})}
Call spread: Math.max(...array);
Classes: class C extends React.Component { render() { return ; } }
Destructuring: var {isActive, style} = this.props;
Modules: import React, { Component } from 'react-native';
Object Consise Method: var obj = { method() { return 10; } };
Object Short Notation: var name = 'vjeux'; var obj = { name };
Rest Params: function(type, ...args) { }
Template Literals: var who = 'world'; var str = Hello ${who};

ES7

Object Spread: var extended = { ...obj, a: 10 };
Function Trailing Comma: function f(a, b, c,) { }

React Native Webpack Server

笔者已经习惯使用Webpack做为模块管理与编译工具，在React Native的开发中，一样可使用Webpack进行开发，笔者参考的是这个Repo。

安装

npm install --save-dev react-native-webpack-server

使用

React Native命令行默认会查找index.ios.js或者index.android.js文件做为整个项目的根文件，在Webpack的配置文件中则能够按照Webpack的风格进行以下配置：

entry: {
  'index.ios': ['./src/main.js']
}

完整的webpack.config.js配置文件以下：

var fs = require('fs');
var path = require('path');
var webpack = require('webpack');

var config = {

  debug: true,

  devtool: 'source-map',

  entry: {
    'index.ios': ['./src/main.js'],
  },

  output: {
    path: path.resolve(__dirname, 'build'),
    filename: '[name].js',
  },

  module: {
    loaders: [{
      test: /\.js$/,
      exclude: /node_modules/,
      loader: 'babel',
      query: {
        stage: 0,
        plugins: []
      }
    }]
  },

  plugins: [],

};

// Hot loader
if (process.env.HOT) {
  config.devtool = 'eval'; // Speed up incremental builds
  config.entry['index.ios'].unshift('react-native-webpack-server/hot/entry');
  config.entry['index.ios'].unshift('webpack/hot/only-dev-server');
  config.entry['index.ios'].unshift('webpack-dev-server/client?http://localhost:8082');
  config.output.publicPath = 'http://localhost:8082/';
  config.plugins.unshift(new webpack.HotModuleReplacementPlugin());
  config.module.loaders[0].query.plugins.push('react-transform');
  config.module.loaders[0].query.extra = {
    'react-transform': {
      transforms: [{
        transform: 'react-transform-hmr',
        imports: ['react-native'],
        locals: ['module']
      }]
    }
  };
}

// Production config
if (process.env.NODE_ENV === 'production') {
  config.plugins.push(new webpack.optimize.OccurrenceOrderPlugin());
  config.plugins.push(new webpack.optimize.UglifyJsPlugin());
}

module.exports = config;

在项目的package.json能够添加以下控制脚本：

"scripts": {
  "bundle": "rnws bundle",
  "start": "rnws start"
}

使用npm start命令便可开启开发服务器，在代码中设置路径以下便可：

jsCodeLocation = [NSURL URLWithString:@"http://localhost:8080/index.ios.bundle"];

若是须要构建一个发布版本，则可使用以下命令：

rnws bundle
# OR, using the above package.json script:
npm run bundle

Debug & Test

Chrome Debugger

在模拟器中使用CMD+D命令能够弹出开发者菜单，从该菜单中能够选择打开Chrome或者Safari调试器。而在真实的设备中，能够经过摇晃设备来打开开发者菜单。在Chrome或者Safari中能够查看console.log的记录从而方便调试，正如调试React Web同样的效果。不过须要注意的是，若是在频繁的刷新下这种调试会致使应用程序很明显的运行变慢。

Type-Checking with Flow

在安装React Native开发环境时官方就推荐了Flow做为开发辅助工具，Flow是一个用于静态类型检查的JavaScript的开发库。Flow依赖于类型推导来检测代码中可能的类型错误，而且容许逐步向现存的项目中添加类型声明。若是须要使用Flow，只须要用以下的命令：

flow check

通常状况下默认的应用中都会包含一个.flowconfig文件，用于配置Flow的行为。若是不但愿flow检查所有的文件，能够在.flowconfig文件中添加配置进行忽略：

[ignore]
.*/node_modules/.*

最终检查的时候就能够直接运行：

$ flow check
$ Found 0 errors.

Testing with Jest

React Native支持使用Jest进行React组件的测试，Jest是一个基于Jasmine的单元测试框架，它提供了自动的依赖Mock，而且与React的测试工具协做顺利。

npm install jest-cli --save-dev

能够将test脚本加入到package.son文件中：

{
  ...
  "scripts": {
    "test": "jest"
   }
   ...
}

直接使用npm test命令直接运行jest命令，下面能够建立tests文件夹，Jest会递归搜索tests目录中的文件，这些测试文件中的代码以下：

'use strict';

describe('a silly test', function() {
 it('expects true to be true', function() {
   expect(true).toBe(true);
 });
});

而对于一些复杂的应用能够查看React Native的官方文档，以其中一个getImageSource为例：

**
 * Taken from https://github.com/facebook/react-native/blob/master/Examples/Movies/__tests__/getImageSource-test.js
 */

'use strict';

jest.dontMock('../getImageSource');
var getImageSource = require('../getImageSource');

describe('getImageSource', () => {
  it('returns null for invalid input', () => {
    expect(getImageSource().uri).toBe(null);
  });
  ...
});

由于Jest是默认自动Mock的，因此须要对待测试的方法设置dontMock.

Application Exploration(应用探究)

Architecture(应用架构)

当使用react-native命令建立新的项目时，调用的即https://github.com/facebook/react-native/blob/master/react-native-cli/index.js这个脚本。当使用react-native init HelloWorld建立一个新的应用目录时，它会建立一个新的HelloWorld的文件夹，包含以下列表：

HelloWorld.xcodeproj/

Podfile

iOS/

Android/

index.ios.js

index.android.js

node_modules/

package.json

React Native最大的卖点在于（1）可使用JavaScript编写iOS或者Android原生程序。（2）应用能够运行在原生环境下而且提供流畅的UI与用户体验。众所周知，iOS或者Android并不能直接运行JavaScript代码，而是依靠相似于UIWebView这样的原生组件去运行JavaScript代码，也就是传统的混合式应用。整个应用运行开始仍是自原生开始，不过相似于Objective-C/Java这样的原生代码只是负责启动一个WebView容器，即没有浏览器界面的浏览器引擎。

而对于React Native而言，并不须要一个WebView容器去执行Web方面的代码，而是将全部的JavaScript代码运行在一个内嵌的JavaScriptCore容器实例中，并最终渲染为高级别的平台相关的组件。这里以iOS为例，打开HelloWorld/AppDelegate.m文件，能够看到以下的代码：

.....................
RCTRootView *rootView = [[RCTRootView alloc]     
    initWithBundleURL:jsCodeLocation
    moduleName:@"HelloWorld"
    launchOptions:launchOptions];
.....................

AppDelegate.m文件自己是iOS程序的入口，相信每个有iOS开发经验的同窗都不会陌生，这也是本地的Objective-C代码与React Native的JavaScript代码胶合的地方。而这种胶合的关键就是RCTRootView这个组件，能够从React声明的组件中加载到Native的组件。RCTRootView组件是一个由React Native提供的原生的Objective-C类，能够读取React的JavaScript代码而且执行，除此以外，也容许咱们从JavaScript代码中调用iOS UI的组件。

到这里咱们能够看出，React Native并无将JavaScript代码编译转化为原生的Objective-C或者Swift代码，可是这些在React中建立的组件渲染的方式也很是相似于传统的Objective-C或者Swift建立的基于UIKit的组件，并非相似于WebView中网页渲染的结果。

这种架构也就很好地解释了为何能够动态加载咱们的应用，当咱们仅仅改变了JS代码而没有原生的代码改变的时候，不须要去从新编译。RCTRootView组件会监听Command+R组合键而后从新执行JavaScript代码。

Virtual Dom的扩展

Virtual Dom是React的核心机制之一，对于Virtual Dom的详细说明能够参考笔者React系列文章。在React组件被用于原生渲染以前，Clipboard已经将React用于渲染到HTML的Canvas中，能够查看render React to the HTML element这篇文章。对于React Web而言，就是将React组件渲染为DOM节点，而对于React Natively而言，就是利用原生的接口把React组件渲染为原生的接口，其大概示意图能够以下：

虽然React最初是以Web的形式呈现，可是React声明的组件能够经过bridge，即不一样的桥接器转化器会将一样声明的组件转化为不一样的具体的实现。React在组件的render函数中返回具体的平台中应该如何去渲染这些组件。对于React Native而言，<View/>这个组件会被转化为iOS中特定的UIView组件。

载入JavaScript代码

React Native提供了很是方便的动态调试机制，具体的表现而言便是容许以一种相似于中间件服务器的方式动态的加载JS代码，即

jsCodeLocation = [NSURL URLWithString:@"http://localhost:8081/index.ios.bundle"];

另外一种发布环境下，能够将JavaScript代码打包编译，即npm build：

jsCodeLocation = [[NSBundle mainBundle] URLForResource:@"main" withExtension:@"jsbundle"];

若是在Xcode中直接运行程序会自动调用npm start命令来启动一个动态编译的服务器，若是没有自动启动能够手动的使用npm start命令，就如定义在package.json文件中的，它会启动node_modules/react-native/packager/packager.sh这个脚本。

React Native中的现代JavaScript代码

从上文中能够看出，React Native中使用的是所谓的JSX以及大量的ES6的语法，在打包器打包以前须要将JavaScript代码进行一些转换。这是由于iOS与Android中的JavaScript解释器目前主要仍是支持到了ES5版本，并不能彻底识别React Native中提供的语法或者关键字。固然，并非说咱们不能使用ES5的语法去编写React Native程序，只是最新的一些语法细则规范能够辅助咱们快速构建高可维护的应用程序。

譬如咱们以JSX的语法编写了以下渲染函数：

render: function() {
  return (
    <View style={styles.container}>
      <TextInput
      style={styles.nameInput}
      onChange={this.onNameChanged}
      placeholder='Who should be greeted?'/>
      <Text style={styles.welcome}>
      Hello, {this.state.name}!</Text>
      <Text style={styles.instructions}>
      To get started, edit index.ios.js
      </Text>
      <Text style={styles.instructions}>
      Press Cmd+R to reload,{'\n'}
      Cmd+Control+Z for dev menu
      </Text>
    </View>
  );
}

在JS代码载入以前，React打包器须要首先将JSX语法转化为ES5的表达式：

render: function() {
  return (
      React.createElement(View, {style: styles.container},
    React.createElement(TextInput, {
    style: styles.nameInput,
    onChange: this.onNameChanged,
    placeholder: "Who should be greeted?"}),
    React.createElement(Text, {style: styles.welcome},
    "Hello, ", this.state.name, "!"),
    React.createElement(Text, {style: styles.instructions},
    "To get started, edit index.ios.js"
    ),
    React.createElement(Text, {style: styles.instructions},
    "Press Cmd+R to reload,", '\n',
    "Cmd+Control+Z for dev menu"
    )
  )
);
}

另外一些比较经常使用的语法转换，一个是模块导入时候的结构器，即咱们经常见到模块导入：

var React = require('react-native');
var {
AppRegistry,
StyleSheet,
Text,
TextInput,
View,
} = React;

上文中的用法便是所谓的解构赋值，一个简单的例子以下：

var fruits = {banana: "A banana", orange: "An orange", apple: "An apple"};
var { banana, orange, apple } = fruits;

那么咱们在某个组件中进行导出的时候，就能够用以下语法：

module.exports.displayName = "Name";
module.exports.Component = Component;

而导入时，便是：

var {Component} = require("component.js");

另外一个经常使用的ES6的语法便是所谓的Arrow Function，这有点相似于Lambda表达式：

AppRegistry.registerComponent('HelloWorld', () => HelloWorld);

会被转化为：

AppRegistry.registerComponent('HelloWorld', function() {return HelloWorld;});