React Native 项目(One 【一个】客户端)

4,757 阅读6分钟

前段时间开始学习React Native,然后试着开始做一个小项目,在练手的同时,分享出来希望和各位同学互相学习react-native项目。之前写过项目相关的文章,没看过的同学可以参考一下:

目前项目完成了(One 【一个】)主体界面功能,当然功能和原App还有较大的差距,之前主要对ios进行了适配,这两天对Android也进行了一些调整。有什么bug大家可以评论或者在github上提issue。先看一下效果图:

Paste_Image.png

Paste_Image.png

Paste_Image.png

Paste_Image.png

Paste_Image.png

这里贴的是ios的效果图,android端的类似。接下来介绍项目的结构,用到的一些第三方库,以及项目过程中的小坑。

项目结构

  • Pages
    项目的主要界面,目录下有One、Douban、Zhihu三个文件夹,分别对应one、豆瓣、知乎日报三个应用,其中one是完成度相对比较高的,其他两个应用界面很少。
  • Assets
    目录下存放了项目中用到了一些图标,这里存放的是android和ios的共有图标,比如one主界面下面的四个图标。android和ios的launch icon是在各自工程中分别设置的。
  • Constants
    定义项目中的常量
  • Components
    项目的一些自定义components,可以在多个pages中使用。
  • Styles
    定义常用的界面style,使用时可以直接引用,模拟android的styles,这样就不需要在每个page中重复定义styles
  • Utils
    定义常用的一些工具类,如网络请求、时间格式、展示属性等。
  • Actions
  • reducers
  • sagas
    这三个目录是redux相关的一些方法,相关的介绍可以查看 React native 项目进阶(redux, redux saga, redux logger),当然阅读之前最好有redux基础,推荐redux的学习教程:
    leonshi.com/redux-saga-…
    cn.redux.js.org/index.html

第三方库

React Native 从第一次提交到现在已经有20个月的时间,目前github上有近4万star,很多大牛贡献了各种第三方库,目前开始学习React Native对于新人初学者来说文档和社区非常友好。这里罗列下用到的第三方库:

    "react-native-button": "github:ide/react-native-button",
    "react-native-datepicker": "^1.3.2",
    "react-native-drawer": "^2.2.2",
    "react-native-fs": "^2.0.1-rc.2",
    "react-native-root-toast": "^1.0.3",
    "react-native-router-flux": "[3.30.1]",
    "react-native-scrollable-tab-view": "0.6.0",
    "react-native-sound": "^0.8.3",
    "react-native-viewpager": "^0.2.1",
    "react-redux": "^4.4.5",
    "redux": "^3.6.0",
    "redux-logger": "^2.6.1",
    "redux-saga": "^0.11.1"

其中部分比较简单,有些在之前的文章中进行了介绍,下面主要介绍:

    "react-native-viewpager": "^0.2.1",
    "react-native-scrollable-tab-view": "0.6.0",
    "react-native-sound": "^0.8.3",
    "react-native-fs": "^2.0.1-rc.2",

React-Native-ViewPager

是一个viewpager,one项目中的首页、文章页、音乐页均使用了viewpager,使用率很高,先看一个demo:

                   <ViewPager
                        dataSource={this.state.banners}
                        renderPage={this.renderBanners}
                        isLoop={true}
                        autoPlay={true}
                    />

dataSource定义数据源,其数据源的定义过程是:

        var bannerDataSource = new ViewPager.DataSource({
            pageHasChanged: (p1, p2) => p1 !== p2,
        });  

        banners: bannerDataSource.cloneWithPages([]),

renderPage用于展示每个pager的界面

    renderBanners(data, pageID) {
        return (
            <Image style={{
                height: 140,
                width: deviceWidth,
            }} source={{uri: data.cover}}>
            </Image>
        );
    }

isLoop 是否轮播

autoPlay 是否自动播放

renderPageIndicator定义indicator的样式 ,当然可以使用default的样式,这里是一个示例,隐藏掉indicator:

renderPageIndicator={()=>(<View style={{width: 0, height: 0}}></View>)}

react-native-scrollable-tab-view

react-native-scrollable-tab-view用于定义应用的主tab,项目中主要定义了one的四个tab,可以滑屏幕切换界面,在项目中由于各个子界面自身有左右切换的需求,因此关闭了该功能。

部分设置

renderTabBar
自定义tabbar,如项目中自定义了四个tab的样式

onChangeTab
当tab切换时回调

locked
是否锁定,锁定时不能左右滑动

page
设置选中的tab

项目使用示例:

           <ScrollableTabView initialPage={0} locked={true} prerenderingSiblingsNumber={1} tabBarPosition="bottom"
                               renderTabBar={()=><FacebookTabBar tabIcons={this.tabIcons}/>}>
                <OneHome tabLabel="首页"/>
                <OneRead tabLabel="阅读"/>
                <OneMusic tabLabel="音乐"/>
                <OneFilm tabLabel="电影"/>
            </ScrollableTabView>

react-native-fs

react-native-sound

这两个主要用于one音乐的播放,其中react-native-fs主要用于音乐的下载,react-native-sound用于本地文件的播放,这两个库都用到了原生方法,因此需要分别在android和ios项目中进行设置使用:

ios端

1.


如图需要Add两个lib的*.xcodeproj到主工程的Libraries中,然后

2.


如图Add所有的*.a文件,编译运行就ok了。

Android 端

  1. 在setting.gradle中添加:
    include ':app'
    include ':react-native-fs'
    project(':react-native-fs').projectDir = new File(settingsDir, '../node_modules/react-native-fs/android')
    include ':RNSound', ':app'
    project(':RNSound').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-sound/android')
  2. 在build.gradle中添加:
     compile project(':react-native-fs')
     compile project(':RNSound')
    Paste_Image.png

注意添加位置要正确,对代码进行重新编译,在Android目录机构下即可以看到RNSound、react-native-fs两个module。

两个lib在react-native 中的使用比较简单,可以参考one项目中的使用:react-native-sound 和react-native-fs的使用

项目中踩坑

  1. Image中设置source={{url:"http://..."}}
    在ios中这样设置是没有问题的,但是android中不起效, 需要设置source={{uri:"http://..."}},另关于Image,目前必须设置width和height,官方解释为防止在进行渲染时如果宽高不固定容易造成界面跳动,影响用户体验。
  2. react-native-sound 播放路径问题
    var whoosh = new Sound('whoosh.mp3', Sound.MAIN_BUNDLE, (error) => {
    if (error) {
     console.log('failed to load the sound', error);
    } else { // loaded successfully
     console.log('duration in seconds: ' + whoosh.getDuration() +
         'number of channels: ' + whoosh.getNumberOfChannels());
    }
    });
    其中'whoosh.mp3'为相对路径,Sound.MAIN_BUNDLE为基本路径,在ios中可用,但是在android中提示找不到路径,最终第一个参数设置绝对路径,第二个参数设置为 '' 空串。
  3. react-native-sound 播放问题
    musicHandler = new Sound(`${RNFS.DocumentDirectoryPath}/music.mp3`, '',(error) => {
            if (error) {
                console.log('failed to load the sound', error);
            } else { // loaded successfully
                this.playSound();
            }
        });
    需要在sound创建成功的回调中启动播放,不可以直接写在创建的语句之后。

4.gif图问题
ios的Image支持直接播放gif图,android需要添加lib,在build.gradle的dependencies中添加:

compile 'com.facebook.fresco:animated-gif:0.12.0'//for gif

5.布局问题

Paste_Image.png

这种布局可以设置marginTop为负值即可。

  1. 关于react-native-viewpager和react-native-srollable-tab-view嵌套问题
    当发生嵌套时,可能发生界面的错位,这是可以设置view的style:overflow: 'hidden',可以避免界面叠加错位。

总结

目前项目中还有较多的问题,尤其是Android端,之后还会继续进行完善。根据目前的开发体验,感觉react native非常适合于展示类型的app,开发效率非常高,但是在Android上体验要低于ios,有很大的优化空间。
接下来在继续完善项目的基础上,继续学习相关的知识,争取做出自己的东西,实现在React-native项目入门与思考中立下的flag。

项目地址请戳这里

欢迎关注公众号wutongke,每天推送移动开发前沿技术文章:

wutongke

推荐阅读:

React-native项目入门与思考
React native 项目入门(知乎日报,豆瓣电影,[one]一个)
React native 项目进阶(redux, redux saga, redux logger)
React Native 项目2(One 【一个】客户端)