电容设置启动器插件

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

特征

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

缺少一个功能? 刚刚 打开一个问题 我们看看!

使用大小写

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

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

兼容性

安装

你可以用我们的 AI 辅助设置 以安装插件. 添加数据 超级技能 至您的 AI 工具,使用以下命令:

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.

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

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

机器人

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

iOS系统

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

配置

此插件不需要配置 .

使用量

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

打开应用程序的设置屏幕

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

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

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

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

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

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

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

打开Android系统设置屏幕

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

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

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

API 密码

• openAndroidSettings(...)
• openAppSettings()
• openNotificationSettings()
• 接口
• 数字

openAndroid 设置(...)

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

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

只能从Android上找到.

自: 0.1.0 (中文(简体) )

打开 AppSettings ()

openAppSettings() => Promise<void>

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

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

仅在Android和iOS上提供.

自: 0.1.0 (中文(简体) )

通知安排( )

openNotificationSettings() => Promise<void>

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

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

仅在Android和iOS上提供.

自: 0.1.0 (中文(简体) )

接口

OpenAndroid 设置选项

数字

Android 定居页面

从 capacitor-native-settings

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

在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在拒绝后都没有再次显示许可的提示. 见 使用示例 见上文.

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

使用 权限 插头 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 方案) (中文(简体) ).

为什么 openNotificationSettings 在iOS上拒绝?

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

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

这个 openAndroidSettings(...) 方法支持一个大型的Android系统设置屏幕目录,包括Wi-Fi,蓝牙,位置,地产,NFC,显示,声音,以及更多. 见 AndroidSettingsPage 语句 API 参考 完整名单。 这种方法只在Android上可用.

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

此插件取代单个 open(...) 方法 capacitor-native-settings 采用三种明确的方法: openAppSettings(), (中文(简体) ), openNotificationSettings() 财务报告和审定财务报表 openAndroidSettings(...)见 移徙指南 上方为绘图表.

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

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

相关插件

• Android 电池优化:管理电池优化设置并请求Android豁免.
• Android 有意发射装置:发射任意的Android意图.
• App 语言:管理应用程序自己的语言覆盖,独立于设备语言.
• 应用程序启动器:检查一个应用程序能否被打开并打开.
• 权限:以统一的API检查并请求设备权限.

通讯

随时更新有关卡帕韦索姆、Capacitor和Ionic生态系统的最新消息和最新消息,因为我们 《卡帕索克通讯》。 。 。 .

更改日志

见 变动情况。 。 。 .

许可证

见 自由主义。 。 。 .