Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Blog post for the 0.63 release #2024

Merged
merged 9 commits into from
Jul 8, 2020
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
153 changes: 153 additions & 0 deletions website/blog/2020-07-06-version-0.63.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,153 @@
---
title: Announcing React Native 0.63 with LogBox
author: Mike Grabowski
authorTitle: CTO and Co-Founder at Callstack
authorURL: https://twitter.com/grabbou
authorImageURL: https://avatars0.githubusercontent.com/u/2464966?s=460&v=4
authorTwitter: grabbou
category: announcements
---

Today we’re releasing React Native 0.63 that ships with LogBox turned on by default.

## LogBox

We’ve heard frequent feedback from the community that errors and warnings are difficult to debug in React Native. To address these issues we took a look at the entire error, warning, and log system in React Native and redesigned it [from the ground up](https://www.youtube.com/watch?v=Y8brBH5O-bQ&feature=youtu.be).

![Screenshot of LogBox](/blog/assets/0.63-logbox.png)

LogBox is a completely redesigned redbox, yellowbox, and logging experience in React Native. In 0.62 we introduced LogBox as an opt-in. In this release, we’re launching LogBox as the default experience in all of React Native.

LogBox addresses complaints that errors and warnings were too verbose, poorly formatted, or unactionable by focusing on three primary goals:

- **Concise**: Logs should provide the minimum amount of information necessary to debug an issue.
- **Formatted**: Logs should be formatted so that you can quickly find the information you need.
- **Actionable**: Logs should be actionable, so you can fix the issue and move on.

To achieve these goals, LogBox includes:

- **Log notifications**: We’ve redesigned the warning notifications and added support for errors so that all console.warn and console.log messages show up as notifications instead of covering your app.
- **Code Frames**: Every error and warning now includes a code frame that shows the source code of the log right inside the app, allowing you to quickly identify the source of your issue.
- **Component Stacks**: All component stacks are now stripped from error messages and put into their own section with the top three frames visible. This gives you a single, consistent space to expect stack frame information that doesn’t clutter the log message.
- **Stack Frame Collapsing**: By default we now collapse call stack frames not related to your application’s code so you can quickly see the issue in your app and not sift through React Native internals.
- **Syntax Error Formatting**: We’ve improved the formatting for syntax errors and added codeframes with syntax highlighting so you can see the source of the error, fix it, and continue coding without React Native getting in your way.

We’ve wrapped all of these features into an improved visual design that’s consistent between errors and warnings and allows paginating through all logs in one enjoyable UI.

With this change we’re also deprecating YellowBox in favor of LogBox APIs:

- `LogBox.ignoreLogs()`: This function replaces `YellowBox.ignoreLogs([])` as a way to silence any logs that match the given strings or regexes.
- `LogBox.ignoreAllLogs()`: This function replaces `console.disableYellowBox` as a way to turn off error or warning notifications. Note: this only disables notifications, uncaught errors will still open a full screen LogBox.

In 0.63, we will warn when using these deprecated modules or methods. Please update your call sites off of these APIs before they are removed in 0.64.

For more information on LogBox and debugging react native, see the docs [here](https://reactnative.dev/docs/debugging#in-app-errors-and-warnings).

## Pressable

React Native is built to enable your applications to meet user’s expectations of the platform. This includes avoiding “tells”—little things that give away that the experience was built with React Native. One major source of these tells has been the Touchable components: `Button`, `TouchableWithoutFeedback`, `TouchableHighlight`, `TouchableOpacity`, `TouchableNativeFeedback`, and `TouchableBounce`.
grabbou marked this conversation as resolved.
Show resolved Hide resolved

These components make it easy to get started making things interactive. However, because they include built-in styles and effects that don’t match the system interaction, they make it easy to tell when experiences are written with React Native. Further, as React Native has grown and our bar for high-quality applications has gone up, these components haven't grown with it. React Native now supports platforms like Web, Desktop, and TV, but support for additional input modalities has been lacking. React Native needs something that meets users' expectations and gives them the best possible interaction experience on all platforms.
grabbou marked this conversation as resolved.
Show resolved Hide resolved
grabbou marked this conversation as resolved.
Show resolved Hide resolved

To address these problems, we are shipping a new core component called Pressable. This component can be used to detect various types of interactions. It can be extended by the platform to include things like hover, blur, focus, and more. We expect that most people will build and share components utilizing Pressable under the hood instead of relying on the default experience of something like TouchableOpacity.
grabbou marked this conversation as resolved.
Show resolved Hide resolved

```jsx
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>;
```

<p style="text-align: center; font-size: 12px">
grabbou marked this conversation as resolved.
Show resolved Hide resolved
A simple example of a Pressable component in action
</p>

You can learn more about it from [the documentation](https://reactnative.dev/docs/next/pressable).
grabbou marked this conversation as resolved.
Show resolved Hide resolved

## Native Colors (PlatformColor, DynamicColorIOS)

Every native platform has the concept of system-defined colors. Colors that automatically respond to system theme settings such as Light or Dark mode, accessibility settings such as a High Contrast mode, and even its context within the app such as the traits of a containing view or window.

While it is possible to detect some of these settings via the [`Appearance`](https://reactnative.dev/docs/appearance#getcolorscheme) API and/or [`AccessibilityInfo`](https://reactnative.dev/docs/accessibilityinfo#isgrayscaleenabled) and set your styles accordingly, such abstractions are not only costly to develop but are just approximating the appearance of native colors. These inconsistencies are particularly noticeable when working on a hybrid application, where React Native elements co-exist next to the native ones.

React Native now provides an out-of-the-box solution to use these system colors. `PlatformColor()` is a new API that can be used like any other color in React Native.

For example, on iOS, the [system provides a color called `labelColor`](https://developer.apple.com/documentation/uikit/uicolor/ui_element_colors?language=objc). That can be used in React Native with `PlatformColor` like this:

```jsx
import { Text, PlatformColor } from 'react-native';

<Text style={{color: PlatformColor(‘labelColor’) }}>
grabbou marked this conversation as resolved.
Show resolved Hide resolved
This is a label
</Text>
```

<p style="text-align: center; font-size: 12px">
Sets the color of the Text component to labelColor as defined by iOS.
</p>

Android, on the other hand, [provides colors like colorButtonNormal](https://developer.android.com/reference/android/R.attr#colorButtonNormal). You can use this color in React Native with:

```jsx
import { View, Text, PlatformColor } from 'react-native';

<View
style={{
backgroundColor: PlatformColor('?attr/colorButtonNormal')
}}>
<Text>This is colored like a button!</Text>
</View>;
```

<p style="text-align: center; font-size: 12px">
Sets the background color of the View component to colorButtonNormal as defined by Android.
</p>

You can learn more about `PlatformColor` from [the documentation](https://reactnative.dev/docs/next/platformcolor). You can also check the actual [code examples present in the RNTester](https://github.com/facebook/react-native/blob/master/RNTester/js/examples/PlatformColor/PlatformColorExample.js).
grabbou marked this conversation as resolved.
Show resolved Hide resolved

`DynamicColorIOS` is an iOS only API that lets you define which color to use in light and dark mode. Similar to `PlatformColor`, this can be used anywhere you can use colors. `DynamicColorIOS` uses iOS’s `colorWithDynamicProvider` under the hood.

```jsx
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>;
```

<p style="text-align: center; font-size: 12px">
Changes the text color based on the system theme
</p>

You can learn more about `DynamicColorIOS` from [the documentation](https://reactnative.dev/docs/next/dynamiccolorios).
grabbou marked this conversation as resolved.
Show resolved Hide resolved

## Dropping iOS 9 and Node.js 8 support

After over four years from its release, we are dropping support for iOS 9. This change will allow us to move faster by being able to reduce the number of compatibility checks that need to be placed in the native code to detect whether a given feature was supported on a certain iOS version. With its [market share of 1%](https://david-smith.org/iosversionstats/), it shouldn’t have much negative impact on your customers.

At the same time, we are dropping support for Node 8. [Its LTS maintenance cycle expired in December 2019](https://nodejs.org/fr/blog/release/v8.9.0/). The current LTS is Node 10 and it is now the version that we are targeting. If you are still using Node 8 for the development of React Native applications, we encourage you to upgrade in order to receive all the latest security fixes and updates.

## Other notable improvements

- **Support rendering <View /> in <Text /> without explicit size**: You can now render any <View /> inside any <Text /> component without setting its width and height explicitly, which wasn’t always possible. On previous releases of React Native, this would result in a RedBox.
grabbou marked this conversation as resolved.
Show resolved Hide resolved
- **Changed iOS LaunchScreen from `xib` to `storyboard`**: Starting April 30, 2020, all apps submitted to the App Store must use an Xcode storyboard to provide the app’s launch screen and all iPhone apps must support all iPhone screens. This commit adjusts the default React Native template to be compatible with this requirement.

## Thanks

Thank you to the hundreds of contributors that helped make 0.63 possible!

> Special thanks to [Rick Hanlon](https://twitter.com/rickhanlonii) for authoring the section on `LogBox` and [Eli White](https://twitter.com/Eli_White) for authoring the `Pressable` part of this article.

To see all the updates, take a look at the [0.63 changelog](https://github.com/react-native-community/releases/blob/master/CHANGELOG.md#0630).
Binary file added website/blog/assets/0.63-logbox.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.