返回首页 React Native 官方文档中文版

官网首页

快速入门

指南

组件

APIs

温馨提示

iOS 应用程序状态

AppStateIOS 可以告诉你应用程序是在前台还是在后台,而且状态更新时会通知你。 在处理推送通知时,AppStateIOS 经常被用于判断目标和适当的行为。

iOS 应用程序状态

  • Active - 应用程序在前台运行
  • Background - 应用程序在后台运行。用户正在使用另一个应用程序或者在主屏幕上。
  • Inactive - 这是一种过渡状态,目前不会在React Native的应用程序上发生。

想要获取更多的信息,见 Apple's documentation

基本用法

为了查看当前的状态,你可以检查 AppStateIOS.currentState,该方法会一直保持最新状态。然而,当 AppStateIOS 在桥接器上检索currentState时,在启动时它将会为空。

    getInitialState: function() {
      return {
        currentAppState: AppStateIOS.currentState,
      };
    },
    componentDidMount: function() {
      AppStateIOS.addEventListener('change', this._handleAppStateChange);
    },
    componentWillUnmount: function() {
      AppStateIOS.removeEventListener('change', this._handleAppStateChange);
    },
    _handleAppStateChange: function(currentAppState) {
      this.setState({ currentAppState, });
    },
    render: function() {
      return (
       <Text>Current state is: {this.state.currentAppState}</Text>
      );
    },

这个例子似乎只能说"当前状态是:活跃的"因为在 active 状态时,应用程序只对用户是可见的,空状态只能是暂时的。

方法

static addEventListener(type: string, handler: Function)

通过监听 change 事件类型和提供处理程序,为应用程序状态变化添加一个处理程序。

static removeEventListener(type: string, handler: Function)

通过传递 change 事件类型和处理程序,删除一个处理程序。

例子

Edit on GitHub

    'use strict';
    var React = require('react-native');
    var {
      AppStateIOS,
      Text,
    View
    } = React;
    var AppStateSubscription = React.createClass({
      getInitialState() {
        return {
          appState: AppStateIOS.currentState,
          previousAppStates: [],
        };
      },
      componentDidMount: function() {
        AppStateIOS.addEventListener('change', this._handleAppStateChange);
      },
      componentWillUnmount: function() {
        AppStateIOS.removeEventListener('change', this._handleAppStateChange);
      },
      _handleAppStateChange: function(appState) {
        var previousAppStates = this.state.previousAppStates.slice();
        previousAppStates.push(this.state.appState);
        this.setState({
          appState,
          previousAppStates,
        });
      },
      render() {
        if (this.props.showCurrentOnly) {
          return (
            <View>
              <Text>{this.state.appState}</Text>
            </View>
          );
        }
        return (
          <View>
            <Text>{JSON.stringify(this.state.previousAppStates)}</Text>
          </View>
        );
      }
    });
    exports.title = 'AppStateIOS';
    exports.description = 'iOS app background status';
    exports.examples = [
      {
        title: 'AppStateIOS.currentState',
        description: 'Can be null on app initialization',
        render() { return <Text>{AppStateIOS.currentState}</Text>; }
      },
      {
        title: 'Subscribed AppStateIOS:',
        description: 'This changes according to the current state, so you can only ever see it rendered as "active"',
        render(): ReactElement { return <AppStateSubscription showCurrentOnly={true} />; }
      },
      {
        title: 'Previous states:',
        render(): ReactElement { return <AppStateSubscription showCurrentOnly={false} />; }
      },
    ];
上一篇: 应用程序注册表 下一篇: 异步存储