简体中文
简体中文
# Android UTS 扩展开发
版本要求: HBuilderX 3.6.9+
HBuilderX 3.6.9+， 新增 uts 插件 Android 平台 真机运行支持三方 Gradle 仓储。
运行带有 uts 插件的项目到 Android 设备，如果您遇到以下提示，请配置运行环境
# uts 扩展插件
当您运行带有 uts 插件的项目到 Android 设备时，会自动安装【uts 开发扩展 - Android】插件，请务必安装。具体如下：
# 环境配置
下载插件后打开 HBuilderX 到 【设置 - 插件配置】：如图
# 上面的截图展示了以下配置：
# 配置 Gradle
- 点击图标 1 的下载地址进入下载页面。如图所示，点击红圈部分下载工具包。
- 将步骤 1 下载的内容解压后，找到 bin 目录下的执行脚本，填入图标 2 处。
注意 mac 为%解压路径%/bin/gradle；window 为%解压路径%\bin\gradle.bat。
# 配置 Gradle JDK
- 不同版本 Gradle 依赖不同版本的 JDK 。HbuilderX 内置的 JDK 为 11，仅支持 Gradle8.0 以下。如配置 Gradle 为 8.0 及以上版本需要手动下载并配置 JDK 路径。配置方式如下
点击图标 3 的下载地址进入下载页面，选择所需要的版本。（如本地已安装 JDK 可跳过此步骤）
将步骤 1 下载的内容解压后，找到 Home 目录，填入图标 4 处。
注意
- HBuilderX 4.02+支持此配置项
- Gradle8.0 最低要求 JDK 版本为 17。更多版本要求参考文档
# 配置 SDK
点击图标 5 的下载地址进入安卓官网，提供如下两种形式。
# ◇ 下载 Android Studio
- 如图所示，根据平台下载 Android Studio
- 安装后获取 Android Studio 中 sdk 的路径地址填入图标 6 处。
注意
- 默认路径 mac 为
/Users/用户名/Library/Android/sdk；window 为C:\Users\用户名\AppData\Local\Android\Sdk
# ◇ 如不需要安装 Android Studio 可通过下载 Command line tools only
- 如图所示，根据平台下载 Command line tools only。
- 下载解压后通过`%解压目录%/bin/sdkmanager 脚本安装 build-tools 和 platforms
sdkmanager --sdk_root=%sdk路径% --install "build-tools;30.0.0"
sdkmanager --sdk_root=%sdk路径% --install "platforms;android-30"
将
%sdk路径%填入图标 6 处。
注意
- 下载 Android Studio 和下载 Command line tools only 选择一种形式下载 sdk 即可。
# 配置示例
配置后如下图（根据本地目录结构有所不同）
注意
- 如果环境已存在可以直接设置本地的工具包路径
- 此插件依赖 sdk 目录下 build-tools 版本不低于 30.0.0
- 此插件依赖 sdk 目录下 platforms 版本不低于 android-30
