React Native项目github址:
https://github.com/facebook/react-native
React Native项目官网文档:
http://facebook.github.io/react-native/docs/getting-started.html
开发技巧教程
http://reactnative.cn/docs/0.36/getting-started.html
1 RN能力简介
1.1 原生组件引用
使用React Native,你可以使用标准的平台组件,例如iOS的UITabBar或安卓的Drawer。 这使你的app获得平台一致的视觉效果和体验,并且获得最佳的性能和流畅性。
使用对应的React component,就可以轻松地把这些原生组件整合到你的ReactNative应用中, 例如TabBarIOS和DrawerLayoutAndroid。
// iOS
importReact, {
Component,
} from 'react';
import{
TabBarIOS,
NavigatorIOS
} from 'react-native';
class App extends Component{
render() {
return (
<TabBarIOS>
<TabBarIOS.Item title="React Native" selected={true}>
<NavigatorIOS initialRoute={{ title: 'React Native' }} />
</TabBarIOS.Item>
</TabBarIOS>
);
}
}
// Android
importReact, {
Component,
} from 'react';
import{
DrawerLayoutAndroid,
ProgressBarAndroid,
Text
} from 'react-native';
class App extends Component{
render() {
return(
<DrawerLayoutAndroid renderNavigationView={() => <Text>React Native</Text>}>
<ProgressBarAndroid />
</DrawerLayoutAndroid>
);
}
}
1.2 异步执行
在Javascript代码和原生平台之间的所有操作都是异步执行的,并且原生模块还可以根据需要创建新的线程。这意味着你可以在主线程解码图片,然后在后台将它保存到磁盘,或者在不阻塞UI的情况下计算文字大小和界面布局等等。所以React Native开发的app天然具备流畅和反应灵敏的优势。Javascript和原生代码之间的通讯是完全可序列化的,这使得我们可以借助Chrome开发者工具去调试应用,而不论应用运行在模拟器还是真机上。
参见调试
1.3 触摸事件处理
React Native实现了一个强大的触摸事件处理系统,可以在复杂的View层次关系下正确地处理触摸事件。同时还提供了高度封装的组件如TouchableHighlight等,可以直接嵌入到ScrollView或者其它的元素中,无需额外配置。
// iOS & Android
importReact, {
Component,
} from 'react';
import{
ScrollView,
TouchableHighlight,
Text
} from 'react-native';
class TouchDemo extends Component{
render() {
return(
<ScrollView>
<TouchableHighlight onPress={() => console.log('pressed')}>
<Text>Proper Touch Handling</Text>
</TouchableHighlight>
</ScrollView>
);
}
}
1.4 弹性盒(Flexbox)和样式
控制view的布局应当简单易行,这就是为什么React Native从web中借鉴了Flexbox模型。Flexbox让大多数常见的UI布局构建变得简单(譬如带有外衬margin和内衬padding,且堆叠在一起的多个矩形)。React Native还支持多种常见的web样式,例如fontWeight等。抽象样式表提供了一个高性能的机制来声明所有的样式和布局,并且可以直接应用到你的组件中。
// iOS & Android
importReact, {
Component,
} from 'react';
import{
Image,
StyleSheet,
Text,
View
} from 'react-native';
class ReactNative extends Component{
render() {
return(
<View style={styles.row}>
<Image source={{uri: 'http://facebook.github.io/react/img/logo_og.png'}} style={styles.image} />
<View style={styles.text}>
<Text style={styles.title}>
ReactNative
</Text>
<Text style={styles.subtitle}>
Build high quality mobile apps using React
</Text>
</View>
</View>
);
}
}
var styles = StyleSheet.create({
row: {flexDirection: 'row', margin: 40 },
image: { width:40, height: 40, marginRight: 10 },
text: { flex: 1, justifyContent: 'center'},
title: {fontSize: 11, fontWeight: 'bold' },
subtitle: {fontSize: 10 },
});
1.4.1 Flexbox属性
alignItems enum('flex-start', 'flex-end', 'center','stretch')
alignSelf enum('auto', 'flex-start', 'flex-end','center', 'stretch')
borderBottomWidth 数值型
borderLeftWidth 数值型
borderRightWidth 数值型
borderTopWidth 数值型
borderWidth 数值型
bottom 数值型
flex 数值型
flexDirection enum('row', 'column')
flexWrap enum('wrap', 'nowrap')
height 数值型
justifyContent enum('flex-start', 'flex-end', 'center',
'space-between', 'space-around') left 数值型
margin 数值型
marginBottom 数值型
marginHorizontal 数值型
marginLeft 数值型
marginRight 数值型
marginTop 数值型
marginVertical 数值型
padding 数值型
paddingBottom 数值型
paddingHorizontal 数值型
paddingLeft 数值型
paddingRight 数值型
paddingTop 数值型
paddingVertical 数值型
position enum('absolute', 'relative') right 数值型
top 数值型 width 数值型
1.5 兼容通用标准
React Native致力于改进视图代码的编写方式。除此之外,我们还吸纳了web生态系统中的通用标准,并在必要的时候为这些API提供兼容层。如此一来,npm上的许多库就可以在React Native中直接使用。这样的兼容层有XMLHttpRequest, window.requestAnimationFrame,navigator.geolocation等。我们还在努力增加更多的API,并且十分欢迎开源社区进行贡献。
// iOS & Android
importReact, {
Component,
} from 'react';
import{
Text
} from 'react-native';
class GeoInfo extends Component{
constructor(props) {
super(props);
this.state = { position: 'unknown'};
},
componentDidMount() {
navigator.geolocation.getCurrentPosition(
(position)=>this.setState({position}),
(error) =>console.error(error)
);
}
render() {
return(
<Text>
Position:{JSON.stringify(this.state.position)}
</Text>
);
}
}
1.6 扩展性
使用React Native,无需编写一行原生代码即可创造一款不错的app。尽管如此,使用自定义的原生视图和模块来扩展ReactNative也非常容易 —— 这意味着你现有的所有工作都可以被复用,你喜欢的各种原生库都可以被导入。
1.7 创建iOS模块
想要创建一个iOS模块,只需要创建一个接口,实现RCTBridgeModule协议,然后把你想在Javascript中使用的任何方法用RCT_EXPORT_METHOD包装。最后,再用RCT_EXPORT_MODULE导出整个模块即可。
// Objective-C
#import "RCTBridgeModule.h"
@interface MyCustomModule : NSObject <RCTBridgeModule>
@end
@implementation MyCustomModule
RCT_EXPORT_MODULE();
// Available as NativeModules.MyCustomModule.processString
RCT_EXPORT_METHOD(processString:(NSString*)input callback:(RCTResponseSenderBlock)callback)
{
callback(@[[input stringByReplacingOccurrencesOfString:@"Goodbye" withString:@"Hello"]]);
}
@end
// JavaScript
importReact, {
Component,
} from 'react';
import{
NativeModules,
Text
} from 'react-native';
class Message extends Component{
constructor(props) {
super(props);
this.state = { text: 'Goodbye World.'};
}
componentDidMount() {
NativeModules.MyCustomModule.processString(this.state.text, (text) => {
this.setState({text});
});
}
render() {
return(
<Text>
{this.state.text}
</Text>
);
}
}
1.8 创建iOS View
若想自定义iOS View,可以这样来做:首先继承RCTViewManager类,然后实现一个-(UIView*)view方法,并且使用RCT_EXPORT_VIEW_PROPERTY宏导出属性。最后用一个Javascript文件连接并进行包装。
// Objective-C
#import "RCTViewManager.h"
@interface MyCustomViewManager : RCTViewManager
@end
@implementation MyCustomViewManager
RCT_EXPORT_MODULE()
- (UIView*)view
{
return [[MyCustomView alloc] init];
}
RCT_EXPORT_VIEW_PROPERTY(myCustomProperty, NSString);
@end
// JavaScript
importReact, {
Component,
requireNativeComponent
} from 'react-native';
var NativeMyCustomView = requireNativeComponent('MyCustomView', MyCustomView);
export default class MyCustomView extends Component{
static propTypes = {
myCustomProperty: React.PropTypes.oneOf(['a', 'b']),
};
render() {
return <NativeMyCustomView {...this.props} />;
}
}
1.9 创建Android模块
同样的,Android也支持自定义扩展。仅仅是方法略有差异。
创建一个基础的安卓模块,需要先创建一个继承自ReactContentBaseJavaModule的类,然后使用@ReactMethod标注(Annotation)来标记那些你希望通过Javascript来访问的方法。最后,需要在ReactPackage中注册这个模块。
// Java
public class MyCustomModule extends ReactContextBaseJavaModule{
// Available as NativeModules.MyCustomModule.processString
@ReactMethod
public void processString(String input, Callback callback) {
callback.invoke(input.replace("Goodbye", "Hello"));
}
}
// JavaScript
importReact, {
Component,
} from 'react';
import{
NativeModules,
Text
} from 'react-native';
class Message extends Component{
constructor(props) {
super(props);
this.state = { text: 'Goodbye World.'};
},
componentDidMount() {
NativeModules.MyCustomModule.processString(this.state.text, (text) => {
this.setState({text});
});
}
render() {
return(
<Text> {this.state.text}</Text>
);
}
}
1.10 创建Android View
创建自定义的Android View,首先定义一个继承自SimpleViewManager的类,并实现createViewInstance和getName方法,然后使用@ReactProp标注导出属性,最后用一个Javascript文件连接并进行包装。
// Java
public class MyCustomViewManager extends SimpleViewManager {
@Override
public String getName() {
return "MyCustomView";
}
@Override
protected MyCustomView createViewInstance(ThemedReactContext reactContext) {
return newMyCustomView(reactContext);
}
@ReactProp(name = "myCustomProperty")
public void setMyCustomProperty(MyCustomView view, String value) {
view.setMyCustomProperty(value);
}
}
// JavaScript
importReact, {
Component,
requireNativeComponent
} from 'react-native';
var NativeMyCustomView = requireNativeComponent('MyCustomView', MyCustomView);
export default class MyCustomView extends Component{
staticpropTypes = {
myCustomProperty: React.PropTypes.oneOf(['a', 'b']),
};
render() {
return <NativeMyCustomView {...this.props} />;
}
}
2 参考链接
React Native项目github址:
https://github.com/facebook/react-native
React Native项目官网文档:
http://facebook.github.io/react-native/docs/getting-started.html
开发技巧教程
http://reactnative.cn/docs/0.36/getting-started.html