跳过主要内容

意图启动器 Capacitor 插件

使用意图系统,启动 Android 意图,打开系统设置以及与其他应用程序进行交互

安装

bun add @capgo/capacitor-intent-launcher bunx cap sync
npm、pnpm 或 yarn
  • npm install @capgo/capacitor-intent-launcher
  • pnpm add @capgo/capacitor-intent-launcher
  • yarn add @capgo/capacitor-intent-launcher

指南

如何在Capacitor中使用意图启动器

在设备上测试

下载Capgo应用程序,然后扫描code的二维码。

意图启动器插件预览二维码 code

使用 @capgo/capacitor-intent-launcher

Capacitor 意图启动器插件,用于在 Android 和 iOS 上启动 Android 意图和打开系统设置

安装

bun add @capgo/capacitor-intent-launcher
bunx cap sync

bunx cap sync 将插件的本机 code 复制到您的本机项目中。每次升级插件后,请重新运行它。

Import

import { IntentLauncher } from '@capgo/capacitor-intent-launcher';

API概览

Method 描述
startActivityAsync 启动一个用于给定动作的 Android 活动。
openIOSSettings 打开 iOS 设置屏幕。
openApplication 打开一个通过包名识别的应用。
getApplicationIconAsync 获取应用图标作为一个 base64 编码的 PNG 字符串。

示例

startActivityAsync()

启动一个用于给定动作的 Android 活动。

import { IntentLauncher, ActivityAction } from '@capgo/capacitor-intent-launcher';

// Open location settings
const result = await IntentLauncher.startActivityAsync({
  action: ActivityAction.LOCATION_SOURCE_SETTINGS
});

// Open a specific app settings
const result = await IntentLauncher.startActivityAsync({
  action: ActivityAction.APPLICATION_DETAILS_SETTINGS,
  data: 'package:com.example.app'
});

openIOSSettings()

打开 iOS 设置屏幕。

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()

打开一个通过包名识别的应用。

import { IntentLauncher } from '@capgo/capacitor-intent-launcher';

// Open Gmail app
await IntentLauncher.openApplication({ packageName: 'com.google.android.gm' });

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;
}

全局参考

继续使用@capgo/capacitor-意图启动器

如果您正在使用 使用@capgo/capacitor-意图启动器 为了计划仪表板和API操作,连接它与 @capgo/capacitor-意图启动器 为了在@capgo/capacitor-意图启动器中实现详细信息 开始 为了在开始中实现详细信息 API概述 为了在API概述中实现详细信息 简介 简介中的实现细节 API 键 API 键中的实现细节

常见问题

意图启动器插件FAQ

如何在Capacitor应用中安装意图启动器插件?

运行“bun add @capgo/capacitor-intent-launcher”(或“npm install @capgo/capacitor-intent-launcher”),然后运行“bunx cap sync”,使iOS和Android项目捕获native code。从“@capgo/capacitor-intent-launcher”中导入它到您的应用code。

是否@capgo/capacitor-intent-launcher与React、Vue和Angular兼容?

是的。意图启动器是一个Capacitor包,因此它与任何运行在Capacitor中的Web框架兼容,包括Ionic、React、Vue、Angular、Svelte和普通JavaScript。

哪个Capacitor版本支持@capgo/capacitor-intent-launcher?

Capgo插件遵循Capacitor的主要版本:使用与Capacitor主要版本匹配的插件主要版本(例如插件v8与Capacitor 8)。在GitHub README中列出的兼容性表格列出了维护的版本。

是否@capgo/capacitor-intent-launcher免费且开源?

是的。code源代码在GitHub上公开,https://github.com/Cap-go/capacitor-intent-launcher/,并且该包从npm中免费安装。欢迎bug报告和拉取请求。

是否可以在不经过App Store审查的情况下更新使用意图启动器的code?

安装或升级插件会改变本机code,因此需要新建一个商店构建。之后,调用插件的JavaScript、HTML和CSS更改可以立即通过Capgo实时更新发布。

不必等待应用程序审查就可以将意图启动器更改

一旦插件在您的商店构建中,Capgo实时更新将推送您的JavaScript、HTML和CSS更改到用户中几分钟内。

从Capgo开始