目录

• app 应用代码
  • actions 存放应用的action
    • index.js action入口
    • application.js app全局的action
  • assets 存放应用需要的本地图片、附件等
  • config 存放配置文件，譬如微信的key之类的
    • api.js 网络请求地址
    • globalCssValue.js ui规范的设计值
    • actionType.js redux的acton.type的全局存放
  • components 存放组件模块
    • commons 公共组件
      • Loading.js 加载中
      • Toast.js 简单提示
      • Navigation.js 导航栏
      • Router.js 路由配置
  • containers 存放顶层容器
    • App.js app进入逻辑总页面
    • SplashScrenn.js 闪屏
    • LoginScreen.js 登陆页面
    • IntroScreen.js 介绍页面
  • middleware 中间层
  • modules 存放独立逻辑模块，如数据收集等等
    • statistic 数据收集
  • reducers 存放应用的 reducer
    • application.js app全局公用的reducer
    • index.js reducer入口
  • utils app的工具模块，如日期计算、远程连接、本地存储等通用工具
    • Ajax.js 远程请求封装
    • BackPress.js 返回按钮监控
    • create-reducer.js reducer生成器
  • root.js 应用最顶层入口
• data 应用的本地数据

功能模块

运动装备控一共有四个模块：智能选装、装备库、工具、关于。

• 智能选装功能：跟之前基本一致，需要改变的是：
  • 将会把用户最近一次的选装报告保存在本地，进入这个模块时，如果有历史选装报告，则展示；
  • 选装结果页面是否需要分享（待定）
• 装备库：跟现在一致。
• 工具：工具包括 鞋码对比 和 鉴定真假。
  • 鞋码对比：为跑步者提供不同跑鞋品牌，中国码对应其他国家的鞋码。具体品牌和鞋码参考微信文章。
  • 鉴定功能：跟现在一致（待定）
• 关于：展示运动装备控的相关信息以及可以用户反馈

插件

• react-native
• react-redux ，作为应用的状态容器管理。这里是中文手册。
• realm Realm是一个极速的、简单轻巧的、跨平台的、面向对象的移动存储数据库。
• react-native-overlay RN界的懒加载
• react-native-device-info 这个插件可以获取android、ios移动硬件的信息
• react-native-storage 本地存储插件，数据过期后可自动重新拉取。不过这个插件同时兼容了 web localstorage，所以需要自己 重新编写。
• react-native-swiper 号称最好的幻灯片组件
• code-push 微软出品，热更新工具。
• Bughd 内测分发 和 实时监控appCash ， 邀请码生成。
• DeepShare
• 百川推送 阿里旗下的百川推送
• 腾讯Bugly app质量跟踪平台
• 分词搜查 腾讯旗下的分词 搜索工具

原生组件

• Component 组件抽象类
• View 一个支持flexbox布局、样式、触控事件、可以包含0到多个任意类型子组件的容器
• Text 显示文字
• Image 显示图片
• StyleSheet 类似于css的样式表
• Navigator 使用Navigator可以在不同的页面之间转跳
• ScrollView 滚动视图
• ListView 横向或纵向滚动视图，改变数据的列表
• ProgressBarAndroid 菊花加载
• TouchableHighlight 可点击的组件,可改变点击的底色
• TouchableOpacity 当按下时，封装的视图的不透明度要降低，可以指定不透明度 activeOpacity

原生api

• AsyncStorage 本地数据存储
• NetInfo 检测网络状况
• InteractionManager 可以将一些耗时的工作安排在所有活动那个或动画结束后进行，保证js的动画流畅进行。
• BackAndroid 安卓返回键

自定义公共组件

路由管理

路由管理包括两个方面：第一是集中的路由对象管理，第二是路由转跳组件。
路由对象管理是指：把应用中所有的都有路由地址统一交给路由中心管理。该路由中心负责存储应用的所有路由地址以及对应的组件。
路由中心像一个配置文件。通过路由中心，减少应用转跳带来的逻辑问题。
路由转跳组件：目前的navitagor组件都未能实现高度的定制化，因此封装系统自带的导航组件，保留其导航功能，实现自定义导航界面。 这个路由与 reduce关联起来，每个组件不需要显示传递参数actions，路由将会自动传递 actions

公共样式管理

有了 ui设计规范 后，我们可以把公共的ui属性，譬如颜色、字号、间距、背景颜色等写成一份全局变量配置： globalCss.js
其他组件设置样式的属性值时，从配置中读取。
通过全局变量配置，当 ui规范发生变化时，我们就不用一个一个组件地修改了。
当某两个或几个组件有公共的样式时，也把它们抽出来放在同一个文件里面。

网络请求封装

rn底层使用的网络工具是 okHttp，是目前较好地一个工具。所以我们就不做修改了，在使用层封装一下网络请求库： Ajax.js
方法包括：get、post。
在使用Fetch方法的时候需要注意的是：需要判断当前的网络情况和捕捉错误。

本地存储

AsyncStorage是rn自带的简单的、异步的、持久化的Key-Value存储系统。
本地存储功能包括：

• 设置数据存储最大值
• 设置过期日期
• 自动同步数据

##约定 具体可参考 AIRBNB的react代码规范

文件名

使用驼峰命名且首字母大写，如 TextView.js

变量与常量声明

• 变量尽量使用 let
• 常量必须使用 const

解构

• 已经声明的变量不能再用于解构值
• 若函数形参为对象时，使用对象解构赋值

	function someFun( obj ){
		let { opt1 , opt2 } = obj;
	}

组件

组件声明 使用 class 和 extends 关键字。需要导出的组件直接在class关键词前使用 export default

	export default class Demo extends Component{
	}

组件必传值 组件接收的prop需要声明其格式

	Demo.propTypes={
		userName : PropTypes.string.isRequired
	}

state和props

• 多个单词组成的props，使用驼峰命名，首字母小写，禁止使用下划线，如 userName。
• 读取 state或 props 时，使用 const 和 解构，禁止使用var

	const { userName } = this.props;

标签

对于没有子标签的JSX标签，始终自闭合

	<Demo />

如果组件有多行属性，则另起一行进行自闭合。

	<Demo
		userName=''
		age='' 
	/>

方法

• 组件内的方法不能使用下划线开头
• 对于点击事件，方法前加 on 前缀

  //点击事件
  onItemPress(){
  
  }

• 对于渲染子视图的，方法前加 render 前缀

	//渲染滚动栏
	renderItem(){
	}

###关于action 当调用异步API时，一般都需要三个状态：请求开始、请求成功、请求错误。 为了区分这三种状态，我们在action中添加一个专门的status字段作为标记位。

标准组件格式

以下是标准的组件js文件。包含引入包、样式声明、组件声明、组件传值声明。

	'use strict';
	import React ,{
		Component,
		StyleSheet,
		PropTypes,
		View,
	} from 'react-native';
	//声明样式
	let styles = StyleSheet.create({
	});
	
	export default class Demo extends Component{
		render(){
			return(
				<View></View>
			)
		}
	}
	
	Demo.propTypes ={
		demo : PropTypes.string.isRequired
	}

技巧

如果业务需要在webView中触发了点击事件，需要传递参数给外层。

可以通过点击事件改变hash，外层监听 onNavigationStateChange； 或者使用 react-native-webview-bridge

获取屏幕长宽

import Dimensions from 'Dimensions';
const {width , height} = Dimensions.get('window');

请求延迟执行

 const fetchWithTimeout(timeout, ...args){
 	return Promise.race( [fetch(...args) , delay(timeout) ] )
 }

在安卓上，使用navtigator切换时，解决流畅

配置configureScene为 FadeAndroid

	<Navigator
		configureScene ={(route,routeStack)=> Navigator.SceneConfigs.FadeAndroid }
		/>

##已知问题

运行

android

1. 打开模拟器（android avd），或者链接真机
2. 进入项目目录，运行 react-native run-android