mirror of
https://github.com/facebook/react-native.git
synced 2025-11-01 09:14:26 +00:00
louiszawadzkiandFacebook GitHub Bot
54a5ff9745
Summary: When an iOS app launches, the current `AppStateStatus` that is returned is `"unknown"`. However, `RCTSharedApplication().applicationState` returns `UIApplicationStateInactive` - which makes sense since the app is still showing its launch screen. I suggest to return `"inactive"` instead of `"unknown"`, since it makes more sense and `"unknown"` is not mentioned in the [official documentation](https://reactnative.dev/docs/appstate). I also edited the annotation for the `"inactive"` status type to make it more accurate. bypass-github-export-checks ## Changelog: [IOS] [CHANGED] - Set initial AppState status to "inactive" instead of "unknown" Pull Request resolved: https://github.com/facebook/react-native/pull/37690 Test Plan: I played a bit with the `rn-tester` app to display the `AppStateExample` [component](https://github.com/facebook/react-native/blob/main/packages/rn-tester/js/examples/AppState/AppStateExample.js). I did not manage to display its content, but I managed to render it and log from [its render function](https://github.com/facebook/react-native/blob/main/packages/rn-tester/js/examples/AppState/AppStateExample.js#L84). This is what I log in the `render` function:  Here is the log I saw before the change:  and after the change:  Reviewed By: cortinico Differential Revision: D46729548 Pulled By: cipolleschi fbshipit-source-id: 18d2d606e0b77306811bd898b28858746c713e12
59 lines
2.1 KiB
TypeScript
59 lines
2.1 KiB
TypeScript
/**
|
|
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
*
|
|
* This source code is licensed under the MIT license found in the
|
|
* LICENSE file in the root directory of this source tree.
|
|
*
|
|
* @format
|
|
*/
|
|
|
|
import {NativeEventSubscription} from '../EventEmitter/RCTNativeAppEventEmitter';
|
|
|
|
/**
|
|
* AppState can tell you if the app is in the foreground or background,
|
|
* and notify you when the state changes.
|
|
*
|
|
* AppState is frequently used to determine the intent and proper behavior
|
|
* when handling push notifications.
|
|
*
|
|
* App State Events
|
|
* change - This even is received when the app state has changed.
|
|
* focus [Android] - Received when the app gains focus (the user is interacting with the app).
|
|
* blur [Android] - Received when the user is not actively interacting with the app.
|
|
*
|
|
* App States
|
|
* active - The app is running in the foreground
|
|
* background - The app is running in the background. The user is either in another app or on the home screen
|
|
* inactive [iOS] - This is a transition state that happens when the app launches, is asking for permissions or when a call or SMS message is received.
|
|
* unknown [iOS] - Initial value until the current app state is determined
|
|
* extension [iOS] - The app is running as an app extension
|
|
*
|
|
* For more information, see Apple's documentation: https://developer.apple.com/library/ios/documentation/iPhone/Conceptual/iPhoneOSProgrammingGuide/TheAppLifeCycle/TheAppLifeCycle.html
|
|
*
|
|
* @see https://reactnative.dev/docs/appstate#app-states
|
|
*/
|
|
export type AppStateEvent = 'change' | 'memoryWarning' | 'blur' | 'focus';
|
|
export type AppStateStatus =
|
|
| 'active'
|
|
| 'background'
|
|
| 'inactive'
|
|
| 'unknown'
|
|
| 'extension';
|
|
|
|
export interface AppStateStatic {
|
|
currentState: AppStateStatus;
|
|
isAvailable: boolean;
|
|
|
|
/**
|
|
* Add a handler to AppState changes by listening to the change event
|
|
* type and providing the handler
|
|
*/
|
|
addEventListener(
|
|
type: AppStateEvent,
|
|
listener: (state: AppStateStatus) => void,
|
|
): NativeEventSubscription;
|
|
}
|
|
|
|
export const AppState: AppStateStatic;
|
|
export type AppState = AppStateStatic;
|