| 承载协议 | HTTPS |
|---|---|
| 接口方向 | 开发者服务器 -> 华为服务器 |
| 接口方法 | POST |
| 接口URL | https://connect-api.cloud.huawei.com/api/gpos/binary/instrumentation |
| 数据格式 |
|
在相同packageName和version的情况下,若待传文件的objectId和之前某次未执行失败的插桩任务传入的完全一样,则会直接返回之前已生成的插桩任务ID。
| 参数 | 类型 | 必选(M)/可选(O) | 说明 |
|---|---|---|---|
| soFileInfos | List<InstrumentationSoInfo> | M | 文件信息。最多20条。 |
| packageName | string | M | 原始so文件所在游戏的包名,与创建项目和应用时保持一致。最大长度256个字符。 |
| version | string | M | 原始so文件所在游戏的版本号,例如“1.0.0”。最大长度64个字符。 |
| note | string | O | 插桩任务的备注信息,最大长度1024个字符。 |
| 参数 | 类型 | 必选(M)/可选(O) | 说明 |
|---|---|---|---|
| soObjectId | string | M | 原始so文件的对象ID,即调用获取so文件上传地址接口返回的objectId。最大长度512个字符。 |
| portStart | int | O | 工具包中trigger工具触发采集profile数据的端口号,请填写未被占用的端口号,默认端口号3040。端口号范围为1024到65535,且跟设备上使用的端口号不冲突。 说明:
|
POST /api/gpos/binary/instrumentation
Host: connect-api.cloud.huawei.com
Content-Type: application/json
client_id: ***
Authorization: Bearer ***
projectId: ***
{
"soFileInfos": [
{
"soObjectId": "pvt_2/GameCenter_perf_900_9/2/v3/8VJBonG4T1CyxP88MM0IuQ/xxx.so",
"portStart": 3041
}
],
"packageName": "com.test.company",
"version": "1.0.0",
"note":"任务备注信息"
} | 参数 | 类型 | 必选(M)/可选(O) | 说明 |
|---|---|---|---|
| ret | M | 包含返回码及描述信息的JSON字符串,格式为{"code":retcode, "msg": "description"}。 | |
| data | O | 若调用成功,将返回插桩任务ID。 |
| 参数 | 类型 | 必选(M)/可选(O) | 说明 |
|---|---|---|---|
| code | int | O | 返回码。 |
| msg | string | O | 描述信息。 |
SubmitBinaryInstrumentationResult参数说明
| 参数 | 类型 | 必选(M)/可选(O) | 说明 |
|---|---|---|---|
| taskIds | List<string> | M | 插桩任务ID列表,调用获取插桩结果接口即可查询任务信息。 |
| code | msg | Description |
|---|---|---|
| 0 | Success. | 成功。 |
| 1004 | Unfinished task number has reached limit. | 当前未完成的插桩任务数累计超过20个。 |
| 1012 | file info num not match. | soObjectId传入错误,请检查与调用获取文件上传地址接口后返回的objectId是否一致。 |
| 3001 | invalid parameters. | 参数错误。 |