快速入门
复制包含安装步骤和该插件完整 Markdown 指南的配置 prompt。
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-intent-launcher`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/intent-launcher/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
安装
“安装”章节你可以使用我们的 AI 辅助设置来安装插件。使用以下命令将 Capgo skills 添加到你的 AI 工具中:
bunx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins然后使用以下 prompt:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-intent-launcher` plugin in my project.如果你更想手动设置,请运行以下命令安装插件,并按照下方各平台的说明操作:
bun add @capgo/capacitor-intent-launcherbunx cap sync导入
“导入”章节import { IntentLauncher } from '@capgo/capacitor-intent-launcher';快速入门
章节标题为“快速入门”import { IntentLauncher, ActivityAction } from '@capgo/capacitor-intent-launcher';
// Open location settingsconst result = await IntentLauncher.startActivityAsync({ action: ActivityAction.LOCATION_SOURCE_SETTINGS});
// Open a specific app settingsconst result = await IntentLauncher.startActivityAsync({ action: ActivityAction.APPLICATION_DETAILS_SETTINGS, data: 'package:com.example.app'});示例:openIOSSettings
标题为“示例:openIOSSettings”的章节import { IntentLauncher, IOSSettings } from '@capgo/capacitor-intent-launcher';
// Open app settings (recommended - officially supported by Apple)await IntentLauncher.openIOSSettings({ option: IOSSettings.App });
// Open WiFi settings (may not work in all iOS versions)await IntentLauncher.openIOSSettings({ option: IOSSettings.WiFi });示例:openApplication
标题为“示例:openApplication”的章节import { IntentLauncher } from '@capgo/capacitor-intent-launcher';
// Open Gmail appawait IntentLauncher.openApplication({ packageName: 'com.google.android.gm' });常见坑点
章节标题为“常见陷阱”- 原生同步:运行
bunx cap sync在插件升级后。 - 唯一可信来源:信任
src/definitions.ts在 GitHub 仓库中。
API 概览
章节标题:“API 概览”startActivityAsync
标题为 “startActivityAsync” 的章节针对指定操作启动 Android Activity。
import { IntentLauncher, ActivityAction } from '@capgo/capacitor-intent-launcher';
// Open location settingsconst result = await IntentLauncher.startActivityAsync({ action: ActivityAction.LOCATION_SOURCE_SETTINGS});
// Open a specific app settingsconst result = await IntentLauncher.startActivityAsync({ action: ActivityAction.APPLICATION_DETAILS_SETTINGS, data: 'package:com.example.app'});openIOSSettings
“openIOSSettings” 章节打开 iOS 设置界面。
注意:Apple 官方唯一支持的选项是 App 它会打开你应用的设置页面。
其他选项可能有效,但无法保证,未来 iOS 版本中可能失效,或导致 App Store 审核被拒。
另外注意,iOS Simulator 有时只会打开“设置”App,而不是指定的选项。
import { IntentLauncher, IOSSettings } from '@capgo/capacitor-intent-launcher';
// Open app settings (recommended - officially supported by Apple)await IntentLauncher.openIOSSettings({ option: IOSSettings.App });
// Open WiFi settings (may not work in all iOS versions)await IntentLauncher.openIOSSettings({ option: IOSSettings.WiFi });openApplication
“openApplication” 章节通过包名打开应用。
import { IntentLauncher } from '@capgo/capacitor-intent-launcher';
// Open Gmail appawait IntentLauncher.openApplication({ packageName: 'com.google.android.gm' });getApplicationIconAsync
“getApplicationIconAsync” 章节获取应用图标,返回 base64 编码的 PNG 字符串。
import { IntentLauncher } from '@capgo/capacitor-intent-launcher';
const { icon } = await IntentLauncher.getApplicationIconAsync({ packageName: 'com.google.android.gm'});if (icon) { const img = document.createElement('img'); img.src = icon;}类型参考
“类型参考” 章节IntentLauncherParams
标题为“IntentLauncherParams”的章节启动 Activity 的选项。
export interface IntentLauncherParams { /** * The action to perform. Use values from `ActivityAction` enum. * * @since 1.0.0 */ action: string;
/** * Optional category to add to the intent. * * @since 1.0.0 */ category?: string;
/** * Optional class name for the component to launch. * * @since 1.0.0 */ className?: string;
/** * Optional URI data for the intent. Must be a valid URI. * * @since 1.0.0 */ data?: string;
/** * Optional extra data to pass to the intent as key-value pairs. * * @since 1.0.0 */ extra?: Record<string, unknown>;
/** * Optional intent flags as a bitmask. * * @since 1.0.0 */ flags?: number;
/** * Optional package name for the component. * * @since 1.0.0 */ packageName?: string;
/** * Optional MIME type for the intent data. * * @since 1.0.0 */ type?: string;}IntentLauncherResult
标题为“IntentLauncherResult”的章节启动 Activity 的结果。
export interface IntentLauncherResult { /** * The result code returned by the activity. * * @since 1.0.0 */ resultCode: ResultCode;
/** * Optional data URI returned by the activity. * * @since 1.0.0 */ data?: string;
/** * Optional extra data returned by the activity. * * @since 1.0.0 */ extra?: Record<string, unknown>;}IOSSettingsParams
标题为“IOSSettingsParams”的章节打开 iOS 设置的选项。
export interface IOSSettingsParams { /** * The iOS settings screen to open. Use values from `IOSSettings` enum. * * @since 8.2.0 */ option: string;}IOSSettingsResult
标题为“IOSSettingsResult”的章节打开 iOS 设置的结果。
export interface IOSSettingsResult { /** * Whether the settings screen was successfully opened. * * @since 8.2.0 */ success: boolean;}OpenApplicationOptions
“OpenApplicationOptions” 部分打开应用程序的选项。
export interface OpenApplicationOptions { /** * The package name of the application to open. * * @since 1.0.0 */ packageName: string;}GetApplicationIconOptions
“GetApplicationIconOptions” 部分获取应用程序图标的选项。
export interface GetApplicationIconOptions { /** * The package name of the application. * * @since 1.0.0 */ packageName: string;}GetApplicationIconResult
“GetApplicationIconResult” 部分获取应用程序图标的结果。
export interface GetApplicationIconResult { /** * The application icon as a base64-encoded PNG string prefixed with 'data:image/.png;base64,'. * Empty string if the icon is not available. * * @since 1.0.0 */ icon: string;}ResultCode
“ResultCode” 部分Activity 返回的结果码。
export enum ResultCode { /** * The activity completed successfully. */ Success = -1,
/** * The activity was canceled by the user. */ Canceled = 0,
/** * First custom user-defined result code. */ FirstUser = 1,}单一事实来源
标题为“单一事实来源”的部分本页面由插件的 src/definitions.ts生成。当上游的公共 API 发生变化时,请重新运行 sync。
从入门指南继续
“从入门指南继续”章节如果你正在使用 快速入门 要规划 dashboard 和 API 操作,请将其连接到 使用 @capgo/capacitor-intent-launcher 关于《使用 @capgo/capacitor-intent-launcher》中的原生能力, API 概览 关于 API Overview 中的实现细节, 简介 关于 Introduction 中的实现细节, API 密钥 有关 API Keys 的实现细节,以及 设备 有关 Devices 的实现细节。