管理配置插件
访问管理配置设置的电容插件 .
使用大小写
管理配置插件通常用于通过EMM或MDM解决方案发行的企业应用程序,例如:
- 预配置服务器设置:读取组织IT部门配置的服务器URL或端口,而不是要求用户输入.
- 政策驱动的特征: 使用布尔配置条目来启用或禁用每次部署的特性,例如允许在蜂窝连接上下载.
- 多租户部署:根据每个租户的管理配置值,将一个单一的应用程序运送给多个组织并进行运行时的调整.
兼容性
| 插件版本 | 电容版本 | 状态 |
|---|---|---|
| 8.x.x (英语) | >=8.x.x | 积极支持 |
| 7.x.x (中文(简体) ) | 7.x.x (中文(简体) ) | 折旧 |
| 6.x.x (中文(简体) ) | 6.x.x (中文(简体) ) | 折旧 |
| 5.x.x (中文(简体) ) | 5.x.x (中文(简体) ) | 折旧 |
安装
你可以用我们的 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-managed-configurations` plugin in my project.
如果你喜欢 手动设置,通过运行以下命令来安装插件,并遵循下面的平台特定指令:
npm install @capawesome/capacitor-managed-configurations
npx cap sync
机器人
见 定义管理的配置 并遵循指令以正确声明应用管理配置.
配置
此插件不需要配置 .
演示
这里有一个实例: robingenz/电容器-插管-demo
使用量
以下示例显示如何将管理下的配置值读取为字符串,数字和布尔.
读取管理的配置值
获取与给定的密钥相关的值作为字符串、数字或布尔值。 结果包含 null 如果不存在给定密钥的映射。 这些方法仅在Android和iOS上提供:
import { ManagedConfigurations } from '@capawesome/capacitor-managed-configurations';
const getString = async () => {
const result = await ManagedConfigurations.getString({ key: 'server_url' });
return result.value;
};
const getNumber = async () => {
const result = await ManagedConfigurations.getNumber({ key: 'server_port' });
return result.value;
};
const getBoolean = async () => {
const result = await ManagedConfigurations.getBoolean({
key: 'download_on_cellular',
});
return result.value;
};
API 密码
获取 String (...)
getString(options: GetOptions) => Promise<GetResult<string>>
获取与给定密钥相关的值,或 null 如果不存在给定密钥的映射.
仅在Android和iOS上提供.
| 参数 | 类型 |
|---|---|
options | GetOptions |
回返情况: Promise<GetResult<string>>
获取数字(...)
getNumber(options: GetOptions) => Promise<GetResult<number>>
获取与给定密钥相关的值,或 null 如果不存在给定密钥的映射.
仅在Android和iOS上提供.
| 参数 | 类型 |
|---|---|
options | GetOptions |
回返情况: Promise<GetResult<number>>
获取 Boolean (...)
getBoolean(options: GetOptions) => Promise<GetResult<boolean>>
获取与给定密钥相关的值,或 null 如果不存在给定密钥的映射.
仅在Android和iOS上提供.
| 参数 | 类型 |
|---|---|
options | GetOptions |
回返情况: Promise<GetResult<boolean>>
接口
获取恢复
| Prop | 类型 | 说明 |
|---|---|---|
value | T | null | 配置条目的值,或 null 如果不存在给定密钥的映射. |
获取选项
| Prop | 类型 | 说明 |
|---|---|---|
key | string | 配置条目唯一的密钥 . |
测试您的执行
打开 机器人,参见 设置测试的设备所有者 并遵循设置设备所有者测试环境的指示.
打开 iOS系统您需要将应用程序安装为 管理应用程序 有MDM解决方案.
财务问题
什么是管理配置?
被管理的配置是某个组织的EMM或MDM解决方案推向应用程序的设置,例如服务器URL或特性切换. 此插件允许您的 Capacitor app 在运行时使用 getString, (中文(简体) ), getNumber,以及 getBoolean 方法。 。 .
我应该使用这个插件还是Intune插件?
各组织可以通过两个不同的渠道提供应用程序配置,管理员经常将它们混为一谈. 此插件覆盖 MDM 频道; 数据 腾讯 插件覆盖 MAM 频道数字 :
| MDM 频道( 此插件) | MAM频道(腾讯(中文(简体) ) | |
|---|---|---|
| 需要设备注册 | 对 | 没有 |
| 通过 | RestrictionsManager 编号 : com.apple.configuration.managed | Intune App SDK (Intune service) (英语) |
| 目标 | 设备 | 注册账户( 身份) |
| EMM供应商 | EMM/MDM供应商 | 只限微软微调 |
| 典型情景 | 公司拥有、完全管理的设备 | 不管理设备的 BYOD / 应用保护 |
如果您的组织将应用配置策略应用到 "管理设备" 作为Intune管理中心的传送通道,请使用此插件。 如果部署在 "管理软件",使用Intune插件。 必须支持这两种情景的应用程序应读作两种渠道.
如果配置密钥不存在, 会发生什么 ?
这个 getString, (中文(简体) ), getNumber,以及 getBoolean 方法返回结果 value 实值 null 如果不存在给定密钥的映射。 您的应用程序应该处理这个案件, 例如回到默认值 .
我需要在应用程序中声明管理配置吗?
对,在Android上 您需要声明您的应用程序的管理配置如下: 定义管理的配置 以便EMM解决方案能够发现并设置. 见 安装 详细情况.
开发期间我如何测试管理配置?
在Android上,您可以设置设备所有者测试环境,例如: 设置测试的设备所有者. 在iOS上,应用程序必须通过MDM解决方案作为管理下的应用程序被安装. 见 测试您的执行 详细情况.
支持Web平台吗?
不,那个 getString, (中文(简体) ), getNumber,以及 getBoolean 方法仅在Android和iOS上可用. 管理配置是移动设备管理的概念,在浏览器中不存在.
我能用这个插件吗? 有Ionic、React、Vue或Angular?
是的,插件是框架不可知的。 它在任意网络框架的Capacitor app中工作,包括有Angular,React,或Vue的Ionic,以及平版JavaScript等项目.
相关插件
- App 完整性: 使用 Play Guide API 和 App Attest 验证应用及设备完整性.
- 腾讯:用微软Intune移动应用程序管理(这个插件的MAM频道对应)保护公司数据.
- 根检测: 检测出有根有根和断裂的装置.
- 安全优惠:安全地存储密钥/值对,如密码,令牌或其他敏感信息.
通讯
随时更新有关卡帕韦索姆、Capacitor和Ionic生态系统的最新消息和最新消息,因为我们 《卡帕索克通讯》。 。 。 .
更改日志
见 变动情况。 。 。 .
许可证
见 自由主义。 。 。 .
贷项
此插件基于 管理配置 插件 . 感谢所有为这个项目捐款的人!