RN 从上手到“放弃”
RN 从上手到“放弃”
前言: react-native,相对于最近🔥的飞起的flutter,不算是一个新技术,2015年Facebook 开源,到现在已经4 5 个年头,一直在维护当中,但是至今未发布 v1 版本,目前已经更新到0.59。 该技术目标: 跨平台实现原生应用。 GitHub start 数目: 77602(2019-5-29)。
正文
1、项目预览
现在已完成的功能展示:
入手demo项目,本打算模仿微信的功能做一遍。现在已经完成微信的一级界面。截图如下:
首页:
通信录:
发现:
我:
朋友圈(上拉加载和下拉刷新):
(未完成,就是调用了接口)
聊天界面:
摄像头拍照(安卓虚拟机):
github地址: react-native-wx
nodejs后台:nodejsApi
项目主要使用插件(库):
- react-native-camera (调用摄像头)
- react-native-vector-icons (图标库)
- react-navigation (路由导航)
参考资料:
2、项目运行
~前提: 环境搭建及相关软件、安卓或者ios 的模拟器安装, 参考官网即可,https://reactnative.cn/docs/getting-started.html
git clone https://github.com/adouwt/react-native-wx.git
cd react-native-wx
npm i
npm run and (安卓)
npm run ios (苹果)
(上面的运行命令,我在package.json 做了封装,一些处理编译错误的命令,我也已经封装进去)
执行命令后,会自动弹出nodejs 执行终端界面,这个是程序运行的一个监控
模拟器显示:
3、分步实现
3.1 初始化并运行项目
``` react-native init AwesomeProject react-native run-ios ```
3.2 项目结构说明
3.3 新建文件夹 app,接下来所有的源码文件代码将在这里
目前新建 component组件、page页面、及utils 工具三个,后面会根据需要建新的文件夹。
四个一级界面+ 聊天和朋友圈的界面
3.4 安装插件做页面导航跳转
3.4.1 npm install react-navigation -S
3.4.2 修改项目文件下的App.js
这是根文件,我们的页面导航写进这个组件,我项目中已经完成代码片段,这里直接使用,代码如下:
import React from 'react'; import HomeScreen from './app/page/Home' import DiscoverScreen from './app/page/Discover' import UserListScreen from './app/page/UserList' import MyScreen from './app/page/My' import CameraComponent from './app/component/camera' import ChatScreen from './app/page/Chat' import FriendCircle from './app/page/friendCircle' import Icon from "react-native-vector-icons/Ionicons"; import { View, Text } from 'react-native'; import { createAppContainer, createBottomTabNavigator, createStackNavigator, createDrawerNavigator } from 'react-navigation'; // Version can be specified in package.json const HomeNav = createStackNavigator({ Home: { screen: HomeScreen, navigationOptions:{ headerTitle:'微信', headerBackTitle:null, } }, }) const UserListNav = createStackNavigator({ UserList: { screen: UserListScreen, }, }) // 二级页面写进一级页面中 const DiscoverNav = createStackNavigator( { Discover: { screen: DiscoverScreen, }, } ) const MyNav = createStackNavigator( { My: MyScreen, } ); let BottomNav = createBottomTabNavigator( // createBottomTabNavigator 两个参数,一个页面路由,一个是路由配置 { 微信: HomeNav, 通讯录: UserListNav, 发现: DiscoverNav, 我: MyNav, }, { defaultNavigationOptions: ({ navigation }) => ({ tabBarIcon: ({ focused, horizontal, tintColor }) => { const { routeName } = navigation.state; let iconName; let badgeCount = 3 switch(routeName) { case '微信': iconName = 'ios-text'; break; case '通讯录': iconName = 'md-person-add'; break; case '发现': iconName = 'md-compass'; break; case '我': iconName = 'ios-person'; break; } iconColor = `${focused ? '#1AAD19' : '#4D4D4D'}`; return ( <View> <Icon name={iconName} size={18} color={iconColor}></Icon> { routeName === '发现' && badgeCount > 0 && ( <View style={{ // If you're using react-native < 0.57 overflow outside of the parent // will not work on Android, see https://git.io/fhLJ8 position: 'absolute', right: -6, top: -3, backgroundColor: 'red', borderRadius: 6, width: 12, height: 12, justifyContent: 'center', alignItems: 'center', color: '#fff' }}> <Text style={{ color: '#fff', fontSize: 10, fontWeight: 'bold' }}>{badgeCount}</Text> </View> )} </View> ) }, }), tabBarOptions: { activeTintColor: '#1AAD19', inactiveTintColor: '#4D4D4D', }, } ); let RootNav = createStackNavigator({ BottomNav: { screen: BottomNav, navigationOptions: ({ navigation, screenProps }) => { return { header: null, }; } }, Camera: { screen: CameraComponent }, Chat: { screen: ChatScreen }, FriendCircle: { screen: FriendCircle } }) export default createAppContainer(RootNav);
这里需要参考导航资料:navigation
文档讲的很明白,看看示例就知道怎么用了,我下面讲两个注意内容,这也是在这几天的学习中遇到的troubles.
a、创建底部导航:
createBottomTabNavigator 方法,接受两个参数,一个页面路由,一个是路由配置,
直接看这个方法名字,就知道这个是创建底部导航的方法。
--第一个参数,页面路由,这里你写多少tab, 底部就会呈现几个tab 均匀分布,(不要有杠精来袭,“要是有100个tab,怎么显示?”,哪有这样的设计,你要是有100个tab,你试试这样排版?)
参数的key,就是底部显示的名称,value 就是这个页面 screen。页面screen可以单独定义引入,如下:
可以像第一个DiscoverNav,以screen定义的方式引入,也可以简略使用,如下面的MyNav
-- 第二个参数,路由配置,在这里配置,底部导航的样式、图标、foucs 状态及badge等
tabBarIcon 顾名思义,配置他的图标,我这里根据navigation.state 里的routeName 来区分页面路由,从而为他们配置不同的 icon
b、二级页面注入Stack Navigator
我们写的页面要注入我们的导航,这样才能访问到,我们这里采用的是react-navigation的 createStackNavigaor 的createStackNavigator方法,如图:
3.4.3 具体页面逻辑
这里讲两个页面,一个是静态页面,一个是调用接口的长列表的界面。
静态页面 discoverScreen
布局方式: flex, 属性和web 书写不一致,语法参考这个不完全手册: https://shenbao.github.io/ishehui/html/RN%20%E5%9F%BA%E7%A1%80/React%20Native%20%E6%A0%B7%E5%BC%8F%E8%A1%A8%E6%8C%87%E5%8D%97.html
点击按钮封装: RN 里面的点击方法只能绑定在它的button 组件上,提供的其他组件我们么办法直接绑定事件,它提供了一个封装子组件可以绑定事件的自定义按钮-Touchable 系列 (TouchableOpacity ,TouchableNativeFeedback)如下书写可以点击的item:
注意: 上面划线的位置,这个样式(flex: 1, flexDirection: 'row',)要写上。有一定的兼容问题,如果没有这个样式,在安卓上无法点击,ios上没有影响。说明在实际开发中,我们还要处理一定的平台差异问题,真正实现无差异的跨平台还是有些困难。
页面header:
在static 里面没办法直接调用组件的方法,需要借助 navigation 来做一下中转,调用setParams将方法放进navigation里面,这样在static里面就可以使用navigation.getParams 获取这个方法了,如下:
过渡动画
这个方法实现的是一个 动画,我们在 写web 的时候,会用 transform transaction 这样的动画属性,RN里面也支持这样的动画,具体语法有所差异。这里我们用一个绝对定位里面的 right值 做过渡效果。
开始定义:
在点击时候,修改这个 this.state.animateRightValue 的值,实现动画效果,
Animated有几个动画(),这里采用了timing,他接受两个参数,一个是监听的动画值,另一个是这个值的配置,配置动画方式,动画时间等。
这个页面也没有复杂的页面逻辑,基本一看就知道怎么回事,一些语法 api 不会的话,可以上官网lou 一眼:
调接口的页面 friendCircle
这个页面调用了一个分页接口,上拉加载更多,长列表的组件用的是RN 原生的 FlatList 组件,这个具体使用可以参考api 文档看看,
但是就个人使用之后的感觉而言,这个真正要用到生产,还得要稍微改造一下,比如loading菊花图片要改一改。
在生命周期函数componentDidMount 里面,调用我们的接口。说道这里,我们引出了接口封装问题,用的是自带的fetch,这个fetch 底层具体我们就不考虑怎么实现的,现在我们需要对fetch 封装一下,方便后面在多处使用,fetch 封装如下:
let base_url = 'https://api.scampus.cn'; //服务器基本地址 // let base_url = 'http://18.10.1.115:4000'; //服务器基本地址 let token = ''; /** * @param {string} url 接口地址 * @param {string} method 请求方法:GET、POST,只能大写 * @param {JSON} [params=''] body的请求参数,默认为空 * @return 返回Promise */ const fetchRequest = (url, method, params = '') => { let header = { "Content-Type": "application/json;charset=UTF-8", "accesstoken":token //用户登陆后返回的token,某些涉及用户数据的接口需要在header中加上token }; if(params == ''){ //如果网络请求中带有参数 return new Promise(function (resolve, reject) { fetch(base_url + url, { method: method, headers: header }).then((response) => response.json()) .then((responseData) => { resolve(responseData); }) .catch( (err) => { reject(err); }); }); } else{ //如果网络请求中没有参数 return new Promise(function (resolve, reject) { fetch(base_url + url, { method: method, headers: header, body:JSON.stringify(params) //body参数,通常需要转换成字符串后服务器才能解析 }).then((response) => response.json()) .then((responseData) => { resolve(responseData); }) .catch( (err) => { reject(err); }); }); } } export default fetchRequest
使用Promise 处理异步问题,将我们最后的需要的数据统统resolve 出去。封装中规中距,基本是按照文档说明 fetch 的用法,稍加修改
4、使用第三方的图标
npm install -S react-native-vector-icons
图标地址: https://oblador.github.io/react-native-vector-icons/ 注意这站点不是图标全部可用,滚动条快速找到中间位置,就能看到我们需要的图标。
使用: name 值可以在上面的地址中寻找,哪个合适就用哪个,
就个人看来,这个图标库基本够开发使用,如果不够可以继续引用字体图标库。
5、调用手机硬件设备-摄像头
具体演示实例,拍照功能,用的第三方库,react-native-camera
安装: npm install -S react-native-camera
使用:import { RNCamera } from 'react-native-camera';
<View style={styles.container}> <RNCamera ref={ref => { this.camera = ref; }} style={styles.preview} type={ this.state.cameraType} flashMode={RNCamera.Constants.FlashMode.on} autoFocus={RNCamera.Constants.AutoFocus.on} androidCameraPermissionOptions={{ title: 'Permission to use camera', message: 'We need your permission to use your camera', buttonPositive: 'Ok', buttonNegative: 'Cancel', }} androidRecordAudioPermissionOptions={{ title: 'Permission to use audio recording', message: 'We need your permission to use your audio', buttonPositive: 'Ok', buttonNegative: 'Cancel', }} onGoogleVisionBarcodesDetected={({ barcodes }) => { console.log(barcodes); }} > {({ camera, status, recordAudioPermissionStatus }) => { if (status !== 'READY') return <PendingView />; return ( <View style={{ flex: 1, flexDirection: 'row', justifyContent: 'space-around',marginBottom: 20 }}> <TouchableOpacity onPress={() => this.takePicture(camera)} style={styles.capture}> <Text style={{ fontSize: 14 }}> 拍照 </Text> </TouchableOpacity> <TouchableOpacity onPress={this.swtichCamera} style={styles.capture}> <Icon name="ios-reverse-camera" size={18} color="#333"></Icon> </TouchableOpacity> <TouchableOpacity onPress={this.lookAlbum} style={styles.imgPreview}> <Image style={styles.imgPreview} source={{uri: this.state.currentUri || 'https://yyb.gtimg.com/aiplat/page/product/visionimgidy/img/demo6-16a47e5d31.jpg?', isStatic: true}} /> </TouchableOpacity> </View> ); }} </RNCamera> </View>
在组件里面可以定义照相机界面的ui,可以自定义拍照按钮,切换摄像头的按钮,拍照图片预览等,调用api 不难,问题难点在配置调用的文件,你得有权限调用原生的设备。
1、修改android/gradle/wrapper/gradle-wrapper.properties
distributionUrl=https\://services.gradle.org/distributions/gradle-4.10.1-all.zip
2、修改android/app/build.gradle
missingDimensionStrategy 'react-native-camera', 'general'
在实际安装使用的时候会有相关的提示报错,按照报错信息去寻找解决办法,这里还是得推荐github,上面有很多类似的问题,可以耐心找找。
6、结言
从一开始了解RN 到最后上手demo,到现在陆续修改项目,差不多十天时间,本人的技术栈是vue,react 并没有生产项目,看看文档,基本可以上手。总结而言,使用一些基本的功能,并不难,文档很全,使用的群体很大,所以遇到的问题也可以在相关社区找到合适的解决方法或者替换方案。还没有具体开发生产项目,但是我觉得我将要面临的问题,应该在体验优化上,比如过渡动画,上拉下拉刷新加载,切换视图;集成第三方库,调用硬件设备;性能优化问题等。
7、TODO
后面有时间,继续把这个项目做下去,
- 登录注册
- 聊天,后面集成聊天机器人
- 通讯录的人员分组,现在因为是后台接口还没有完成,只是本地造了一个数据
- 扫码功能
- 发动态
- 集成地图
- 拍照后,图像识别
如果有兴趣的同学欢迎加入一起完成。
github地址: react-native-wx
nodejs后台:nodejsApi
班门弄斧之作,若有RN 老手见到,请勿见笑,有不对不合理之处,敬请指教!我是迩伶贰!
-1、相关错误处理
- react-native-camera 插件的使用问题:
解决: [解决](https://github.com/react-native-community/react-native-camera/issues/2150)
- 编译问题
解决: cd android && ./gradlew clean
Unable to resolve module 'scheduler/tracing' in ReactNative
解决: yarn add @babel/runtime@7.0.0 再重新跑 react-native run-android
开发中还遇到了其他问题,但是忘了做记录 ~~ RN 暂时放一段落,接下来要使用 flutter,打算两周后 出一个flutter版本。
- [Android-ARCore开发]ARCore从入门到放弃1-Demo上手
- [Android-ARCore开发]ARCore从入门到放弃1-Demo上手
- Win10 10176 RTM候选版上手视频 微软已经放弃这个版本
- OpenCV从入门到放弃(二):架构和上手
- Mybatis3快速上手应用示例
- Rancher 2.0快速上手指南
- 你可以经常失败,但是唯有在放弃的时候,你才成为失败者。
- Google Analytics上手
- 【转载】适合儿童上手的八款编程工具
- TensorFlow可视化工具-TensorBoard上手
- 如何第一次寫Android Launcher Switcher就上手
- OpenCV从入门到放弃:摸鱼笔记(一)
- Google 选择 Jetty, 放弃 Tomcat
- jemalloc 快速上手攻略
- Microsoft Hyper-V Server 2012快速上手之前奏 推荐
- CMake快速上手笔记
- 有所放弃(二)
- Spring AOP从入门到放弃之概念以及Spring Boot AOP demo
- 不对等的爱情该不该放弃
- 嗯,哇! Git 教程 上手实战,创建gitHub 账户,并添加ssh密钥(二)