npm 包 react-native-intents 使用教程-JavaScript中文网-JavaScript教程资源分享门户

介绍

react-native-intents 是一个用于 React Native 应用程序的 npm 包，可以用于在 Android 应用程序中启动其他应用程序或使用 Android 应用程序提供的服务。rel="noopener noreferrer"

使用 react-native-intents 可以方便地实现对其他应用程序的交互，例如打电话、发短信、发邮件、打开地图、扫描二维码等。本文将介绍 react-native-intents 的使用方法，并提供示例代码。

安装

使用 npm 进行安装：

npm install react-native-intents

或者使用 yarn：

yarn add react-native-intents

集成

手动集成

在你的项目中，进入 android/app/src/main 目录下，新建文件夹 java/com/reactlibrary/intents。
将 react-native-intents 中的 IntentsModule.java 文件复制到 intents 文件夹下。

在 MainApplication.java 文件中，导入 IntentsModule 类，并将其添加到 getPackages 函数的返回值中。

-- -------------------- ---- -------
------ ---------------------------------------

------ ----- --------------- ------- ----------- ---------- ---------------- -

  -- ---

  ---------
  --------- ------------------ ------------- -
    ---------------------------------------------
    ------------------ -------- - --- --------------------------------
    ---------------- -----------------    -- -- ------------- -
    ------ ---------
  -

  -- ---

-

自动集成

使用 React Native 0.60 及以上版本时，可以使用自动链接进行集成。在项目根目录下运行以下命令：

react-native link react-native-intents

此命令会将 IntentsModule.java 文件添加到你的项目中，并在 MainApplication.java 中自动添加 IntentsPackage。如果你已经手动集成了 IntentsModule.java，则需要在 MainApplication.java 中手动移除重复添加的包。

使用方式

导入库

在需要使用 react-native-intents 的文件中，导入库：

import { Intents } from 'react-native-intents';

检测应用程序是否可用

在启动其他应用程序之前，需要先检测该应用程序是否可用。可用的应用程序包括已安装并且已启动的，或者设备已知并且可以打开的应用程序。使用 Intents.isAppInstalled 函数检测应用程序是否可用，例如检测是否安装了 Google Maps：

Intents.isAppInstalled('com.google.android.apps.maps')
  .then(isInstalled => {
    if(isInstalled) {
      console.log('Google Maps 已安装');
    } else {
      console.log('Google Maps 未安装');
    }
  });

启动其他应用程序

使用 Intents.startActivity 函数启动其他应用程序。该函数接受一个参数对象，包括以下属性：

action：字符串，表示要执行的操作，例如 android.intent.action.CALL 表示拨打电话。
category：字符串数组，表示要用于筛选活动的类别。例如，为了启动一个没有启动任何 Activity 的应用程序，可以使用 category: ['android.intent.category.LAUNCHER']。
type：字符串，表示要传递的 MIME 类型。例如，要启动一个播放音乐的应用程序，可以使用 type: 'audio/*'。
data：字符串，表示要传递的数据。例如，要启动一个地图应用程序并显示一个经纬度位置，可以使用 data: 'geo:37.7749,-122.4194'。
extra：对象，表示要传递的额外信息。例如，要向短信应用程序传递短信内容和收件人号码，可以使用 extra: {sms_body: '你好！', address: '1234567890'}。

例如，启动 Google Maps 并显示指定位置：

var dataUri = 'geo:37.7749,-122.4194';
Intents.startActivity({ data: dataUri })
  .then(() => {
    console.log('Google Maps 启动成功');
  })
  .catch(error => {
    console.log(`启动失败：${error.message}`);
  });

打电话

使用 Intents.startActivity 函数，action 为 android.intent.action.CALL，data 为包含电话号码的 URI 即可。例如，拨打号码为 10000 的电话：

Intents.startActivity({ action: 'android.intent.action.CALL', data: 'tel:10000' });

发短信

使用 Intents.startActivity 函数，action 为 android.intent.action.SENDTO，data 为 smsto 和收件人号码的 URI，extra 中包含短信内容的键值对即可。例如，向号码为 10000 的人发送短信内容为 你好！ 的短信：

Intents.startActivity({ 
  action: 'android.intent.action.SENDTO', 
  data: 'smsto:10000', 
  extra: { sms_body: '你好！' }
});

发邮件

使用 Intents.startActivity 函数，action 为 android.intent.action.SENDTO，data 为 mailto 和接收人的 URI，extra 中包含邮件主题、正文等信息的键值对即可。例如，向邮箱地址为 example@domain.com 的人发送主题为 邮件主题、正文为 邮件正文 的邮件：

Intents.startActivity({
  action: 'android.intent.action.SENDTO', 
  data: 'mailto:example@domain.com',
  extra: { subject: '邮件主题', text: '邮件正文' } 
})

打开地图

使用 Intents.startActivity 函数，data 为包含经纬度信息的 URI 即可。例如，打开经纬度为 (37.7749, -122.4194) 的地图：

var dataUri = 'geo:37.7749,-122.4194';
Intents.startActivity({ data: dataUri });

扫描二维码

使用 Intents.startActivity 函数，action 为 com.google.zxing.client.android.SCAN，extra 可以包含扫描结果返回的键值对。例如，使用 Google Play 中已安装的 QR 码扫描器扫描二维码：

-- -------------------- ---- -------
-------------------------------------------------------------------------- -- -
  ---------------- -
    ----------------- -- -------
    -------
  -
  ----------------------- 
    ------- ---------------------------------------
    ------ - ------------ -------------- - 
  --
    ------------ -- -
      ------------------------------
    --
    ------------ -- -
      -------------------------------------
    ---
---

注意事项

react-native-intents 目前只支持 Android。在 iOS 中使用它将不起作用。
使用 Intents.startActivity 函数时，应该先检测对应应用程序是否可用，否则可能会引发错误。
Intents.startActivity 函数返回一个 Promise 对象，调用时应使用 then() 和 catch() 方法处理返回结果和错误。
在启动其他应用程序时，由于 Android 版本差异较大，不同版本中可能会存在某些行为、参数或权限上的差异。建议先在模拟器或实体设备上测试应用程序，并测试一些边界情况，以确保在所有情况下都能正确地启动其他应用程序。

结论

react-native-intents 提供了一种方便易用的方式，通过它可以方便地在 React Native 应用程序中启动其他应用程序或使用 Android 应用程序提供的服务。本文中介绍了 react-native-intents 的安装、集成和使用方法，并提供了常见用例的代码示例。在实际应用中，读者可以根据自己的需求进行调整和扩展。

来源：JavaScript中文网，转载请注明来源 https://www.javascriptcn.com/post/60055fd881e8991b448dd666