JavaScriptCore框架 是一个苹果在iOS7引入的框架,该框架让 Objective-C 和 JavaScript 代码直接的交互变得更加的简单方便。
而JavaScriptCore是苹果Safari浏览器的JavaScript引擎,或许你听过Google的V8引擎,在WWDC上苹果演示了最新的Safari,据说JavaScript处理速度已经大大超越了Google的Chrome,这就意味着JavaScriptCore在性能上也不输V8了。
1.原生UI组件的编写
1.编写原生组件继承 RCTViewManager
接下来你需要一些Javascript代码来让这个视图变成一个可用的React组件:
提供原生视图很简单:
- 首先创建一个子类
- 添加
RCT_EXPORT_MODULE()
标记宏 - 实现
-(UIView *)view
方法
// RNTMapManager.m
#import <MapKit/MapKit.h>
#import <React/RCTViewManager.h>
@interface RNTMapManager : RCTViewManager
@end
@implementation RNTMapManager
RCT_EXPORT_MODULE()
- (UIView *)view
{
return [[MKMapView alloc] init];
}
@end
接下来你需要一些Javascript代码来让这个视图变成一个可用的React组件:
// MapView.js
var { requireNativeComponent } = require('react-native');
// requireNativeComponent 自动把这个组件提供给 "RNTMapManager"
module.exports = requireNativeComponent('RNTMap', null);
现在我们就已经实现了一个完整功能的地图组件了,诸如捏放和其它的手势都已经完整支持。但是现在我们还不能真正的从Javascript端控制它。(╯﹏╰)
属性
我们能让这个组件变得更强大的第一件事情就是要能够封装一些原生属性供Javascript使用。举例来说,我们希望能够禁用手指捏放操作,然后指定一个初始的地图可见区域。禁用捏放操作只需要一个布尔值类型的属性就行了,所以我们添加这么一行:
// RNTMapManager.m
RCT_EXPORT_VIEW_PROPERTY(pitchEnabled, BOOL)
注意我们现在把类型声明为BOOL
类型——React Native用RCTConvert
来在JavaScript和原生代码之间完成类型转换。如果转换无法完成,会产生一个“红屏”的报错提示,这样你就能立即知道代码中出现了问题。如果一切进展顺利,上面这个宏就已经包含了导出属性的全部实现。
现在要想禁用捏放操作,我们只需要在JS里设置对应的属性:
// MyApp.js
<MapView pitchEnabled={false} />
但这样并不能很好的说明这个组件的用法——用户要想知道我们的组件有哪些属性可以用,以及可以取什么样的值,他不得不一路翻到Objective-C的代码。要解决这个问题,我们可以创建一个封装组件,并且通过PropTypes
来说明这个组件的接口。
// MapView.js
import React, { Component, PropTypes } from 'react';
import { requireNativeComponent } from 'react-native';
var RNTMap = requireNativeComponent('RNTMap', MapView);
import PropTypes from 'prop-types';
export default class MapView extends Component {
static propTypes = {
/**
* 当这个属性被设置为true,并且地图上绑定了一个有效的可视区域的情况下,
* 可以通过捏放操作来改变摄像头的偏转角度。
* 当这个属性被设置成false时,摄像头的角度会被忽略,地图会一直显示为俯视状态。
*/
pitchEnabled: PropTypes.bool,
};
render() {
return <RNTMap {...this.props} />;
}
}
译注:使用了封装组件之后,你还需要注意到module.exports导出的不再是requireNativeComponent的返回值,而是所创建的包装组件。
现在我们有了一个封装好的组件,还有了一些注释文档,用户使用起来也更方便了。注意我们现在把<