Skip to content

Commit 4b43684

Browse files
trlgmltrlgml
committed
fix:update
1 parent c9cb0ae commit 4b43684

16 files changed

+1708
-244
lines changed

‎zh-cn/cli/_sidebar.md‎

Lines changed: 25 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,28 @@
1-
* [cli概述](/cli/README.md)
2-
* cli命令
3-
* [用户账号操作](/cli/user.md)
4-
* [关闭/打开项目](/cli/project.md)
5-
* [打开文件](/cli/file.md)
6-
* [uni-app发行 - Android/iOS云打包](/cli/pack.md)
7-
* [uni-app发行 - App生成本地打包资源](/cli/publish-app-appResource.md)
8-
* [uni-app发行 - App-Harmony-本地打包](/cli/pack-app-harmony.md)
9-
* [uni-app发行 - App-Harmony-本地打包App资源](/cli/publish-app-harmony.md)
10-
* [uni-app发行 - App制作应用wgt包](/cli/publish-app-wgt.md)
11-
* [uni-app发行 - 微信小程序](cli/publish-mp-weixin.md)
12-
* [uni-app发行 - 支付宝小程序](cli/publish-mp-alipay.md)
13-
* [uni-app发行 - 鸿蒙元服务打包](/cli/pack-mp-harmony.md)
14-
* [uni-app发行 - WEB](cli/publish-h5.md)
15-
* [uniCloud](/cli/uniCloud.md)
16-
* [前端网页托管](/cli/uniCloud-hosting.md)
17-
* 扩展
18-
* [配置环境变量](/cli/env.md)
19-
* [Linux 安装插件市场插件](/cli/linux-install-market-plugin.md)
1+
- [cli 概述](/cli/README.md)
2+
- cli 命令
3+
- [用户账号操作](/cli/user.md)
4+
- [关闭/打开项目](/cli/project.md)
5+
- [打开文件](/cli/file.md)
6+
- [uni-app 发行 - Android/iOS 云打包](/cli/pack.md)
7+
- [uni-app 发行 - App 生成本地打包资源](/cli/publish-app-appResource.md)
8+
- [uni-app 发行 - App-Harmony-本地打包](/cli/pack-app-harmony.md)
9+
- [uni-app 发行 - App-Harmony-本地打包 App 资源](/cli/publish-app-harmony.md)
10+
- [uni-app 发行 - App 制作应用 wgt 包](/cli/publish-app-wgt.md)
11+
- [uni-app 发行 - WEB](cli/publish-h5.md)
12+
- [uni-app 发行 - 小程序](cli/publish-miniProgram.md)
13+
- [uni-app 发行 - 鸿蒙元服务打包](/cli/pack-mp-harmony.md)
14+
- [uni-app 运行 - 手机或模拟器](cli/launch-app.md)
15+
- [uni-app 运行 - WEB](cli/launch-web.md)
16+
- [uni-app 运行 - 小程序](cli/launch-miniProgram.md)
17+
- [uni-app 运行日志 - 手机或模拟器](cli/logcat-app.md)
18+
- [uni-app 运行日志 - WEB](cli/logcat-web.md)
19+
- [uni-app 运行日志 - 小程序](cli/logcat-miniProgram.md)
20+
- [获取设备列表](/cli/devices-list.md)
21+
- [uniCloud](/cli/uniCloud.md)
22+
- [前端网页托管](/cli/uniCloud-hosting.md)
23+
- 扩展
24+
_ [配置环境变量](/cli/env.md)
25+
_ [Linux 安装插件市场插件](/cli/linux-install-market-plugin.md)
2026
<div class="contact-box">
2127
<a href="https://www.dcloud.io/hbuilderx.html" target="_blank" class="contact-item">
2228
<img src="/static/favicon/favicon.png" width="20" height="21">

‎zh-cn/cli/devices-list.md‎

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
# CLI 获取设备列表
2+
3+
> HBuilderX cli 命令行工具
4+
5+
通过 CLI 获取可用的设备列表。
6+
7+
## 命令说明
8+
9+
### devices list
10+
11+
获取设备列表
12+
13+
**用法：**
14+
15+
```shell
16+
./cli devices list --help
17+
```
18+
19+
**参数：**
20+
21+
| 参数名称 | 描述 |
22+
| ---------- | --------------------------------------------------------------------------------------------- |
23+
| --help | 显示 cli 命令帮助 |
24+
| --platform | 设备类型，取值：android、ios-iPhone、ios-simulator、mp-harmony、app-harmony，默认值为 android |
25+
26+
**使用示例：**
27+
28+
```shell
29+
# 获取Android设备列表（默认）
30+
./cli devices list
31+
32+
# 获取Android设备列表（指定平台）
33+
./cli devices list --platform android
34+
35+
# 获取iPhone设备列表
36+
./cli devices list --platform ios-iPhone
37+
38+
# 获取iOS模拟器列表
39+
./cli devices list --platform ios-simulator
40+
41+
# 获取鸿蒙元服务设备列表
42+
./cli devices list --platform mp-harmony
43+
44+
# 获取鸿蒙App设备列表
45+
./cli devices list --platform app-harmony
46+
```

‎zh-cn/cli/launch-app.md‎

Lines changed: 170 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,170 @@
1+
# CLI uni-app 运行 - 手机或模拟器@launch-app
2+
3+
> HBuilderX cli 命令行工具
4+
5+
通过 CLI 运行到手机或模拟器的 uni-app 应用，支持 Android、iOS、鸿蒙平台。
6+
7+
## 命令说明
8+
9+
### launch app-android
10+
11+
运行到 Android App
12+
13+
**用法：**
14+
15+
```shell
16+
./cli launch app-android --help
17+
```
18+
19+
**参数：**
20+
21+
| 参数名称 | 描述 |
22+
| ------------------- | ----------------------------------------------------------------------------------- |
23+
| --help | 显示 cli 命令帮助 |
24+
| --project | HBuilder X 里导入的项目名称或绝对路径 |
25+
| --deviceId | 指定要使用的设备序列号，默认使用第一个设备，可通过 devices list 获取设备列表 |
26+
| --playground | 基座类型（自定义基座仅支持云打包基座），取值：standard 或 custom，默认值为 standard |
27+
| --native-log | 显示原生日志，取值：true 或 false，默认值为 false |
28+
| --cleanCache | 清理构建缓存（仅 uni-app x 项目生效），取值：true 或 false，默认值为 false |
29+
| --compile | 编译模式运行（只编译代码），取值：true 或 false，默认值为 false |
30+
| --continue-on-error | 编译错误后继续运行，取值：true 或 false，默认值为 false |
31+
32+
**使用示例：**
33+
34+
```shell
35+
# 运行到Android App
36+
./cli launch app-android --project 项目名称
37+
38+
# 运行到Android App（指定设备）
39+
./cli launch app-android --project 项目名称 --deviceId 设备序列号
40+
41+
# 运行到Android App（使用自定义基座）
42+
./cli launch app-android --project 项目名称 --playground custom
43+
44+
# 运行到Android App（显示原生日志）
45+
./cli launch app-android --project 项目名称 --native-log true
46+
47+
# 运行到Android App（清理构建缓存）
48+
./cli launch app-android --project 项目名称 --cleanCache true
49+
50+
# 运行到Android App（编译模式运行）
51+
./cli launch app-android --project 项目名称 --compile true
52+
53+
# 运行到Android App（编译错误后继续运行）
54+
./cli launch app-android --project 项目名称 --continue-on-error true
55+
56+
# 运行到Android App（组合参数：指定设备 + 使用自定义基座）
57+
./cli launch app-android --project 项目名称 --deviceId 设备序列号 --playground custom
58+
59+
# 运行到Android App（组合参数：编译模式 + 显示原生日志）
60+
./cli launch app-android --project 项目名称 --compile true --native-log true
61+
62+
# 运行到Android App（组合参数：清理构建缓存 + 编译模式）
63+
./cli launch app-android --project 项目名称 --cleanCache true --compile true
64+
```
65+
66+
### launch app-ios
67+
68+
运行到 iOS App
69+
70+
**用法：**
71+
72+
```shell
73+
./cli launch app-ios --help
74+
```
75+
76+
**参数：**
77+
78+
| 参数名称 | 描述 |
79+
| ---------------------- | ----------------------------------------------------------------------------------- |
80+
| --help | 显示 cli 命令帮助 |
81+
| --project | HBuilder X 里导入的项目名称或绝对路径 |
82+
| --deviceId | 指定要使用的设备序列号，默认使用第一个设备，可通过 devices list 获取设备列表 |
83+
| --iosTarget | 设备类型，取值：device 或 simulator，默认值为 device |
84+
| --playground | 基座类型（自定义基座仅支持云打包基座），取值：standard 或 custom，默认值为 standard |
85+
| --cleanCache | 清理构建缓存（仅 uni-app x 项目生效），取值：true 或 false，默认值为 false |
86+
| --compile | 编译模式运行（只编译代码），取值：true 或 false，默认值为 false |
87+
| --continue-on-error | 编译错误后继续运行，取值：true 或 false，默认值为 false |
88+
| --peveloperCertificate | 开发者证书文件（开发 uts 插件需要） |
89+
| --provisioningProfile | 配置描述文件（开发 uts 插件需要） |
90+
| --privateKey | 私钥密码（开发 uts 插件需要） |
91+
92+
**使用示例：**
93+
94+
```shell
95+
# 运行到iOS App（真机）
96+
./cli launch app-ios --project 项目名称
97+
98+
# 运行到iOS App（模拟器）
99+
./cli launch app-ios --project 项目名称 --iosTarget simulator
100+
101+
# 运行到iOS App（指定设备）
102+
./cli launch app-ios --project 项目名称 --deviceId 设备序列号
103+
104+
# 运行到iOS App（使用自定义基座）
105+
./cli launch app-ios --project 项目名称 --playground custom
106+
107+
# 运行到iOS App（清理构建缓存）
108+
./cli launch app-ios --project 项目名称 --cleanCache true
109+
110+
# 运行到iOS App（编译模式运行）
111+
./cli launch app-ios --project 项目名称 --compile true
112+
113+
# 运行到iOS App（编译错误后继续运行）
114+
./cli launch app-ios --project 项目名称 --continue-on-error true
115+
116+
# 运行到iOS App（开发uts插件，指定证书）
117+
./cli launch app-ios --project 项目名称 --peveloperCertificate 证书文件 --provisioningProfile 描述文件 --privateKey 私钥密码
118+
119+
# 运行到iOS App（组合参数：模拟器 + 使用自定义基座）
120+
./cli launch app-ios --project 项目名称 --iosTarget simulator --playground custom
121+
122+
# 运行到iOS App（组合参数：编译模式 + 清理构建缓存）
123+
./cli launch app-ios --project 项目名称 --compile true --cleanCache true
124+
```
125+
126+
### launch app-harmony
127+
128+
运行到鸿蒙
129+
130+
**用法：**
131+
132+
```shell
133+
cli launch app-harmony --help
134+
```
135+
136+
**参数：**
137+
138+
| 参数名称 | 描述 |
139+
| ------------------- | ---------------------------------------------------------------------------- |
140+
| --help | cli 命令帮助 |
141+
| --project | HBuilder X 里导入的项目绝对路径或目录名 |
142+
| --deviceId | 指定要使用的设备序列号，默认使用第一个设备，可通过 devices list 获取设备列表 |
143+
| --cleanCache | 清理构建缓存，取值：true 或 false，默认值为 false |
144+
| --compile | 编译模式运行（只编译代码），取值：true 或 false，默认值为 false |
145+
| --continue-on-error | 编译错误后继续运行，取值：true 或 false，默认值为 false |
146+
147+
**使用示例：**
148+
149+
```shell
150+
# 运行到鸿蒙
151+
cli launch app-harmony --project 项目名称
152+
153+
# 运行到鸿蒙（指定设备）
154+
cli launch app-harmony --project 项目名称 --deviceId 设备序列号
155+
156+
# 运行到鸿蒙（清理构建缓存）
157+
cli launch app-harmony --project 项目名称 --cleanCache true
158+
159+
# 运行到鸿蒙（编译模式运行）
160+
cli launch app-harmony --project 项目名称 --compile true
161+
162+
# 运行到鸿蒙（编译错误后继续运行）
163+
cli launch app-harmony --project 项目名称 --continue-on-error true
164+
165+
# 运行到鸿蒙（组合参数：指定设备 + 清理构建缓存）
166+
cli launch app-harmony --project 项目名称 --deviceId 设备序列号 --cleanCache true
167+
168+
# 运行到鸿蒙（组合参数：编译模式 + 清理构建缓存）
169+
cli launch app-harmony --project 项目名称 --compile true --cleanCache true
170+
```

0 commit comments

Comments
 (0)