# @cdx-extensions/di-sdk 中文文档

规范地址：https://npmcn.com/package/%40cdx-extensions/di-sdk/

版本：1\.1\.7
npm 元数据更新时间：2026-09-01T06:12:35.879Z
中文译文更新时间：2026-11-09T07:27:54.995Z
软件包许可：ISC

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

原始 npm 页面：https://www.npmjs.com/package/%40cdx-extensions/di-sdk
原文对照：https://npmcn.com/package/%40cdx-extensions/di-sdk/?lang=original
项目主页：https://github.com/dfh-digital-insight/cdx-extensibility-sdk#readme
源码仓库：https://github.com/dfh-digital-insight/cdx-extensibility-sdk

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

- 包体积（解压后）：16.1 kB，6 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：3 个
- 首次发布：2026-03-31T11:38:43.742Z
- 最新版本发布：2026-09-01T06:12:35.661Z
- 近 30 天下载量：4213（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 9 个）

## 中文简介

用于构建平台扩展的扩展SDK接口 - Candescent开发者经验(CDX)的一部分

## 安装

```sh
npm install @cdx-extensions/di-sdk
```

也可以使用：`pnpm add @cdx-extensions/di-sdk`、`yarn add @cdx-extensions/di-sdk`、`bun add @cdx-extensions/di-sdk`

## README

# @cdx-扩展/di-sdk

> 部分 [Candescent 开发者经验( CDX)](https://github.com/candescent-dx/extensibility-docs)

用于构建平台扩展的核心SDK接口. 此软件包提供统一的 `PlatformSDK` 财务报告和审定财务报表 **不依赖于** `@cdx-extensions/di-sdk-web` 或者说 `@cdx-extensions/di-sdk-mobile`。主机应用程序只安装它所需要的平台,并且 **登记册** 与SDK(依赖性注射). 这避免了像Metro这样的捆绑者在应用程序只使用一个时解决两个平台包.

**这个图书馆是独立的.** 运行时由 JFrog 解决依赖性 `pnpm install` 在此文件夹中。 从此目录构建并发布 .

## 安装

安装 SDK 核心 **只有您需要的平台** (网络或移动).

**网络 :**

```bash
pnpm add @cdx-extensions/di-sdk @cdx-extensions/di-sdk-web
```

**移动( 如反应原生) :**

```bash
pnpm add @cdx-extensions/di-sdk @cdx-extensions/di-sdk-mobile
```

## 快速启动

这个 **主机应用程序** (一个有 `di-sdk-web` 或者说 `di-sdk-mobile`(电话) `PlatformSDK.init({ platform })` 曾经在靴子上. **部件和扩展** 只有电话 `PlatformSDK.getInstance()` 没有争论. `getInstance()` 如果主机没有调用, 则丢弃 `init()`。 。 。 .

### 主机应用程序( bootstrap)

只有主机应用程序才能调用 `init()`。在任何部件运行前,在应用程序条目(例如根组件或主组件)上做一次.

**网页主机 :**

```typescript
import { PlatformSDK } from '@cdx-extensions/di-sdk';
import { WebPlatform } from '@cdx-extensions/di-sdk-web';

// Once at bootstrap
PlatformSDK.init({ platform: WebPlatform.getInstance() });
```

**移动主机( 如 React Industrial) :**

```typescript
import { PlatformSDK } from '@cdx-extensions/di-sdk';
import { MobilePlatform } from '@cdx-extensions/di-sdk-mobile';

// Once at bootstrap
PlatformSDK.init({ platform: MobilePlatform.getInstance() });
```

### 部件/ 扩展

部件仅依赖 `@cdx-extensions/di-sdk`。它们必须运行在一个已经呼叫 `PlatformSDK.init()`。 。 。 .

```typescript
import { PlatformSDK } from '@cdx-extensions/di-sdk';

const sdk = PlatformSDK.getInstance();
const userContext = sdk.useUserContext();
const httpClient = sdk.getHttpClient();
```

因为SDK核心从不进口 `di-sdk-web` 或者说 `di-sdk-mobile`,一个只移动的应用程序不需要安装网页软件包,Metro也不会试图解决.

关于方法、流程和图表的全部说明,见 [PLATFORM 注册.md](https://npmcn.com/package/%40cdx-extensions/di-sdk/PLATFORM_REGISTRATION.md)。 。 。 .

## 发展

从寄存器根 :

```bash
cd libs/common/extensibility-sdk
pnpm install
pnpm run build
```

出版(例如合并到 `main`:

```bash
pnpm run build
pnpm publish
```

**正在开发的出版:** 要发布此 lib 在开发过程中不影响主版本, 请从此目录中运行 : `pnpm publish --tag development`。 。 。 .

## 文档

-   [完整文档](https://github.com/candescent-dx/extensibility-docs)
-   [API 参考](https://github.com/candescent-dx/extensibility-docs/docs/api-reference)
-   [实例](https://github.com/candescent-dx/extensibility-examples-web)

## 许可证

公务员制度委员会

**CDX = 干燥开发者经验**

## 常见问题

### @cdx-extensions/di-sdk 是什么？

用于构建平台扩展的扩展SDK接口 - Candescent开发者经验\(CDX\)的一部分

### 如何安装 @cdx-extensions/di-sdk？

在项目目录运行 npm install @cdx-extensions/di-sdk，或使用 pnpm add / yarn add / bun add。

### @cdx-extensions/di-sdk 支持 TypeScript 吗？

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

### @cdx-extensions/di-sdk 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @cdx-extensions/di-sdk 可以商用吗？

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

### @cdx-extensions/di-sdk 的下载量有多少？

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

### @cdx-extensions/di-sdk 还在维护吗？

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