# @apple/cktool\.core 中文文档

规范地址：https://npmcn.com/package/%40apple/cktool.core/

版本：1\.3\.2
npm 元数据更新时间：2025-10-22T07:27:41.164Z
中文译文更新时间：2026-11-06T17:51:40.554Z
软件包许可：SEE LICENSE IN LICENSE\.md

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

原始 npm 页面：https://www.npmjs.com/package/%40apple/cktool.core
原文对照：https://npmcn.com/package/%40apple/cktool.core/?lang=original

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

- 包体积（解压后）：231 kB，126 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：5 个
- 首次发布：2021-11-30T22:36:11.215Z
- 最新版本发布：2022-06-03T17:17:32.142Z
- 近 30 天下载量：2540（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：8（近 12 个月 0 个）

## 中文简介

Apple CKTool JS 客户端库运行时支持

## 安装

```sh
npm install @apple/cktool.core
```

也可以使用：`pnpm add @apple/cktool.core`、`yarn add @apple/cktool.core`、`bun add @apple/cktool.core`

## README

# CKTooJS核心软件包

此软件包是 CKTool JS JavaScript 客户端库套件的一部分 并用于支持其他CKTool JS软件包.

别自己用这个包裹 自动拉出 包含时 `@apple/cktool.database` 在你身边 `package.json` 依赖性.

## 开始

见 [苹果开发者文档](https://developer.apple.com/documentation/cktooljs) 关于如何开始使用CKTool JS的更多细节.

## 严格数字类型

有几种品牌类型用来标记验证值. 例如 `Int32` 类型是一个品牌数字类型,即 可转让到 `number` 不过 `number` 不可直接转让.

```ts
const a: number = toInt32(12); // OK
const b: Int32 = 12; // Error
```

## 创建函数

这个客户端库试图尽可能做到类型安全. 有几种数据类型必须验证才能存在 交给一个手术。 例如,如果 `Int32` 预计将, 您必须先通过常数 `toInt32` 铸造功能. 这个 `Int32` 铸造函数具有下列功能:

-   验证该值为数值类型.
-   验证数字为整数 `Int32` 范围.
-   返回 a `Int32` 值将会通过类型检查.

不要使用类型断言来设定相关的类型, 例如 `number` 给一个品牌类型。 这种方法不能保证汇编到 未来和无效值可能属于类型,可导致 用来在下行出错.

## Int64, Float, 和双支持

支助 `Int64`, (中文(简体) ), `Float`,以及 `Double` 以 [大数.js](https://github.com/MikeMcl/bignumber.js) 图书馆。 每当从操作中返回其中一种数字类型时,就会是 `BigNumber` 举个例子 为了执行这些案件的行动 作为增减,您需要使用 `BigNumber` 方法。 。 . 见文档 `BigNumber` 时间 [https://github.com/mikeMcl/bignature.js (中文(简体) )](https://github.com/MikeMcl/bignumber.js)。 。 。 .

这个 `toInt64` 铸造函数将完成以下工作:

-   验证该值为数值类型.
-   验证数字为整数 `Int64` 范围.
-   回返a `BigNumber` 类型实例 `Int64`。 。 。 .

这个 `toFloat` 铸造函数将完成以下工作:

-   验证该值为数值类型.
-   验证数字为整数 `Float` 范围.
-   回返a `BigNumber` 类型实例 `Float`。 。 。 .

这个 `toDouble` 铸造函数将完成以下工作:

-   验证该值为数值类型.
-   验证数字为整数 `Double` 范围.
-   回返a `BigNumber` 类型实例 `Double`。 。 。 .

## 用户界面

通过一个 `Uuid` 函数,使用 `toUuid` 铸造功能. 创建 `Uuid` 对象,使用 `createUuid` 函数.

## 常见问题

### @apple/cktool\.core 是什么？

Apple CKTool JS 客户端库运行时支持

### 如何安装 @apple/cktool\.core？

在项目目录运行 npm install @apple/cktool\.core，或使用 pnpm add / yarn add / bun add。

### @apple/cktool\.core 支持 TypeScript 吗？

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

### @apple/cktool\.core 支持 ESM 还是 CommonJS？

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

### @apple/cktool\.core 可以商用吗？

@apple/cktool\.core 使用 SEE LICENSE IN LICENSE\.md 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @apple/cktool\.core 的下载量有多少？

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

### @apple/cktool\.core 还在维护吗？

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