59 lines
1.7 KiB
Markdown
59 lines
1.7 KiB
Markdown
# 执行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`|
|