# 运行 - 手机或模拟器
通过 CLI 将 uni-app x 项目运行到手机或模拟器，支持 Android、iOS、鸿蒙平台。
适用平台：
app-android/app-ios/app-harmony。平台对照见 CLI 概述。
# launch app-android
运行到 Android App。
cli launch app-android --help
| 参数 | 说明 |
|---|---|
--help | 查看命令帮助 |
--project | 必填，项目绝对路径 |
--deviceId | 指定设备序列号，默认使用第一台设备，可通过 设备列表 获取 |
--playground | 基座类型，取值 standard 或 custom，默认 standard（自定义基座仅支持云打包基座） |
--cleanCache | 清理构建缓存，取值 true 或 false |
--native-log | 显示原生日志，取值 true 或 false |
--compile | 编译模式运行（只编译代码），取值 true 或 false |
--continue-on-error | 编译错误后继续运行 |
--pagePath | 运行到指定页面，取 pages.json 中注册的页面路径 |
--pageQuery | 启动页面的查询参数，使用 & 连接多个参数 |
# 运行到 Android App
cli launch app-android --project 项目绝对路径
# 指定设备
cli launch app-android --project 项目绝对路径 --deviceId 设备序列号
# 使用自定义基座
cli launch app-android --project 项目绝对路径 --playground custom
# 显示原生日志 + 清理构建缓存
cli launch app-android --project 项目绝对路径 --native-log true --cleanCache true
# 运行到指定页面并带查询参数
cli launch app-android --project 项目绝对路径 --pagePath pages/detail/detail --pageQuery id=123&type=product
# launch app-ios
运行到 iOS App。
cli launch app-ios --help
| 参数 | 说明 |
|---|---|
--help | 查看命令帮助 |
--project | 必填，项目绝对路径 |
--iosTarget | 运行目标，取值 device（真机）或 simulator（模拟器），默认 device |
--deviceId | 指定设备序列号 |
--playground | 基座类型，取值 standard 或 custom |
--cleanCache | 清理构建缓存，取值 true 或 false |
--compile | 编译模式运行，取值 true 或 false |
--pagePath / --pageQuery | 指定运行页面及查询参数 |
--peveloperCertificate / --provisioningProfile / --privateKey | 开发 UTS 插件时使用的证书文件、描述文件与私钥密码 |
# 运行到 iOS 真机
cli launch app-ios --project 项目绝对路径
# 运行到 iOS 模拟器
cli launch app-ios --project 项目绝对路径 --iosTarget simulator
# 开发 UTS 插件，指定证书
cli launch app-ios --project 项目绝对路径 \
--peveloperCertificate 证书文件 --provisioningProfile 描述文件 --privateKey 私钥密码
# launch app-harmony
运行到鸿蒙设备。
cli launch app-harmony --help
| 参数 | 说明 |
|---|---|
--help | 查看命令帮助 |
--project | 必填，项目绝对路径 |
--deviceId | 指定设备序列号 |
--buildType | 构建类型 |
--cleanCache | 清理构建缓存，取值 true、false 或 mandatory |
--compile | 编译模式运行，取值 true 或 false |
--pagePath / --pageQuery | 指定运行页面及查询参数 |
# 运行到鸿蒙
cli launch app-harmony --project 项目绝对路径
# 指定设备
cli launch app-harmony --project 项目绝对路径 --deviceId 设备序列号
# 常见问题
- 提示未检测到设备：先用 设备列表 确认设备已连接，或通过
--deviceId指定。 - 修改代码后没有热刷新：确认运行进程未停止；App 端原生层修改无法热刷新，需要重新运行或制作自定义基座。
更多问题见 常见问题。
