Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/duheng/mozi

此项目致力于构建一套最基础，最精简，可维护的react-native项目，支持ios，android 🌹
https://github.com/duheng/mozi

es6 eslint prettier-eslint react react-native react-native-app react-native-demo react-native-demo-app react-native-navigation react-navigation react-navigation-demo react-navigation-redux react-redux reactjs rnn

Last synced: about 4 hours ago
JSON representation

此项目致力于构建一套最基础，最精简，可维护的react-native项目，支持ios，android 🌹

Awesome Lists containing this project

README 

        
# Mozi 2.0-beta



[![npm](https://img.shields.io/npm/l/express.svg)](https://github.com/duheng/Mozi)

[![CircleCI](https://img.shields.io/circleci/project/github/RedSparr0w/node-csgo-parser.svg)](https://github.com/duheng/Mozi)

[![Codecov branch](https://img.shields.io/codecov/c/github/codecov/example-python/master.svg)](https://github.com/duheng/Mozi)



此项目致力于构建一套可最基础，最精简，可维护的 react-native 项目，适用于团队合作开发 React Native 项目，我们知道 react-native init 出来的项目只是一个最简单的 demo，距离开发企业级项目还差很远，所以这套框架是我在开发中总结优化而来的，会提供群里关注度高的问题的解决方案以及 demo，此项目虽然还不够完善，但是以此为基础足可以搭建一个大型项目：



##升级 2.1-beta 说明：



```

  1- 增加auth分枝，包含登录功能，个人中心

```



##升级 2.0-beta 说明：



```

  1- 升级react-native到0.55.4；升级了react-navigation到2.5.5；这快改动比较大，如果你自己的项目有不会升级react-navigation的可以参考一下config.js

  2- 增加了消息推动和codepush，和jpush，目前安卓版本有效，ios因没有证书还没测试

  3- 删除了redux-saga，删除的原因并不是因为它不优秀，我个人觉得它很优秀，但是根据大多数工程师反馈不会用saga。而我个人觉得它是一个锦上添花的模块，并不是一个必须的，为了适应大多数工程师的使用习惯改回了原始版本。 注：（大家有喜欢用saga的也可以用 mozi1.0 的分枝）

  4-master分枝是2.0-beta版本，还没有完善，大家要用稳定版本的也可以用mozi1.0分枝

  5- 这个版本集成了codepush和jpush，因为我觉得这是每个成熟的产品都必须要有的功能，大家换成自己申请的key就可以了；如果觉得不需要某个我集成的功能可以直接 unlink就OK了；比如：react-native unlink react-native-code-push 这个模块

```



#### 涉及主要技术



```

1.项目主架构:



  react-native,

  react-navigation,

  redux,

  redux-saga,



2.自动化工程部分



  eslint,

  prettier,

  editorconfig,

  pre-commit

```



#### 项目初始化



请完全按照以下步骤启动项目，请完全按照以下步骤启动项目，请完全按照以下步骤启动项目，重要的事情说三遍



```

git clone https://github.com/duheng/Mozi.git



cd Mozi



yarn install



yarn start



yarn run ios (android)



windows用户请用 react-native run-android 命令启动

```



**特别注意** 目前 npm5 存在安装新库时会删除其他库的问题，导致项目无法正常运行。请尽量使用 yarn 代替 npm 操作；



**项目演示**



---



















---



#### 已经完善文档 & 已完善效果



一：

[添加启动屏 API](http://www.jianshu.com/p/4540ac17dfd4)



二：

[添加 icons](http://www.jianshu.com/p/a25e4ecce60f)



三：

[React Native 预设占位 placeholder](http://www.jianshu.com/p/984ef99641f5)



四：SectionList Demo & 下拉刷新



五：FlatList Demo



六：react-navigation 自定义可缩放头部



七：返回到指定页面（返回多级）



群号:397885169（有问题或者需求欢迎进群探讨 ）



简书：http://www.jianshu.com/u/c971c7ffa27e



知乎：https://www.zhihu.com/people/duheng2011/activities



**项目结构**



```

├── README.md                   // help

├── src                         // Ract Native

│   ├── app                     // redux部分

│   │    ├── actions            // creat action

│   │    ├── constants          // constants

│   │    ├── reducers           // reducer

│   │    ├── sagas              // redux saga

│   │    ├── selectors          // 过滤以及准备view层需要的数据

│   │    └── store              // store

│   ├── commons                 // 共享基础模块

│   ├── components              // Ract Native 通用组件

│   ├── containers

│   │    └── page               // 具体业务模块

│   ├── routers                 // 路由部分

│   │    ├── index.js           // page模块聚合页

│   │    └── app.js             // 导航注册

│   ├── AppNavigationState.js   // Nvigation state 入口

│   ├── config.js               // 导航通用配置

│   └── root.js                 // Ract Native 入口页

│

├── ios                         // ios原生部分

├── index.js                    // 项目注册入口文件

├── android                     // android原生部分

├── node_modules                // 项目依赖包

├── __test__                    // 自动化测试

├── package.json                // 项目配置信息

├── pre-commit                  // 提交代码时按照.eslint的配置进行校验

├── .editorconfig               // 统一不同编辑器配置

├── .babelrc                    // 设置转码的规则,插件,文件地址映射

├── .eslintrc                   // 代码校验规则配置

└── yarn.lock                   // 依赖的版本信息管理

```



**项目架构说明**



1.  在 redux 的集成方面采用了 es7 的 Decorator 的写法，这样写的优势是在不污染现有代码逻辑的前提下实现了链接 store（非侵入式编程思想）



```

@connect(Selector筛选后符合渲染标准的数据, 当前页面需要的Actions)

export default class Zi extends Component {



}

```



2.  采用了 redux-saga 来做扁平（描述性语言）化的数据组织方式，（优势是用同步的方式写异步码方便自动化测试，随意组织多个 action，代理 mock 数据，自由控制 loading）



3.  在导航（react-navigation）的配置方面我封装了 config.js 的通用配置，默认会用通用配置，当你在业务页面配置了相应的字段会用你自己配置的覆盖默认的。实现了自由耦合。比如下面 demo 是 墨规范 页面我配置了 headerTitle 会用当前配置的：



```

  export default class Rule extends Component {

    static navigationOptions = {

      headerTitle: '墨规范',

    };

  }

```



4.  待更新...



### 依赖库



    1. react-navigation: 是官方主推的导航库，支持ios和安卓，如果你想很好的支持安卓用户最好用这个，

    [导航器性能对比](http://reactnative.cn/docs/0.43/navigation.html)

    2. redux:   a predictable state container

    3. react-redux:  offical react binding for redux

    4. redux-saga:  An alternative side effect model for Redux apps

    5. redux-logger:    日志



### 组件库



     1.  MOUI: 是一套轻量的适用于react-native的ui组件库，待开发..

     2.  react-native-vector-icons: 是可以直接使用图片名就能加载图标的第三方库,类似于web的iconfont矢量图，使用很方便, 你不需要在工程文件夹里塞各种图片, 节省很多空间

     3. react-native-scrollable-tab-view：是一个很好用的可滑动的tab导航，（如果你的项目的tab没有超过一屏的话就用react-navigation的TabNavigator）



### 消息推送



    1. jpush-react-native: 极光推送官方支持的 React Native 插件（Android & iOS）

    2. react-native-code-push: 微软的热更新开源库



### 如何使用消息推送



    全局搜索 896ea8641e9c62c38906de41 ，替换成自己的JPUSH_APPKEY就可以了



### 如何使用热更新



    1. android部分：全局搜索 TyXCHztJx9rvb3Ogy5I4cVU-DHGH6a76e0de-a57f-4a89-b60d-01d72ab0675f ，替换成自己的安卓项目codepushkey就可以了；

    2. ios部分： 全局搜索 5WgvzaDBLyL5zKjeLscIhfGKtJHb6a76e0de-a57f-4a89-b60d-01d72ab0675f ，替换成自己的ios项目codepushkey就可以了；



### 编程规范



    编程规范我们使用的是airbnb，但是这还不够，我希望大部分的代码格式类的工作都能自动化帮我做，开发人员只需要注重业务代码就好。

    为此我们用prettier+eslint+sublimelinter+airbnb，在保存代码的时候就对我们的代码进行格式化，提交代码之前再做一次严格的airbnb校验。基本就能保证团队代码的可维护性。



### 数据统计和错误分析



    1. 项目基础数据由talkingdata收集并分析，7日内错误率达到0.5%时发相关报警短信邮件给开发人员处理。

    2. 细粒度的数据收集用react-native-google-analytics-bridge来收集，主要用于产品部门，大数据，项目运营人员对用户行为以及数据的分析