[ { "path": "HybirdAPI/AudioPlayer.md", "content": "# AudioPlayer\n\n# 概述\n\n音频播放对象，播放本地音频。\n\n注：网络音频请使用h5的audio标签。\n\n# 常量\n\n### TYPE_SPEAKER\n### TYPE_EARPIECE\n\n# 方法\n\n### play\n### pause\n### stop\n### setCurrentTime(long ms)\n### (long)getDuration\n### (long)getCurrentTime\n### setType(int AudioPlayer.TYPE_*)\n\n# 事件\n\n### onPlay\n### onPause\n### onFail\n### onEnded\n### onTimeupdate\n\n\n\n" }, { "path": "HybirdAPI/AudioRecorder.md", "content": "# AudioRecorder\n\n# 概述\n\n调用麦克风进行录音操作\n\n# 方法\n\n### record\n\nfilePath\nsamplerate\nformat\n\n### stop\n### getFilePath\n### clear\n\n# 事件\n\n### onRecord\n### onFail\n### onEnded\n### onTimeupdate\n\n\n\n\n" }, { "path": "HybirdAPI/index.md", "content": "# HybirdAPI\n\n# 概述\n\n此系列文档是为了描述app中如何提供一套统一的原生接口，供js调用。\n\napp中webview中的js可以调用。\n\napp中reactnative模块可以调用。\n\n" }, { "path": "README.md", "content": "# 文章目录\n\n大家有问题欢迎留言issues讨论。\n\n### [【翻译】理解ios11中的webview viewport（第一部分）](https://github.com/cnsnake11/blog/blob/master/%E5%85%B6%E5%AE%83/Understanding%20the%20WebView%20Viewport%20in%20iOS%2011%20~%201.md)\n\n### [【翻译】让网站适配iphoneX](https://github.com/cnsnake11/blog/blob/master/%E5%85%B6%E5%AE%83/Designing%20Websites%20for%20iPhone%20X.md)\n\n### [【原创】富文本编辑器4~站外图片的粘贴](https://github.com/cnsnake11/blog/blob/master/%E5%85%B6%E5%AE%83/%E5%AF%8C%E6%96%87%E6%9C%AC%E7%BC%96%E8%BE%91%E5%99%A84~%E7%AB%99%E5%A4%96%E5%9B%BE%E7%89%87%E7%9A%84%E7%B2%98%E8%B4%B4.md)\n\n### [【原创】富文本编辑器3~自定义元素](https://github.com/cnsnake11/blog/blob/master/%E5%85%B6%E5%AE%83/%E5%AF%8C%E6%96%87%E6%9C%AC%E7%BC%96%E8%BE%91%E5%99%A83~%E8%87%AA%E5%AE%9A%E4%B9%89%E5%85%83%E7%B4%A0.md)\n\n### [【原创】富文本编辑器2~复制粘贴的处理](https://github.com/cnsnake11/blog/blob/master/%E5%85%B6%E5%AE%83/%E5%AF%8C%E6%96%87%E6%9C%AC%E7%BC%96%E8%BE%91%E5%99%A82~%E5%A4%8D%E5%88%B6%E7%B2%98%E8%B4%B4%E7%9A%84%E5%A4%84%E7%90%86.md)\n\n### [【原创】富文本编辑器1~html转结构化数据](https://github.com/cnsnake11/blog/blob/master/%E5%85%B6%E5%AE%83/%E5%AF%8C%E6%96%87%E6%9C%AC%E7%BC%96%E8%BE%91%E5%99%A81~html%E8%BD%AC%E7%BB%93%E6%9E%84%E5%8C%96%E6%95%B0%E6%8D%AE.md)\n\n### [【翻译】ReactNative:关于苹果审核警告](https://github.com/cnsnake11/blog/blob/master/ReactNative%E7%BF%BB%E8%AF%91/ReactNative%20:%20A%20warning%20from%20Apple.md)\n\n### [【翻译】Reconciliation React比对算法](https://github.com/cnsnake11/blog/blob/master/ReactNative%E7%BF%BB%E8%AF%91/Reconciliation.md)\n\n### [【原创】数据结构--树形数据的处理(2)](https://github.com/cnsnake11/blog/blob/master/%E5%85%B6%E5%AE%83/%E6%95%B0%E6%8D%AE%E7%BB%93%E6%9E%84--%E6%A0%91%E5%BD%A2%E6%95%B0%E6%8D%AE%E7%9A%84%E5%A4%84%E7%90%862.md)\n\n### [【原创】数据结构--树形数据的处理(1)](https://github.com/cnsnake11/blog/blob/master/%E5%85%B6%E5%AE%83/%E6%95%B0%E6%8D%AE%E7%BB%93%E6%9E%84--%E6%A0%91%E5%9E%8B%E6%95%B0%E6%8D%AE%E7%9A%84%E5%A4%84%E7%90%86(1).md)\n\n### [【翻译】React Advanced Performance 性能进阶](https://github.com/cnsnake11/blog/blob/master/ReactNative%E7%BF%BB%E8%AF%91/React%20Advanced%20Performance.md)\n\n### [【原创】弱特征广告方案](https://github.com/cnsnake11/blog/blob/master/%E5%85%B6%E5%AE%83/%E5%BC%B1%E7%89%B9%E5%BE%81%E5%B9%BF%E5%91%8A%E6%96%B9%E6%A1%88.md)\n\n### [【原创】前端和开闭原则](https://github.com/cnsnake11/blog/blob/master/%E5%85%B6%E5%AE%83/%E5%89%8D%E7%AB%AF%E5%92%8C%E5%BC%80%E9%97%AD%E5%8E%9F%E5%88%99.md)\n\n### [【原创】React的render优化通用解决方案](https://github.com/cnsnake11/blog/blob/master/ReactNative%E5%BC%80%E5%8F%91%E6%8C%87%E5%AF%BC/React%E7%9A%84render%E4%BC%98%E5%8C%96%E6%A1%86%E6%9E%B6.md)\n\n### [【原创】一个类似微信群聊程序的技术方案设计过程](https://github.com/cnsnake11/blog/blob/master/%E5%85%B6%E5%AE%83/%E4%B8%80%E4%B8%AA%E7%B1%BB%E4%BC%BC%E5%BE%AE%E4%BF%A1%E7%BE%A4%E8%81%8A%E7%A8%8B%E5%BA%8F%E7%9A%84%E6%8A%80%E6%9C%AF%E6%96%B9%E6%A1%88%E8%AE%BE%E8%AE%A1%E8%BF%87%E7%A8%8B.md)\n\n### [【原创】ReactNative的ios崩溃整理分析](https://github.com/cnsnake11/blog/blob/master/ReactNative%E5%BC%80%E5%8F%91%E6%8C%87%E5%AF%BC/ReactNative%E7%9A%84ios%E5%B4%A9%E6%BA%83%E6%95%B4%E7%90%86%E5%88%86%E6%9E%90.md)\n\n### [【原创】ReactNative团队分享提纲](https://github.com/cnsnake11/blog/blob/master/ReactNative%E5%BC%80%E5%8F%91%E6%8C%87%E5%AF%BC/ReactNative%E5%88%86%E4%BA%AB.md)\n\n### [【翻译】React PureRenderMixin](https://github.com/cnsnake11/blog/blob/master/ReactNative%E7%BF%BB%E8%AF%91/React%20PureRenderMixin.md)\n\n### [【原创】ReactNative增量升级解决方案](https://github.com/cnsnake11/blog/blob/master/ReactNative%E5%BC%80%E5%8F%91%E6%8C%87%E5%AF%BC/ReactNative%E5%A2%9E%E9%87%8F%E5%8D%87%E7%BA%A7%E6%96%B9%E6%A1%88.md)\n\n### [【翻译】React 浅比对 Shallow Compare](https://github.com/cnsnake11/blog/blob/master/ReactNative%E7%BF%BB%E8%AF%91/React%20Shallow%20Compare.md)\n\n### [【原创】ReactNative安卓首屏白屏优化](https://github.com/cnsnake11/blog/blob/master/ReactNative%E5%BC%80%E5%8F%91%E6%8C%87%E5%AF%BC/ReactNative%E5%AE%89%E5%8D%93%E9%A6%96%E5%B1%8F%E7%99%BD%E5%B1%8F%E4%BC%98%E5%8C%96.md)\n\n### [【原创】ReactNative导航设计与实现](https://github.com/cnsnake11/blog/blob/master/ReactNative%E5%BC%80%E5%8F%91%E6%8C%87%E5%AF%BC/ReactNative%E5%AF%BC%E8%88%AA%E8%AE%BE%E8%AE%A1%E4%B8%8E%E5%AE%9E%E7%8E%B0.md)\n\n### [【原创】ReactNative打离线包-android篇](https://github.com/cnsnake11/blog/blob/master/ReactNative%E5%BC%80%E5%8F%91%E6%8C%87%E5%AF%BC/ReactNative%E6%89%93%E7%A6%BB%E7%BA%BF%E5%8C%85-android%E7%AF%87.md)\n\n### [【原创】ReactNative打离线包-ios篇](https://github.com/cnsnake11/blog/blob/master/ReactNative%E5%BC%80%E5%8F%91%E6%8C%87%E5%AF%BC/ReactNative%E6%89%93%E7%A6%BB%E7%BA%BF%E5%8C%85-ios%E7%AF%87.md)\n\n### [【原创】ReactNative的组件架构设计](https://github.com/cnsnake11/blog/blob/master/ReactNative%E5%BC%80%E5%8F%91%E6%8C%87%E5%AF%BC/ReactNative%E7%9A%84%E6%9E%B6%E6%9E%84%E8%AE%BE%E8%AE%A1.md)\n\n### [【原创】ReactNative组件状态设计思考](https://github.com/cnsnake11/blog/blob/master/ReactNative%E5%BC%80%E5%8F%91%E6%8C%87%E5%AF%BC/ReactNative%E7%BB%84%E4%BB%B6%E7%8A%B6%E6%80%81%E8%AE%BE%E8%AE%A1%E6%80%9D%E8%80%83.md)\n\n### [【翻译】ReactNative的定时器Timers](https://github.com/cnsnake11/blog/blob/master/ReactNative%E7%BF%BB%E8%AF%91/react-native%E7%9A%84%E5%AE%9A%E6%97%B6%E5%99%A8.md)\n\n### [【原创】已有工程集成ReactNative-IOS](https://github.com/cnsnake11/blog/blob/master/ReactNative%E5%BC%80%E5%8F%91%E6%8C%87%E5%AF%BC/%E5%B7%B2%E6%9C%89%E5%B7%A5%E7%A8%8B%E9%9B%86%E6%88%90ReactNaitve-IOS.md)\n\n### [【翻译】ReactNative的性能](https://github.com/cnsnake11/blog/blob/master/ReactNative%E7%BF%BB%E8%AF%91/react-native%E7%9A%84%E6%80%A7%E8%83%BD.md)\n\n### [【原创】ReactNative的组件架构设计](https://github.com/cnsnake11/blog/blob/master/ReactNative%E5%BC%80%E5%8F%91%E6%8C%87%E5%AF%BC/ReactNative%E7%9A%84%E6%9E%B6%E6%9E%84%E8%AE%BE%E8%AE%A1.md)\n\n### [【转载】ReactNative变革无线前端-淘宝d2分享](https://github.com/cnsnake11/blog/blob/master/ReactNative%E5%BC%80%E5%8F%91%E6%8C%87%E5%AF%BC/%E6%B7%98%E5%AE%9Dd2%E5%88%86%E4%BA%AB-ReactNative%E5%8F%98%E9%9D%A9%E6%97%A0%E7%BA%BF%E5%89%8D%E7%AB%AF.md)\n\n### [【原创】CodePush](https://github.com/cnsnake11/blog/blob/master/ReactNative%E5%BC%80%E5%8F%91%E6%8C%87%E5%AF%BC/CodePush.md)\n\n### [【原创】ReactNative开发技巧总结](https://github.com/cnsnake11/blog/blob/master/ReactNative%E5%BC%80%E5%8F%91%E6%8C%87%E5%AF%BC/ReactNative%E5%BC%80%E5%8F%91%E6%8A%80%E5%B7%A7%E6%80%BB%E7%BB%93.md)\n\n### [【原创】ReactNative入门知识](https://github.com/cnsnake11/blog/blob/master/ReactNative%E5%BC%80%E5%8F%91%E6%8C%87%E5%AF%BC/ReactNative%E5%85%A5%E9%97%A8%E7%9F%A5%E8%AF%86.md)\n\n\n\n\n\n" }, { "path": "ReactNative开发指导/CodePush.md", "content": "#CodePush\n\nhttps://github.com/Microsoft/react-native-code-push\n\n#重要说明\n\n\n\nWhile the service is in beta, we don’t recommend using it for doing production deployments, since we don’t currently offer any specific SLA.因为现在是beta版本，不建议用做生产版本的发布。\n\n确实不能用于生产,目前只在美国有服务器，大陆访问非常慢。\n\n所以，增量升级只能自力更生了。\n\n#工作方式\n可以只升级Rn的js和图片，不用使用二进制包升级。\n\n通过CodePush服务器进行升级。\n\n服务端目前没有开源，不能用自己的服务器\n\n原生代码的改动是不能通过codepush升级的。\n\n# 支持平台\n\nAndroid (asset support coming soon!)\n\n安卓暂不支持asset\n\n#基本流程\n1. 安装CodePush CLI\n2. 创建codePush账户\n3. 注册app到codepush服务器\n4. app中加入codepush客户端代码，并开发升级相关代码。 \n5. 发布更新到codepush服务器\n6. app收到了升级推送\n\n\n具体配置过程请参考官网\n\n网上资料参考\n\n\n#下一步工作\n\n因为codepush服务器端不开源，而且服务器还在国外的关系，不能保证服务端的稳定性，所以很遗憾不能应用于真正的项目中。\n\n针对目前的情况，制定下一步工作如下：\n\n1. 研读codepush客户端源码，理解android和ios在客户端下载资源文件后，如何切换到新资源的方法。\n2. 设计服务端，服务端仅提供文件资源下载服务和升级信息描述服务即可，不需要较复杂的逻辑。\n3. 设计自动化打包解决方案，包括升级补丁打包，完整app打包。\n\n\n\n\n#源码阅读记录\n1. js版本同时需要考虑对app版本的依赖问题，例如，js1.0版本必须运行在iosApp2.0，安卓app2.6上等。\n2. 提供了一系列js接口，方便应用更细节的控制升级的过程。\n3. 对于assets中的图片内容，可以自动计算与上一版本的差别，只下载增量部分。\n4. 如果app升级了，js应自动使用app中版本。todo一个升级算法状态图。\n4. 客户端应有2部分组件-codepush文档很详细，可以参考\n\t1. native部分，安卓和ios分别提供启动时bundle资源位置的服务\n\t2. js部分，提供对更新和下载的细粒度控制接口.\n\n" }, { "path": "ReactNative开发指导/ReactNative入门知识.md", "content": "# ReactNative入门知识\n\n本文也可以作为RN的入门知识范围，为入门RN提供了一个知识大纲。掌握这些知识帮助你快速入门RN，少走弯路。\n\n#es6\n\nlet和const\n\n箭头函数\n\n类定义\n\n解构赋值Destructuring\n\n函数参数的默认值\n\n函数的rest参数【形式为“...变量名”】；及其逆运算；\n\nimport export\n\n参考地址：http://facebook.github.io/react-native/docs/javascript-environment.html#content\n\n参考地址：http://www.ghugo.com/react-native-es6/\n\n#Flow\n\n\n#react\njsx\n\n生命周期事件\n\nrender方法\n\nstate相关\n\nprops相关\n\n\n#react-naive常用组件\nview\n\ntext\n\ntouch\n\nimage\n\ntextInput\n\nscrollview\n\nlistview\n\nnavigator\n\n\n#flexbox\n\n\n#Dimensions\n\n#fetch\n\n#console\n断点\n\n#定时任务\n参考地址：https://github.com/cnsnake11/blog/blob/master/ReactNative翻译/react-native的定时器.md\n\n#交互管理器\n参考地址：https://github.com/cnsnake11/blog/blob/master/ReactNative翻译/react-native的定时器.md\n\n#调试\nconsole.log()\n\n在chrome中调试js\n\n#Immutable.js\n\n\n" }, { "path": "ReactNative开发指导/ReactNative分享.md", "content": "\n# ReactNative分享提纲\n\n# 分享的目的\n\n1. 了解rn是什么，特点和使用场景\n2. 本次重点是学习架构（思想）而不是学习框架（用法）\n3. 学习组件化的思想及其好处，目标是能运用到工作中\n4. 希望随时打断进行交流讨论\n\n# reactnative是个啥\n\n用js写原生app的开源框架，目前官方支持ios和android。\n\nfacebook2015年发布。社区关注度非常高。版本迭代很快，基本上2周左右一个版本。\n\n# 安卓demo包下载\n\n[RnDemo.apk,9MB](http://pan.baidu.com/s/1mhX6VoO)\n\n\n# 优势\n\n## 开发体验\n\t\n1. 改代码，即时编译，即时加载\n1. 兼容性好，代码可预测，各系统的模拟器、各型号的真机基本无差异\n1. 组件化支撑，代码更易复用\n1. flexbox布局，自适应布局更容易\n1. 手势操控系统，更易开发体验佳的触屏应用\n1. 支持应用内更新，自由控制发版\n1. es6新特性，各种语法黑魔法\n\t1. 箭头函数\n\t1. promise\n\t1. 解构赋值\n\t1. 类定义、继承\n\t1. fetch\n\t2. 等\n\n## 用户体验\n1. 加载性能好，无白屏\n2. 动画性能好，无卡顿\n2. 顺畅的手势操作\n\n# 劣势\n1. 无web版，分享页等还要开发,react-web目前还不成熟\n1. 无选择器的概念，定义样式很繁琐,通过开发规范部分解决\n1. 尚未发布1.0\n\n程序员首先要思考的是让用户爽，然后才是让自己爽。如果按此原则的话，劣势还是在我们接受范围内的。（用户体验和开发体验同样重要，最好是有更完美的解决方案。）\n\n# react基本概念\n\n## 组件化编程\n\n### 组件化定义\n组件的定义：独立的可完成某些工作的部件。可能是一个button，或者一个util类。\n\n组件化编程的目的：复用复用复用。站在别人肩膀上可以极大的提升开发测试效率。\n\n遇到的困难：个性化定制。通过属性、事件等扩展。\n\n举个web组件的例子，参考此文档的前半部分：[链接](https://github.com/cnsnake11/blog/blob/master/ReactNative%E5%BC%80%E5%8F%91%E6%8C%87%E5%AF%BC/ReactNative%E7%BB%84%E4%BB%B6%E7%8A%B6%E6%80%81%E8%AE%BE%E8%AE%A1%E6%80%9D%E8%80%83.md)\n\n### react做了什么\n\nreact是一个组件化编程的框架，提供了组件化编程的完整解决方案。[例子](http://facebook.github.io/react/)\n\nreact组件的定义。 [链接](http://facebook.github.io/react/docs/component-specs.html)\n\nreact组件生命周期及其生命周期事件。[链接](http://facebook.github.io/react/docs/component-specs.html#lifecycle-methods)\n\n## 面向状态编程\n\n页面中任何组件的state的改变，都会引起页面所有组件的render方法的执行。react会根据render执行的结果与当前的虚拟dom进行比对，只进行增量的更新。[链接](https://github.com/cnsnake11/blog/blob/master/ReactNative%E5%BC%80%E5%8F%91%E6%8C%87%E5%AF%BC/ReactNative%E7%BB%84%E4%BB%B6%E7%8A%B6%E6%80%81%E8%AE%BE%E8%AE%A1%E6%80%9D%E8%80%83.md#rn设计思路)\n\n## jsx\njs中的xml。[例子](http://facebook.github.io/react/)\n\n# reactnative基本概念\n\n## 和react的关系\n\n1. rn使用react的组件化规范。\n2. rn使用react的面向状态编程的机制。\n3. rn使用react的jsx机制。\n4. rn提供了一系列app开发所需要的组件。\n\n## 常用组件\n1. div View\n2. span Text\n3. img Image\n4. input TextInput\n5. button Touch*\n\n## 样式定义\n不支持选择器。不支持选择器。不支持选择器。\n\n只能内联或者在每一个节点上声明外部css定义。所以，一般没有复用的样式使用内联，有复用的才使用外部定义。\n\n[链接](http://reactnative.cn/docs/0.24/style.html#content)\n\n\n# 开发环境\n\n## ios\n\nxcode+app的ios代码+js编辑器+rn开发服务器+真机or模拟器\n\n## android\n\njdk+androidSdk+androidStudio+app的android代码+js编辑器+rn开发服务器+真机or模拟器\n\n# 开发过程\n\n1. 启动rn开发服务器\n2. 启动模拟器，点开app，设置自动reload\n3. 启动js代码编辑器，coding---save---看效果\n4. tips:可以直接让首页显示你要开发的页面，可以快速查看效果\n\n```\n// tips用到的代码，替换index页面的最后一行\nAppRegistry.registerComponent('Ask', () => require('../../../demo/demo1/animate/drag2'));\n```\n\n# 调试过程\n\n1. console.log\n2. js断点调试\n3. alert\n3. 页面元素检测器\n\n# 组件设计\n[链接](https://github.com/cnsnake11/blog/blob/master/ReactNative%E5%BC%80%E5%8F%91%E6%8C%87%E5%AF%BC/ReactNative%E7%9A%84%E6%9E%B6%E6%9E%84%E8%AE%BE%E8%AE%A1.md)\n\n\n# 坑坑坑\n\n1. android的textinput不能设置边框圆角\n1. android的图片resizemodal=contain不好用\n1. 循环依赖报错的问题\n1. 安卓rn首屏白屏时间长\n1. 安卓的中绝对定位元素移动出父元素会不可见，设置overflow=hidden也不好使\n1. 不支持隐藏元素\n1. 安卓中，使用缓存rootview，并且键盘打开情况下，直接后退出rn模块，在进入会报错\n1. 魅族smartbar不占高\n1. android中，设置overflow=hidden，父容器高度不能为0，至少为0.01，否则hidden无效\n1. 加固后动画有掉帧现象\n\n\n# 架构设计\n```\n业务模块\n业务框架\n技术框架\nreactnative\nandroid、ios操作系统\n```\n\n# 框架设计\n\n参考技术框架和业务框架的目录结构介绍。\n\n# 版本发布\n\n## 全量发布\n\n全量发布是将rn相关资源打包进app中，是无需网络下载的。\n\n一般过程：\n\n1. coding结束\n2. 使用全量打包命令，打出android和ios全量包\n3. 将包拷贝到android和ios工程约定好的位置\n4. 按照android和ios原有打包方式进行打包即可\n\n## 增量发布\n\n[增量升级方案](https://github.com/cnsnake11/blog/blob/master/ReactNative%E5%BC%80%E5%8F%91%E6%8C%87%E5%AF%BC/ReactNative%E5%A2%9E%E9%87%8F%E5%8D%87%E7%BA%A7%E6%96%B9%E6%A1%88.md)\n\n一般过程：\n\n1. coding结束\n2. 使用全量打包命令，打出android和ios全量包\n3. 使用增量打包命令，打出android和ios增量包\n4. 将增量包上传到后台管理系统，上线即可\n\n" }, { "path": "ReactNative开发指导/ReactNative增量升级方案.md", "content": "# ReactNative增量升级方案\n\n# 前言\nfacebook的react-native给我们带来了用js写出原生应用的同时，也使得使用RN编写的代码的在线升级变得可能，终于可以不通过应用市场来进行升级，极大的提升了app修bug和赋予新功能的能力。----使用h5的方式也可以做到，但是rn的用户体验可要远远超过h5啊。\n\n一般使用RN编写的app的线上使用方式，是将react-native bundle命令打出bundle文件和assets文件夹，直接内置到app中，app在viewcontroller或者activity中直接加载app内部的bundle文件，比如下图。\n\n![](media/14534499414604.jpg)\n\n\n当修改了代码或者图片的时候，只要app使用新的bundle文件和assets文件夹，就完成了一次在线升级。\n\n本文主要基于以上思路，讲解增量升级的解决方案。\n\n# 何为增量？\n\n 一个完整的RN-app程序通常包含以下几个部分：\n \n 1. native代码部分-objc或者java\n 2. js代码部分-rn代码、依赖的第三方库、业务代码等\n 3. 图片资源部分\n\nnative代码别想了，没法在线升级，要是能大家就都不使用应用市场ota升级了。\n \n能进行在线升级的是js代码部分和图片资源部分，具体到代码就是bundle文件和assets文件夹。\n\n因为在线升级是要走网络的，我们要想办法将网络消耗降到最低，所以要使用增量升级的方式。\n\n针对js代码部分（即bundle文件）的增量指的是，代码的改动有多少，增量patch的补丁就有多少，那些没有改动的代码部分是不在补丁的范围内的。\n\n针对图片部分（即assets）的增量指的是，升级补丁包中只包含新增的图片和有改动的图片。\n\n那么在app端，下载升级补丁包，只需要和现有的版本进行合并，就能计算出最新版本的全量包。\n\n总结下流程：()中为例子\n\n首先，计算增量包：新版本(v10) - 旧版本(v1到v9) = 增量包 （会有9个包，v1~v10.zip,v2~v10.zip,,,,,v9-v10.zip）\n\n然后，app根据自己的当前版本(比如V6)，下载对应的增量包（V6-V10.zip）。\n\n最后，app中通过 旧版本(v6) + 增量包(v6~v10.zip) = 新版本(v10) ，计算出了新版本的全量包。\n\n \n# 增量算法\n \n assets增量算法，比较简单，就是比对，可以很容易的比较出新增的文件，和不同的文件（使用md5）。\n \n bundle文件的增量算法，确实比较复杂，刚开始没有什么头绪，后来在leader的指引下，很幸运的找到了google写的一个开源的库，可以对大字符串进行diff和patch，并且支持java、objc、js等等语言，完全的满足了我们的需求。\n\n只用到2个接口，具体请参考github上的文档\n\n1. 生成增量包时候：patch_make(text1, text2) => patches \n2. app生成全量包时候：patch_apply(patches, text1) => [text2, results]\n\ngoogle开源库地址：https://github.com/bystep15/google-diff-match-patch\n\n\n# codepush\n\n微软的codepush也做了类似的事情，不过由于以下原因，我们团队没敢使用其作为解决方案。\n\n1. 其增量升级仅仅是针对图片资源的 \n2. 其升级服务器端程序并不开源\n3. 其升级服务器在美国，国内访问很慢且不稳定\n\n不过，codepush客户端的源码和文档也给我们提供了很多思路，在此感谢codepush团队。\n\ncodepush地址：http://microsoft.github.io/code-push/\n\n# bundle要求的app最小版本\n\n本文中一般用min-v或者appMinV表示。\n\n因为js代码是依赖于native代码的，所以，jsbundle对app的版本有要求，所以有这个概念。\n\n试想，如果bundle依赖了一个native的一个新的接口，这个接口在v3版本的app中才发布，如果v2版本的app升级了这个bundle，那么必然会报错，严重的可能会导致app的崩溃。\n\n\n# 系统结构设计与各模块职责\n![312313123](media/312313123.png)\n\n# bundle仓库设计\n\n存储全量bundle和生成增量patch\n\n\n## node patch 命令\n\n在bundle目录下放入一个符合要求【参考目录结构说明】的新版本目录，比如0.3.0,然后执行以下命令。\n\n命令：node patch 版本号 ， 示例：node patch 0.3.0\n\n-d参数: node patch 版本号 -d ，如果加入-d参数，会先删除patch目录下的对应版本目录，然后进行patch生成\n\n然后在patch目录中就会生成0.3.0的增量包，同时patch目录下的update.json文件也会重新生成.\n\n## node update.json 命令\n\n在patch目录下重新生成update.json文件\n\n## 目录结构说明\n![](media/14534529649291.jpg)\n\n```\nbundle 存放全量bundle和全量assets的目录,里面的文件基本上是使用react-native bundle命令生成的\n 0.1.0\n 略\n 0.2.0\n android\n 略，同ios\n ios\n config.json 此版本的配置信息，包含要求app的最低版本等，手动配置\n index.jsbundle 全量jsbundle文件，使用react-native bundle命令生成\n assets 全量图片目录，使用react-native bundle命令生成\n 0.3.0\n 略\n \npatch 存放增量补丁的目录，里面文件都是命令生成的，无需手动维护 \n 0.1.0\n 第一版本无文件\n 0.2.0\n android\n 略，同ios\n ios\n 0.1.0-0.2.0.zip 增量包.zip\n 0.3.0\n android\n 略，同ios\n ios\n 0.1.0-0.3.0.zip 增量包.zip\n 0.2.0-0.3.0.zip 增量包.zip\n update.json 所有的升级包信息\nsrc 存放打包用的源码\nlib 存放打包用依赖的第三方的源码\npatch.js patch命令入口\nupdate.json.js update.json命令入口\n```\n## config.json示例\n\n```\n{\n \"v\": \"0.3.0\", //版本\n \"min-v\": \"4.0.0\", //此版本要求的最小app版本\n \"date\": \"2016-01-01\", //打包日期\n \"des\": [\n \"修复xxbug\", \"添加xx功能\"\n ]\n}\n\n```\n\n\n## update.json示例\n\n```\n[\n {\n \"v\": \"0.1.0\",\n \"min-v\": \"4.0.0\",\n \"date\": \"2016-01-01\",\n \"des\": [\n \"修复xxbug\",\n \"添加xx功能\"\n ],\n \"iosBundleMd5\": \"11f82563f8fd3f22dccb80ad2297f7bc\",\n \"androidBundleMd5\": \"11f82563f8fd3f22dccb80ad2297f7bc\"\n },\n {\n \"v\": \"0.2.0\",\n \"min-v\": \"4.0.0\",\n \"date\": \"2016-01-01\",\n \"des\": [\n \"修复xxbug\",\n \"添加xx功能\"\n ],\n \"iosBundleMd5\": \"3ca2824b008132cee515c0ea29938ff2\",\n \"androidBundleMd5\": \"3ca2824b008132cee515c0ea29938ff2\"\n },\n {\n \"v\": \"0.3.0\",\n \"min-v\": \"4.0.0\",\n \"date\": \"2016-01-01\",\n \"des\": [\n \"修复xxbug\",\n \"添加xx功能\"\n ],\n \"iosBundleMd5\": \"dbb81d2383112abb50eb19970c486acd\",\n \"androidBundleMd5\": \"dbb81d2383112abb50eb19970c486acd\"\n }\n]\n\n```\n\n# 升级服务器设计\n\n## 接口patch/query\n\n例如：http://localhost:3000/patch/query?bundleV=0.2.0&appV=4.0.0&platform=ios\n\n此接口会有以下4个场景的使用情况，每个场景返回的json示例已经提供在后面文档中。\n\n### 输入参数\n\n ```\n bundleV : app中的bundle版本\n appV : app版本\n platform : app的平台\n\n ```\n\n### 返回json各项说明\n\n\n 1. status : 本次请求后台是否发生了错误\n 1. msg : 给用户看的中文提示信息，静默升级时候没什么用\n 1. latestBundleV : 当前的最新bundle版本\n 1. latestAppMinV : 最新bundle要求的app最低版本\n 1. canUpdate : 能否升级，boolean\n 1. canUpdateBundleV : 能升级的bundle版本\n 1. canUpdateAppMinV : 能升级的bundle要求的app最低版本\n 1. patchUrl : 补丁包相对地址\n 1. platform : 平台：ios or android\n\n\n\n### 场景1\n\n能升级，且能升级到最新版\n\n```\n{\n status: 'success',\n msg: '可以升级，bundle最新版为0.3.0',\n latestBundleV: '0.3.0',\n latestAppMinV: '4.0.0',\n canUpdate: true,\n canUpdateBundleV: '0.3.0',\n canUpdateAppMinV: '4.0.0',\n patchUrl: 'patch/0.3.0/ios/0.2.0-0.3.0.zip',\n platform: 'ios'\n}\n```\n\n### 场景2\n无需升级,已经是最新版本\n\n```\n{\n status: 'success',\n msg: '无需升级，已经是最新版本',\n canUpdate: false,\n platform: 'ios'\n}\n```\n\n### 场景3\n能升级,能升级到当前appMinV的最新bundle版本,但不是最新的bundle,想升最新bundle，必须先升app\n\n```\n{\n status: 'success',\n msg: '可以升级，但app版本3.0.0太低，只能升到bundleV0.2.0，bundleV最新为0.3.0',\n latestBundleV: '0.3.0',\n latestAppMinV: '4.0.0',\n canUpdate: true,\n canUpdateBundleV: '0.2.0',\n canUpdateAppMinV: '3.0.0',\n patchUrl: 'patch/0.2.0/ios/0.1.0-0.2.0.zip',\n platform: 'ios'\n}\n```\n\n### 场景4\n不能升级,已经是当前appMinV的最新bundle,但不是最新的bundle,想升最新bundle，必须先升app\n\n```\n{\n status: 'success',\n msg: '不能升级，当前已经是app3.0.0的最新bundle了，但不是最新bundle0.3.0，想升级bundle到最新，请先升级app',\n latestBundleV: '0.3.0',\n latestAppMinV: '4.0.0',\n canUpdate: false,\n platform: 'ios'\n}\n```\n\n# native客户端设计\n\n客户端的主要工作就是发请求到升级服务器询问是否能升级，然后根据返回的信息，下载升级包，解压升级包，安装升级包。\n\n过程中要保证下载的文件是正确的（md5校验），要保证补丁安装之后的全量bundle文件是正确的（md5校验）。\n\n整个过程用户无感知。\n\n此部分详细设计后边会补充。\n\n# 遗留问题\n目前rn将安卓的图片放入到res目录中，导致安卓图片不能使用在线升级的解决方案，但是codepush的作者已经重构了此部分内容，并提pr到rn，rn团队也接受了这个pr，会在近期的版本中发布。\n\n参考地址：https://github.com/facebook/react-native/pull/4527\n\n# 近期开源\n本部分内容核心的几个部分都已经完成，近期完善之后，会开源出来。\n\n\n\n" }, { "path": "ReactNative开发指导/ReactNative安卓首屏白屏优化.md", "content": "# ReactNative安卓首屏白屏优化\n\n#问题描述\n公司现有app中部分模块使用reactnative开发，在实施的过程中，rn良好的兼容性，极佳的加载、动画性能，提升了我们的开发、测试效率，提升了用户体验。\n\n但是，在android中，当点击某个rn模块的入口按钮，弹出rn的activity到rn的页面展现出来的过程中，会有很明显的白屏现象，不同的机型不同（cpu好的白屏时间短），大概1s到2s的时间。\n\n注意，只有在真机上才会有此现象，在模拟器上没有此现象完全是秒开。ios上也是秒开，测试的最低版本是ios7，iphone4s。\n\nreactnative版本0.20.0。\n\njsbundle文件大小717kb。\n\n#优化效果\n经过了大量的源码阅读，和网上资料查找，最终完美的解决了这个问题，无论什么机型，都可以达到秒开，如图（虽然下图是模拟器的截图，但是真机效果基本一样）：\n\n![1](media/1.gif)\n\n#优化过程\n\n##时间分布\n一般优化速度问题，首先就是要找到时间分布，然后根据二八原则，先优化耗时最长的部分。\n\nandroid集成rn都会继承官方提供的ReactActivity\n\n```\npublic class MainActivity extends ReactActivity {\n```\n然后只在自己的activity中覆盖一些配置项。\n\n在官方的ReactActivity中的onCreate方法中\n\n```\nprotected void onCreate(Bundle savedInstanceState) {\n super.onCreate(savedInstanceState);\n\n if (getUseDeveloperSupport() && Build.VERSION.SDK_INT >= 23) {\n // Get permission to show redbox in dev builds.\n if (!Settings.canDrawOverlays(this)) {\n Intent serviceIntent = new Intent(Settings.ACTION_MANAGE_OVERLAY_PERMISSION);\n startActivity(serviceIntent);\n FLog.w(ReactConstants.TAG, REDBOX_PERMISSION_MESSAGE);\n Toast.makeText(this, REDBOX_PERMISSION_MESSAGE, Toast.LENGTH_LONG).show();\n }\n }\n\n mReactInstanceManager = createReactInstanceManager();\n ReactRootView mReactRootView = createRootView();\n mReactRootView.startReactApplication(mReactInstanceManager, getMainComponentName(), getLaunchOptions());\n setContentView(mReactRootView);\n }\n```\n最慢的就是这两行代码，占了90%以上的时间。\n\n```\nReactRootView mReactRootView = createRootView();\nmReactRootView.startReactApplication(mReactInstanceManager, getMainComponentName(), getLaunchOptions());\n```\n\n这两行代码就是把jsbundle文件读入到内存中，并进行执行，然后初始化各个对象。\n\n##优化思路---内存换时间\n\n在app启动时候，就将mReactRootView初始化出来，并缓存起来，在用的时候直接setContentView(mReactRootView)，达到秒开。\n\n###步骤1 缓存rootview管理器\n\n缓存rootview管理器主要用于初始化和缓存rootview对象。\n\n```\nimport android.app.Activity;\nimport android.os.Bundle;\nimport android.view.ViewParent;\n\nimport com.facebook.react.LifecycleState;\nimport com.facebook.react.ReactInstanceManager;\nimport com.facebook.react.ReactPackage;\nimport com.facebook.react.ReactRootView;\n\nimport java.lang.reflect.Field;\n\n/**\n * 缓存view管理\n */\npublic class RNCacheViewManager {\n\n private static ReactRootView mRootView = null;\n private static ReactInstanceManager mManager = null;\n private static AbsRnInfo mRnInfo = null;\n\n //初始化\n public static void init(Activity act, AbsRnInfo rnInfo) {\n init(act, rnInfo, null);\n }\n\n public static void init(Activity act, AbsRnInfo rnInfo, Bundle launchOptions) {\n if (mManager == null) {\n updateCache(act, rnInfo, launchOptions);\n }\n }\n\n public static void updateCache(Activity act, AbsRnInfo rnInfo) {\n updateCache(act, rnInfo, null);\n }\n\n //更新cache，适合于版本升级时候更新cache\n public static void updateCache(Activity act, AbsRnInfo rnInfo, Bundle launchOptions) {\n mRnInfo = rnInfo;\n mManager = createReactInstanceManager(act);\n mRootView = new ReactRootView(act);\n mRootView.startReactApplication(mManager, rnInfo.getMainComponentName(), launchOptions);\n }\n\n//设置模块名称，因为是private，只能通过反射赋值\n public static void setModuleName(String moduleName) {\n try {\n Field field = ReactRootView.class.getDeclaredField(\"mJSModuleName\");\n field.setAccessible(true);\n field.set(getReactRootView(), moduleName);\n } catch (Throwable e) {\n throw new RuntimeException(e);\n }\n }\n \n//设置启动参数，因为是private，只能通过反射赋值\n public static void setLaunchOptions(Bundle launchOptions) {\n try {\n Field field = ReactRootView.class.getDeclaredField(\"mLaunchOptions\");\n field.setAccessible(true);\n field.set(getReactRootView(), launchOptions);\n } catch (Throwable e) {\n throw new RuntimeException(e);\n }\n }\n\n public static ReactRootView getReactRootView() {\n if(mRootView==null){\n throw new RuntimeException(\"缓存view管理器尚未初始化！\");\n }\n return mRootView;\n }\n\n public static ReactInstanceManager getReactInstanceManager() {\n if(mManager==null){\n throw new RuntimeException(\"缓存view管理器尚未初始化！\");\n }\n return mManager;\n }\n\n public static AbsRnInfo getRnInfo() {\n if(mRnInfo==null){\n throw new RuntimeException(\"缓存view管理器尚未初始化！\");\n }\n return mRnInfo;\n }\n\n public static void onDestroy() {\n try {\n ViewParent parent = getReactRootView().getParent();\n if (parent != null)\n ((android.view.ViewGroup) parent).removeView(getReactRootView());\n } catch (Throwable e) {\n e.printStackTrace();\n }\n }\n\n public static void clear() {\n try {\n if (mManager != null) {\n mManager.onDestroy();\n mManager = null;\n }\n if (mRootView != null) {\n onDestroy();\n mRootView = null;\n }\n mRnInfo = null;\n } catch (Throwable e) {\n e.printStackTrace();\n }\n }\n\n private static ReactInstanceManager createReactInstanceManager(Activity act) {\n\n ReactInstanceManager.Builder builder = ReactInstanceManager.builder()\n .setApplication(act.getApplication())\n .setJSMainModuleName(getRnInfo().getJSMainModuleName())\n .setUseDeveloperSupport(getRnInfo().getUseDeveloperSupport())\n .setInitialLifecycleState(LifecycleState.BEFORE_RESUME);\n\n for (ReactPackage reactPackage : getRnInfo().getPackages()) {\n builder.addPackage(reactPackage);\n }\n\n String jsBundleFile = getRnInfo().getJSBundleFile();\n\n if (jsBundleFile != null) {\n builder.setJSBundleFile(jsBundleFile);\n } else {\n builder.setBundleAssetName(getRnInfo().getBundleAssetName());\n }\n return builder.build();\n }\n}\n\n```\n\n###步骤2 重写ReactActivity\n将官方的ReactActivity粘出来，重写2个方法，onCreate和onDestroy，其余代码不动。\n\nonCreate方法中使用缓存rootview管理器来获得rootview对象，而不是重新创建。\n\n这里曾尝试继承ReactActivity，而不是重写这个类，但是子类覆盖onCreate方法时候，必须要调用super.onCreate，否则编译会报错，但是super.onCreate方法会重新创建rootview，所以实在是绕不过去了。\n\n```\nprotected void onCreate(Bundle savedInstanceState) {\n super.onCreate(savedInstanceState);\n\n if (RNCacheViewManager.getRnInfo().getUseDeveloperSupport() && Build.VERSION.SDK_INT >= 23) {\n // Get permission to show redbox in dev builds.\n if (!Settings.canDrawOverlays(this)) {\n Intent serviceIntent = new Intent(Settings.ACTION_MANAGE_OVERLAY_PERMISSION);\n startActivity(serviceIntent);\n FLog.w(ReactConstants.TAG, REDBOX_PERMISSION_MESSAGE);\n Toast.makeText(this, REDBOX_PERMISSION_MESSAGE, Toast.LENGTH_LONG).show();\n }\n }\n\n mReactInstanceManager = RNCacheViewManager.getReactInstanceManager();\n ReactRootView mReactRootView = RNCacheViewManager.getReactRootView();\n setContentView(mReactRootView);\n }\n```\n\n\nonDestroy方法中，不能再调用原有的mReactInstanceManager.destroy()方法了，否则rn初始化出来的对象会被销毁，下次就用不了了。同时，要卸载掉rootview的parent对象，否则下次再setContentView时候回报错。\n\n```\nprotected void onDestroy() {\n RNCacheViewManager.onDestroy();\n super.onDestroy();\n }\n``` \n \nRNCacheViewManager.onDestroy的方法：\n\n```\npublic static void onDestroy() {\n try {\n ViewParent parent = getReactRootView().getParent();\n if (parent != null)\n ((android.view.ViewGroup) parent).removeView(getReactRootView());\n } catch (Throwable e) {\n e.printStackTrace();\n }\n }\n```\n\n\n###步骤3 在app启动时候初始化缓存rootview管理器\n\n```\nRNCacheViewManager.init((Activity) context, new RnInfo(moduleName, launchOptions));\n```\n\n其中RnInfo如下：\n\n```\npublic class RnInfo extends AbsRnInfo {\n\n private String mModuleName;\n private Bundle mLaunchOptions;\n\n public RnInfo(String moduleName) {\n this.mModuleName = moduleName;\n }\n\n public RnInfo(String moduleName, Bundle launchOptions) {\n this.mModuleName = moduleName;\n this.mLaunchOptions = launchOptions;\n }\n\n @Nullable\n @Override\n public Bundle getLaunchOptions() {\n return mLaunchOptions;\n }\n\n @Override\n public String getMainComponentName() {\n return mModuleName;\n }\n\n @Override\n public String getJSMainModuleName() {\n return RNKeys.Default.DEf_JS_MAIN_MODULE_NAME;\n }\n\n @Nullable\n @Override\n public String getJSBundleFile() {\n return RNManager.getJsBundlePath();\n }\n\n @Override\n public boolean getUseDeveloperSupport() {\n return true;\n }\n\n @Override\n public List getPackages() {\n return Arrays.asList(\n new MainReactPackage(),\n new BBReactPackage()\n );\n }\n}\n```\n\n#结语\n希望本篇文档能帮助遇到类似问题的小伙伴们。\n\nreactnative虽然不是银弹，但是在目前移动端浏览器兼容性弱爆了的情况下，还是能极大的提升开发测试效率的，性能也是极佳的，看好rn的未来。\n\n\n#参考文章\nhttp://zhuanlan.zhihu.com/magilu/20587485\n\nhttp://zhuanlan.zhihu.com/magilu/20259704\n\nhttps://yq.aliyun.com/articles/3208?spm=5176.100239.yqblog1.39.t2g49u&utm_source=tuicool&utm_medium=referral\n\n\n" }, { "path": "ReactNative开发指导/ReactNative导航设计与实现.md", "content": "# ReactNative导航设计与实现\n\n# 前言\n\n关于reactnaitve的导航，官方提供了2个组件，NavigatorIOS和Navigator，其中官方并不推荐使用NavigatorIOS，它不是官方维护的，不能保证及时的更新和维护。\n\n所以本文中是以Navigator组件为基础，进行导航的设计和实现。\n\nNavigator的劣势：Navigator组件是纯js的实现，所以在页面进行转场动画的过程中，如果js不能保证在16ms内完成其它操作的话，转场动画会有卡顿现象，后面会介绍优化的方案。\n\n官方的Navigator组件使用方式较为灵活，本文的目的是选取一种最佳用法，并提取出通用功能应对常用场景，规范和设计项目中导航的使用。\n\n# 定义\n\nrn应用：全站rn应用，简称rn应用。\n\nrn模块：部分模块使用rn，简称rn模块。\n\nrn首页：无论是rn应用还是rn模块，进入rn页面的第一屏，简称rn首页。\n\nnav：Navigator组件对象的简称，注意是实例化好的对象，不是类。页面间传递的导航对象统一使用此命名。\n\nHeader：自定义的导航栏组件。\n\n# 体系结构、设计原则\n\n一个rn应用或者一个rn模块，有且只有一个Navigator组件被定义。\n\n在rn首页定义Navigator组件。\n\n各个子页面统一使用首页定义的Navigator组件对象nav。\n\n不要使用Navigator的navigationBar，请自定义导航栏组件，例如Header组件。\n\n\n# Navigator组件的定义和初始化\n\n在rn首页中的render方法中，定义一个Navigator组件，并做好以下几件事：\n\n1. 实现好通用的renderScene方法，\n2. 实现好android的物理返回按键\n3. 初始化真正的rn首页\n\n## 实现统一路由函数renderScene\n\nrenderScene函数是Navigator组件的必填函数，入参是route对象和当前的nav对象，返回值是jsx。\n\n此函数的意思是根据传入的route，返回一个作为新页面的jsx，也就是说所有的路由算法都是在此函数中实现的。\n\n其中route对象是一个自定义的对象，是nav.push方法中传入的对象。\n\n此函数设计相当于门面模式，此函数是路由的统一处理器，所有的页面跳转请求都会通过此函数的计算来获得具体的jsx页面。\n\n既然是统一的路由处理器，必然要求传入的route对象要满足统一的规则，否则无法实现统一的算法。\n\n在此，设计route对象如下：\n\n```\n{\n\tname: 'page2', //名字用来做上下文判断和日志输出\n\tpage: , //jsx形式的page，作为新页面的jsx\n\t// page: () => , //或者函数形式的page，此函数必须返回jsx，此jsx作为新页面的jsx\n}\n```\n根据route对象设计，设计统一的renderScene方法如下：\n\n```\n_renderPage(route, nav) {\n\n if (!route.page) {\n console.error('页面导航请求没有传入page参数.');\n return null;\n }\n\n let page;\n\n if (typeof route.page === 'function') {\n page = route.page();\n } else {\n page = route.page;\n }\n\n\n let name = route.name;\n if (!name) {\n if (page) {\n name = page.type.name;\n }\n }\n console.log(`in render page ${name}`);\n\n return page;\n }\n```\n\n业务代码中，页面跳转的时候，只需要如下代码\n\n```\nnav.push({\n\tname: 'page2',\n\tpage: ,\n});\n```\n\n## android物理返回按键的处理\n如果你的应用需要支持android的话，那就要实现andorid的物理返回按键的对应处理。\n\n一般按物理返回按键要么是返回上一页面，要么是返回页面的上一状态【例如，有打开的弹窗，按返回是关闭这个弹窗】。\n\n返回上一页面因为有通用路由器的存在，所以可以通用处理，直接使用nav.pop()即可。\n\n但是返回页面上一状态，并不容易统一处理，所以使用基于事件扩展的方式，交给业务代码自行实现。\n\n在此重构route对象的规则，添加事件onHardwareBackPress，如下\n\n```\n{\n\tname: 'page2', //名字用来做上下文判断和日志输出\n\tpage: , //jsx形式的page，作为新页面的jsx\n\t// page: () => , //或者函数形式的page，此函数必须返回jsx，此jsx作为新页面的jsx\n\tonHardwareBackPress: () => alert('点物理按键会触发我'), // 返回false就终止统一路由器的默认动作，即终止页面返回动作,可以在此方法中实现返回页面上一状态的相关实现\n}\n```\n\nandroid物理返回按键的统一处理代码如下，\n\n```\ncomponentWillMount() {\n\n BackAndroid.addEventListener('hardwareBackPress', () => {\n\n if (this.refs.nav) {\n\n let routes = this.refs.nav.getCurrentRoutes();\n let lastRoute = routes[routes.length - 1]; // 当前页面对应的route对象\n\n if (lastRoute.onHardwareBackPress) {// 先执行route注册的事件\n let flag = lastRoute.onHardwareBackPress();\n if (flag === false) {// 返回值为false就终止后续操作\n return true;\n }\n }\n\n\n if (routes.length === 1) {// 在第一页了\n\n // 此处可以根据情况实现 点2次就退出应用，或者弹出rn视图等\n \n } else {\n \n this.refs.nav.pop();\n \n }\n }\n\n return true;\n });\n }\n \n```\n\n\n## 初始化真正的rn首页\n\n此处较为简单，直接使用Navigator组件的initialRoute属性来指定初始化的route对象。\n\n```\n, // Home为伪代码，自定义的首页组件\n name: 'home',\n }} />\n```\n\n# 页面跳转\n\n根据前面设计好的renderScene方法，直接使用如下代码,即可跳转到Page2，并将nav对象传递给了Page2.\n\n```\nnav.push({\n\tname: 'page2',\n\tpage: ,\n});\n```\n\n# 页面返回\n\n页面返回直接使用\n\n```\nnav.pop();\n```\n\n# 页面转场优化\n\n前面提到，Navigator组件完全使用js实现，由于js的单线程特点，如果在页面转场动画过程中，js干其他事情【比如渲染个某个jsx】超过了16ms，那么转场动画将不足60帧，给用户的感觉就是动画有卡顿。\n\n为了避免这种情况，一种简单粗暴的办法就是在转场动画中不要让js来干别的事情。\n\n那么我们如何知道转场动画什么时候结束呢，官方提供了动画交互管理器InteractionManager，示例伪代码如下：\n\n```\nInteractionManager.runAfterInteractions(() => {\n alert('哈哈 转场动画结束了！');\n });\n```\n\n大多数的场景：点击page1的某个按钮，要跳转到page2，并且page2要和服务器请求数据，根据返回的数据来渲染page2的部分or全部内容。\n\n针对上述场景，解决方案如下，用伪代码描述：\n\n1. page2的state至少有2个值，转场动画进行中=true，服务器查询=true\n1. page2的componentWillMount方法中发起异步服务器交互请求,当请求结束setState:服务器查询=false\n2. page2的componentWillMount方法中注册InteractionManager.runAfterInteractions事件，当转场结束setState:转场动画进行中=false\n3. page2的render方法中，先判断（转场动画进行中=true || 服务器查询=true）就返回一个loading的提示，否则返回真正的jsx，并且此时，服务器返回的数据已经可用了\n\n也可以参考官方文档： http://reactnative.cn/docs/0.22/performance.html#content\n\n# 刷新的实现\n\n目标：实现类似于html中window.reload的方法。\n\n由于我们对route的规则限定，所以我们可以做到统一的刷新页面的逻辑。\n\n思路是，\n\n1. 首先获得当前页面对应的route对象\n2. 然后获取route中的page属性，page属性可能是当前页面的jsx，也可能是可以产生当前页面jsx的方法\n3. 最后使用官方Navigator组件提供的replace方法，来用新的route替换掉原有的route\n\n示例参考代码如下：\n\n```\n/**\n * 刷新页面，route可以为空，会刷新当前页面\n * @param nav\n * @param route\n */\n refresh(nav, route) {\n\n if (!route) {\n let routes = nav.getCurrentRoutes();\n let length = routes.length;\n route = routes[length - 1]; // 使用当前页对应的route\n }\n\n // todo 最好的方式是直接使用route.page，但是不好使，这种写法只支持一层节点，如果有多层会有问题\n // todo 暂时未处理page是function的情况\n let Tag = route.page.type;\n nav.replace({\n page: ,\n });\n\n }\n```\n\n然后业务代码中这样调用,当前页面就被刷新了。\n\n```\nUtil.refresh(nav); //Util是伪代码，是你定义refresh方法的对应对象\n\n```\n\n\n# rn首页直接跳转子页面\n\n如果你开发的是rn模块【rn模块嵌入到已有app中，定义可以参考前面定义一节】，可能进入rn模块的入口会很多，比如，用rn开发一个论坛模块，正常入口进来是直接展现帖子列表，也可能会有点击某个其它按钮【此按钮是不是rn的】会直接跳转到某个帖子的详情页。\n\n使用官方Navigator组件提供的initialRouteStack属性，可以完美的解决此问题，官方文档对此属性的说明如下：提供一个路由集合用来初始化。如果没有设置初始路由的话则必须设置该属性。如果没有提供该属性，它将被默认设置成一个只含有initialRoute的数组。\n\n说白了就是，initialRouteStack要定义一个数组，里面是很多route对象，然后Navigator对象会展现到最后一个，而且数组中的其他route也都被初始化过了，你想返回到任何一个route都是可以的，是不是爽歪歪了。\n\n给个示例代码吧，这是我项目中真正的代码，请当伪代码来阅读:\n\n```\ngetInitialRouteStack() {\n\n let props = this.getProps();\n\n let detailId = props.detailId;\n if (detailId) { // 如果传入了详情id，那么跳转到详情页\n return [{name: 'home', },\n {\n page: ,\n backIsClose: true,\n }];\n }\n\n\n let wantAsk = props.wantAsk;\n if (wantAsk === true || wantAsk === 'true') { // 如果传入了提问属性=true，那么直接跳转到提问页面\n return [{name: 'home', },\n {\n page: ,\n backIsClose: true,\n }];\n }\n\n // 跳转到首页\n return [{name: 'home', }];\n\n }\n```\n\n# 实现代码参考：\n根据以上设计思路，笔者封装了一个Navigator组件，是对官方的navigator组件进行了一层封装，供大家参考：\n\n```\nimport React from \"react-native\";\n\nconst {\n Platform,\n Animated,\n View,\n DeviceEventEmitter,\n Dimensions,\n Navigator,\n BackAndroid,\n } = React;\n\nclass Navigator2 extends React.Component {\n\n componentWillMount() {\n\n BackAndroid.addEventListener('hardwareBackPress', () => {\n\n if (this.refs.nav) {\n\n let routes = this.refs.nav.getCurrentRoutes();\n let lastRoute = routes[routes.length - 1];\n\n if (lastRoute.onHardwareBackPress) {// 先执行route注册的事件\n let flag = lastRoute.onHardwareBackPress();\n if (flag === false) {// 返回值为false就终止后续操作\n return true;\n }\n }\n\n\n if (routes.length === 1) {// 在第一页了\n\n if (this.props.nav) {// 父页面仍有nav\n this.props.nav.pop();\n }\n\n if (this.props.onHardwareBackPressInFirstPage) {\n this.props.onHardwareBackPressInFirstPage();\n }\n\n } else {\n\n if (lastRoute.backIsClose === true) {\n if (this.props.onHardwareBackPressInFirstPage) {\n this.props.onHardwareBackPressInFirstPage();\n }\n } else {\n this.refs.nav.pop();\n }\n }\n }\n\n return true;\n });\n }\n\n\n getLastRoute() {\n if (this.refs.nav) {\n let routes = this.getCurrentRoutes();\n let lastRoute = routes[routes.length - 1];\n return lastRoute;\n }\n\n return null;\n }\n\n render() {\n return ;\n }\n\n\n _renderPage(route, nav) {\n\n if (!route.page) {\n console.error('页面导航请求没有传入page参数.');\n return null;\n }\n\n let page;\n\n if (typeof route.page === 'function') {\n page = route.page();\n } else {\n page = route.page;\n }\n\n\n let name = route.name;\n if (!name) {\n if (page) {\n name = page.type.name;\n }\n }\n console.log(`in render page ${name}`);\n\n return page;\n }\n\n // todo 以下的方法为实现原版navigator的方法，这样做不好，但是没想到其它好办法\n getCurrentRoutes() {\n return this.refs.nav.getCurrentRoutes(...arguments);\n }\n jumpBack() {\n return this.refs.nav.jumpBack(...arguments);\n }\n jumpForward() {\n return this.refs.nav.jumpForward(...arguments);\n }\n jumpTo(route) {\n return this.refs.nav.jumpTo(...arguments);\n }\n push(route) {\n return this.refs.nav.push(...arguments);\n }\n pop() {\n return this.refs.nav.pop(...arguments);\n }\n replace(route) {\n return this.refs.nav.replace(...arguments);\n }\n replaceAtIndex(route, index) {\n return this.refs.nav.replaceAtIndex(...arguments);\n }\n replacePrevious(route) {\n return this.refs.nav.replacePrevious(...arguments);\n }\n immediatelyResetRouteStack(routeStack) {\n return this.refs.nav.immediatelyResetRouteStack(...arguments);\n }\n popToRoute(route) {\n return this.refs.nav.popToRoute(...arguments);\n }\n popToTop() {\n return this.refs.nav.popToTop(...arguments);\n }\n\n}\n\nmodule.exports = Navigator2;\n\n```\n\n#参考地址\n\nhttp://reactnative.cn/docs/0.21/navigator.html#content\n\nhttp://reactnative.cn/docs/0.22/performance.html#content\n\n\n" }, { "path": "ReactNative开发指导/ReactNative开发技巧总结.md", "content": "# ReactNative开发技巧总结\n\n#样式\n不支持选择器\n\n无复用就尽量用行内，避免命名难题\n\n不支持position=fixed，利用flexbox可以搞定。\n\n\t\t\nRN样式没有提供类似于display=none的方式,使用BaseCss提供的hidden样式,原理是绝对定位，left=-9999\n\t\n总结的较好：http://segmentfault.com/a/1190000002658374\n\n\n#调试\n在系统首页调试可以极大的提供效率，系统首页直接使用你要调试的组件作为app\n\t\njs可以用chrome来调试\n\ncss和结构就靠刷新了，官方给的结构查看器不是很好用\n\n在一些重要逻辑部分多用console.log，特别是在触摸事件中，有时候还可以发现隐藏问题，习惯用console.log代替一些注释\n\n\n#touch系列\n一般包裹在view的外面，margin写在touch上，不要写在view上，否则margin会有动画效果，padding写在view上。\n\t\n一般使用touchOpacity，不使用touchHeighlight\n\n\n\n#text\n一定不要有padding margin，如果要有请在外面套一个view，写在view上\n\n#listview，scrollview\n必须有高，否则不能滚动，flex=1也可以，相当于给了高\n\n\n" }, { "path": "ReactNative开发指导/ReactNative打离线包-android篇.md", "content": "# ReactNative打离线包-android篇\n\n\n官方文档：\n\n官方文档2：\n\n离线包就是把RN和你写的js图片等资源都打包放入app，不需要走网络下载。\n\n#打包命令说明\n\nreact-native bundle\n\nOptions:\n\n --entry-file Path to the root JS file, either absolute or relative to JS root [required]\n \n --platform Either \"ios\" or \"android\" \n \n --transformer Specify a custom transformer to be used (absolute path) [default: \"/Users/babytree-mbp13/projects/xcodeProjects/AwesomeProject/node_modules/react-native/packager/transformer.js\"]\n \n --dev If false, warnings are disabled and the bundle is minified [default: true]\n \n --prepack If true, the output bundle will use the Prepack format. [default: false]\n \n --bridge-config File name of a a JSON export of __fbBatchedBridgeConfig. Used by Prepack. Ex. ./bridgeconfig.json\n \n --bundle-output File name where to store the resulting bundle, ex. /tmp/groups.bundle [required]\n \n --bundle-encoding Encoding the bundle should be written in (https://nodejs.org/api/buffer.html#buffer_buffer). [default: \"utf8\"]\n \n --sourcemap-output File name where to store the sourcemap file for resulting bundle, ex. /tmp/groups.map \n \n --assets-dest Directory name where to store assets referenced in the bundle \n \n --verbose Enables logging [default: false]\n\n\n#安卓打包步骤\n\n1. 在工程根目录下执行打包命令，比如``` react-native bundle --entry-file demo/index.js --bundle-output ./android/app/src/main/assets/index.android.jsbundle --platform android --assets-dest ./android/app/src/main/res/ --dev false ```请参考上面命令说明，根据自己的情况进行修改再执行。注意要先保证[./android/app/src/main/assets/]文件夹存在。\n2. ps:增量升级的话不要把图片资源直接打包到res中，脚本如下：``` react-native bundle --entry-file demo/index.js --bundle-output ./bundle/androidBundle/index.android.jsbundle --platform android --assets-dest ./bundle/androidBundle --dev false ```\n1. 命令执行完生成资源如图![2015-12-24 11.05.31](media/2015-12-24%2011.05.31.png)\n\n1. 保证MainActivity.java中的setBundleAssetName与你的jsbundle文件名一致，比如`.setBundleAssetName(\"index.android.jsbundle\")`就与我生成的资源名一致\n2. 一切OK 打包测试吧\n\n\n\n#To disable the developer menu for production builds:\n\nFor iOS open your project in Xcode and select Product → Scheme → Edit Scheme... (or press ⌘ + <). Next, select Run from the menu on the left and change the Build Configuration to Release.\n\n\nFor Android, by default, developer menu will be disabled in release builds done by gradle (e.g with gradle assembleRelease task). Although this behavior can be customized by passing proper value to ReactInstanceManager#setUseDeveloperSupport.\n\n\n" }, { "path": "ReactNative开发指导/ReactNative打离线包-ios篇.md", "content": "# ReactNative打离线包-ios篇\n\n官方文档，内容很旧：\n\n相关链接：\n\n离线包就是把RN和你写的js图片等资源都打包放入app，不需要走网络下载。\n\n升级服务器的使用方法：\n在mobile-rn/bbt-rn-update-server目录中，执行命令npm start，然后访问http://localhost:3000/\n\n#打包命令说明\n\nreact-native bundle\n\nOptions:\n\n --entry-file Path to the root JS file, either absolute or relative to JS root [required]\n \n --platform Either \"ios\" or \"android\" \n \n --transformer Specify a custom transformer to be used (absolute path) [default: \"/Users/babytree-mbp13/projects/xcodeProjects/AwesomeProject/node_modules/react-native/packager/transformer.js\"]\n \n --dev If false, warnings are disabled and the bundle is minified [default: true]\n \n --prepack If true, the output bundle will use the Prepack format. [default: false]\n \n --bridge-config File name of a a JSON export of __fbBatchedBridgeConfig. Used by Prepack. Ex. ./bridgeconfig.json\n \n --bundle-output File name where to store the resulting bundle, ex. /tmp/groups.bundle [required]\n \n --bundle-encoding Encoding the bundle should be written in (https://nodejs.org/api/buffer.html#buffer_buffer). [default: \"utf8\"]\n \n --sourcemap-output File name where to store the sourcemap file for resulting bundle, ex. /tmp/groups.map \n \n --assets-dest Directory name where to store assets referenced in the bundle \n \n --verbose Enables logging [default: false]\n\n\n \n#ios打包步骤\n1. 在工程根目录下执行打包命令，比如``` react-native bundle --entry-file demo/index.js --bundle-output ./bundle/iosBundle/index.ios.jsbundle --platform ios --assets-dest ./bundle/iosBundle --dev false ```请参考上面命令说明，根据自己的情况进行修改再执行。注意要先保证bundle文件夹存在。\n2. 命令执行完生成如下资源 ![323424sf](media/323424sf-1.png)\n\n\n\n\n2. 在xcode中添加assets【必须用Create folder references的方式，添加完是蓝色文件夹图标】和index.ios.jsbundle，如图![2015-12-23 17.35.50](media/2015-12-23%2017.35.50.png)\n3. 参考官方文档，修改AppDelegate.m文件,使用OPTION 2处的代码\n\t```\n\tjsCodeLocation = [[NSBundle mainBundle] URLForResource:@\"index.ios\" withExtension:@\"jsbundle\"];\n\t```\n4. 一切OK 运行模拟器看效果吧\n \n#ios打包遇到的问题\n1. 离线包如果开启了chrome调试，会访问调试服务器，而且会一直loading出不来。 \n2. 如果bundle的名字是main.jsbundle,app会一直读取旧的,改名就好了。。。非常奇葩的问题，我重新删了app，clean工程都没用，就是不能用main.jsbundle这个名字。\n3. 必须用Create folder references【蓝色文件夹图标】的方式引入图片的assets，否则引用不到图片\n4. 执行bundle命令之前，要保证相关的文件夹都存在\n\n\n#To disable the developer menu for production builds:\n\nFor iOS open your project in Xcode and select Product → Scheme → Edit Scheme... (or press ⌘ + <). Next, select Run from the menu on the left and change the Build Configuration to Release.\n\n\nFor Android, by default, developer menu will be disabled in release builds done by gradle (e.g with gradle assembleRelease task). Although this behavior can be customized by passing proper value to ReactInstanceManager#setUseDeveloperSupport.\n\n" }, { "path": "ReactNative开发指导/ReactNative的ios崩溃整理分析.md", "content": "# ReactNative的ios崩溃整理分析\n\n共12种异常,如下：\n\n```\nwanghonglu 18:14\n>---------------------- Row 1 -----------------------<\n=> Start Unable to execute JS call: __fbBatchedBridge is undefined \n\t-> translating『 0x100ac2b60x100aa8004 』=> RCTFatal /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTAssert.m: line 120\n\t-> translating『 0x100ac2b60 』=> -[RCTBatchedBridge stopLoadingWithError:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBatchedBridge.m: line 476\n\t-> translating『 0x1006d72fc 』=> main /Users/wanghonglu/Desktop/project/pregnancy-v2-ios/pregnancy/pregnancy/main.m: line 13\n=> End Unable to execute JS call: __fbBatchedBridge is undefined \n>------------------------------------------------------<\n\n\n>---------------------- Row 2 -----------------------<\n=> Start Application received signal SIGSEGV \n\t-> translating『 0x1012891bc 』=> \n\t-> translating『 0x100abf734 』=> __64-[RCTJSCExecutor executeApplicationScript:sourceURL:onComplete:]_block_invoke /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Executors/RCTJSCExecutor.m: line 515\n\t-> translating『 0x100abf944 』=> -[RCTJSCExecutor executeBlockOnJavaScriptQueue:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Executors/RCTJSCExecutor.m: line 547\n\t-> translating『 0x100abdc3c 』=> +[RCTJSCExecutor runRunLoopThread] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Executors/RCTJSCExecutor.m: line 151\n=> End Application received signal SIGSEGV \n>------------------------------------------------------<\nwanghonglu 18:14\n>---------------------- Row 4 -----------------------<\n=> Start Application received signal SIGSEGV \n\t-> translating『 0x1012891bc 』=> \n\t-> translating『 0x100abf734 』=> __64-[RCTJSCExecutor executeApplicationScript:sourceURL:onComplete:]_block_invoke /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Executors/RCTJSCExecutor.m: line 515\n\t-> translating『 0x100abf944 』=> -[RCTJSCExecutor executeBlockOnJavaScriptQueue:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Executors/RCTJSCExecutor.m: line 547\n\t-> translating『 0x100abdc3c 』=> +[RCTJSCExecutor runRunLoopThread] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Executors/RCTJSCExecutor.m: line 151\n=> End Application received signal SIGSEGV\nwanghonglu 18:14\n>---------------------- Row 7 -----------------------<\n=> Start SyntaxError: Unexpected end of script \n\t-> translating『 0x100aa8004 』=> RCTFatal /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTAssert.m: line 120\n\t-> translating『 0x100ac2b60 』=> -[RCTBatchedBridge stopLoadingWithError:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBatchedBridge.m: line 476\n\t-> translating『 0x1006d72fc 』=> main /Users/wanghonglu/Desktop/project/pregnancy-v2-ios/pregnancy/pregnancy/main.m: line 13\n=> End SyntaxError: Unexpected end of script \n>------------------------------------------------------<\n\n\n>---------------------- Row 8 -----------------------<\n=> Start Unable to execute JS call: __fbBatchedBridge is undefined \n\t-> translating『 0x100aa8004 』=> RCTFatal /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTAssert.m: line 120\n\t-> translating『 0x100ac2b60 』=> -[RCTBatchedBridge stopLoadingWithError:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBatchedBridge.m: line 476\n\t-> translating『 0x1006d72fc 』=> main /Users/wanghonglu/Desktop/project/pregnancy-v2-ios/pregnancy/pregnancy/main.m: line 13\n=> End Unable to execute JS call: __fbBatchedBridge is undefined \n>------------------------------------------------------<\nwanghonglu 18:14\n>---------------------- Row 11 -----------------------<\n=> Start Application received signal SIGSEGV \n\t-> translating『 0x1012891bc 』=> \n\t-> translating『 0x100a92140 』=> __46-[RCTNetworking buildRequest:completionBlock:]_block_invoke /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/Libraries/Network/RCTNetworking.m: line 215\n\t-> translating『 0x100a923bc 』=> -[RCTNetworking processDataForHTTPQuery:callback:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/Libraries/Network/RCTNetworking.m: line 264\n\t-> translating『 0x100a91e2c 』=> -[RCTNetworking buildRequest:completionBlock:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/Libraries/Network/RCTNetworking.m: line 204\n\t-> translating『 0x100a940a8 』=> -[RCTNetworking sendRequest:responseSender:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/Libraries/Network/RCTNetworking.m: line 442\n\t-> translating『 0x100aa67ec 』=> -[RCTModuleMethod invokeWithBridge:module:arguments:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTModuleMethod.m: line 426\n\t-> translating『 0x100ac53f0 』=> -[RCTBatchedBridge _handleRequestNumber:moduleID:methodID:params:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBatchedBridge.m: line 899\n\t-> translating『 0x100ac4de0 』=> __33-[RCTBatchedBridge handleBuffer:]_block_invoke.383 /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBatchedBridge.m: line 848\n=> End Application received signal SIGSEGV \n>------------------------------------------------------<\nwanghonglu 18:15\n>---------------------- Row 16 -----------------------<\n=> Start Unable to execute JS call: __fbBatchedBridge is undefined \n\t-> translating『 0xa3b4ef 』=> RCTFatal /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTAssert.m: line 120\n\t-> translating『 0xa52b37 』=> -[RCTBatchedBridge stopLoadingWithError:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBatchedBridge.m: line 476\n\t-> translating『 0x68b883 』=> main /Users/wanghonglu/Desktop/project/pregnancy-v2-ios/pregnancy/pregnancy/main.m: line 13\n=> End Unable to execute JS call: __fbBatchedBridge is undefined \n>------------------------------------------------------<\nwanghonglu 18:15\n>---------------------- Row 22 -----------------------<\n=> Start Application received signal SIGSEGV \n\t-> translating『 0x1012891bc 』=> \n\t-> translating『 0x100ac1c30 』=> -[RCTBatchedBridge registerModuleForFrameUpdates:withModuleData:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBatchedBridge.m: line 357\n\t-> translating『 0x100ac707c 』=> -[RCTModuleData finishSetupForInstance] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTModuleData.m: line 73\n\t-> translating『 0x100ac1a74 』=> -[RCTBatchedBridge initModules] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBatchedBridge.m: line 249\n\t-> translating『 0x100ac02a8 』=> -[RCTBatchedBridge start] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBatchedBridge.m: line 99\n\t-> translating『 0x100ac016c 』=> -[RCTBatchedBridge initWithParentBridge:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBatchedBridge.m: line 68\n\t-> translating『 0x100ad5648 』=> -[RCTBridge setUp] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBridge.m: line 257\n\t-> translating『 0x100ad5068 』=> -[RCTBridge initWithDelegate:launchOptions:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBridge.m: line 156\n\t-> translating『 0x100071c60 』=> __36-[BBRNManager reactNativeBridgeInit]_block_invoke /Users/wanghonglu/Desktop/project/pregnancy-v2-ios/pregnancy/pregnancy/ReactNative/Utils/BBRNManager.m: line 56\n\t-> translating『 0x1006d72fc 』=> main /Users/wanghonglu/Desktop/project/pregnancy-v2-ios/pregnancy/pregnancy/main.m: line 13\n=> End Application received signal SIGSEGV \n>------------------------------------------------------<\nwanghonglu 18:15\n>---------------------- Row 24 -----------------------<\n=> Start Application received signal SIGABRT \n\t-> translating『 0x1012891bc 』=> \n\t-> translating『 0x100abf290 』=> __52-[RCTJSCExecutor _executeJSCall:arguments:callback:]_block_invoke /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Executors/RCTJSCExecutor.m: line 391\n\t-> translating『 0x100abf944 』=> -[RCTJSCExecutor executeBlockOnJavaScriptQueue:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Executors/RCTJSCExecutor.m: line 547\n\t-> translating『 0x100abeda4 』=> -[RCTJSCExecutor _executeJSCall:arguments:callback:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Executors/RCTJSCExecutor.m: line 385\n\t-> translating『 0x100abeb7c 』=> -[RCTJSCExecutor callFunctionOnModule:method:arguments:callback:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Executors/RCTJSCExecutor.m: line 368\n\t-> translating『 0x100ac43b0 』=> -[RCTBatchedBridge _actuallyInvokeAndProcessModule:method:arguments:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBatchedBridge.m: line 747\n\t-> translating『 0x100ac3774 』=> __39-[RCTBatchedBridge enqueueJSCall:args:]_block_invoke /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBatchedBridge.m: line 642\n\t-> translating『 0x100abf944 』=> -[RCTJSCExecutor executeBlockOnJavaScriptQueue:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Executors/RCTJSCExecutor.m: line 547\n\t-> translating『 0x100abdc3c 』=> +[RCTJSCExecutor runRunLoopThread] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Executors/RCTJSCExecutor.m: line 151\n=> End Application received signal SIGABRT \n>------------------------------------------------------<\nwanghonglu 18:15\n>---------------------- Row 25 -----------------------<\n=> Start Application received signal SIGABRT \n\t-> translating『 0x1012891bc 』=> \n\t-> translating『 0x100ace79c 』=> _RCTJSONStringifyNoRetry /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTUtils.m: line 26\n\t-> translating『 0x100ace5bc 』=> RCTJSONStringify /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTUtils.m: line 71\n\t-> translating『 0x100abeeec 』=> __52-[RCTJSCExecutor _executeJSCall:arguments:callback:]_block_invoke /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Executors/RCTJSCExecutor.m: line 391\n\t-> translating『 0x100abf944 』=> -[RCTJSCExecutor executeBlockOnJavaScriptQueue:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Executors/RCTJSCExecutor.m: line 547\n\t-> translating『 0x100abeda4 』=> -[RCTJSCExecutor _executeJSCall:arguments:callback:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Executors/RCTJSCExecutor.m: line 385\n\t-> translating『 0x100abeb7c 』=> -[RCTJSCExecutor callFunctionOnModule:method:arguments:callback:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Executors/RCTJSCExecutor.m: line 368\n\t-> translating『 0x100ac43b0 』=> -[RCTBatchedBridge _actuallyInvokeAndProcessModule:method:arguments:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBatchedBridge.m: line 747\n\t-> translating『 0x100ac3774 』=> __39-[RCTBatchedBridge enqueueJSCall:args:]_block_invoke /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBatchedBridge.m: line 642\n\t-> translating『 0x100abf944 』=> -[RCTJSCExecutor executeBlockOnJavaScriptQueue:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Executors/RCTJSCExecutor.m: line 547\n\t-> translating『 0x100abdc3c 』=> +[RCTJSCExecutor runRunLoopThread] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Executors/RCTJSCExecutor.m: line 151\n=> End Application received signal SIGABRT \n>------------------------------------------------------<\nwanghonglu 18:16\n>---------------------- Row 26 -----------------------<\n=> Start Application received signal SIGSEGV \n\t-> translating『 0x1012891bc 』=> \n\t-> translating『 0x100ac1c30 』=> -[RCTBatchedBridge registerModuleForFrameUpdates:withModuleData:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBatchedBridge.m: line 357\n\t-> translating『 0x100ac707c 』=> -[RCTModuleData finishSetupForInstance] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTModuleData.m: line 73\n\t-> translating『 0x100ac7400 』=> -[RCTModuleData instance] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTModuleData.m: line 122\n\t-> translating『 0x100ac113c 』=> -[RCTBatchedBridge moduleForName:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBatchedBridge.m: line 231\n\t-> translating『 0x100ad540c 』=> -[RCTBridge moduleForClass:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBridge.m: line 236\n\t-> translating『 0x100ae16d4 』=> -[RCTUIManager setBridge:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Modules/RCTUIManager.m: line 270\n\t-> translating『 0x100ac6f2c 』=> -[RCTModuleData setBridgeForInstance] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTModuleData.m: line 58\n\t-> translating『 0x100ac19b0 』=> -[RCTBatchedBridge initModules] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBatchedBridge.m: line 249\n\t-> translating『 0x100ac02a8 』=> -[RCTBatchedBridge start] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBatchedBridge.m: line 99\n\t-> translating『 0x100ac016c 』=> -[RCTBatchedBridge initWithParentBridge:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBatchedBridge.m: line 68\n\t-> translating『 0x100ad5648 』=> -[RCTBridge setUp] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBridge.m: line 257\n\t-> translating『 0x100ad5068 』=> -[RCTBridge initWithDelegate:launchOptions:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBridge.m: line 156\n\t-> translating『 0x100071c60 』=> __36-[BBRNManager reactNativeBridgeInit]_block_invoke /Users/wanghonglu/Desktop/project/pregnancy-v2-ios/pregnancy/pregnancy/ReactNative/Utils/BBRNManager.m: line 56\n\t-> translating『 0x1006d72fc 』=> main /Users/wanghonglu/Desktop/project/pregnancy-v2-ios/pregnancy/pregnancy/main.m: line 13\n=> End Application received signal SIGSEGV \n>------------------------------------------------------<\nwanghonglu 18:16\n>---------------------- Row 27 -----------------------<\n=> Start SyntaxError: Unexpected EOF \n\t-> translating『 0x100aa8004 』=> RCTFatal /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTAssert.m: line 120\n\t-> translating『 0x100ac2b60 』=> -[RCTBatchedBridge stopLoadingWithError:] /Users/kevin/Code/pregnancy-rn/mobile-rn/node_modules/react-native/React/Base/RCTBatchedBridge.m: line 476\n\t-> translating『 0x1006d72fc 』=> main /Users/wanghonglu/Desktop/project/pregnancy-v2-ios/pregnancy/pregnancy/main.m: line 13\n=> End SyntaxError: Unexpected EOF \n>------------------------------------------------------<\n```\n\n# __fbBatchedBridge is undefined 3次；Unexpected end of script 1次；Unexpected EOF 1次；\n\n场景：异常从RCTBatchedBridge stopLoadingWithError方法【此方法是当jsbundle加载出现异常时就会执行】抛出，应为加载的jsbundle文件有问题，有可能是文件下载不对或存储空间不足等，建议加载前，使用md5进行校验。\n\n解决：建议加载前，使用md5进行校验。校验不通过的不进行加载，尝试回退or重新下载补丁等动作。\n\nandroid端也出现了__fbBatchedBridge is undefined的异常，解法也是使用md5来校验jsbundle。\n\n参考链接：http://www.jianshu.com/p/3db03c8c4ae7\n\n\n# Start Application received signal SIGSEGV\n\n## [RCTJSCExecutor executeApplicationScript:sourceURL:onComplete:]2次\n\n-> translating『 0x1012891bc 』=> \n\n最根的没有转换出来\n\nRCTJSCExecutor executeApplicationScrip\n\nRCTJSCExecutor executeBlockOnJavaScriptQueue\n\n场景：暂时没有线索\n\n解决： todo\n\n\n## [RCTNetworking buildRequest:completionBlock:] 1次\n\n-> translating『 0x1012891bc 』=> \n\n最根的没有转换出来\n\n场景：js调用原生，发送网络请求\n\n解决：todo\n\n## [RCTBatchedBridge registerModuleForFrameUpdates:withModuleData:] 2次\n\n-> translating『 0x1012891bc 』=> \n\n最根的没有转换出来\n\n场景：初始化bridge的过程，[BBRNManager reactNativeBridgeInit]中调用[RCTBridge initWithDelegate:launchOptions:]的时候。\n\n解决：todo\n\n# Start Application received signal SIGABRT\n\n## [RCTJSCExecutor _executeJSCall:arguments:callback:] 1次\n\n-> translating『 0x1012891bc 』=> \n\n最根的没有转换出来\n\n场景：是由RCTBatchedBridge enqueueJSCall调用，是native调用js。\n\n解决：todo\n\n## RCTUtils.m 中的 _RCTJSONStringifyNoRetry 1次\n\n-> translating『 0x1012891bc 』=> \n\n最根的没有转换出来\n\n场景：将json对象转换为json字符串。也是由[RCTJSCExecutor _executeJSCall:arguments:callback:]调用造成的。是由RCTBatchedBridge enqueueJSCall调用，是native调用js。\n\n解决：todo\n\n" }, { "path": "ReactNative开发指导/ReactNative的架构设计.md", "content": "# ReactNative的组件架构设计\n\n还有一篇较早的文章，也是分析的过程，可以对本篇文章进行一个补全：RN组件状态设计思考：http://segmentfault.com/a/1190000004180955 \n\n请注意，本篇写的是react native的架构设计，如果你用react来开发web程序，本篇文章只能仅供参考，问题都没有在web上去考虑过。\n\n本篇较长，前面是目前flux开源框架的一些分析，后面是架构设计过程。您可以直奔主题。\n\n用RN最大的难题是设计思想的转变，以前的设计方法论已经不太适用了。而RN仅仅提供了view的框架，构建完整app的架构并没有直接提供。\n\n考虑目前遇到的如下问题，希望架构给出解决方案。\n\n1. **交互**：如何解决组件间通信【父子、子父、兄弟等，特别是跨层or反向数据流动等】；用state还是接口操作组件；\n3. **职责**：组件状态放哪，业务逻辑放哪，数据放哪，因为太灵活了，怎么做都可以实现功能，但是怎么做才是最好的，才是最正确的呢？\n\n*todo一个问题：由于react是面向状态编程，相当于react的组件只关注数据的最终状态，数据是怎么产生的并不关心，但是某些场景下，数据如何产生的是会影响到组件的一些行为的【比如一个新增行要求有动画效果，查询出的行就不需要等】，这在RN中很难描述。。。。。*\n\nRN架构就是为解决上述问题提供的指导和方法论，是通盘考虑整个开发、测试、运维的状况，做出的考虑最全面的抉择，或者为抉择提供依据。\n\n目前为react服务的架构也有一些了，如Flux，Reflux，Redux，Relay，Marty。\n\n##Flux\nflux是官方提供的架构，目的是分层解耦，职责划分清晰，谁负责干啥很明确。具体描述可以参考官方文档，这里不详述。\n\n1. action 封装请求\n2. dispatcher 注册处理器、分发请求\n3. store 是处理器，处理业务逻辑，保存数据\n4. view 根据store提供的数据进行展现;接受用户的输入并发出action请求。\n\n\n![](media/14500845993004.jpg)\n\n\n数据流动：\nAction-> Dispatcher -> Store -> Component\n\n但我觉得解耦的太细了，干一个事，要做太多太多的额外工作了。\n\n光注册监听动作就2次，一次是store注册到dispatcher，一次是view注册到store中。\n\n而且，注册到dispatcher的监听应该都不叫注册，架构完全没有提供任何封装，直接暴露一个统一的回调方法，里面自行if else路由不同的store。\n\n\n##Reflux\n结构上与flux架构基本一致，去掉了flux的一些冗余操作【比如没有了dispatcher】，架构更加简洁和紧凑，用到了一些约定大于配置的理念。\n\n基本上将flux的架构冗余都简化了，可以说是flux的去冗余提升版，但是没有本质的变化。\n\n```\n╔═════════╗ ╔════════╗ ╔═════════════════╗\n║ Actions ║──────>║ Stores ║──────>║ View Components ║\n╚═════════╝ ╚════════╝ ╚═════════════════╝\n ^ │\n └──────────────────────────────────────┘\n\n```\n\n1. 更容易的监听。listenables和约定以on开头的方法。等。\n2. 去掉了dispatcher。\n3. action可以进行aop编程。\n4. 去掉了waitfor。store可以监听store。\n5. component提供了一系列mixin，方便注册\\卸载到store的监听和与store交互等。\n\n##Redux\n\n社区内比较受推崇，因为用起来相对比较简单\n\n\n![](media/14502335830493.jpg)\n\n\n特性：\n\n1. 分层设计，职责清晰。\n2. 要求store reducer都是页面单例，易于管理。\n2. action为请求dto对象，是请求类型，请求数据的载体。\n3. reducer是处理请求的方法。不允许有状态，必须是纯方法。必须严格遵守输入输出，中间不允许有异步调用。不允许对state直接进行修改，要想修改必须返回新对象。\n4. store\n\t5. 维持应用的state；\n\t1. 提供 getState() 方法获取 state；\n\t2. 提供 dispatch(action) 方法分发请求来更新 state；门面模式，要求所有的请求满足统一的格式【可以进行路由、监控、日志等】，统一的调用方式。\n\t1. 通过 subscribe(listener) 注册监听器监听state的变化。\n1. 官方文档写的较为详细，从设计到开发都有，比flux要好\n\n痛处如下，看能否接受或者解决：\n\n1. redux的原则1：state不能被修改。 \n\t4. 其实这个用react的state也会有同样的问题，最好把state设计的没有冗余，尽量少出这种情况\n\t4. **解决方案：**参考官方：因为我们不能直接修改却要更新数组中指定的一项数据，这里需要先把前面和后面都切开。如果经常需要这类的操作，可以选择使用帮助类 React.addons.update，updeep，或者使用原生支持深度更新的库 Immutable。最后，时刻谨记永远不要在克隆 state 前修改它。\n4. 单一的庞大的reducer的拆分\n\t5. 这块设计也不好做，会让人疑惑\n\t6. 官方给的demo中直接按state的内容区分，我觉得这样做不好，如果后期有跨内容的情况，就比较奇怪了。官方给的combineReducers方案，也只是减少代码量，本质没有变化，state还是拆分处理，路由还是业务逻辑自己来做。\n\t7. **解决方案**：还是处理一整个state，可以按照约定写reducer类而不是方法，类里按照actionType建方法，架构自动路由并调用。\n\t8. 以前做java架构，路由一定是架构来调用的，目前感觉各大flux框架都是解决问题不彻底。\n1. 官方建议设计模式：顶层容器组件才对redux有依赖，组件间通过props来传递数据。按照这样设计还是没有解决组件间交互和数据传递的问题。官方react设计建议：react的设计建议：http://camsong.github.io/redux-in-chinese/docs/basics/UsageWithReact.htm\n2. 使用connect将state绑定到component。此处有些黑盒了。\n2. 异步action用来请求服务端数据,利用middleware增强createStore的dispatch后即支持。\n\n##Relay\n没有时间，没做研究\n##Marty\n没有时间，没做研究\n\n##结论\n\n开源架构封装的简单的flux会产生较多的冗余代码。\n\n开源架构封装的复杂的redux，其和RN绑定封装了一些东西，是一个黑盒，不易理解和维护。\n\n介于上述两者之间的开源架构reflux，文档较上述2个少，不知道其可持续性如何。如果一定要用开源架构的话，我觉得他稍加封装是一个较为推荐的选择。\n\n不是特复杂的程序【一般spa的程序会更复杂一些，而RN并不是spa】，这些概念只会增加你的开发难度，并且对后面维护的人要求更高。\n\n我们继续头脑风暴，继续抽象总结一下flux系列框架， flux系列框架干了什么，没干什么，针对开篇提出的问题。\n\n2. 【解决职责】flux系列框架都做到了解耦，分层，谁该干什么就干什么，不许干别的，让代码读起来更有预测性和一致性，方便维护\n3. 【解决通信】继续解耦，flux系列框架采用事件机制解决各层之间通信，采用props传递解决各组件之间通信。\n\n\n####事件系统是关键\n\nflux系列架构解决通信问题的方法是使用事件系统，事件系统中的回调函数是业务逻辑，redux是【store action reducer】，flux是【action dispacher store】。\n\n我们真的需要事件系统吗？\n\n事件系统的好处： \n\n1. 一个事件可以注册多个回调函数\n2. 各回调函数间没有耦合。\n\n关于1\n\n需要注册多个的这种情况并不多见，不信你去翻看你已经写好的代码，是不是大部分都是注册一个。\n\n关于2 \n\n解耦确实很彻底，但是当我需要控制执行顺序，需要等a执行完在执行b，怎么办？ok你可以先注册a在注册b啊。那a要是一个fetch或ajax操作呢？这时候只能乖乖的在a的请求结束回调函数中进行调用b了。又变成a依赖b了。当然，你可以继续dispatch(b)，这就没有耦合了。但是你要知道注册一个事件是要有成本的，要写action，而且这种dispatch的方式，真的不太适合人类的阅读，dispatch一下，下一步都有谁来执行都不知道，这哪有直接调用来的爽快。\n\n\n好吧说到这，最后的结论也出来了，不使用开源架构，借助其好的思想，替换其事件系统为面向对象结构，自行封装架构。\n\n\n## 架构设计\n\n再次强调：目前仅考虑如何应用于react native\n\n###先扣题，针对开篇问题的解决方案如下\n\n####交互\n1. 组件对外发布：组件对外只允许使用props来暴露功能，不允许使用接口及其它一切方式\n2. 父子组件间：组件的子组件通过父组件传递的接口来与父组件通信\n3. 兄弟组件间:\n\t4. 方案1：假设a要调用b，参考第一条的话，其实就是a要改变b的props，那么a只要改b的props的来源即可，b的props的来源一般就是根组件的state。那么根组件就要有组织和协调的能力。\n\t5. 方案2：利用事件机制，基本同flux架构。略复杂，且我们并不需要事件的特性，本架构设计不推荐。\t\n#### 职责\n\n1. root-存放state，组织子view组件，组织业务逻辑对象等\n2. 子view组件-根据this.props渲染view。\n3. 业务逻辑对象-提供业务逻辑方法\n\n\n\n根据以上推导，我将其命名为面向对象的ReactNative组件架构设计，它与flux系列架构的最大的不同之处在于，用业务逻辑对象来代替了【store action dispatcher】or【store reducer】的事件系统。业务逻辑对象就是一组对象，用面向对象的设计理念设计出的n个对象，其负责处理整个页面的业务逻辑。\n\n以上为推导过程，干货才开始。。。。\n\n### 面向对象的ReactNative组件\\页面架构设计\n\n 一个独立完整的组件\\页面一般由以下元素构成：\n \n1. root组件，1个， \n\t1. 负责初始化state\n\t2. 负责提供对外props列表\n\t2. 负责组合子view组件形成页面效果\n\t3. 负责注册业务逻辑对象提供的业务逻辑方法\n\t4. 负责管理业务逻辑对象\n1. view子组件，0-n个，\n\t1. 根据props进行视图的渲染\n1. 业务逻辑对象，0-n个，\n\t2. 提供业务逻辑方法 \n\n\t\t\n####root组件\nroot组件由以下元素组成：\n\n1. props-公有属性\n2. state-RN体系的状态,必须使用Immutable对象\n3. 私有属性\n4. 业务逻辑对象的引用-在componentWillMount中初始化\n4. 私有方法-以下划线开头，内部使用or传递给子组件使用\n5. 公有方法【不推荐】，子组件和外部组件都可以用，但不推荐用公有方法来对外发布功能，破坏了面向状态编程，尽可能的使用props来发布功能\n\n\n![root](media/root.png)\n\n\t\n\n####子view组件\n\n子view组件中包含：\n\n1. props-公有属性\n2. 私有属性-强烈不建议有，除非你能理解以下几点，建议放在父组件or业务逻辑对象中\n\t3. 绝对不允许和父组件的属性or状态有冗余。无论是显性冗余还是计算结果冗余，除非你能确定结算是性能的瓶颈。\n\t4. 此属性只有自己会用，父组件和兄弟组件不会使用，如果你不确定这点，请把这个组件放到父组件上，方便组件间通信\n3. 私有方法-仅作为渲染view的使用，不许有业务逻辑\n4. 公有方法【不推荐，理由同root组件】 \n\n![gsddfa](media/gsddfa.png)\n\n\n\t\n\n\t\n####业务逻辑对象\n业务逻辑对象由以下元素组成：\n\n3. root组件对象引用-this.root\n2. 构造器-初始化root对象，初始化私有属性\n2. 私有属性\n3. 公有方法-对外提供业务逻辑\n3. 私有方法-以下划线开头，内部使用\n\n\t\n![dafa](media/dafa.png)\n\n\n\n\t \n#### ps1：通用型组件只要求尽量满足上述架构设计\n\n通用型组件一般为不包含任何业务的纯技术组件，具有高复用价值、高定制性、通常不能直接使用需要代码定制等特点。\n\n可以说是一个系统的各个基础零件，比如一个蒙板效果，或者一个模态弹出框。\n\n架构的最终目的是保证系统整体结构良好，代码质量良好，易于维护。一般编写通用型组件的人也是经验较为丰富的工程师，代码质量会有保证。而且，作为零件的通用组件的使用场景和生命周期都和普通组件\\页面不同，所以，仅要求通用组件编写尽量满足架构设计即可。\n\n\n\n####ps2：view子组件复用问题\n\t\n抛出一个问题，设计的过程中，子组件是否需要复用？子组件是否需要复用会影响到组件设计。\n\t\n6. 需复用，只暴露props，可以内部自行管理state【尽量避免除非业务需要】\n7. 不需复用，只暴露props，内部无state【因为不会单独使用，不需要setState来触发渲染】\n \n其实， 一般按照不需复用的情况设计，除非复用很明确，但这时候应该抽出去，变成独立的组件存在就可以了，所以这个问题是不存在的。\n\t\n\t\n\t\n##适用场景分析\n\n###flux系列框架\n\nflux系列框架的适用场景我觉得应具有以下特点：\n\n**一个页面中组件较多，组件之间较为独立，但是重叠使用模型，模型的变化会影响很多组件的展现和行为。**\n\n比如，开发一个类似qq的聊天页面，左侧是联系人列表，右侧是与某人的消息对话框，当收到一个消息之后，1要刷新左侧联系人列表的最近联系人，2要右侧的消息对话框中显示这个消息，3要页面title要提示新消息。这就是典型的一个新消息到来事件【消息模型发生了变化】触发三个无关联的组件都有行为和展现的变化。如果用事件系统来开发就做到了解耦的极致，未来如果还要加入第4种处理也不用修改原来的逻辑，就直接注册一下就可以了，满足了开闭原则。\n\n**需要对app运行过程进行监控，数据采样等**\n\nflux系列框架是一个典型的门面模式，业务动作都要通过统一的门面dispatch进行，天生具有良好的监控解决方案。\n\n\n###面向对象的RN组件架构\n\n面向对象的RN组件架构的使用场景特点我没有总结出来，我觉得所有场景都可以用，只要你业务逻辑对象设计的好，都不是问题。\n\n还拿上面聊天界面举例子，面向对象的RN组件架构其实也可以解耦的写出写上述场景，你完全可以将业务逻辑对象之间的交互设计成一个小的事件系统，只是架构没有直接约束这种解耦，flux系列架构直接在架构中就强制编码人员做到了解耦，但是如果我不需要解耦的时候就相当于增加了复杂度，得不偿失了。\n\n所以面向对象的RN组件架构要更灵活，也更简单更容易让人理解，更容易预测代码的执行流向，但同时因为灵活对业务逻辑对象设计者的要求也较高，针对较为复杂or重要页面建议进行详细设计并leader检查来保证质量。\n\n\n##如何做监控\n\n因为面向对象的RN架构中去掉了统一的业务逻辑调用facade入口dispatch，那我们如何来做监控呢。\n\n###方案1：在需要监控的地方人为加入监控点。\n这个方案对业务代码和监控代码的耦合确实有点大，是最差的解决方案了。不推荐。\n###方案2：在基类BaseLogicObj的构造器中对对象的所有方法进行代理-todo待验证\n这个方案对业务代码透明，但是还只是个想法，未进行代码测试和验证。\n###方案3.....还没有想出别的方案，有没有同学给点思路？\n\n\n##架构之美\n\n最后在分享demo代码之前，摘抄了天猫前端架构师团队对架构的认识，个人觉得十分认同。\n\n简单：\n简单的东西才能长久，HTML、CSS和JavaScript之所以能够活到现在，而其他类似的很牛的方案都死掉了，原因之一是简单，才有那么多人用它，所以我们需要把技术和产品方案朝着简单的思路发展，简单才是本质，复杂一定是临时的会过时的。天猫的前端技术架构为什么都基于Kissy，为什么是两层架构，就是朝着简单的方式去思考。看起来简单，用起来简单。\n\n高效：\n简单是高效的前提，复杂的高效都是临时的会过时的，技术架构一定要提高团队的工作效率，否则一定会被抛弃，因此把简单的规则自动化，把精确的重复的事情让机器去做，前端这么多年为什么开发环境不够成熟，就是自动化的工具太少，前端又很少能力驾驭编写工具的语言，而Nodejs的出现是一个前所未有的机会。\n\n灵活：\n高效往往和灵活是对立的，就像移动上Native和Web的关系，而我们就需要思考如何做到两者兼顾，既高效又灵活，所以要不断把事情做简单，思考本质、看到本质，基于本质去实现。比如Apple为什么敢于把鼠标和键盘去掉，是因为确信人直接和界面打交道比借助一个中间硬件更能够表达人机交互的本质。\n\n新鲜：\n面向未来，前端需要不停地更新自己，无论是思想还是技术。比如整个天猫基于Kissy，那么就使用最新的Kissy版本，基础设施能够升级是一种能力，如果有一天基础设施升不了啦，那么这套技术架构就老去了。比如发现Gulp比Grunt更能够代表未来，那么我们毫不犹豫地整个团队开始进行升级。\n\n##完整demo代码\n\n此demo仿照redux提供的todolist demo编写。\n\nredux demo 地址：http://camsong.github.io/redux-in-chinese/docs/basics/ExampleTodoList.html\n\ndemo截图：\n\n![](media/14503398097842.jpg)\n\n \n\ntodolist页面：\n\n```\n\n\n'use strict'\n\n\nlet React=require('react-native');\nlet Immutable = require('immutable');\nvar BbtRN=require('../../../bbt-react-native');\n\n\nvar {\n BaseLogicObj,\n }=BbtRN;\n\n\nlet {\n AppRegistry,\n Component,\n StyleSheet,\n Text,\n View,\n Navigator,\n TouchableHighlight,\n TouchableOpacity,\n Platform,\n ListView,\n TextInput,\n ScrollView,\n }=React;\n\n//root组件开始-----------------\n\nlet Root =React.createClass({\n\n //初始化模拟数据，\n data:[{\n name:'aaaaa',\n completed:true,\n },{\n name:'bbbbb',\n completed:false,\n },{\n name:'ccccc',\n completed:false,\n }\n ,{\n name:'ddddd',\n completed:true,\n }],\n\n\n componentWillMount(){\n\n //初始化业务逻辑对象\n this.addTodoObj=new AddTodoObj(this);\n this.todoListObj=new TodoListObj(this);\n this.filterObj=new FilterObj(this);\n\n //下面可以继续做一些组件初始化动作，比如请求数据等.\n //当然了这些动作最好是业务逻辑对象提供的，这样root组件将非常干净.\n //例如这样：this.todoListObj.queryData();\n },\n\n\n //状态初始化\n getInitialState(){\n return {\n data:Immutable.fromJS(this.data),//模拟的初始化数据\n todoName:'',//新任务的text\n curFilter:'all',//过滤条件 all no ok\n }\n },\n\n\n\n //这里组合子view组件 并 注册业务逻辑对象提供的方法到各个子view组件上\n render(){\n\n return (\n \n\n \n\n \n\n