【0.47】React Native 中文更新日志

• 本文为 Marno 原创，转载必须保留出处！
• 公众号【 Marno 】，关注后回复 RN 加入交流群
• React Native 优秀开源项目大全：www.marno.cn

1、导读

---

此次更新翻译的慢了一点，由于最近事情比较多，但愿你们谅解，毕竟我都是在用业余时间作这些。若是想第一时间获取 RN 中文更新日志，也能够关注个人公众号。

言归正传，此次更新最多的内容就是分包的变化，对性能的优化比较小，由于原理就是那样，不管在怎么优化都不可能突破原生和 JS 之间这道障碍，不过通过这几回不断的分包，代码结构看起来更清晰了，并且随着功能愈来愈大，也须要这样的方式去优化管理。

此次更新在 Android 增长了对 Kotlin 模块的 link 功能，算是对上次更新遗留问题的弥补，这也说明一个问题，无论你愿不肯意， Kotlin 已经被愈来愈多的人接受了。

对了，顺便说一下，仔细的人应该早就发如今 Libraries 包下有一个 Experimental 的包，里面包含了一些实验性的组件，包括一些侧滑组件，按钮之类的，感兴趣的能够本身下载源码看下。可是实验性组件，你懂的！

PS：更新有风险，尝鲜需谨慎。我的以为除非十分必要，不然没有必要常常更新 RN 版本。

2、通用

---

2.1 重大变化

• 移除再也不使用的 createJSModules 方法（Android）

  如今不用特地声明要提供哪一个 JS 模块给 native 了，因此将 createJSModule 方法完全移除了，可是仍能够按照以前的方式来调用 JS 模块。

• 修正字体 weight 属性的（iOS）

  以前设置 weight 的属性值为 “300”或者 “200” ，通过计算后都会按照 Roboto-Thin 样式来处理，这致使这两个值呈现的效果同样，如今已经将这一问题修复。

2.2 修复 Bug

• VirtualizedList: 修复因为过早调用 _updateCellsToRender 方法带来的问题
• VirtualizedList: 优化渲染时间计算方式
• VirtualizedList: 修复当没有设置 getItemLayout 方法时引发的渲染问题
• CLI: Fix broken default getProjectRoots
• 修复类文件中声明证书的注释格式（以前只多了个【*号】）
• Fix deepFreezeAndThrowOnMutationInDev-test for Node v8.1.0
• 修复 invariant 的引用路径
• Fix configure glog script when building from xcodebuild
• 修复在 Geolocation.js 中调用 warning 方法时缺乏第一个参数致使的错误

2.3 新特性

• 在官网的侧边菜单中的 Guides 分类下添加一栏：Components and APIs（改版快主要是将现有组件和 API 进行了分类整理）
• 添加 marker 来标记整个 native 模块建立的过程
• 在官网侧边菜单 Guides 下 Images 中添加关于自定义 require 类型的文档介绍
• 向 RN CLI 服务端添加 https 选项
• 使 VirtualizedList 支持同一方向的嵌套滚动。
• Add --maxWorkers flag and allow transformers to run in-band
• FlatList: 在 Dev 模式下增长对 getItemLayout 返回对象的属性数量的校验，便于咱们在开发时能快速定位因为对象缺乏属性致使的问题
• FlatList: 添加 setNativeProps 方法，能够直接对 native 属性进行设置
• 当同时设置了 pagingEnabled 和 snapToInterval 属性时会报警告
• 为 SwipeableRow 组件（实验性组件）添加了 close 方法
• 添加一个新的 babel 转换器用于 inlining regenerator-runtime per file
• 将 Wix.com 添加到官网的 showcase 中
• 移除 react-native/packager 文件夹

  由于 RN 更换了新的打包工具 metro-bundler，这个工具是 FB 专门为 RN 设计的 JS 打包机，听说比以前用的 packager 更快了，感兴趣的能够到 github 看下，网址：github.com/facebook/me…

• Docs：更新了官网中侧边菜单 The Basics 板块中 Handling Touches 下的教程，更便于初学者理解 RN 的 Touch 时间。
• Docs: 修改了官网侧边菜单一些模块的排序
• 在尽量多的地方默认禁用 auto-mock
• 从 local-cli 中移除 worker
• Promise support for C++ bridge
• 给 VirtualizedList 和 FlatList 添加 progressViewOffset 方法，目的为了正确的显示上拉加载动画
• Implement Systrace integration for Fiber
• 添加判断 global.performance 确实为空时才进行覆盖
• 将关于 uglify 和 babel 的类型定义从 React Native 中移到了 Metro Bundler 中
• 清理 local-cli/core/tests
• 修复在 Node v8 时使用 mock-fs 形成的问题
• 修改了以前更新时没有修改到的一些 PropTypes 的引用

  记得不少人下载一些开源的项目，运行时会提示 PropTypes 找不到，由于 FB 将 PropTypes 移到了另外一个包，因此会找不到，看下以前的更新日志里有提到过的。

• 改进 ，这是上次更新添加的组件，若是不清楚怎么使用，能够看下上次的更新日志。
• 移除了 retainLines 和 sourceMaps 选项
• 将 jest、jest-repl、jest-runtime 版本更新到 20.0.4
• 更新 guidelines
• 将 preset 变成一个函数来处理不一样的开发者设置
• 将 Native Animated 中 x.makeNative 的调用调到 super.makeNative 以前
• 修改语法，使用 'its' 代替 'it's'
• Yoga: 若是使用了 flex，那么其总和最小为 1
• Yoga: 当设置了 display:none 时，中止渲染子节点
• Yoga: 在 display 属性中添加 flex 和 none 的属性值
• ImageBackground: 用 StyleSheet 中缓存的样式代替直接在 style 中设置属性对象，以提升渲染性能。
• 在文档中添加内容，说明在 Android 上暂不支持keyboardWillShow 和keyboardWillHide 属性。
• 给 debugger.html 添加音频，以保持在 Chrome 中调试 RN 应用时 tab 的优先级
• 在 react-native 中提供方法获取 unstable_batchedUpdates
• 当设置了 sticky headers 时禁用子组件 clipping
• 使用 create-react-class 包中的 createReactClass 取代某些官方组件中的 React.createClass
• 控制 Metro 是否调用 Babel 去查找 .babelrc 文件
• 中止在 JSTimers 使用 Map
• 将 JSTimersExecution 合并到 JSTimers，并删除对 JSTimersExecution 的引用。
• 容许无参的 rejection 回调
• 修复 TextInputState 类中 blurTextInput() 方法注释中的错别字
• 重构了 Button.js 中的代码，使逻辑更清晰
• 设置 bridge 能够为共享：容许 native 模块在 init 后再注册
• 使用 prop-types 包中的 PropTypes 代替 react 中的 PropTypes
• 将 Executor 重命名为 JSExecutor
• 修改文档中在 Windows 安装开发环境的 choco 命令（缩短语法）
• 像 app component 添加一个可选的 wrapper component
• Jest Mocks for NetInfo and Linking
• 在 Yoga 中检测组件是否溢出

3、Android

---

修复 Bug

• 修复 ReactArt 中的绘制弧线计算的问题
• 修复当没有获取到 Window 权限时程序奔溃的问题
• 修复 dev 加载指示器
• 修复 ReactInstanceManager.java 中的 package 顺序

新特性

• 在文档中指明 Android 目前不支持 overflow: hidden 属性
• 添加 cmd+opt+ctrl+D 命令以便全局调用 dev menu
• 添加 dev bundle 下载监听器，方便咱们在 bundle 加载的时候能够显示进度，该功能也主要是为了 Expo 显示加载进度的。
• 为 AndroidViewPager 增长 peeking（偷看） 功能

  不少 App 的 banner 都用这种设计，在 Android 上用 ViewPager 实现比较简单，如今官方也正式提供这个属性了。用语言描述的话，大概就是在本页会露出下一页的一边。

• 在调用同步 native 模块时的错误信息中显示 Java 堆栈信息
• 在文档中说明如何从 Android 的 asset 目录中读取图片资源 source={{uri: 'asset:/foo.png'}}
• 控制台 link 命令支持编译用 Kotlin 开发的 Android 模块了
• 容许添加多个 bridge 监听器
• 在 ReactInstanceManager.java 类中增长 log 日志打印
• 移除 SetBuilder 这个类
• 使用非零的实例化的 key 来标记 INITIALIZE_MODULE 标记
• 只加载一次核心模块
• 将代理 server 中标识 host 和 port 的常量分离开，以前IP和端口保存在一个常量中，如今拆分开了。
• 在 ReactRootView 中调用 removeOnGlobalLayoutListener 时先判断 Android SDK 的版本
• 将 packages 拆分到 core bridge 和 core RN 中
• 再也不容许 multipart bundle 的传送
• 将 getConstants 中的 NativeArray 转换成 NativeMap

4、iOS

---

修复 Bug

• 修改 iOS 上 WebView 的属性 scalesPageToFit 默认值为 true，该属性表示是否自动放大页面内容以适应浏览器窗口大小
• OSS build：使用 #import "..." 代替 #import
• 修复在 Apple TV 上的编译错误
• 修复在开启 JS debugger 的时候不 timer 不Fix timers 不运行的问题
• 修复在没有 executor 时访问 jsContextRef 形成的奔溃问题
• 修复调用 AccessibilityManager.setAccessibilityContentSizeMultipliers 时的奔溃问题
• 修复在 separate bundles 中引用过期资源的问题
• 修复当组件 height/width 设置为 0.5dp 时会被四舍五入成 1dp 的问题
• 修复 installGlobalFunction 方法的可见性
• 将单行 的 blurOnSubmit 属性默认值设置为 true

新特性

• 在文档中增长如何获取 iOS 系统版本的说明
• 根据 Apple 官方指导修改在 iOS 上的蓝色的默认值，从 #0C42FD 改成 #007AFF
• 使 RCTPackagerConnection 和 RCTSamplingProfilerPackagerMethod
  再也不依赖 RCTBridge
• 修复头文件中使用 CocoaPods/Xcode 导入文件时路径错误的问题
• 从 OSS React Xcode 项目中移除无用的 folly/File.{h,cpp}
• 提供 content-available APS key 用于 iOS 静默推送

  在 iOS 上若是想要发送一个调静音的推送消息，必须设置 content-available 的值为 1

• 在 RCTShadowView 中不容许插入子组件
• 支持 display: none 属性
• 实现 nativeID 属性以便使 native 代码能够引用 react 管理 views
• 添加 presentationStyle 属性控制 的表现方式，以便对大屏有更好的支持，如 iPad 和 iPhone7 plus 等
• 删除再也不使用的 RCTRenderingPerf
• 为 RCTUITextField 增长 editable 属性
• 将 RCTTextView 中的 placeholderText 属性重命名为 placeholder
• 增长 RCTBackedTextInputViewProtocol ，以便外部组件访问输入状态
• RCTTextInput: 将通用的布局相关的逻辑代码移到了基类中
• 为 添加 keyboardType 和 returnKeyType 属性

  当用户输入数字的时候，键盘没有提供 Done 或 Enter 按钮，因此增长 returnKeyType 属性，方便咱们提供收起键盘的方式，以提升用户体验

• 容许 RCTModuleData 明确的选择退出执行其建立的主队列
• 将 RCTAnimation 和 RCTLayoutAnimation 与 RCTUIManager 解耦
• 新方式去实现 RCTUITextField 的 editable 和 non-editable 属性
• ScrollView: 添加属性 DEPRECATED_sendUpdatedChildFrames 来控制是否调用 updatedChildFrames 来刷新数据
• 处理 Chrome debugger 抛出的致命性错误
• 容许上传视频

  以前若是选择相册中的视频进行上传，会读取视频第一帧看成图片上传；如今会判断所选文件的后缀名，若是是 *.mov 则会看成视频上传。

• 若是 bridge 无效则在 websocket 执行器启动时就报错
• TextInput: 固定单行 的 textWasPaste 属性的返回值为 YES
• 更新文档中 podspec 集成说明

---