【0.48】React Native 中文更新日志

时间 2019-11-24

原文原文链接

本文为 Marno 原创，转载必须保留出处！

公众号【 aMarno 】，关注后回复 RN 加入交流群

React Native 优秀开源项目大全：www.marno.cn

1、导读

翻译更新文档真是一件特别枯燥无聊的事情，还会占用大量的业余时间，可是为了翻译的尽可能准确，我会详细查看每个更新的内容，而后结合修改的代码和更新说明再进行翻译。尽管如此有时候仍是可能出现翻译的不太准确的地方，但愿你们能够谅解。若是发现有翻译不许确的地方，能够经过留言或者关注个人公众号联系我进行修改。javascript

此次更新对 iOS 的变更要大一些，新增了一个组 MaskedViewIO，还在
Guides (IOS) 中添加了 App Extensions 相关的内容，具体使用能够到官网看下。还有就是大量重构了 TextInput 相关的代码，合并了不少属性，除此以外还为适配 iOS11 作了一些改动，具体能够看详细的更新日志。java

2、通用

2.1 重大变化node

使 RCTDeviceEventEmitter 报致命性的警告react

以前若是 RCTDeviceEventEmitter 中出现错误，会经过 console.warn() 方式来提醒，如今若是发生错误，会直接经过 throw new Error() 方式抛出错误。android
移除 RCTUIManager.h 文件中 3 个再也不使用的通知（iOS）ios
移除了官方 APIs 中的 AdSupportIOS（iOS）git

官方解释是为了集中精力提供更多高质量的组件，会逐渐移除那些不属于该范畴内的一些 API 和 Component。可是若是你的项目中用到了该组件，能够继续从 react-native-deprecated-modules 中引用该组件（以往移除的一些组件也均可以在这里找到），或者使用后面推荐的这个库来代替： github.com/ptomasroos/…github

2.2 修复 Bugspring

修复 JSClassCreate 的错误调用
修复因为解决 #14684 问题时无心间引发的反作用

以前在解决 SwipeableRow.js 与 react-navigation 的手势冲突时，致使了一个黄盒警告，如今已经解决了。记得以前有提到过 SwipeableRow 这个组件，是一个实验性组件，想了解的能够翻下 0.47 的更新日志npm
修复 CLI 中缺乏 "getPolyfills" tag 的问题
修复不能正常嵌套在组件中的错误
Yoga: Fixing edge case issue in Yoga where text node was unnecessary rounded down
Yoga: Reset the hadOverflow flag at the beginning of the algorithm
Docs: 修复 Linking.js 注释中的拼写错误
Docs: 修复 Animations.md 中的拼写错误
Docs: Fix mistake acquireWakeLockNow in headless js section
Docs: 修改组件的文档中的示例代码

以前版本的示例代码让人觉得 title 是 section 的必须字段，但实际上不是，因此在文档的示例代码中删除了
title 字段。
Docs: 修改组件的 backgroundColor 属性的值类型为 string
Docs: 修复文档中不完整的连接地址
Docs: Fix navigation menu regression on mobile
Docs: 修正 FlatList.js 类注释种的语法错误
Docs: 修改文档中不规范的缩进

2.3 新特性

为 WebSocket 添加 Blob 实现，使 WebSocket 支持二进制数据的传递
在 __fbBatchedBridge is undefined 的报错信息中添加可能致使该错误出现的缘由
添加缺乏的 assetRegistryPath 命令到 dependencies command
为 Animated.spring 添加一个 delay 属性，以推迟动画的开始时间
为 TouchableHighlight 启用 flow
将 KeyboardAvoidingView 组件中的属性抽取到了ViewPropTypes.js 中统一管理
将 application/javascript 与 text/javascript 都添加为 packager 支持加载的 bundle 的类型
添加 CODEOWNERS 文件方便自审查 PR 的代码
移除了一些再也不使用的 npm 依赖库，而且添加了一个 babel-plugin-transform-flow-strip-types 的新依赖
将全部文件中的 React.createClass 替换成 create-react-class 包中的 createReactClass 方法

以前的版本更新中就已经将 React.createClass 移除了，因此你们有用到 React.createClass 的，或者下载的三方库中有用到的，记得去替换下。
SwipeableRow: 添加属性可设置禁用左滑或者右滑的事件，以解决和 react-navigation 滑动返回的冲突
VirtualizedList: 调整了 getItemLayout 的临界值，使列表能够滚动到最后一项
在 Linux 平台上添加支持经过 chromium 使用 devTools 进行 RN 应用调试
将 polyfills 从新移回到 react-native 中
修改了 PushNotificationIOS 组件中拼写错误的属性名
将 throat 依赖从 3.0.0 更新到 4.1.0
将 inspector proxy 从 packager 移走
在 ReactNativeART.js 避免反复建立新的 Path 示例致使性能下降
将 runServer.js 中的 polyfills 改成 getPolyfills() 以提升可配置性
尝试将 React DevTools 主题和如今 Nuclide 主题统一
将 Jest 版本从 20.1.0-alpha.3 更新至 20.1.0-chi.1
在 CLI 命令行工具中添加了 info 命令，能够显示 react-native 相关信息，使用方法为：react-native info
移除 TouchableOpacity 组件中与 focusedOpacity 相关的属性和方法
移遗留的 JSC profiler
将 Flow 从 0.49.1 更新到 0.50.0 版本
移除 metro-bundler 中默认的 polyfills
设置值时中止 native 驱动的动画
更新 metro-bundler 版本从 0.9.0 到 0.10.0
将 transform 速度提升 8.5%
将 RCTDevMenu.m 中的 Hide/Show Inspector重命名为 Toggle Inspector
在核心代码初始化时使 Set 和 Map 懒加载
统一了 NetInfo API 在两个平台上的返回字段，而且提供方法判断当前链接的网络频段是 2g/3g/4g
移除了 ScrollView 组件中的 onScrollAnimationEnd 属性
将 JSTimers 的 requires 设为内联方式
为不一样平台下的 View props 添加 hook
移除 JSCTracing.cpp 中再也不使用的 nativeTrace*stage 方法
在 runServer.js 中添加属性和方法，用来控制 Metro 是否经过 Babel 去查找 .babelrc 文件
为 MessageQueue.spy 输出的日志信息多添加了一些信息
Docs: 修复了 StatusBar 组件文档中某些属性锚点连接跳转不正确的问题
Docs: 修改 Navigation.md 文档，将 NavigatorIOS 的 push 方法所接收的参数类型变成 route 对象，并为其添加 passProps 属性
Docs: 修改 Headless 文档，添加如何传递参数的示例代码
Docs: 在 Performance.md 文档中说明， Animated API 默认在 JS 线程进行计算，但设置了
useNativeDriver 属性后则会在 Native 线程计算（这也是提升动画流畅度的一种方式，感兴趣能够搜一下，网上有相应的文章）
Docs: 修改 IntegrationWithExistingApps.md 文档中示例代码中的项目名称，旧版本中先后名称不一致，init 时使用的是 MyReactNativeApp ，可是注册的时候使用的是 HelloWorld
Docs: 更新 Transforms 的文档，标明了哪些属性已通过期；而且对各属性的值类型作了说明，标明哪些须要传入 string，哪些须要传入 number
Docs: 为设置 animationType 属性时传入的值不用再使用 {} 包裹
Docs: 将 ReactImageView 中 setSrc() 方法的参数由 String 改成 ReadableArray
Docs: 在文档中明确说明了 FlatList 继承了全部 ScrollView 的属性
Docs: 给 TouchableWithoutFeedback.js 中的 onPressIn 和 onPressOut 属性添加说明
Docs: 更新 podspec 集成说明，在 >=0.47 的版本中须要引入 CxxBridge
Docs: 在 ListView 的文档中添加了一些使用说明，具体以下：
1. 在水平的 ListView 中 header 和 footer 是如何渲染的（header在左，footer 在右）
2. 添加如何使用 cloneWithRowsAndSections 的示例代码
3. 为 getRowCount() 和 getRowAndSectionCount() 方法添加说明
Docs: 以前添加了组件后没有更新 Image 文档中相关的说明，此次将这部分说明及示例代码都更新了
Docs: 澄清了若是在 OC 代码中的类以 RCT 为前缀，在 JS 层调用的时候应该排除掉前缀。
Docs: 澄清在 Android 平台上 ScrollView 的 pagingEnabled 仅支持横向

以前的文档没有误让人觉得 pagingEnabled 在双平台都支持横向、竖向模式，但其实在 Android 上不支持竖向模式。
Docs: 为组件增长示例代码，说明如何经过 'data' 来展现图片
Docs: 修改侧边菜单 IntegrationWithExistingApps.md 中示例代码的项目名称
Docs: 将示例代码中经过 pod 导入文件的路径改成单引号包裹
Docs: 在 sectionList 中尽管·1使用了 keyExtractor 方法，仍须要单独为整个 section 设置 key
Docs: 将 Animated 添加到 ComponentsAndAPIs 栏目的 Others 分类下
Docs: 为 ScrollView.js 中的 onMomentumScrollEnd 属性添加说明文档
Docs: 为 ScrollView.js 中的 onMomentumScrollBegin 属性添加说明文档

3、Android

修复 Bug

修复在使用某些角度旋转图片时使其边缘产生锯齿的问题
修复当调用图片剪裁时给 displaySize 属性设置 float 类型的值时致使的奔溃
Fixed new line and prioritise blurOnSubmit in multiline text input
修复 HEAD 请求方式失败的问题
修复当初始化后再去更新 z-index 属性无效的问题
将 WebSocket 模块中接收到的二进制消息转换为 base64 而非 utf-8 格式

新特性

在 Headless JS 文档中添加说明，提示用户记得将 service 添加到 AndroidManifest 中
将 ReactWebViewManager.java 类中的方法和变量的权限修饰符由 private 改成 protected
支持为 ARTSurfaceView 设置背景色
为 Arguments.java 类中添加了一些新功能，具体以下

1.添加了 ReadableArray 转换成 ArrayList 的方法
2.添加了 List 转换成 WritableArray 的方法
3.修改了 toBundle 方法，使其支持 arrays
4.修改了 fromBundle 方法，使其支持 lists
在 DrawerLayoutAndroid 文档中添加如何调用 openDrawer 和 closeDrawer 方法的说明
将 Native Modules Android 文档中涉及到的 ToastAndroid 名字换成 ToastExample

在该文档中所说的 ToastAndroid 并不是 API 中提供的那个，而只是为了演示 Android 原生 Toast 如何使用而建立的名字，因此为了不混淆，干脆将其更名为 ToastExample。
简化 MethodInvoker.cpp 中的宏的使用
升级了 Fresco 相关依赖的版本(从1.0.1 > 1.3.0 )
剧烈摇晃手机 2 次后显示 DevMenu
在 drawable 加载完成后再进行 ToolbarAndroid 布局
将 ReactInstanceManagerBuilder.java 类中的成员变量由 protected 变成 private
为 CxxModule.h 中的 getConstants 方法提供默认实现
删除 settings.gradle 文件中已经不存在的 module 的引用
在清理内存缓存前先检查 fresco 是否完成初始化
将 window 的尺寸和屏幕 orientation 区分开

在某些状况下，设备是竖屏的，可是获取到的 window 的尺寸倒是横屏的尺寸，这是由于当设备方向发生变化时，尺寸更新事件从 ReactRootView 获取到了错误的尺寸。如今将 window 尺寸和 screen 尺寸拆分开，就不会发生这样的状况了。

4、iOS