@capacitor/app-launcher

AppLauncher API 使您的应用能够检查并打开其他应用程序。

在 iOS 平台，您只能通过已知的 URL Scheme 来打开应用。

在 Android 平台，您既可以通过 URL Scheme，也可以使用应用的公开包名来打开应用。

注意： 在 Android 11 及更高版本中，您需要将要查询的应用包名添加到 AndroidManifest.xml 文件的 queries 标签中。

示例：

<queries>
  <package android:name="com.getcapacitor.myapp" />
</queries>

安装

npm install @capacitor/app-launcher
npx cap sync

使用示例

import { AppLauncher } from '@capacitor/app-launcher';

const checkCanOpenUrl = async () => {
  const { value } = await AppLauncher.canOpenUrl({ url: 'com.getcapacitor.myapp' });

  console.log('能否打开该URL: ', value);
};

const openPortfolioPage = async () => {
  await AppLauncher.openUrl({ url: 'com.getcapacitor.myapp://page?id=portfolio' });
};

API 文档

• canOpenUrl(...)
• openUrl(...)
• 接口定义

canOpenUrl(...)

canOpenUrl(options: CanOpenURLOptions) => Promise<CanOpenURLResult>

检查给定 URL 是否能打开对应的应用。

在 iOS 平台上，您必须先在应用的 Info.plist 文件中通过添加 LSApplicationQueriesSchemes 键来声明要检查的 URL Scheme。 详细了解如何配置 Info.plist。

对于未声明的 Scheme，无论是否安装了对应应用，此方法都会返回 false。更多关于此键的信息，请参阅 LSApplicationQueriesSchemes。

参数	类型
options	CanOpenURLOptions

返回值：

Promise<CanOpenURLResult>

起始版本： 1.0.0

---

openUrl(...)

openUrl(options: OpenURLOptions) => Promise<OpenURLResult>

通过给定 URL 打开对应应用。 在 iOS 平台上，URL 应为已知的 URL Scheme。 在 Android 平台上，URL 可以是已知的 URL Scheme 或应用包名。

参数	类型
options	OpenURLOptions

返回值：

Promise<OpenURLResult>

起始版本： 1.0.0

---

Interfaces

CanOpenURLResult

属性	类型
value	boolean

CanOpenURLOptions

属性	类型
url	string

OpenURLResult

属性	类型
completed	boolean

OpenURLOptions

属性	类型
url	string