# QDMP CLI

在终端完成项目创建、登录认证和版本上传。本文命令默认使用正式开放平台。

## 安装与配置

安装 CLI，检查版本并查看当前版本支持的命令。

```bash
npm install -g qdmp-cli
qdmp-cli --version
qdmp-cli --help
```

### 关联应用

先使用开放平台账号登录 CLI。仅在项目没有 qdmp.json 时，替换 AppID 并初始化配置；已有文件时核对其中的 AppID，保留其他字段，不重复初始化。

```bash
qdmp-cli login

# 仅在项目没有 qdmp.json 时执行
qdmp-cli init -a your_app_id
```

AppID 可在开放平台控制台获取。不要把 AppSecret 放入前端代码或提交到仓库。

## 项目管理

查看可用模板，创建项目并初始化应用配置。

### 查看模板

查看当前 CLI 提供的模板。

```bash
qdmp-cli list
```

### 创建项目

使用默认模板创建本地目录；选择其他模板时，使用 -t 指定 list 中的模板名称。

```bash
qdmp-cli create my-miniapp
cd my-miniapp
```

### 拉取配置

登录 CLI 后，根据 AppID 初始化配置；已有 qdmp.json 时直接核对并复用，不要重复执行。

```bash
qdmp-cli init -a your_app_id
```

## 登录认证

使用正式开放平台账号登录 CLI，并确认当前账号和关联应用。

### 登录认证

使用开放平台用户的账号和密码登录，不是应用的 AppID 和 AppSecret。

```bash
qdmp-cli login
```

账号信息可前往 [开放平台个人资料页](https://open.qiandao.com/dashboard/profile) 查看。浏览器登录与 CLI 登录分别完成。

### 查看当前用户

确认当前账号与操作环境。

```bash
qdmp-cli getMe
```

## 构建与上传

构建方式由模板和 loader 决定，先检查项目配置与构建脚本。

### 打包构建

按模板 package.json 执行构建。使用 EMP loader 的项目可运行 qdmp-cli build；其他模板请遵循其构建说明。

```bash
# 查看 CLI 构建选项
qdmp-cli build --help

# 已配置 EMP loader 的项目
qdmp-cli build
```

### 上传版本

在项目目录上传至正式开放平台。上传不会自动设置体验版或上线。

```bash
qdmp-cli upload
```

## 完整流程

按项目模板完成开发和构建后上传，再到正式开放平台控制台设置体验版。

```bash
# 1. 安装与查看模板
npm install -g qdmp-cli
qdmp-cli list

# 2. 创建项目
qdmp-cli create my-miniapp
cd my-miniapp

# 3. 登录并关联应用
qdmp-cli login
# 仅在项目没有 qdmp.json 时执行；已有配置时核对 AppID
qdmp-cli init -a your_app_id
qdmp-cli getMe

# 4. 开发与构建
# 按所选模板的 package.json 执行构建脚本

# 5. 上传开发版本
qdmp-cli upload

# 6. 在控制台设置体验版，使用千岛 App 扫码验证
```

上传不会自动完成体验版设置、提交审核或正式发布。请在千岛 App 中验证页面和原生能力。

[查看预览体验步骤](https://open.qiandao.com/docs/getting-started.md#preview)

网页：https://open.qiandao.com/docs/backend-ops