# 运行到Android App基座

App 运行使用 运行基座 实现热刷新:代码编译后同步到设备上的基座 App,修改代码即可实时生效,无需每次打包。iOS 设备请参考 运行到iOS App基座。

# 运行步骤

  1. 通过 USB 连接手机并开启开发者模式与 USB 调试,或先启动 Android 模拟器;
  2. 点击标题栏运行按钮,选择 运行到Android App基座;
  3. 在设备选择对话框中选择要运行到的设备,等待编译并自动安装到设备。

设备对话框会记住上次选择的设备,下次运行默认选中该设备;设备不可用时会自动回退到第一个可用设备。

# 设备连接

  • 支持 adb 协议,可连接 USB 真机,也可使用电脑上已启动的 Android 模拟器(如 Google 官方模拟器、雷电、夜神等);
  • 确认手机已开启 USB 调试(通常在【设置】【开发者选项】中);
  • 连接后不能选择“仅充电”模式,如为充电模式需勾选“允许 USB 调试”;
  • 设备列表为空时,可以点击刷新;仍找不到设备时,检查数据线与设置中的 ADB 路径。

# 标准基座与自定义基座

基座类型 说明
标准基座 由 DCloud 提供,使用 DCloud 的包名、证书与三方 SDK 配置,开箱即用,适合日常开发调试
自定义基座 项目修改了原生层配置时使用,保证 App 名称、图标、包名、证书、原生插件、三方 SDK、权限等配置在运行时生效

自定义基座需要通过打包生成,制作完成后 HBuilder V 会自动识别,在设备选择对话框中选择使用。

自定义基座仅用于开发调试,不可直接用于正式发版;正式发版请参考 发行 App。

# 运行日志

Android App 运行默认输出原生日志,日志会进入独立的输出通道,可在 输出 面板中查看。

# 常见问题

  • 设备列表为空或找不到设备:检查数据线连接、开发者模式与 USB 调试是否开启;
  • 修改了原生配置但运行不生效:App 原生层配置需要在自定义基座中生效,请重新制作自定义基座;
  • 安装基座失败:检查手机存储空间与系统版本,并确认已允许安装未知来源应用。

更多问题见 常见问题。