|
2 | 2 |
|
3 | 3 | > HBuilderX cli 命令行工具 |
4 | 4 |
|
| 5 | +> 仅适用于 HBuilderX 4.87+ 版本 |
| 6 | +
|
| 7 | +> 您也可以通过 npm 包使用此功能:[@dcloudio/hbuilderx-cli](https://www.npmjs.com/package/@dcloudio/hbuilderx-cli) |
| 8 | +
|
5 | 9 | 通过 CLI 查看运行到手机或模拟器的 uni-app 应用日志,支持 Android、iOS、鸿蒙平台。 |
6 | 10 |
|
7 | 11 | ## 命令说明 |
|
18 | 22 |
|
19 | 23 | **参数:** |
20 | 24 |
|
21 | | -| 参数名称 | 描述 | |
22 | | -| --------------- | ----------------------------------------------------------------------------- | |
23 | | -| --help | 显示 cli 命令帮助 | |
24 | | -| --project | HBuilder X 里导入的项目名称或绝对路径 | |
25 | | -| --deviceId | 指定要使用的设备序列号,默认使用第一个设备,可通过 devices list 获取设备列表 | |
26 | | -| --wait-for-stop | 等待运行停止后再退出,取值:true 或 false,默认值为 false | |
27 | | -| --full-log | 获取完整编译日志,默认仅显示最新编译日志,取值:true 或 false,默认值为 false | |
| 25 | +| 参数名称 | 描述 | |
| 26 | +| ---------- | ---------------------------------------------------------------------------- | |
| 27 | +| --help | 显示 cli 命令帮助 | |
| 28 | +| --project | HBuilder X 里导入的项目名称或绝对路径 | |
| 29 | +| --deviceId | 指定要使用的设备序列号,默认使用第一个设备,可通过 devices list 获取设备列表 | |
| 30 | +| --mode | 日志模式,取值:full、lastBuild、prevBuild,默认值为 prevBuild | |
28 | 31 |
|
29 | 32 | **使用示例:** |
30 | 33 |
|
|
35 | 38 | # 查看Android App日志(指定设备) |
36 | 39 | ./cli logcat app-android --project 项目名称 --deviceId 设备序列号 |
37 | 40 |
|
38 | | -# 查看Android App日志(等待运行停止) |
39 | | -./cli logcat app-android --project 项目名称 --wait-for-stop true |
40 | | - |
41 | | -# 查看Android App日志(获取完整日志) |
42 | | -./cli logcat app-android --project 项目名称 --full-log true |
| 41 | +# 查看Android App日志(指定日志模式) |
| 42 | +./cli logcat app-android --project 项目名称 --mode full |
43 | 43 |
|
44 | | -# 查看Android App日志(组合参数:指定设备 + 等待停止 + 完整日志) |
45 | | -./cli logcat app-android --project 项目名称 --deviceId 设备序列号 --wait-for-stop true --full-log true |
| 44 | +# 查看Android App日志(组合参数:指定设备 + 日志模式) |
| 45 | +./cli logcat app-android --project 项目名称 --deviceId 设备序列号 --mode lastBuild |
46 | 46 | ``` |
47 | 47 |
|
48 | 48 | ### logcat app-ios |
|
57 | 57 |
|
58 | 58 | **参数:** |
59 | 59 |
|
60 | | -| 参数名称 | 描述 | |
61 | | -| --------------- | ----------------------------------------------------------------------------- | |
62 | | -| --help | 显示 cli 命令帮助 | |
63 | | -| --project | HBuilder X 里导入的项目名称或绝对路径 | |
64 | | -| --deviceId | 指定要使用的设备序列号,默认使用第一个设备,可通过 devices list 获取设备列表 | |
65 | | -| --iosTarget | 设备类型,取值:device 或 simulator,默认值为 device | |
66 | | -| --wait-for-stop | 等待运行停止后再退出,取值:true 或 false,默认值为 false | |
67 | | -| --full-log | 获取完整编译日志,默认仅显示最新编译日志,取值:true 或 false,默认值为 false | |
| 60 | +| 参数名称 | 描述 | |
| 61 | +| ----------- | ---------------------------------------------------------------------------- | |
| 62 | +| --help | 显示 cli 命令帮助 | |
| 63 | +| --project | HBuilder X 里导入的项目名称或绝对路径 | |
| 64 | +| --deviceId | 指定要使用的设备序列号,默认使用第一个设备,可通过 devices list 获取设备列表 | |
| 65 | +| --iosTarget | 设备类型,取值:device 或 simulator,默认值为 device | |
| 66 | +| --mode | 日志模式,取值:full、lastBuild、prevBuild,默认值为 prevBuild | |
68 | 67 |
|
69 | 68 | **使用示例:** |
70 | 69 |
|
|
78 | 77 | # 查看iOS App日志(指定设备) |
79 | 78 | ./cli logcat app-ios --project 项目名称 --deviceId 设备序列号 |
80 | 79 |
|
81 | | -# 查看iOS App日志(等待运行停止) |
82 | | -./cli logcat app-ios --project 项目名称 --wait-for-stop true |
| 80 | +# 查看iOS App日志(指定日志模式) |
| 81 | +./cli logcat app-ios --project 项目名称 --mode full |
83 | 82 |
|
84 | | -# 查看iOS App日志(获取完整日志) |
85 | | -./cli logcat app-ios --project 项目名称 --full-log true |
86 | | - |
87 | | -# 查看iOS App日志(组合参数:模拟器 + 指定设备 + 等待停止 + 完整日志) |
88 | | -./cli logcat app-ios --project 项目名称 --iosTarget simulator --deviceId 设备序列号 --wait-for-stop true --full-log true |
| 83 | +# 查看iOS App日志(组合参数:模拟器 + 指定设备 + 日志模式) |
| 84 | +./cli logcat app-ios --project 项目名称 --iosTarget simulator --deviceId 设备序列号 --mode lastBuild |
89 | 85 | ``` |
90 | 86 |
|
91 | 87 | ### logcat app-harmony |
|
100 | 96 |
|
101 | 97 | **参数:** |
102 | 98 |
|
103 | | -| 参数名称 | 描述 | |
104 | | -| --------------- | ----------------------------------------------------------------------------- | |
105 | | -| --help | 显示 cli 命令帮助 | |
106 | | -| --project | HBuilder X 里导入的项目名称或绝对路径 | |
107 | | -| --deviceId | 指定要使用的设备序列号,默认使用第一个设备,可通过 devices list 获取设备列表 | |
108 | | -| --wait-for-stop | 等待运行停止后再退出,取值:true 或 false,默认值为 false | |
109 | | -| --full-log | 获取完整编译日志,默认仅显示最新编译日志,取值:true 或 false,默认值为 false | |
| 99 | +| 参数名称 | 描述 | |
| 100 | +| ---------- | ---------------------------------------------------------------------------- | |
| 101 | +| --help | 显示 cli 命令帮助 | |
| 102 | +| --project | HBuilder X 里导入的项目名称或绝对路径 | |
| 103 | +| --deviceId | 指定要使用的设备序列号,默认使用第一个设备,可通过 devices list 获取设备列表 | |
| 104 | +| --mode | 日志模式,取值:full、lastBuild、prevBuild,默认值为 prevBuild | |
110 | 105 |
|
111 | 106 | **使用示例:** |
112 | 107 |
|
|
117 | 112 | # 查看鸿蒙App日志(指定设备) |
118 | 113 | ./cli logcat app-harmony --project 项目名称 --deviceId 设备序列号 |
119 | 114 |
|
120 | | -# 查看鸿蒙App日志(等待运行停止) |
121 | | -./cli logcat app-harmony --project 项目名称 --wait-for-stop true |
122 | | - |
123 | | -# 查看鸿蒙App日志(获取完整日志) |
124 | | -./cli logcat app-harmony --project 项目名称 --full-log true |
| 115 | +# 查看鸿蒙App日志(指定日志模式) |
| 116 | +./cli logcat app-harmony --project 项目名称 --mode full |
125 | 117 |
|
126 | | -# 查看鸿蒙App日志(组合参数:指定设备 + 等待停止 + 完整日志) |
127 | | -./cli logcat app-harmony --project 项目名称 --deviceId 设备序列号 --wait-for-stop true --full-log true |
| 118 | +# 查看鸿蒙App日志(组合参数:指定设备 + 日志模式) |
| 119 | +./cli logcat app-harmony --project 项目名称 --deviceId 设备序列号 --mode lastBuild |
128 | 120 | ``` |
0 commit comments