今天,我们发布了 React Native 0.63,它默认启用了 LogBox。
LogBox
我们经常收到社区的反馈,即 React Native 中的错误和警告难以调试。为了解决这些问题,我们查看了 React Native 中的整个错误、警告和日志系统,并从头开始重新设计了它。

LogBox 是 React Native 中完全重新设计的红框、黄框和日志记录体验。在 0.62 版本中,我们推出了 LogBox 作为可选择启用项。在此版本中,我们将 LogBox 作为所有 React Native 中的默认体验推出。
LogBox 通过关注三个主要目标来解决错误和警告过于冗长、格式不佳或不可操作的抱怨
- 简洁:日志应提供调试问题所需的最小信息量。
- 格式化:日志应进行格式化,以便您可以快速找到所需的信息。
- 可操作:日志应可操作,以便您可以修复问题并继续前进。
为了实现这些目标,LogBox 包括
- 日志通知:我们重新设计了警告通知,并添加了对错误的支持,以便所有 console.warn 和 console.log 消息都显示为通知,而不是覆盖您的应用。
- 代码框架:每个错误和警告现在都包含一个代码框架,该框架在应用内显示日志的源代码,使您可以快速识别问题根源。
- 组件堆栈:所有组件堆栈现在都从错误消息中剥离出来,并放入自己的部分,顶部三个框架可见。这为您提供了一个单一且一致的空间来期望不混乱日志消息的堆栈框架信息。
- 堆栈框架折叠:默认情况下,我们现在折叠与您的应用程序代码无关的调用堆栈框架,以便您可以快速查看应用中的问题,而无需筛选 React Native 内部结构。
- 语法错误格式化:我们改进了语法错误的格式,并添加了带有语法高亮的代码框,以便您可以查看错误来源、修复错误并继续编码,而不会受到 React Native 的阻碍。
我们已将所有这些功能整合到一个改进的视觉设计中,该设计在错误和警告之间保持一致,并允许在一个令人愉悦的 UI 中分页浏览所有日志。
随着此项更改,我们还将弃用 YellowBox,转而使用 LogBox API。
LogBox.ignoreLogs()
:此函数取代了 YellowBox.ignoreLogs([])
,作为一种静默处理任何与给定字符串或正则表达式匹配的日志的方法。
LogBox.ignoreAllLogs()
:此函数取代了 console.disableYellowBox
,作为一种关闭错误或警告通知的方法。注意:这仅禁用通知,未捕获的错误仍将打开全屏 LogBox。
在 0.63 版本中,当使用这些已弃用的模块或方法时,我们将发出警告。请在这些 API 在 0.64 版本中移除之前,更新您的调用位置,使其不再使用这些 API。
有关 LogBox 和调试 react native 的更多信息,请参阅此处的文档。
Pressable
React Native 的构建旨在使应用程序能够满足用户对平台的期望。这包括避免“泄露信息”——即那些泄露体验是用 React Native 构建的小细节。这些泄露信息的主要来源之一是 Touchable 组件:Button
、TouchableWithoutFeedback
、TouchableHighlight
、TouchableOpacity
、TouchableNativeFeedback
和 TouchableBounce
。这些组件通过允许您为用户交互提供视觉反馈,使您的应用程序具有交互性。然而,由于它们包含与平台交互不匹配的内置样式和效果,用户可以分辨出哪些体验是用 React Native 编写的。
此外,随着 React Native 的发展以及我们对高质量应用程序的要求不断提高,这些组件并没有随之发展。React Native 现在支持 Web、桌面和电视等平台,但对其他输入方式的支持一直不足。React Native 需要在所有平台上支持高质量的交互体验。
为了解决这些问题,我们发布了一个新的核心组件,名为 Pressable
。此组件可用于检测各种类型的交互。API 的设计旨在提供对当前交互状态的直接访问,而无需在父组件中手动维护状态。它还旨在使平台能够扩展其功能,以包括悬停、模糊、焦点等。我们预计大多数人将构建和共享在底层使用 Pressable
的组件,而不是依赖于像 TouchableOpacity
这样的默认体验。
import {Pressable, Text} from 'react-native';
<Pressable
onPress={() => {
console.log('pressed');
}}
style={({pressed}) => ({
backgroundColor: pressed ? 'lightskyblue' : 'white',
})}>
<Text style={styles.text}>Press Me!</Text>
</Pressable>;
Pressable 组件在操作中的一个简单示例
您可以从文档中了解更多信息。
每个原生平台都有系统定义颜色的概念。这些颜色会自动响应系统主题设置,例如浅色或深色模式,辅助功能设置,例如高对比度模式,甚至在应用程序中的上下文,例如包含视图或窗口的特性。
虽然可以通过 Appearance
API 和/或 AccessibilityInfo
检测到其中一些设置,并相应地设置您的样式,但这种抽象不仅开发成本高昂,而且只是在近似原生颜色的外观。当在混合应用程序上工作时,这些不一致性尤其明显,在混合应用程序中,React Native 元素与原生元素并存。
React Native 现在提供了一个开箱即用的解决方案来使用这些系统颜色。PlatformColor()
是一个新的 API,可以像 React Native 中的任何其他颜色一样使用。
例如,在 iOS 上,系统提供了一种名为 labelColor
的颜色。可以在 React Native 中使用 PlatformColor
,如下所示
import {Text, PlatformColor} from 'react-native';
<Text style={{color: PlatformColor('labelColor')}}>
This is a label
</Text>;
将 Text 组件的颜色设置为 iOS 定义的 labelColor。
另一方面,Android 提供了像 colorButtonNormal
这样的颜色。您可以在 React Native 中使用此颜色,如下所示
import {View, Text, PlatformColor} from 'react-native';
<View
style={{
backgroundColor: PlatformColor('?attr/colorButtonNormal'),
}}>
<Text>This is colored like a button!</Text>
</View>;
将 View 组件的背景颜色设置为 Android 定义的 colorButtonNormal。
您可以从文档中了解更多关于 PlatformColor
的信息。您还可以查看 RNTester 中提供的实际代码示例。
DynamicColorIOS
是一个仅限 iOS 的 API,可让您定义在浅色和深色模式下使用的颜色。与 PlatformColor
类似,这可以在任何可以使用颜色的地方使用。DynamicColorIOS
在底层使用 iOS 的 colorWithDynamicProvider
。
import {Text, DynamicColorIOS} from 'react-native';
const customDynamicTextColor = DynamicColorIOS({
dark: 'lightskyblue',
light: 'midnightblue',
});
<Text style={{color: customDynamicTextColor}}>
This color changes automatically based on the system theme!
</Text>;
根据系统主题更改文本颜色
您可以从文档中了解更多关于 DynamicColorIOS
的信息。
放弃对 iOS 9 和 Node.js 8 的支持
在发布四年多之后,我们正在放弃对 iOS 9 的支持。此项更改将使我们能够通过减少需要在原生代码中进行的兼容性检查数量来加快开发速度,以检测给定功能是否在特定 iOS 版本上受支持。凭借其 1% 的市场份额,它不应对您的客户产生太大的负面影响。
同时,我们正在放弃对 Node 8 的支持。它的 LTS 维护周期于 2019 年 12 月到期。当前的 LTS 是 Node 10,现在是我们正在定位的版本。如果您仍在为 React Native 应用程序的开发使用 Node 8,我们鼓励您升级,以便接收所有最新的安全修复和更新。
其他值得注意的改进
- 支持在
<Text />
中渲染 <View />
而无需显式大小:您现在可以在任何 <Text />
组件内渲染任何 <View />
,而无需显式设置其宽度和高度,这在以前的版本中并非总是可能的。在以前版本的 React Native 中,这会导致 RedBox 错误。
- 将 iOS 启动屏幕从 xib 更改为 storyboard:从 2020 年 4 月 30 日起,所有提交到 App Store 的应用程序都必须使用 Xcode storyboard 来提供应用程序的启动屏幕,并且所有 iPhone 应用程序都必须支持所有 iPhone 屏幕。此提交调整了默认的 React Native 模板,使其与此要求兼容。
感谢数百位为 0.63 版本的发布做出贡献的贡献者!
特别感谢 Rick Hanlon 撰写关于 LogBox
的部分,以及 Eli White 撰写本文关于 Pressable
的部分。
要查看所有更新,请查看 0.63 版本的更新日志。