@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@latest-5
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(...)
• Interfaces

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 应该是一个已知的 URLScheme。 在 Android 上，URL 可以是已知的 URLScheme 或应用包名。

参数	类型
options	OpenURLOptions

返回：

Promise<OpenURLResult>

自从： 1.0.0

---

接口

CanOpenURLResult

属性	类型
value	boolean

CanOpenURLOptions

属性	类型
url	string

OpenURLResult

属性	类型
completed	boolean

OpenURLOptions

属性	类型
url	string