# @bb-cli/bb-mobile 中文文档

规范地址：https://npmcn.com/package/%40bb-cli/bb-mobile/

版本：2\.0\.1-pr\.9
npm 元数据更新时间：2022-07-20T12:52:28.441Z
中文译文更新时间：2026-11-08T05:33:51.710Z
软件包许可：SEE LICENSE IN LICENSE

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

原始 npm 页面：https://www.npmjs.com/package/%40bb-cli/bb-mobile
原文对照：https://npmcn.com/package/%40bb-cli/bb-mobile/?lang=original

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

- 包体积（解压后）：64.7 kB，38 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：2 个
- 首次发布：2018-01-17T15:26:33.769Z
- 最新版本发布：2019-11-13T16:42:31.118Z
- 近 30 天下载量：1890（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 0 个）

## 中文简介

获取 bb 工程或全局选项

## 安装

```sh
npm install @bb-cli/bb-mobile
```

也可以使用：`pnpm add @bb-cli/bb-mobile`、`yarn add @bb-cli/bb-mobile`、`bun add @bb-cli/bb-mobile`

## README

# 名称

bb-mobile - 获取 bb 项目或全局选项

# 叙利亚

```bash
bb-mobile [--help] [-v|--version]
bb-mobile encrypt [--help] [-a|--hashassets] [-b|--buildvariant <buildvariantname>]
    [-d|--directory <path>] <platform>,<configuration>
bb-mobile upgrade-conf [--help] [-s|--source <version>] [-t|--target <version>]
    [-o|--output <path>] <configuration>
bb-mobile upgrade-model [--help] [-s|--source <version>] [-t|--target <version>]
    [-o|--output <path>] <model>
```

# 解释

执行与移动应用程序开发相关的命令.

当 bb- cli 命令运行时, 选项取自当前选中的 配置 .

# 二、可选办法

| 选项 | 说明 |
| --- | --- |
| \-v, --version (英语) | 输出版本编号 |
| \-- 帮助 | 产出使用信息 |

# 指挥

## 名称

bb-mobile 加密 - 加密配置文件

## 叙利亚

```bash
bb-mobile encrypt [--help] [-a|--hashassets] [-b|--buildvariant <buildvariantname>]
    [-d|--directory <path>] <platform>,<configuration>
```

## 解释

在建构时间加密配置文件 . 可选择的是,资产中的散列可以计算并添加到加密中 作为SDK运行时完整性检查功能的一部分而使用的配置.

## 二、可选办法

| 选项 | 说明 |
| --- | --- |
| \-a, -- 已经设置了 | 生成资产散列用于运行时间检查 |
| \-b, --buildingvariant "buildingvariant name" (建设变量名称) | (只有机器人) 考虑所有 |
| 散列资产时该建构变量的特有路径 |  |
| \-d, -- -- 指令<路径> | 搜索要散列的资产路径 。 在机器人, |
| 下列路径将附在给定的路径上 : /app/src/main/assets |  |
| \-- 帮助 | 产出使用信息 |

## 备注

平台 要加密配置的平台( 支持的平台: Android, ios)

配置 要加密的配置文件路径 .

## 实例

为了加密您可以使用的配置文件 :

对于Android:

```bash
  bb-mobile encrypt android app/src/main/assets/config.json
```

或用于iOS:

```bash
  bb-mobile encrypt ios assets/config.json
```

如果您想要启用运行时完整性检查, 您可以添加 - a 或 -- hassets 旗帜 .

对于Android:

```bash
  bb-mobile encrypt android app/src/main/assets/config.json -a
```

或者说

```bash
  bb-mobile encrypt android app/src/main/assets/config.json --hashassets
```

对于iOS:

```bash
  bb-mobile encrypt ios assets/config.json -a
```

或者说

```bash
  bb-mobile encrypt ios assets/config.json --hashassets
```

## 名称

bb-mobile升级-conf - 从 1. x 格式升级到 2. x 或 3. x 格式

## 叙利亚

```bash
bb-mobile upgrade-conf [--help] [-s|--source <version>] [-t|--target <version>]
    [-o|--output <path>] <configuration>
```

## 解释

将应用程序配置文件升级到更新 特定 Mobile SDK 版本所需的配置格式.

## 二、可选办法

| 选项 | 说明 |
| --- | --- |
| \-s, -- source (version) (英语) | 要升级的源版本 |
| \-t, -- 目标 <version> | 目标版本升级至 |
| \-o, --输出<路径> | 升级配置输出路径 . |
| 如果不提供,则升级配置将在标准输出中输出(Stdout) |  |
| \-- 帮助 | 产出使用信息 |

## 备注

配置 要升级的配置文件路径 .

## 实例

为了升级配置文件,您可以使用:

```bash
  bb-mobile upgrade-conf app/src/main/assets/config.json -o app/src/main/assets/config-3.json
```

如果您想要简单地预览升级的结果, 您可以省略 -- 输出参数和 将在标准输出上显示结果

```bash
  bb-mobile upgrade-conf app/src/main/assets/config.json
```

如果您想要将配置从第1版迁移到第3版,可以使用:

```bash
  bb-mobile upgrade-conf app/src/main/assets/config.json -s 1 -t 3 -o config-3.json
```

或者,省去目标版本作为3是默认值.

```bash
  bb-mobile upgrade-conf app/src/main/assets/config.json -s 1 -o config-3.json
```

如果您想要将一个配置从第二版迁移到第三版,可以使用:

```bash
  bb-mobile upgrade-conf app/src/main/assets/config.json -t 3 -o config-3.json
```

\-s 2 旗可以省略,因为 2 是默认的源版本.

## 名称

bb-mobile升级-模型 - 从1.x格式升级为2.x或3.4格式的模型文件(本地模型) (移动优化)

## 叙利亚

```bash
bb-mobile upgrade-model [--help] [-s|--source <version>] [-t|--target <version>]
    [-o|--output <path>] <model>
```

## 解释

将应用程序模型文件升级到更新 一个特定的 Mobile SDK 版本所要求的模型格式.

## 二、可选办法

| 选项 | 说明 |
| --- | --- |
| \-s, -- source (version) (英语) | 要升级的源版本 |
| \-t, -- 目标 <version> | 目标版本升级至 |
| \-o, --输出<路径> | 升级模型输出路径 . |
| 如果不提供,则升级的模型将在标准输出中输出(Stdout) |  |
| \-- 帮助 | 产出使用信息 |

## 备注

模式 要升级的本地模式文件路径 .

## 实例

为了升级本地模型文件,您可以使用:

```bash
  bb-mobile upgrade-model app/src/main/assets/local_model.json -o app/src/main/assets/local_model-3.json
```

如果您想要简单地预览升级的结果, 您可以省略 -- 输出参数和 将在标准输出上显示结果

```bash
  bb-mobile upgrade-model app/src/main/assets/local_model.json
```

如果想要将本地模型从第1版迁移到第3.4版,可以使用:

```bash
  bb-mobile upgrade-model app/src/main/assets/local_model.json -s 1 -t 3.4 -o local_model-3.json
```

或,省去目标版本为3.4是默认.

```bash
  bb-mobile upgrade-model app/src/main/assets/local_model.json -s 1 -o local_model-3.json
```

如果想要将本地模式从第2版迁移到第3.4版,可以使用:

```bash
  bb-mobile upgrade-model app/src/main/assets/local_model.json -t 3.4 -o local_model-3.json
```

\-s 2 旗可以省略,因为 2 是默认的源版本.

# 环境变量

设置日志输出量

```bash
LOG_LEVEL=silly|verbose|info|warn|error
```

设定是否在输出中使用颜色

```bash
COLOR=false|true
```

## 常见问题

### @bb-cli/bb-mobile 是什么？

获取 bb 工程或全局选项

### 如何安装 @bb-cli/bb-mobile？

在项目目录运行 npm install @bb-cli/bb-mobile，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 bb-mobile，可以用 npx bb-mobile 直接运行。

### @bb-cli/bb-mobile 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/bb-cli\_\_bb-mobile 是否存在。

### @bb-cli/bb-mobile 支持 ESM 还是 CommonJS？

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

### @bb-cli/bb-mobile 可以商用吗？

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

### @bb-cli/bb-mobile 的下载量有多少？

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

### @bb-cli/bb-mobile 还在维护吗？

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