@capacitor/app-launcher

AppLauncher APIを使うと、アプリが開けるかどうかをチェックして、アプリを開くことができます。

iOSでは、アプリのURLスキームを知っている場合のみ、アプリを開くことができます。

Androidでは、アプリのURLスキームがわかっているか、公開されているパッケージ名を使用すれば、アプリを開くことができます。

注意: Android 11 以降では、AndroidManifest.xml の queries タグ内に、照会したいアプリのパッケージ名を追加する必要があります。

Example:

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

Install

npm install @capacitor/app-launcher
npx cap sync

Example

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

canOpenUrl(...)

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

Check if an app can be opened with the given URL.

On iOS you must declare the URL schemes you pass to this method by adding the LSApplicationQueriesSchemes key to your app's Info.plist file. Learn more about configuring Info.plist.

This method always returns false for undeclared schemes, whether or not an appropriate app is installed. To learn more about the key, see LSApplicationQueriesSchemes.

Param	Type
options	CanOpenURLOptions

Returns:

Promise<CanOpenURLResult>

Since: 1.0.0

---

openUrl(...)

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

Open an app with the given URL. On iOS the URL should be a known URLScheme. On Android the URL can be a known URLScheme or an app package name.

Param	Type
options	OpenURLOptions

Returns:

Promise<OpenURLResult>

Since: 1.0.0

---

Interfaces

CanOpenURLResult

Prop	Type
value	boolean

CanOpenURLOptions

Prop	Type
url	string

OpenURLResult

Prop	Type
completed	boolean

OpenURLOptions

Prop	Type
url	string