Skip to content

Latest commit

 

History

History
1365 lines (1060 loc) · 51.6 KB

File metadata and controls

1365 lines (1060 loc) · 51.6 KB

十二、添加本机功能——第二部分

在本章中,我们将介绍以下配方:

  • 对应用状态的更改作出反应
  • 复制和粘贴内容
  • 通过触摸 ID 或指纹传感器进行身份验证
  • 多任务处理时隐藏应用内容
  • iOS 上的后台处理
  • Android 的后台处理
  • 在 iOS 上播放音频文件
  • 在 Android 上播放音频文件

介绍

在本章中,我们将继续介绍更多涉及编写与本机 iOS 和 Android 代码交互的 React 本机应用的不同方面的方法。我们将介绍利用内置和社区创建模块的示例应用。这些方法涵盖了一系列主题,从呈现基本按钮到创建不阻塞主应用线程的多线程进程。

对应用状态的更改作出反应

一般移动设备用户都有几个定期使用的应用。理想情况下,除了其他社交媒体应用、游戏、媒体播放器等,用户还将使用您的 React 本机应用。任何特定的用户可能会在每个应用中花费很短的时间,因为他或她可以同时处理多个任务。如果我们想在用户离开我们的应用并重新进入时做出反应,该怎么办?我们可以利用这个机会与服务器同步数据,或者告诉用户我们很高兴看到他们返回,或者礼貌地询问应用商店的评分。

本食谱将涵盖对应用状态变化做出反应的基本知识,即当应用处于前台(活动)、后台或非活动状态时做出反应。

对于这个配方,让我们创建一个名为AppStateApp的全新纯 React 原生应用。

怎么做。。。

  1. 幸运的是,React Native 通过AppState模块提供了监听应用状态变化的支持。让我们通过向App.js文件添加依赖项开始构建应用,如下所示:
import React, { Component } from 'react';
import {
  AppState,
  StyleSheet,
  Text,
  View
} from 'react-native';
  1. 在配方中,我们将跟踪之前的状态,以查看用户来自何处。如果这是他们第一次进入应用,我们会欢迎他们,如果他们回来,我们会欢迎他们回来。为此,我们需要保留对以前和当前应用状态的引用。为此,我们将使用实例变量previousAppStatecurrentAppStates而不是使用状态,只是为了避免潜在的命名混乱。我们将使用state将状态消息保存给用户,如下所示:
export default class App extends Component {
  previousAppState = null;
  currentAppState = 'active';
  state = {
    statusMessage: 'Welcome!'
  }
  // Defined on following steps
}
  1. 当组件挂载时,我们将使用AppState组件向change事件添加事件侦听器。每当应用的状态发生变化时(例如,当应用处于后台状态时),将触发change事件,然后我们将触发handleAppStateChange处理程序,该处理程序在下一步中定义,如下所示:
  componentWillMount() {
    AppState.addEventListener('change', this.handleAppStateChange);
  }
  1. handleAppStateChange方法将接收appState作为参数,我们可以预期它是三个字符串之一:inactive如果应用从内存中卸载,background如果应用在内存中并处于后台,以及active如果应用处于前台。我们将使用switch语句相应地更新state上的statusMessage
  handleAppStateChange = (appState) => {
    let statusMessage;

    this.previousAppState = this.currentAppState;
    this.currentAppState = appState;
    switch(appState) {
      case 'inactive':
        statusMessage = "Good Bye.";
        break;
      case 'background':
        statusMessage = "App Is Hidden...";
        break;
      case 'active':
        statusMessage = 'Welcome Back!'
        break;
    }
    this.setState({ statusMessage });
  }
  1. render方法在本配方中非常基本,因为它只需要向用户显示状态消息,如下所示:
 render() {
    return (
      <View style={styles.container}>
        <Text style={styles.welcome}>
          {this.state.statusMessage}
        </Text>
      </View>
    );
  }
  1. 此应用的样式为基本样式,添加字体大小、颜色和边距,如下所示:
const styles = StyleSheet.create({
  container: {
    flex: 1,
    justifyContent: 'center',
    alignItems: 'center',
    backgroundColor: '#fff',
  },
  welcome: {
    fontSize: 40,
    textAlign: 'center',
    margin: 10,
  },
  instructions: {
    textAlign: 'center',
    color: '#333333',
    marginBottom: 5,
  },
});
  1. 根据给定设备上应用的状态,已完成的应用现在应显示相应的状态消息。

它是如何工作的。。。

在这个配方中,我们使用了内置的AppState模块。该模块在 Android 上监听Activity事件,在 iOS 上使用NSNotificationCenter注册各种UIApplication事件的监听器。注意两个平台都支持activebackground状态;然而,inactive状态是仅限 iOS 的概念。Android 不明确支持inactive状态,因为它实现了多任务,所以只能在backgroundactive状态之间切换应用。要在 Android 上实现与 iOS 非活动状态相同的效果,请参阅本章后面的隐藏应用内容 w**hen 多任务配方。

复制和粘贴内容

桌面和移动操作系统中最常用的功能之一是用于复制和粘贴内容的剪贴板。手机上的一种常见情况是用长文本(如长电子邮件地址或密码)填写表单。与其用几个打字错误来输入,不如打开联系人应用,从那里复制电子邮件并粘贴到TextInput字段中。

这个配方将在 Android 和 iOS 上展示一个基本示例,说明如何在 React 本机应用中复制和粘贴文本。在我们的示例应用中,我们将有一个静态Text视图和一个TextInput字段,您可以使用它将内容复制到剪贴板。此外,还会有一个按钮将剪贴板的内容输出到视图。

准备

对于这个配方,我们将创建一个名为CopyPasteApp的纯 React 本机应用。

在此配方中,我们将再次使用react-native-button。用npm安装:

npm install react-native-button

或者,我们可以使用yarn

yarn add react-native-button

怎么做。。。

  1. 让我们先创建一个ClipboardText组件,它既使用Text组件显示文本,又提供通过长按将其内容复制到剪贴板的功能。让我们在项目的根目录中创建一个component文件夹,并在其中创建一个ClipboardText.js文件。我们将从导入依赖项开始,如下所示:
import React, { Component } from 'react';
import {
  StyleSheet,
  Text,
  View,
  Clipboard,
  TextInput
} from 'react-native';
import Button from 'react-native-button';
  1. 接下来我们将定义App类和初始state。我们将使用state上的clipboardContent属性来存储从剪贴板粘贴到 UI 中的文本,如下所示:
export default class App extends Component {
  state = {
    clipboardContent: null
  }
  // Defined in following steps
}
  1. UI 将有一个Text组件,其文本将通过长按进行复制。让我们定义一下copyToClipboard方法。我们将通过其ref(稍后将定义)获取输入,并通过其props.children属性访问组件的文本。一旦文本存储在局部变量中,我们只需将其传递给ClipboardsetString方法,将文本复制到剪贴板,如下所示:
  copyToClipboard = () => {
    const sourceText = this.refs.sourceText.props.children;
    Clipboard.setString(sourceText);
  }
  1. 类似地,我们还需要一个方法将文本从剪贴板粘贴到应用的 UI 中。此方法将使用ClipboardgetString方法,并将返回的字符串保存到stateclipboardContent属性中,重新呈现应用的 UI 以反映粘贴的文本,如下所示:
  getClipboardContent = async () => {
    const clipboardContent = await Clipboard.getString();
    this.setState({
      clipboardContent
    });
  }
  1. render方法将由两部分组成:第一部分由要复制的内容组成,第二部分是将剪贴板中的文本粘贴到 UI 中的方法。让我们从第一部分开始,它包括一个Text输入,其onLongPress道具连接到我们在步骤 3中创建的copyToClipboard方法,以及一个用于正常本机复制/粘贴的文本输入:
  render() {
    return (
      <View style={styles.container}>
        <Text style={styles.instructions}>
          Tap and Hold the next line to copy it to the Clipboard:
        </Text>
        <Text
          ref="sourceText"
          onLongPress={this.copyToClipboard}
        >
          React Native Cookbook
        </Text>
        <Text style={styles.instructions}>
          Input some text into the TextInput below and Cut/Copy as
          you normally would:
        </Text>
        <TextInput style={styles.textInput} />

        // Defined on next step
      </View>
    );
  }
  1. UI 的第二部分包括一个Text组件,用于在state上显示保存在clipboardContent中的当前值,以及一个按钮,该按钮将使用步骤 4中定义的getClipboardContent方法从剪贴板粘贴:
  render() {
    return (
      <View style={styles.container}>
        // Defined in previous step
 <View style={styles.row}>
 <Text style={styles.rowText}>
 Clipboard Contents:
 </Text>
 </View>
 <View style={styles.row}>
 <Text style={styles.content}>
 {this.state.clipboardContent}
 </Text>
 </View>
 <Button
 containerStyle={styles.buttonContainer}
 style={styles.buttonStyle}
 onPress={this.getClipboardContent}
 >
 Paste Clipboard
 </Button>
      </View>
    );
  }

最终的应用应类似于以下屏幕截图:

它是如何工作的。。。

在此配方中,我们使用 React Native 提供的ClipboardAPI 构建了一个简单的复制粘贴应用。Clipboard模块目前只支持String类型的内容,即使设备可以复制更复杂的数据。此模块使使用剪贴板与调用方法setStringgetString一样简单。

通过触摸 ID 或指纹传感器进行身份验证

安全性是软件中最重要的问题,尤其是当存在任何类型的身份验证时。违规和密码泄露已成为每日新闻周期的一部分,各种规模的公司都希望在其应用中实施额外的安全措施。移动设备中的一个此类措施是生物认证,它使用指纹扫描或人脸识别技术提供补充身份识别方法。

本配方介绍了如何添加指纹扫描和人脸识别安全性。多亏了react-native-touch-id库,在 React 原生应用开发中简化了此过程。

准备

对于这个配方,我们需要一个新的纯 React 原生应用。我们叫它BiometricAuth

我们将使用react-native-buttonreact-native-touch-id库。使用npm安装它们:

npm install react-native-button react-native-touch-id --save

或者,我们可以使用yarn

yarn add react-native-button react-native-touch-id

一旦安装,react-native-touch-id将需要链接,因此请确保跟进:

react-native link

权限也需要手动调整。对于 Android 权限,请在项目中找到AndroidManifest.xml文件,该文件应位于BiometricAuth/android/app/src/main/AndroidManifest.xml。除此文件中的其他权限外,您还需要添加以下权限:

<uses-permission android:name="android.permission.USE_FINGERPRINT" />

对于 iOS 权限,您需要在文本编辑器中更新Info.plist文件。可以在BiometricAuth/ios/BiometricAuth/Info.plist中找到Info.plist。与所有其他条目一起,添加以下内容:

<key>NSFaceIDUsageDescription</key>
<string>Enabling Face ID allows you quick and secure access to your account.</string>

怎么做。。。

  1. 让我们从向App.js文件添加依赖项开始,如下所示:
import React, { Component } from 'react';
import {
  StyleSheet,
  Text,
  View
} from 'react-native';
import Button from 'react-native-button';
import TouchID from 'react-native-touch-id';
  1. 接下来,我们将定义该App类和初始state。我们将跟踪stateauthStatus属性的认证状态,如下所示:
export default class App extends Component {
  state = {
    authStatus: null
  }
  // Defined in following steps
}
  1. 让我们定义authenticate方法,该方法将在按下按钮时触发,并在设备上启动身份验证。我们可以通过执行TouchID组件的authenticate方法来启动身份验证。此方法的第一个参数是解释请求原因的可选字符串,如下所示:
  authenticate = () => {
    TouchID.authenticate('Access secret information!')
      .then(this.handleAuthSuccess)
      .catch(this.handleAuthFailure);
  }
  1. 此方法在成功时触发handleAuthSuccess方法。现在让我们来定义它。此方法只是将stateauthStatus属性更新为字符串Authenticated,如下所示:
  handleAuthSuccess = () => {
    this.setState({
      authStatus : 'Authenticated'
    });
  }
  1. 同样,如果身份验证失败,将调用handleAuthFailure函数,将相同的state.authStatus更新为字符串Not Authenticated,如下所示:
  handleAuthFailure = () => {
    this.setState({
      authStatus : 'Not Authenticated'
    });
  }
  1. render方法将需要一个按钮来启动认证请求,以及两个Text组件:一个用于标签,一个用于显示认证状态,如下所示:
  render() {
    return (
      <View style={styles.container}>
        <Button
          containerStyle={styles.buttonContainer}
          style={styles.button}
          onPress={this.authenticate}>
            Authenticate
        </Button>
        <Text style={styles.label}>Authentication Status</Text>
        <Text style={styles.welcome}>{this.state.authStatus}</Text>
      </View>
    );
  }
  1. 最后,我们将为 UI 的颜色、大小和布局添加样式,如下所示:
const styles = StyleSheet.create({
  container: {
    flex: 1,
    justifyContent: 'center',
    alignItems: 'center',
    backgroundColor: '#fff',
  },
  welcome: {
    fontSize: 20,
    textAlign: 'center',
    margin: 10,
  },
  label: {
    textAlign: 'center',
    color: '#333333',
    marginBottom: 5,
  },
  buttonContainer: {
    width: 150,
    padding: 10,
    margin: 5,
    height: 40,
    overflow: 'hidden',
    backgroundColor: '#FF5722'
  },
  button: {
    fontSize: 16,
    color: 'white'
  }
});

它是如何工作的。。。

此配方说明了将本机指纹和面部识别安全性集成到 React 本机应用中是多么简单。对TouchID.authenticate的调用还需要第二个可选选项对象参数,该参数具有三个属性:title表示确认对话框的标题(仅限 Android)、color表示对话框的颜色(仅限 Android)以及fallbackLabel用于编辑默认显示密码标签(仅限 iOS)。

多任务处理时隐藏应用内容

为了保持应用安全的主题,我们有时必须警惕不必要的眼睛和手触摸我们的设备并可能访问我们的应用。为了保护用户在查看敏感信息时免受窥探,我们可以在应用隐藏但仍处于活动状态时屏蔽应用。一旦用户返回应用,我们只需移除掩码,用户就可以继续正常使用该应用。这方面的一个很好的用例是在银行或密码应用中,当应用不在前台时隐藏敏感信息。

此配方将向您展示如何渲染图像以屏蔽应用,并在应用返回前台或活动状态后将其删除。我们将涵盖 iOS 和 Android;然而,整个实施过程各不相同。对于 iOS,我们采用纯 Objective-C 实现以获得最佳性能。对于 Android,我们必须对MainActivity进行一些修改,以便向 JavaScript 层发送应用失去焦点的事件。我们将在那里处理图像遮罩的渲染。

准备

我们将需要一个图像方便地使用作为遮罩时,应用不是前景。我选择使用 iPhone 壁纸,您可以在以下网址找到:

http://www.hdiphone7wallpapers.com/2016/09/white-squares-iphone-7-and-7-plus-wallpapers.html

图像是一种风格化的马赛克图案。看起来是这样的:

你当然可以使用任何你喜欢的图像。在此配方中,图像文件将被命名为hidden.jpg,因此相应地重命名您的图像。

我们需要一个新的纯 React 本地应用。我们叫它HiddenContentApp

怎么做。。。

  1. 让我们首先将掩码图像添加到应用的 iOS 部分。我们需要在 Xcode 中打开项目的ios文件夹,该文件夹位于新 React 本机应用的ios/目录中。
  2. 我们可以通过在 Xcode 中将hidden.jpg图像拖放到项目的Images.xcassets文件夹中,将hidden.jpg图像添加到项目中,如图所示:

  1. 接下来,我们将向AppDelegate.m文件添加一个新的实现和两个方法。该文件的全部内容如下所示,包括生成的代码。为了清晰起见,我们正在添加的代码用粗体标记。我们正在扩展applicationWillResignActive方法,该方法将在给定应用从前景化更改为前景化时触发,以添加一个以hidden.jpg为图像的imageView。同样,我们还需要扩展相反的方法applicationDidBecomeActive,在应用重新前景化时移除图像:
#import "AppDelegate.h"

#import <React/RCTBundleURLProvider.h>
#import <React/RCTRootView.h>

@implementation AppDelegate {
 UIImageView *imageView;
}

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
  NSURL *jsCodeLocation;

  jsCodeLocation = [[RCTBundleURLProvider sharedSettings] jsBundleURLForBundleRoot:@"index" fallbackResource:nil];

  RCTRootView *rootView = [[RCTRootView alloc] initWithBundleURL:jsCodeLocation
                                                      moduleName:@"HiddenContentApp"
                                               initialProperties:nil
                                                   launchOptions:launchOptions];
  rootView.backgroundColor = [[UIColor alloc] initWithRed:1.0f green:1.0f blue:1.0f alpha:1];

  self.window = [[UIWindow alloc] initWithFrame:[UIScreen mainScreen].bounds];
  UIViewController *rootViewController = [UIViewController new];
  rootViewController.view = rootView;
  self.window.rootViewController = rootViewController;
  [self.window makeKeyAndVisible];
  return YES;
}

- (void)applicationWillResignActive:(UIApplication *)application {
 imageView = [[UIImageView alloc] initWithFrame:[self.window frame]];
 [imageView setImage:[UIImage imageNamed:@"hidden.jpg"]];
 [self.window addSubview:imageView];
}

- (void)applicationDidBecomeActive:(UIApplication *)application {
 if(imageView != nil) {
 [imageView removeFromSuperview];
 imageView = nil;
 }
}

@end
  1. 通过前面的三个步骤,在 iOS 应用中显示掩码所需的所有工作都已完成。让我们在 Android Studio 中打开项目的 Android 部分,继续讨论 Android 部分。在 Android Studio 中,选择打开现有的 Android Studio 项目,并打开该项目的android目录。

  2. 我们需要在 Android 项目中更新的唯一本地代码位于MainActivity.java,位于以下位置:

我们需要添加一个方法,以及该方法使用的从 React 导入的三个方法。同样,完整的MainActivity.java文件如下,添加的代码用粗体标记。我们正在定义一个扩展基本方法功能的onWindowFocusChanged方法。只要给定应用的焦点发生变化,就会触发基本的onWindowFocusChangedAndroid 方法,并传递一个表示该应用是否有焦点的hasFocus布尔值。我们的扩展将通过一个我们命名为focusChange的事件,有效地将hasFocus布尔值从父方法传递到 React 本机层,如下所示:

package com.hiddencontentapp;

import com.facebook.react.ReactActivity;
import com.facebook.react.bridge.Arguments;
import com.facebook.react.bridge.WritableMap;
import com.facebook.react.modules.core.DeviceEventManagerModule;

public class MainActivity extends ReactActivity {

  /**
  * Returns the name of the main component registered from JavaScript.
  * This is used to schedule rendering of the component.
  */
  @Override
  protected String getMainComponentName() {
    return "HiddenContentApp";
  }

 @Override
 public void onWindowFocusChanged(boolean hasFocus) {
 super.onWindowFocusChanged(hasFocus);
 if (getReactNativeHost().getReactInstanceManager().getCurrentReactContext() != null) {
 WritableMap params = Arguments.createMap();
 params.putBoolean("appHasFocus", hasFocus);

 getReactNativeHost().getReactInstanceManager()
 .getCurrentReactContext()
 .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter.class)
 .emit("focusChange", params);
 }
 }
}
  1. 要在 Android 中使用hidden.jpg掩码图像,我们还需要将其添加到 React 原生项目中。让我们在 React 原生项目的根目录中创建一个新的assets文件夹,并将hidden.jpg图像文件添加到新文件夹中。
  2. 有了本机部分,我们就可以转向应用的 JavaScript 部分了。让我们将要使用的导入添加到App.js,如下所示:
import React, {Component} from 'react';
import {
  StyleSheet,
  Text,
  View,
  DeviceEventEmitter,
  Image
} from 'react-native';
  1. 接下来,让我们创建App类和首字母statestate只需要一个showMask布尔值,它将指示是否应显示掩码,如下所示:
export default class App extends Component {
  state = {
    showMask: null
  }
  // Defined in following steps
}
  1. 当组件挂载时,我们希望注册一个事件监听器,以使用DeviceEventEmitteraddListener方法侦听从本机 Android 层发出的事件,将字符串focusChange作为要侦听的事件的名称作为第一个参数传递,并将回调作为第二个参数执行。您可能还记得,focusChange是我们在*步骤 5 的onWindowFocusChange方法中为MainActivity.java中的事件分配的名称。*注册事件侦听器,如下所示:
  componentWillMount() {
    this.subscription = DeviceEventEmitter.addListener(
      'focusChange',
      this.onFocusChange
    );
  }
  1. 在此步骤中,我们将事件侦听器保存到类成员this.subscription。这将允许在卸载组件后清理事件侦听器。我们通过componentWillUnmount生命周期钩子在组件卸载时调用this.subscription上的remove方法来实现这一点,如下所示:
  componentWillUnmount() {
    this.subscription.remove();
  }
  1. 让我们定义步骤 9中使用的onFocusChange处理程序。该方法接收一个带有appHasFocus布尔值的params对象,该布尔值通过步骤 5中定义的onWindowFocusChanged方法从本机层传递。通过将state上的showMask布尔值设置为appHasFocus布尔值的倒数,我们可以在render函数中使用该值切换显示hidden.jpg图像,如下所示:
  onFocusChange = (params) => {
    this.setState({showMask: !params.appHasFocus})
  }
  1. render方法的主要内容在本配方中并不重要,但当showMask状态属性为true时,我们可以使用它应用hidden.jpg掩模图像,如下所示:
  render() {
    if(this.state.showMask) {
      return (<Image source={require('./img/hidden.jpg')} />);
    }
    return (
      <View style={styles.container}>
        <Text style={styles.welcome}>Welcome to React Native!</Text>
      </View>
    );
  }
  1. 应用已完成。加载应用后,您应该能够进入应用选择视图(在 iOS 上双击 home,或在 Android 上按下 square 按钮),并在应用未预先固定时查看应用于应用的掩码图像。请注意,Android 模拟器可能无法按预期正确应用掩码,因此此功能可能需要 Android 设备进行测试:

它是如何工作的。。。

在这个配方中,我们看到了一个必须使用两种不同方法来完成相同任务的示例。对于 iOS,我们只在本机层中显示图像掩码,而不需要 React 本机层。对于 Android,我们使用 React Native 来处理图像屏蔽。

步骤 3中,我们扩展了两种 Objective-C 方法:applicationWillResignActive在应用从前景化更改时触发,以及applicationDidBecomeActive在应用前景化时触发。对于每个事件,我们只需切换一个显示 Xcode 项目中Images.xcassettes文件夹中hidden.jpg图像存储的imageView

步骤 5中,我们使用DeviceEventManagerModule中的 React 类RCTDeviceEventEmitter发出一个名为focusChange的事件,将带有appHasFocus布尔值的params对象传递给 React 本机层,如下所示:

     getReactNativeHost().getReactInstanceManager()
       .getCurrentReactContext()
       .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter.class)
       .emit("focusChange", params);
     }

步骤 9中,我们定义了componentWillMount生命周期钩子,它为本机 Android 层发出的focusChange事件设置一个事件监听器,触发onFocusChange方法,该方法将根据本机appHasFocus值更新stateshowMask值,触发重新渲染,根据需要显示遮罩

iOS 上的后台处理

在过去几年中,移动设备的处理能力有了很大的提高。用户要求更丰富的体验,在现代移动设备上实现更高性能的一种方法是通过多线程。当今大多数移动设备都由多核处理器提供动力,它们的操作系统现在为开发人员提供了在后台执行代码的简单抽象,不会影响应用 UI 的性能。

此方法将包括使用 iOS 的Grand Central DispatchGCD)在新线程上执行异步后台处理,以及在处理完成后与 React 本机层通信。

准备

对于这个配方,我们需要一个新的纯 React 本机应用。让我们把它命名为MultiThreadingApp

我们还将使用react-native-button库。用npm安装:

npm install react-native-button --save

或者,我们可以使用yarn

yarn add react-native-button --save

怎么做。。。

  1. 我们将首先在 Xcode 中打开 iOS 项目,该项目位于新 React 本机应用的ios目录中。
  2. 让我们添加一个名为NSObject子类的BackgroundTaskManager的新 Cocoa 类文件。有关在 Xcode 中执行此操作的更多详细信息,请参阅本章中的公开定制 iOS 模块配方。
  3. 接下来,让我们将新模块连接到新模块头文件BackgroundTaskManager.h中的 ReactRCTBrideModule。要添加的代码在以下代码段中以粗体标记:
#import <Foundation/Foundation.h>
#import <dispatch/dispatch.h>
#import "RCTBridgeModule.h"

@interface BackgroundTaskManager : NSObject <RCTBridgeModule> {
 dispatch_queue_t backgroundQueue;
}

@end
  1. 我们将在BackgroundTaskManager.m文件中实现本机模块。同样,我们要添加的新代码在以下代码段中以粗体标记:
#import "BackgroundTaskManager.h"
#import "RCTBridge.h"
#import "RCTEventDispatcher.h"

@implementation BackgroundTaskManager

@synthesize bridge = _bridge;

RCT_EXPORT_MODULE();

RCT_EXPORT_METHOD(loadInBackground) {
 backgroundQueue = dispatch_queue_create("com.moduscreate.bgqueue", NULL);

 dispatch_async(backgroundQueue, ^{
 NSLog(@"processing background");
 [self.bridge.eventDispatcher sendAppEventWithName:@"backgroundProgress" body:@{@"status": @"Loading"}];
 [NSThread sleepForTimeInterval:5];
 NSLog(@"slept");
 dispatch_async(dispatch_get_main_queue(), ^{
 NSLog(@"Done processing; main thread");
 [self.bridge.eventDispatcher sendAppEventWithName:@"backgroundProgress" body:@{@"status": @"Done"}];
 });
 });
}

@end
  1. 接下来让我们转到 JavaScript 层。我们将首先向App.js文件添加依赖项。作为依赖项的一部分,我们还需要导入步骤 3步骤 4中定义的BackgroundTaskManager本机模块,如下所示:
import React, { Component } from 'react';
import {
  StyleSheet,
  Text,
  View,
  NativeModules,
  NativeAppEventEmitter
} from 'react-native';
import Button from 'react-native-button'; 

const BackgroundTaskManager = NativeModules.BackgroundTaskManager;
  1. 让我们定义App类,初始状态backgroundTaskStatus设置为字符串Not Started,属性doNothingCount初始化为0,如下所示:
 export default class App extends Component {
  state = {
    backgroundTaskStatus: 'Not Started',
    counter: 0
  }
  // Defined in following steps
}
  1. 我们需要监听步骤 3步骤 4中创建的自定义模块从本机 iOS 层发出的backgroundProcess事件。让我们使用NativeAppEventEmitterReact Native 组件设置一个事件侦听器,该组件将statebackgroundTaskStatus属性设置为从本机事件接收的事件对象上的status值,如下所示:
  componentWillMount = () => {
    this.subscription = NativeAppEventEmitter.addListener(
      'backgroundProgress',
      event => this.setState({ backgroundTaskStatus: event.status })
    );
  }
  1. 当组件卸载时,我们需要从上一步中删除事件侦听器,如下所示:
  componentWillUnmount = () => {
    this.subscription.remove();
  }
  1. UI 将有两个按钮,每个按钮在按下时都需要调用一个方法。runBackgroundTask将运行我们在BackgroundTaskManager自定义本机模块上从本机 iOS 层定义并导出的loadInBackground方法。increaseCounter按钮只需将state上的counter属性增加1,用于显示主线程如何未被阻塞,如下所示:
  runBackgroundTask = () => {
    BackgroundTaskManager.loadInBackground();
  }

  increaseCounter = () => {
    this.setState({
      counter: this.state.counter + 1
    });
  }
  1. 应用的 UI 将包括两个按钮,用于显示Button组件,以及一个Text组件,用于显示保存在state上的值。运行任务按钮将执行runBackgroundTask方法启动后台进程,this.state.backgroundTaskStatus将更新以显示进程的新状态。在后台进程运行的 5 秒钟内,按下增加计数器按钮仍会将计数器增加1,表明后台进程是非阻塞的,如以下代码段所示:
  render() {
    return (
      <View style={styles.container}>
        <Button
          containerStyle={styles.buttonContainer}
          style={styles.buttonStyle}
          onPress={this.runBackgroundTask}>
            Run Task
        </Button>
        <Text style={styles.instructions}>
          Background Task Status:
        </Text>
        <Text style={styles.welcome}>
          {this.state.backgroundTaskStatus}
        </Text>
        <Text style={styles.instructions}>
          Pressing "Increase Conter" button shows that the task is
          not blocking the main thread
        </Text>
        <Button
          containerStyle={[
            styles.buttonContainer,
            styles.altButtonContainer
          ]}
          style={styles.buttonStyle}
          onPress={this.increaseCounter}
        >
            Increase Counter
        </Button>
        <Text style={styles.instructions}>
          Current Count:
        </Text>
        <Text style={styles.welcome}>
          {this.state.counter}
        </Text>
      </View>
    );
  }
  1. 最后一步,让我们使用 styles 块对应用进行布局和样式设置,如下所示:
const styles = StyleSheet.create({
  container: {
    flex: 1,
    justifyContent: 'center',
    alignItems: 'center',
    backgroundColor: '#F5FCFF',
  },
  welcome: {
    fontSize: 20,
    textAlign: 'center',
    margin: 10,
  },
  instructions: {
    textAlign: 'center',
    color: '#333333',
    marginBottom: 5,
    marginLeft: 20,
    marginRight: 20
  },
  buttonContainer: {
    width: 150,
    padding: 10,
    margin: 5,
    height: 40,
    overflow: 'hidden',
    borderRadius: 4,
    backgroundColor: '#FF5722'
  },
  altButtonContainer : {
    backgroundColor : '#CDDC39',
    marginTop : 30
  },
  buttonStyle: {
    fontSize: 16,
    color: 'white'
  }
});

它是如何工作的。。。

在这个配方中,我们创建了一个本机模块,类似于本章前面的公开定制 iOS 模块配方中介绍的模块。我们定义了本机模块以在 React 本机应用的后台执行任意执行。在此配方中,后台流程由以下三个步骤组成:

  1. 产生一个新线程。
  2. 在新线程上睡眠五秒钟。
  3. 在五秒钟的睡眠(模拟正在运行的后台进程的结束)之后,一个事件从 iOS 层发送到 React 本机层,让它知道进程已经完成。这是通过操作系统的 GCD API 完成的。

此应用中 UI 的目的是展示已经实现了多线程。如果后台进程是在 React 原生层执行的,那么由于 JavaScript 的单线程特性,当该进程运行时,应用会被锁定五秒钟。当您按下按钮时,将调用网桥,从而可以将消息发布到本机层。如果本机线程当前正忙于睡眠,则无法处理此消息。通过将该处理卸载到新线程,可以同时执行这两个线程。

Android 的后台处理

在这个配方中,我们将构建一个与上一个配方相当的 Android。该配方还将使用本机 Android 层创建一个新进程,通过睡眠五秒钟保持该进程运行,并允许用户通过按钮进行交互,以显示应用的主处理线程未被阻塞。

虽然最终结果将非常相同,但在 Android 项目中生成新流程的处理方式与 iOS 稍有不同。此方法将使用本机AsyncTask函数,专门用于处理短时间运行的后台进程,以允许在 React 本机层中执行,而不会阻塞主线程。

准备

对于这个配方,我们需要创建一个新的纯 React 原生应用。让我们把它命名为MultiThreadingApp

我们还将使用react-native-button图书馆。用npm安装:

npm install react-native-button --save

或者,我们可以使用yarn

yarn add react-native-button

怎么做。。。

  1. 让我们首先在 Android Studio 中打开 Android 项目。在 Android Studio 中,选择打开现有的 Android Studio 项目,并打开新项目的android目录。
  2. 我们需要两个新的 Java 类:BackgroundTaskManagerBackgroundTaskPackage
  3. 既然已经创建了两个类,那么让我们打开BackgroundTaskManager.java并开始实现本机模块,该模块将封装AsyncTask操作,从导入开始并定义类。此外,与任何其他原生 Android 模块一样,我们需要定义getName方法,用于为 React native 提供模块名称,如下所示:
package com.multithreadingapp;

import android.os.AsyncTask;

import com.facebook.react.bridge.Arguments;
import com.facebook.react.bridge.ReactApplicationContext;
import com.facebook.react.bridge.ReactContextBaseJavaModule;
import com.facebook.react.bridge.ReactMethod;
import com.facebook.react.bridge.WritableMap;
import com.facebook.react.modules.core.DeviceEventManagerModule;

public class BackgroundTaskManager extends ReactContextBaseJavaModule {
  public BackgroundTaskManager(ReactApplicationContext reactApplicationContext) {
    super(reactApplicationContext);
  }

  @Override
  public String getName() {
    return "BackgroundTaskManager";
  }

  // Defined in following steps
}
  1. 为了执行一个AsyncTask,它需要被一个私有类子类化。我们需要为此添加一个新的私有内部BackgroundLoadTask子类。在定义它之前,让我们首先添加一个loadInBackground方法,该方法最终将导出到 React 本机层。此方法只是创建一个新的BackgroundLoadTask实例并调用其execute方法,如下所示:
public class BackgroundTaskManager extends ReactContextBaseJavaModule {
 // Defined in previous step
  @ReactMethod
 public void loadInBackground() {
 BackgroundLoadTask backgroundLoadTask = new BackgroundLoadTask();
 backgroundLoadTask.execute();
 }
}
  1. BackgroundLoadTask子类还将使用一个 helper 函数在 React 本机网桥上来回发送事件,以传达后台进程的状态。sendEvent方法将eventNameparams作为参数,然后使用 React Native 的RCTDeviceEventEmitter类来emit事件,如下所示:
public class BackgroundTaskManager extends ReactContextBaseJavaModule {
  // Defined in steps above

 private void sendEvent(String eventName, WritableMap params) {
 getReactApplicationContext().getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter.class).emit(eventName, params);
 }
}
  1. 现在让我们继续定义扩展了AsyncTaskBackgroundLoadTask子类。子类将由三种方法组成:doInBackground用于旋转新线程并使其休眠五分钟;onProgressUpdate用于向 React Native 层发送"Loading"状态;onPostExecute用于在后台任务完成后发送"Done"状态,如下所示:
public class BackgroundTaskManager extends ReactContextBaseJavaModule {
  // Defined in above steps

 private class BackgroundLoadTask extends AsyncTask<String, String, String> {
 @Override
 protected String doInBackground(String... params) {
 publishProgress("Loading");
 try {
 Thread.sleep(5000);
 } catch (Exception e) {
 e.printStackTrace();
 }
 return "Done";
 }

 @Override
 protected void onProgressUpdate(String... values) {
 WritableMap params = Arguments.createMap();
 params.putString("status", "Loading");
 sendEvent("backgroundProgress", params);
 }

 @Override
 protected void onPostExecute(String s) {
 WritableMap params = Arguments.createMap();
 params.putString("status", "Done");
 sendEvent("backgroundProgress", params);
 }
 }
}
  1. 由于 iOS 实现和 Android 实现的唯一区别在于配方的本机层,因此您可以按照前面配方的步骤 5步骤 11来实现应用的 JavaScript 部分。

  2. 最终的应用的行为和外观(除了设备上的差异)应与上一个配方中的应用相同:

它是如何工作的。。。

在这个配方中,我们模仿了我们在 Android 上 iOS 配方的后台处理中创建的功能。我们创建了一个 Android 本机模块,其中包含一个方法,当调用该方法时,它会在后台执行任意执行(睡眠 5 秒钟)。当流程完成时,它会向 React 原生层发出一个事件,然后我们更新 appui 以反映后台流程的状态。Android 有多个本机执行多线程操作的选项。在这个配方中,我们使用了AsyncTask,因为它面向短时间运行(几秒钟)的进程,所以实现起来相对简单,操作系统为我们管理线程创建和资源分配。有关AsyncTask的更多信息,请访问官方文档:

https://developer.android.com/reference/android/os/AsyncTask

在 iOS 上播放音频文件

章节实现复杂用户界面–第三部分中,我们介绍了在中构建一个相对复杂的小型音频播放器,使用 Expo SDK 提供的Audio组件创建音频播放器配方。然而,Expo 的Audio组件的一个缺点是,当应用处于后台时,它不能用于播放音频。使用本机层是目前实现这一点的唯一方法。

在此配方中,我们将创建一个本机模块来显示 iOS MediaPicker,然后选择要播放的音乐文件。所选文件将通过本机 iOS 媒体播放器播放,该播放器允许在应用后台播放音频,并允许用户通过本机 iOS 控制中心控制音频。

准备

对于这个配方,我们需要创建一个新的纯 React 原生应用。我们叫它AudioPlayerApp

我们还将使用react-native-button库,它可以与npm一起安装:

npm install react-native-button --save

或者,我们可以使用yarn

yarn add react-native-button

这是一个只能在真实设备上使用的配方。您还需要确保已将音乐同步到 iOS 设备并可在媒体库中使用。

怎么做。。。

  1. 让我们首先在 Xcode 中打开 iOS 项目,该项目位于新 React 本机应用的ios目录中。
  2. 接下来,我们将创建一个名为MediaManager的新 Objective-C Cocoa 类。
  3. MediaManager头(.h文件中,我们需要导入MPMediaPickerControllerMPMusicPlayerController,以及 React 原生桥(RCTBridgeModule,如下所示:
#import <Foundation/Foundation.h>
#import <MediaPlayer/MediaPlayer.h>

#import <React/RCTBridgeModule.h>
#import <React/RCTEventDispatcher.h>

@interface MediaManager : NSObject<RCTBridgeModule, MPMediaPickerControllerDelegate>

@property (nonatomic, retain) MPMediaPickerController *mediaPicker;
@property (nonatomic, retain) MPMusicPlayerController *musicPlayer;

@end
  1. 首先,我们需要在MediaManager实现(MediaManager.m中添加本机MediaPicker。第一种方法是显示和隐藏MediaPickershowMediaPickerhideMediaPicker,如下所示:
#import "MediaManager.h"
#import "AppDelegate.h"

@implementation MediaManager
RCT_EXPORT_MODULE();

@synthesize bridge = _bridge;
@synthesize musicPlayer;

#pragma mark private-methods

-(void)showMediaPicker {
 if(self.mediaPicker == nil) {
 self.mediaPicker = [[MPMediaPickerController alloc] initWithMediaTypes:MPMediaTypeAnyAudio];

 [self.mediaPicker setDelegate:self];
 [self.mediaPicker setAllowsPickingMultipleItems:NO];
 [self.mediaPicker setShowsCloudItems:NO];
 self.mediaPicker.prompt = @"Select song";
 }

 AppDelegate *delegate = (AppDelegate *)[[UIApplication sharedApplication] delegate];

 [delegate.window.rootViewController presentViewController:self.mediaPicker animated:YES completion:nil];
}

void hideMediaPicker() {
 AppDelegate *delegate = (AppDelegate *)[[UIApplication sharedApplication] delegate];
 [delegate.window.rootViewController dismissViewControllerAnimated:YES completion:nil];
}

// Defined on following steps

@end
  1. 接下来,我们将实现mediaPicker需要的两个操作:didPickMediaItems用于拾取媒体项,以及mediaPickerDidCancel用于取消操作,如下所示:
-(void) mediaPicker:(MPMediaPickerController *)mediaPicker didPickMediaItems:(MPMediaItemCollection *)mediaItemCollection {
  MPMediaItem *mediaItem = mediaItemCollection.items[0];
  NSURL *assetURL = [mediaItem valueForProperty:MPMediaItemPropertyAssetURL];

  [self.bridge.eventDispatcher sendAppEventWithName:@"SongPlaying"
                                               body:[mediaItem valueForProperty:MPMediaItemPropertyTitle]];

  if(musicPlayer == nil) {
    musicPlayer = [MPMusicPlayerController systemMusicPlayer];
  }

  [musicPlayer setQueueWithItemCollection:mediaItemCollection];
  [musicPlayer play];

  hideMediaPicker();
}

-(void) mediaPickerDidCancel:(MPMediaPickerController *)mediaPicker {
  hideMediaPicker();
}
  1. 接下来,我们需要将我们的MediaManager暴露给 React 本机网桥,并创建一个将被调用以显示MediaPicker的方法,如下所示:
RCT_EXPORT_MODULE(); 
RCT_EXPORT_METHOD(showSongs) { 
  [self showMediaPicker]; 
} 
  1. 我们已经准备好进入 JavaScript 部分。让我们从向App.js添加依赖项开始。我们还需要使用NativeModules组件将步骤 3中创建的MediaManager本机模块导入步骤 6,如下所示:
import React, { Component } from 'react';
import {
  StyleSheet,
  Text,
  View,
  NativeModules,
  NativeAppEventEmitter
} from 'react-native';
import Button from 'react-native-button';
const MediaManager = NativeModules.MediaManager;
  1. 让我们定义App类和初始statecurrentSong属性将保存当前播放歌曲的曲目信息,如从本机层传递的,如下所示:
export default class App extends Component {
  state = {
    currentSong: null
  }

  // Defined on following steps
}
  1. 当组件挂载时,我们将订阅SongPlaying事件,当歌曲开始播放时,该事件将从本机层发出。我们将把事件监听器保存到一个本地subscription类变量中,以便在组件卸载时使用remove方法清理它,如下所示:
  componentWillMount() {
    this.subscription = NativeAppEventEmitter.addListener(
      'SongPlaying',
      this.updateCurrentlyPlaying
    );
  }

  componentWillUnmount = () => {
    this.subscription.remove();
  }
  1. 我们还需要更新statecurrentSong值的方法,以及在步骤 3步骤 6中定义的本机MediaManager模块上调用showSongs方法的方法,如下所示:
  updateCurrentlyPlaying = (currentSong) => {
    this.setState({ currentSong });
  }

  showSongs() {
    MediaManager.showSongs();
  }
  1. render方法将由一个Button组件组成,用于在按下时执行showSongs方法,以及Text组件用于显示当前播放的歌曲的信息,如下所示:
  render() {
    return (
      <View style={styles.container}>
        <Button
          containerStyle={styles.buttonContainer}
          style={styles.buttonStyle}
          onPress={this.showSongs}>
            Pick Song
        </Button>
        <Text style={styles.instructions}>Song Playing:</Text>
        <Text style={styles.welcome}>{this.state.currentSong}</Text>
      </View>
    );
  }
  1. 最后,我们将添加应用布局和样式的样式,如下所示:
const styles = StyleSheet.create({
  container: {
    flex: 1,
    justifyContent: 'center',
    alignItems: 'center',
    backgroundColor: '#F5FCFF',
  },
  welcome: {
    fontSize: 20,
    textAlign: 'center',
    margin: 10,
  },
  instructions: {
    textAlign: 'center',
    color: '#333333',
    marginBottom: 5,
  },
  buttonContainer: {
    width: 150,
    padding: 10,
    margin: 5,
    height: 40,
    overflow: 'hidden',
    borderRadius: 4,
    backgroundColor: '#3B5998'
  },
  buttonStyle: {
    fontSize: 16,
    color: '#fff'
  }
});

它是如何工作的。。。

在本食谱中,我们介绍了如何在 iOS 中使用媒体播放器,方法是将其功能包装在本机模块中。media player 框架允许我们访问本机 iPod 库,并使用与本机 iOS 音乐应用相同的功能在设备上播放库中的音频文件。

在 Android 上播放音频文件

谷歌喜欢宣称 Android 相对于 iOS 的一个好处是在处理文件存储方面的灵活性。Android 设备支持可以填充媒体文件的外部 SD 卡,不需要像 iOS 那样使用专有方法添加多媒体。

在这个食谱中,我们将使用 Android 的原生MediaPicker,它是从一个意图开始的。然后,我们将能够选择一首歌曲,并通过我们的应用播放它。

准备

对于这个配方,我们将创建一个名为AudioPlayer的 React 本机应用。

在这个配方中,我们将使用react-native-button库。要安装它,请从项目根目录在终端中运行以下命令:

 $ npm install react-native-button --save

确保 Android 设备或仿真器的Music/目录中有可用的音乐文件。

怎么做。。。

  1. 让我们从使用 Android Studio 打开 Android 项目开始。在 Android Studio 中,选择打开现有的 Android Studio 项目,并打开该项目的android目录。

  2. 我们需要两个新的 Java 类来制作这个配方:MediaManagerMediaPackage

  3. 我们的MediaManager将使用意图显示mediaPickerMediaPlayer播放音乐、MediaMetadataRetriever解析音频文件中的元数据信息并发送回 JavaScript 层。让我们从导入MediaManager.java文件中需要的所有依赖项开始,如下所示:

import android.app.Activity;
import android.content.Intent;
import android.media.AudioManager;
import android.media.MediaMetadataRetriever;
import android.media.MediaPlayer;
import android.net.Uri;
import android.provider.MediaStore;

import com.facebook.react.bridge.ActivityEventListener;
import com.facebook.react.bridge.Arguments;
import com.facebook.react.bridge.ReactApplicationContext;
import com.facebook.react.bridge.ReactContextBaseJavaModule;
import com.facebook.react.bridge.ReactMethod;
import com.facebook.react.bridge.WritableMap;
import com.facebook.react.modules.core.DeviceEventManagerModule;
  1. showSongsgetNameplaySongmediaPlayeronActivityResultmediaMetadataRetreiverSongPlaying应采用代码格式。替换为:
public class MediaManager extends ReactContextBaseJavaModule implements ActivityEventListener {
  private MediaPlayer mediaPlayer = null;
  private MediaMetadataRetriever mediaMetadataRetriever = null;

  public MediaManager(ReactApplicationContext reactApplicationContext) {
    super(reactApplicationContext);
    reactApplicationContext.addActivityEventListener(this);
  }

  @Override
  public String getName() {
    return "MediaManager";
  }

  @Override
  public void onCatalystInstanceDestroy() {
    super.onCatalystInstanceDestroy();
    mediaPlayer.stop();
    mediaPlayer.release();
    mediaPlayer = null;
  }

  @ReactMethod
  public void showSongs() {
    Activity activity = getCurrentActivity();
    Intent intent = new Intent(Intent.ACTION_PICK, MediaStore.Audio.Media.EXTERNAL_CONTENT_URI);
    activity.startActivityForResult(intent, 10);
  }

  @Override
  public void onActivityResult(Activity activity, int requestCode, int resultCode, Intent data) {
    if (data != null) {
      playSong(data.getData());
    }
  }

  @Override
  public void onNewIntent(Intent intent) {
  }

  private void playSong(Uri uri) {
    try {
      if (mediaPlayer != null) {
        mediaPlayer.stop();
        mediaPlayer.reset();
      } else {
        mediaMetadataRetriever = new MediaMetadataRetriever();
        mediaPlayer = new MediaPlayer();
        mediaPlayer.setAudioStreamType(AudioManager.STREAM_MUSIC);
      }

      mediaPlayer.setDataSource(getReactApplicationContext(), uri);

      mediaPlayer.prepare();
      mediaPlayer.start();

      mediaMetadataRetriever.setDataSource(getReactApplicationContext(), uri);
      String artist = mediaMetadataRetriever.extractMetadata(MediaMetadataRetriever.METADATA_KEY_ARTIST);
      String songTitle = mediaMetadataRetriever.extractMetadata(MediaMetadataRetriever.METADATA_KEY_TITLE);

      WritableMap params = Arguments.createMap();
      params.putString("songPlaying", artist + " - " + songTitle);

      getReactApplicationContext()
        .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter.class)
        .emit("SongPlaying", params);
    } catch (Exception ex) {
      ex.printStackTrace();
    }
  }
}
  1. 自定义模块还需要添加到MainApplication.java文件中的getPackages数组中,如下所示:
    protected List<ReactPackage> getPackages() {
      return Arrays.<ReactPackage>asList(
          new MainReactPackage(),
 new MediaPackage()
      );
    }
  1. 正如本章前面的公开定制 Android 模块配方中所述,我们必须向MediaPackage.java添加必要的样板文件,以便将我们的MediaManager定制模块导出到 React 本机层。请参考该配方以获得更全面的解释。添加必要的样板,如下所示:
import com.facebook.react.ReactPackage;
import com.facebook.react.bridge.NativeModule;
import com.facebook.react.bridge.ReactApplicationContext;
import com.facebook.react.uimanager.ViewManager;

import java.util.ArrayList;
import java.util.Collections;
import java.util.List;

public class MediaPackage implements ReactPackage {
  @Override
  public List<ViewManager> createViewManagers(ReactApplicationContext reactContext) {
    return Collections.emptyList();
  }

  @Override
  public List<NativeModule> createNativeModules(ReactApplicationContext reactContext) {
    List<NativeModule> modules = new ArrayList<>();

    modules.add(new MediaManager(reactContext));

    return modules;
  }
}
  1. Android 应用的 JavaScript 层与之前的 iOS 配方中的 JavaScript 层相同。使用此配方的步骤 7步骤 12完成应用的最后部分。