# @capawesome/capacitor-managed-configurations 中文文档

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

版本：8\.0\.2
npm 元数据更新时间：2026-09-02T08:22:58.489Z
中文译文更新时间：2026-11-09T06:41:57.659Z
软件包许可：MIT

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

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

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

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

## 中文简介

在Android和iOS上访问所管理配置设置的电容插件.

## 安装

```sh
npm install @capawesome/capacitor-managed-configurations
```

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

## 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/)

## 使用大小写

管理配置插件通常用于通过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 辅助设置** 以安装插件. 添加数据 [超级技能](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-managed-configurations` plugin in my project.
```

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

```bash
npm install @capawesome/capacitor-managed-configurations
npx cap sync
```

### 机器人

见 [定义管理的配置](https://developer.android.com/work/managed-configurations#define-configuration) 并遵循指令以正确声明应用管理配置.

## 配置

此插件不需要配置 .

## 演示

这里有一个实例: [robingenz/电容器-插管-demo](https://github.com/robingenz/capacitor-plugin-demo)

## 使用量

以下示例显示如何将管理下的配置值读取为字符串,数字和布尔.

### 读取管理的配置值

获取与给定的密钥相关的值作为字符串、数字或布尔值。 结果包含 `null` 如果不存在给定密钥的映射。 这些方法仅在Android和iOS上提供:

```typescript
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 密码

-   [`getString(...)`](https://npmcn.com/package/%40capawesome/capacitor-managed-configurations/#readme-getstring)
-   [`getNumber(...)`](https://npmcn.com/package/%40capawesome/capacitor-managed-configurations/#readme-getnumber)
-   [`getBoolean(...)`](https://npmcn.com/package/%40capawesome/capacitor-managed-configurations/#readme-getboolean)
-   [接口](https://npmcn.com/package/%40capawesome/capacitor-managed-configurations/#readme-interfaces)

### 获取 String (...)

```typescript
getString(options: GetOptions) => Promise<GetResult<string>>
```

获取与给定密钥相关的值,或 `null` 如果不存在给定密钥的映射.

仅在Android和iOS上提供.

| 参数 | 类型 |
| --- | --- |
| **`options`** | `[GetOptions](https://npmcn.com/package/%40capawesome/capacitor-managed-configurations/#readme-getoptions)` |

**回返情况:** `Promise<[GetResult](https://npmcn.com/package/%40capawesome/capacitor-managed-configurations/#readme-getresult)<string>>`

* * *

### 获取数字(...)

```typescript
getNumber(options: GetOptions) => Promise<GetResult<number>>
```

获取与给定密钥相关的值,或 `null` 如果不存在给定密钥的映射.

仅在Android和iOS上提供.

| 参数 | 类型 |
| --- | --- |
| **`options`** | `[GetOptions](https://npmcn.com/package/%40capawesome/capacitor-managed-configurations/#readme-getoptions)` |

**回返情况:** `Promise<[GetResult](https://npmcn.com/package/%40capawesome/capacitor-managed-configurations/#readme-getresult)<number>>`

* * *

### 获取 Boolean (...)

```typescript
getBoolean(options: GetOptions) => Promise<GetResult<boolean>>
```

获取与给定密钥相关的值,或 `null` 如果不存在给定密钥的映射.

仅在Android和iOS上提供.

| 参数 | 类型 |
| --- | --- |
| **`options`** | `[GetOptions](https://npmcn.com/package/%40capawesome/capacitor-managed-configurations/#readme-getoptions)` |

**回返情况:** `Promise<[GetResult](https://npmcn.com/package/%40capawesome/capacitor-managed-configurations/#readme-getresult)<boolean>>`

* * *

### 接口

#### 获取恢复

| Prop | 类型 | 说明 |
| --- | --- | --- |
| **`value`** | `T | null` | 配置条目的值,或 `null` 如果不存在给定密钥的映射. |

#### 获取选项

| Prop | 类型 | 说明 |
| --- | --- | --- |
| **`key`** | `string` | 配置条目唯一的密钥 . |

## 测试您的执行

打开 **机器人**,参见 [设置测试的设备所有者](https://source.android.com/devices/tech/admin/testing-setup#set_up_the_device_owner_for_testing) 并遵循设置设备所有者测试环境的指示.

打开 **iOS系统**您需要将应用程序安装为 [管理应用程序](https://support.apple.com/guide/deployment/distribute-managed-apps-dep575bfed86/web) 有MDM解决方案.

## 财务问题

### 什么是管理配置?

被管理的配置是某个组织的EMM或MDM解决方案推向应用程序的设置,例如服务器URL或特性切换. 此插件允许您的 Capacitor app 在运行时使用 `getString`, (中文(简体) ), `getNumber`,以及 `getBoolean` 方法。 。 .

### 我应该使用这个插件还是Intune插件?

各组织可以通过两个不同的渠道提供应用程序配置,管理员经常将它们混为一谈. 此插件覆盖 **MDM 频道**; 数据 [腾讯](https://capawesome.io/docs/sdks/capacitor/intune/) 插件覆盖 **MAM 频道**数字 :

|  | MDM 频道( 此插件) | MAM频道([腾讯](https://capawesome.io/docs/sdks/capacitor/intune/)(中文(简体) ) |
| --- | --- | --- |
| 需要设备注册 | 对 | 没有 |
| 通过 | `RestrictionsManager` 编号 : `com.apple.configuration.managed` | Intune App SDK (Intune service) (英语) |
| 目标 | 设备 | 注册账户( 身份) |
| EMM供应商 | EMM/MDM供应商 | 只限微软微调 |
| 典型情景 | 公司拥有、完全管理的设备 | 不管理设备的 BYOD / 应用保护 |

如果您的组织将应用配置策略应用到 **"管理设备"** 作为Intune管理中心的传送通道,请使用此插件。 如果部署在 **"管理软件"**,使用Intune插件。 必须支持这两种情景的应用程序应读作两种渠道.

### 如果配置密钥不存在, 会发生什么 ?

这个 `getString`, (中文(简体) ), `getNumber`,以及 `getBoolean` 方法返回结果 `value` 实值 `null` 如果不存在给定密钥的映射。 您的应用程序应该处理这个案件, 例如回到默认值 .

### 我需要在应用程序中声明管理配置吗?

对,在Android上 您需要声明您的应用程序的管理配置如下: [定义管理的配置](https://developer.android.com/work/managed-configurations#define-configuration) 以便EMM解决方案能够发现并设置. 见 [安装](https://npmcn.com/package/%40capawesome/capacitor-managed-configurations/#readme-installation) 详细情况.

### 开发期间我如何测试管理配置?

在Android上,您可以设置设备所有者测试环境,例如: [设置测试的设备所有者](https://source.android.com/devices/tech/admin/testing-setup#set_up_the_device_owner_for_testing). 在iOS上,应用程序必须通过MDM解决方案作为管理下的应用程序被安装. 见 [测试您的执行](https://npmcn.com/package/%40capawesome/capacitor-managed-configurations/#readme-test-your-implementation) 详细情况.

### 支持Web平台吗?

不,那个 `getString`, (中文(简体) ), `getNumber`,以及 `getBoolean` 方法仅在Android和iOS上可用. 管理配置是移动设备管理的概念,在浏览器中不存在.

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

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

## 相关插件

-   [App 完整性](https://capawesome.io/docs/sdks/capacitor/app-integrity/): 使用 Play Guide API 和 App Attest 验证应用及设备完整性.
-   [腾讯](https://capawesome.io/docs/sdks/capacitor/intune/):用微软Intune移动应用程序管理(这个插件的MAM频道对应)保护公司数据.
-   [根检测](https://capawesome.io/docs/sdks/capacitor/root-detection/): 检测出有根有根和断裂的装置.
-   [安全优惠](https://capawesome.io/docs/sdks/capacitor/secure-preferences/):安全地存储密钥/值对,如密码,令牌或其他敏感信息.

## 通讯

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

## 更改日志

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

## 许可证

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

## 贷项

此插件基于 [管理配置](https://github.com/capawesome-team/capacitor-managed-configurations) 插件 . 感谢所有为这个项目捐款的人!

## 常见问题

### @capawesome/capacitor-managed-configurations 是什么？

在Android和iOS上访问所管理配置设置的电容插件\.

### 如何安装 @capawesome/capacitor-managed-configurations？

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

### @capawesome/capacitor-managed-configurations 支持 TypeScript 吗？

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

### @capawesome/capacitor-managed-configurations 支持 ESM 还是 CommonJS？

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

### @capawesome/capacitor-managed-configurations 可以商用吗？

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

### @capawesome/capacitor-managed-configurations 的下载量有多少？

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

### @capawesome/capacitor-managed-configurations 还在维护吗？

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