# @capawesome/capacitor-settings-launcher 中文文档

规范地址：https://npmcn.com/package/%40capawesome/capacitor-settings-launcher/

版本：0\.1\.2
npm 元数据更新时间：2026-09-02T08:23:36.440Z
中文译文更新时间：2026-11-09T03:03:19.812Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40capawesome/capacitor-settings-launcher
原文对照：https://npmcn.com/package/%40capawesome/capacitor-settings-launcher/?lang=original
项目主页：https://capawesome.io/docs/sdks/capacitor/settings-launcher/
源码仓库：https://github.com/capawesome-team/capacitor-plugins

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：123 kB，33 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@capacitor/core \>=8\.0\.0
- 首次发布：2026-07-07T08:39:32.963Z
- 最新版本发布：2026-09-02T08:23:36.132Z
- 近 30 天下载量：59990（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

在Android和iOS上打开本地设置屏幕的电容插件.

## 安装

```sh
npm install @capawesome/capacitor-settings-launcher
```

也可以使用：`pnpm add @capawesome/capacitor-settings-launcher`、`yarn add @capawesome/capacitor-settings-launcher`、`bun add @capawesome/capacitor-settings-launcher`

## README

# 电容设置启动器插件

打开本地设置屏幕的电容插件 .

[![Deliver Live Updates to your Capacitor app with Capawesome Cloud](https://cloud.capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.png?t=1)](https://cloud.capawesome.io/)

## 特征

-   ⚙️ **应用程序设置**: 打开您的应用程序的设置屏幕来引导用户给予拒绝的许可.
-   🔔 **通知设置**:打开您的应用程序的通知设置屏幕.
-   🤖 **Android 设置**:打开Android系统设置屏幕的大型目录.
-   🔒 **App 存储安全**:只使用官方平台API——没有私有的URL计划.
-   🤝 **兼容性**: 与 [App 语言](https://capawesome.io/docs/sdks/capacitor/app-language/) 财务报告和审定财务报表 [Android 电池优化](https://capawesome.io/docs/sdks/capacitor/android-battery-optimization/) 插件 .
-   📦 **可可花和SPM**:支持CocoaPods和Swift软件包管理器用于iOS.
-   🔁 **最新数据**:总是支持最新的Capacitor版本.

缺少一个功能? 刚刚 [打开一个问题](https://github.com/capawesome-team/capacitor-plugins/issues) 我们看看!

## 使用大小写

设置启动器插件通常用于引导用户使用正确的系统设置屏幕,例如:

-   **许可恢复**: 打开您的应用程序的设置屏幕, 这样用户就可以给予先前被拒绝的许可 .
-   **选择加入通知**: 当通知被禁用时, 引导用户使用您的应用程序的通知设置 .
-   **连接故障排除**: 当您的应用程序需要连接时, 在Android上打开无线、 蓝牙或飞机模式设置 .
-   **登入流量**: 将用户发送到Android设置屏幕,例如地方,位置,或NFC,以启用您的应用程序所依赖的功能.

## 兼容性

| 插件版本 | 电容版本 | 状态 |
| --- | --- | --- |
| 0.x.x (中文(简体) ) | \>=8.x.x | 积极支持 |

## 安装

你可以用我们的 **AI 辅助设置** 以安装插件. 添加数据 [超级技能](https://github.com/capawesome-team/skills) 至您的 AI 工具,使用以下命令:

```bash
npx skills add capawesome-team/skills --skill capacitor-plugins
```

然后使用下列提示:

```
 Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome/capacitor-settings-launcher` plugin in my project.
```

如果你喜欢 **手动设置**,通过运行以下命令来安装插件,并遵循下面的平台特定指令:

```bash
npm install @capawesome/capacitor-settings-launcher
npx cap sync
```

### 机器人

此插件不需要额外的配置 .

### iOS系统

这个 `openNotificationSettings(...)` 方法需要iOS 16或以后。 在旧版本中,电话拒绝为无法使用.

## 配置

此插件不需要配置 .

## 使用量

以下示例显示如何打开您的应用程序的设置屏幕,打开您的应用程序的通知设置,以及打开一个Android系统设置屏幕.

### 打开应用程序的设置屏幕

打开您的应用程序的设置屏幕, 例如, 以引导用户给予先前被拒绝的许可 。 仅在Android和iOS上提供:

```typescript
import { SettingsLauncher } from '@capawesome/capacitor-settings-launcher';

const openAppSettings = async () => {
  await SettingsLauncher.openAppSettings();
};
```

### 打开您的应用程序的通知设置

打开您的应用程序的通知设置屏幕, 例如当用户已禁用通知 。 在iOS上,这种方法需要iOS 16或更后,并在更旧的版本上拒绝. 仅在Android和iOS上提供:

```typescript
import { SettingsLauncher } from '@capawesome/capacitor-settings-launcher';

const openNotificationSettings = async () => {
  await SettingsLauncher.openNotificationSettings();
};
```

### 打开Android系统设置屏幕

使用 `AndroidSettingsPage` enum可打开许多支持的Android系统设置屏幕之一,例如Wi-Fi,蓝牙或位置. 仅在Android上可用:

```typescript
import { SettingsLauncher, AndroidSettingsPage } from '@capawesome/capacitor-settings-launcher';

const openAndroidSettings = async () => {
  await SettingsLauncher.openAndroidSettings({
    page: AndroidSettingsPage.Wifi,
  });
};
```

## API 密码

-   [`openAndroidSettings(...)`](https://npmcn.com/package/%40capawesome/capacitor-settings-launcher/#readme-openandroidsettings)
-   [`openAppSettings()`](https://npmcn.com/package/%40capawesome/capacitor-settings-launcher/#readme-openappsettings)
-   [`openNotificationSettings()`](https://npmcn.com/package/%40capawesome/capacitor-settings-launcher/#readme-opennotificationsettings)
-   [接口](https://npmcn.com/package/%40capawesome/capacitor-settings-launcher/#readme-interfaces)
-   [数字](https://npmcn.com/package/%40capawesome/capacitor-settings-launcher/#readme-enums)

### openAndroid 设置(...)

```typescript
openAndroidSettings(options: OpenAndroidSettingsOptions) => Promise<void>
```

打开一个特定的Android系统设置屏幕.

只能从Android上找到.

| 参数 | 类型 |
| --- | --- |
| **`options`** | `[OpenAndroidSettingsOptions](https://npmcn.com/package/%40capawesome/capacitor-settings-launcher/#readme-openandroidsettingsoptions)` |

**自:** 0.1.0 (中文(简体) )

* * *

### 打开 AppSettings ()

```typescript
openAppSettings() => Promise<void>
```

打开您的应用程序的设置屏幕 .

这是指导用户批准先前被拒绝的 允许.

仅在Android和iOS上提供.

**自:** 0.1.0 (中文(简体) )

* * *

### 通知安排( )

```typescript
openNotificationSettings() => Promise<void>
```

打开您的应用程序的通知设置屏幕 .

在iOS上,这种方法需要iOS 16或更后,并在更旧的版本上拒绝.

仅在Android和iOS上提供.

**自:** 0.1.0 (中文(简体) )

* * *

### 接口

#### OpenAndroid 设置选项

| Prop | 类型 | 说明 | 自兹 |
| --- | --- | --- | --- |
| **`page`** | `[AndroidSettingsPage](https://npmcn.com/package/%40capawesome/capacitor-settings-launcher/#readme-androidsettingspage)` | Android系统设置屏幕打开. | 0.1.0 (中文(简体) ) |

### 数字

#### Android 定居页面

| 成员 | 数值 | 说明 | 自兹 |
| --- | --- | --- | --- |
| **`Accessibility`** | `'ACCESSIBILITY'` | 显示访问模块的设置 . | 0.1.0 (中文(简体) ) |
| **`AirplaneMode`** | `'AIRPLANE_MODE'` | 显示允许进入/ 退出飞机模式的设置 . | 0.1.0 (中文(简体) ) |
| **`Apn`** | `'APN'` | 显示允许配置APN的设置 . | 0.1.0 (中文(简体) ) |
| **`BatterySaver`** | `'BATTERY_SAVER'` | 显示允许配置电池保存器模式的设置 . | 0.1.0 (中文(简体) ) |
| **`Bluetooth`** | `'BLUETOOTH'` | 显示允许配置蓝牙的设置 . | 0.1.0 (中文(简体) ) |
| **`Captioning`** | `'CAPTIONING'` | 显示视频字幕的设置 . | 0.1.0 (中文(简体) ) |
| **`CastSettings`** | `'CAST_SETTINGS'` | 显示设置以允许配置所投终点 . | 0.1.0 (中文(简体) ) |
| **`DataRoaming`** | `'DATA_ROAMING'` | 显示选择 2G/3G 的设置 . | 0.1.0 (中文(简体) ) |
| **`Date`** | `'DATE'` | 显示允许配置日期和时间的设置 . | 0.1.0 (中文(简体) ) |
| **`Development`** | `'DEVELOPMENT'` | 显示允许配置应用程序开发设置的设置 . | 0.1.0 (中文(简体) ) |
| **`DeviceInfo`** | `'DEVICE_INFO'` | 显示一般设备信息设置(序列号,软件版本,电话号码等). | 0.1.0 (中文(简体) ) |
| **`Display`** | `'DISPLAY'` | 显示允许配置显示的设置 . | 0.1.0 (中文(简体) ) |
| **`Dream`** | `'DREAM'` | 显示 Daydream 设置 . | 0.1.0 (中文(简体) ) |
| **`Home`** | `'HOME'` | 显示选择默认家用应用程序的设置 . | 0.1.0 (中文(简体) ) |
| **`IgnoreBatteryOptimization`** | `'IGNORE_BATTERY_OPTIMIZATION'` | 显示屏幕以控制哪些应用程序可以忽略电池优化 . | 0.1.0 (中文(简体) ) |
| **`InputMethod`** | `'INPUT_METHOD'` | 显示设置以配置输入方法,特别是允许用户启用输入方法. | 0.1.0 (中文(简体) ) |
| **`InternalStorage`** | `'INTERNAL_STORAGE'` | 显示内部存储的设置 . | 0.1.0 (中文(简体) ) |
| **`Locale`** | `'LOCALE'` | 显示允许配置 locale 的设置 . | 0.1.0 (中文(简体) ) |
| **`Location`** | `'LOCATION'` | 显示允许配置当前位置源的设置 . | 0.1.0 (中文(简体) ) |
| **`ManageAllApplications`** | `'MANAGE_ALL_APPLICATIONS'` | 显示管理所有应用程序的设置 . | 0.1.0 (中文(简体) ) |
| **`ManageApplications`** | `'MANAGE_APPLICATIONS'` | 显示管理已安装应用程序的设置 . | 0.1.0 (中文(简体) ) |
| **`MemoryCard`** | `'MEMORY_CARD'` | 显示存储内存卡的设置 . | 0.1.0 (中文(简体) ) |
| **`Network`** | `'NETWORK'` | 显示选择网络操作员的设置 . | 0.1.0 (中文(简体) ) |
| **`Nfc`** | `'NFC'` | 显示允许配置 NFC 的设置 . | 0.1.0 (中文(简体) ) |
| **`NfcPayment`** | `'NFC_PAYMENT'` | 显示允许配置自带和付费的设置 . | 0.1.0 (中文(简体) ) |
| **`NotificationListener`** | `'NOTIFICATION_LISTENER'` | 显示用于管理哪些应用程序可访问通知倾听器服务的设置 . | 0.1.0 (中文(简体) ) |
| **`Printing`** | `'PRINTING'` | 显示打印的设置 . | 0.1.0 (中文(简体) ) |
| **`Privacy`** | `'PRIVACY'` | 显示允许配置隐私选项的设置 . | 0.1.0 (中文(简体) ) |
| **`Search`** | `'SEARCH'` | 显示允许配置搜索的设置 . | 0.1.0 (中文(简体) ) |
| **`Security`** | `'SECURITY'` | 显示设置允许配置安全和位置隐私 . | 0.1.0 (中文(简体) ) |
| **`Sound`** | `'SOUND'` | 显示允许配置声音和音量的设置 . | 0.1.0 (中文(简体) ) |
| **`Sync`** | `'SYNC'` | 显示可以配置同步设置的设置 . | 0.1.0 (中文(简体) ) |
| **`Usage`** | `'USAGE'` | 显示用于控制哪些应用程序可以访问使用统计的屏幕 . | 0.1.0 (中文(简体) ) |
| **`UserDictionary`** | `'USER_DICTIONARY'` | 显示管理用户输入词典的设置 . | 0.1.0 (中文(简体) ) |
| **`VoiceInput`** | `'VOICE_INPUT'` | 显示配置输入方法的设置,特别是允许用户启用语音输入服务. | 0.1.0 (中文(简体) ) |
| **`Vpn`** | `'VPN'` | 显示允许配置 VPN 的设置 . | 0.1.0 (中文(简体) ) |
| **`Wifi`** | `'WIFI'` | 显示允许配置 Wi-Fi 的设置 . | 0.1.0 (中文(简体) ) |
| **`Wireless`** | `'WIRELESS'` | 显示设置可以配置无线控制,如Wi-Fi,蓝牙和移动网络等. | 0.1.0 (中文(简体) ) |

## 从 `capacitor-native-settings`

此插件取代单个 `open(...)` 方法 `capacitor-native-settings` 有三种明确的方法。 而不是通过一个 `optionAndroid` 财务报告和审定财务报表 `optionIOS` 以单方法调用符合您意图的方法:

| `capacitor-native-settings` | 设置启动器 |
| --- | --- |
| `open({ optionAndroid: 'application_details', optionIOS: 'App' })` | `openAppSettings()` |
| `open({ optionAndroid: 'app_notification', optionIOS: 'App' })` | `openNotificationSettings()` |
| `open({ optionAndroid: '<page>', optionIOS: '...' })` | `openAndroidSettings({ page: '<page>' })` |

在iOS上, `openAppSettings()` 财务报告和审定财务报表 `openNotificationSettings()` 覆盖官方支持的目的地。 各种 `optionIOS` 故意不支持与特定iOS设置的深层链接(见下文).

## iOS 和该软件 `App-Prefs:` URL 方案

这个插件是故意的 **没有** 提供深入的链接到特定的iOS系统设置部分(如Wi-Fi,蓝牙,位置等). 这些链接依赖于私人 `App-Prefs:` URL计划,不属于公共iOS API. 在App Store审查期间使用它的Apps可能会面临拒绝的风险,而Apple可能在iOS发布之间不提前通知就将其打破.

相反,这个插件只使用正式的 Apple API : `UIApplication.openSettingsURLString` (你的应用程序的设置)和 `openNotificationSettingsURLString` (您的应用程序的通知设置, iOS 16+). 这是一个有意的设计决定 保护你的应用软件商店的安全.

## 财务问题

### 此插件与其他类似插件有何不同?

它通过三种明确,完全打入的方法——你的应用程序的设置,你的应用程序的通知设置,以及一个大型的Android系统屏幕目录,如Wi-Fi,蓝牙和位置——打开了本地设置屏幕,所以每个调用都明显符合你的用意. 它只依靠官方的苹果和Android API,并故意避开私人 `App-Prefs:` URL 方案,它使您的应用程序 App Store 安全. 它与最新的Capacitor版本相对应而积极维护,被构建为引导用户在Android和iOS上完全正确设置屏幕.

### 我如何引导用户给予先前被拒绝的许可?

打电话 `openAppSettings` 打开应用程序设置屏幕的方法。 这是建议用户给予他们之前拒绝的许可的方式,因为Android和iOS在拒绝后都没有再次显示许可的提示. 见 [使用示例](https://npmcn.com/package/%40capawesome/capacitor-settings-launcher/#readme-open-the-settings-screen-of-your-app) 见上文.

### 此插件如何与权限插件一起工作 ?

使用 [权限](https://capawesome.io/docs/sdks/capacitor/permissions/) 插头 `checkPermissions()` 检测方法 `denied` 权限状态,然后调用 `openAppSettings()` 从此插件将用户直接发送到您的应用程序的设置屏幕, 以便手动授予它 。 这两个插件通常一起用于此检查时恢复流.

### 为什么我不能打开像Wi-Fi或蓝牙这样的特定iOS设置部分?

深链接到特定iOS系统设置部分依赖于私有 `App-Prefs:` URL计划,不属于公共iOS API. 在App Store审查期间使用它的Apps可能会面临拒绝的风险,而Apple可能在iOS发布之间不提前通知就将其打破. 此插件仅刻意使用官方的 Apple API 来保护您的 App Store 安全( 参见 [iOS 和该软件 `App-Prefs:` URL 方案](https://npmcn.com/package/%40capawesome/capacitor-settings-launcher/#readme-ios-and-the-app-prefs-url-scheme)) (中文(简体) ).

### 为什么 `openNotificationSettings` 在iOS上拒绝?

这个 `openNotificationSettings(...)` 方法需要iOS 16或以后。 在更古老的iOS版本上,呼叫拒绝为不可用. 这个 `openAppSettings()` 方法在所有支持的iOS版本上工作,也让用户访问您的应用程序的通知设置.

### 我能打开哪个Android设置屏幕?

这个 `openAndroidSettings(...)` 方法支持一个大型的Android系统设置屏幕目录,包括Wi-Fi,蓝牙,位置,地产,NFC,显示,声音,以及更多. 见 `AndroidSettingsPage` 语句 [API 参考](https://npmcn.com/package/%40capawesome/capacitor-settings-launcher/#readme-api) 完整名单。 这种方法只在Android上可用.

### 我如何从 `capacitor-native-settings`? 吗?

此插件取代单个 `open(...)` 方法 `capacitor-native-settings` 采用三种明确的方法: `openAppSettings()`, (中文(简体) ), `openNotificationSettings()` 财务报告和审定财务报表 `openAndroidSettings(...)`见 [移徙指南](https://npmcn.com/package/%40capawesome/capacitor-settings-launcher/#readme-migrating-from-capacitor-native-settings) 上方为绘图表.

### 我能用这个插件吗? 有Ionic、React、Vue或Angular?

是的,插件是框架不可知的。 它在任意网络框架的Capacitor app中工作,包括有Angular,React,或Vue的Ionic,以及平版JavaScript等项目.

## 相关插件

-   [Android 电池优化](https://capawesome.io/docs/sdks/capacitor/android-battery-optimization/):管理电池优化设置并请求Android豁免.
-   [Android 有意发射装置](https://capawesome.io/docs/sdks/capacitor/android-intent-launcher/):发射任意的Android意图.
-   [App 语言](https://capawesome.io/docs/sdks/capacitor/app-language/):管理应用程序自己的语言覆盖,独立于设备语言.
-   [应用程序启动器](https://capawesome.io/docs/sdks/capacitor/app-launcher/):检查一个应用程序能否被打开并打开.
-   [权限](https://capawesome.io/docs/sdks/capacitor/permissions/):以统一的API检查并请求设备权限.

## 通讯

随时更新有关卡帕韦索姆、Capacitor和Ionic生态系统的最新消息和最新消息,因为我们 [《卡帕索克通讯》](https://cloud.capawesome.io/newsletter/)。 。 。 .

## 更改日志

见 [变动情况](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/settings-launcher/CHANGELOG.md)。 。 。 .

## 许可证

见 [自由主义](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/settings-launcher/LICENSE)。 。 。 .

## 常见问题

### @capawesome/capacitor-settings-launcher 是什么？

在Android和iOS上打开本地设置屏幕的电容插件\.

### 如何安装 @capawesome/capacitor-settings-launcher？

在项目目录运行 npm install @capawesome/capacitor-settings-launcher，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@capacitor/core（\>=8\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @capawesome/capacitor-settings-launcher 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @capawesome/capacitor-settings-launcher 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @capawesome/capacitor-settings-launcher 可以商用吗？

@capawesome/capacitor-settings-launcher 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @capawesome/capacitor-settings-launcher 的下载量有多少？

根据 npm 官方下载统计，@capawesome/capacitor-settings-launcher 在 2026/10/09 – 2026/11/07 这 30 天内被下载 59,990 次，日均约 2,000 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @capawesome/capacitor-settings-launcher 还在维护吗？

最新版本 0\.1\.2 发布于 2026/09/02（2 个月前）；至今共发布 4 个版本，其中过去 12 个月发布了 4 个；首次发布于 2026/07/07。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。