@capacitor/app-launcher

AppLauncher API 允許您的應用程式檢查是否可以開啟另一個應用程式並開啟它。

在 iOS 上，您只能在知道應用程式的網址協定的情況下開啟應用程式。

在 Android 上，如果您知道應用程式的網址協定或使用其公開的套件名稱，則可以開啟應用程式。

注意：在 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('Can open 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 上，您必須將傳遞給此方法的 URL 協定宣告加入您應用程式的 Info.plist 檔案中，方法是新增 LSApplicationQueriesSchemes 索引鍵。瞭解更多關於設定 Info.plist 的資訊。

無論是否安裝了適當的應用程式，此方法對於未宣告的協定總是返回 false。若要進一步瞭解該索引鍵，請參閱 LSApplicationQueriesSchemes。

參數	類型
選項	CanOpenURLOptions

返回： Promise<CanOpenURLResult>

從 1.0.0

---

openUrl(...)

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

使用指定的 URL 開啟應用程式。在 iOS 上，URL 應為已知的 URLScheme。在 Android 上，URL 可以是已知的 URLScheme 或應用程式套件名稱。

參數	類型
選項	OpenURLOptions

返回： Promise<OpenURLResult>

從 1.0.0

---

介面

CanOpenURLResult

屬性	類型
值	布林值

CanOpenURLOptions

屬性	類型
網址	字串

OpenURLResult

屬性	類型
已完成	布林值

OpenURLOptions

屬性	類型
網址	字串