# 执行Preload测试文档

按照步骤一步一步的执行：

1. 如果用户没有提供项目信息，询问用户项目名称，不支持五码或者别名，建议输入项目完整名称。

2. 将用户提供的项目名称，作为`generatePreloadUpdateLink`工具的`project`参数发起调用，若遇到失败，则告诉用户失败原因并终止流程。

成功示例：

```json
{
  "downloadUrl": "string",
  "project": "string",
  "osVer": "string",
  "os": "string",
  "preloadVersion": "string",
  "locationName": "string"
}
```

失败示例：

```json
{
  "success": false,
  "msg": "string"
}
```

参数说明：

| 参数名称 | 含义 |
| --- | --- |
| `downloadUrl` | 生成的 preload 更新下载链接 |
| `project` | 项目名称 |
| `osVer` |  OS版本 |
| `os` | OS目录名 |
| `preloadVersion` | 实际使用的 Preload VER |
| `locationName` | 实际使用的 Location |
| `success` | 当值为false的时候，意味着失败，成功时不返回`success`字段 |
| `msg` | 当`success`字段值为fasle时，该字段作为失败原因 |

3. 阅读[查测试机的文档](./query_test_device_doc.md)获取`testUnitUuid`和`testUnitName`。

4. 使用[请求模板文件](../example/task_preload_request.json)，**一字不改地生成**1个JSON字符串，再根据[变量表](#变量表)执行变量替换。

## 变量表

JSON字符串中变量的格式示例：{id}，根据取值规则查找并替换。

|变量名称|取值规则|
|---|---|
|id|随机生成1个由小写字母、数字组成的7位长度字符串（示例：2b43cb39）|
|date|从**上下文变量**取今天的日期|
|testUnitUuid|调用工具获得的测试机ID|
|testUnitName|调用工具获得的测试机名称|
|downloadUrl|调用工具获得的`downloadUrl`|