diff --git a/docs/tutorial/run/uts-development-android.md b/docs/tutorial/run/uts-development-android.md index 3c40d7f5723f77bda7e25b440ad54b7d13abb882..759bd63258fad4f8bdca5a61fd60fabdf32e088d 100644 --- a/docs/tutorial/run/uts-development-android.md +++ b/docs/tutorial/run/uts-development-android.md @@ -1,74 +1,87 @@ -# Android UTS扩展开发 +# Android UTS 扩展开发 > 版本要求: HBuilderX 3.6.9+ -HBuilderX 3.6.9+, 新增 uts插件 Android平台 真机运行支持三方 Gradle 仓储。 +HBuilderX 3.6.9+, 新增 uts 插件 Android 平台 真机运行支持三方 Gradle 仓储。 -运行带有uts插件的项目到Android设备,如果您遇到以下提示,请配置[运行环境](#环境配置) +运行带有 uts 插件的项目到 Android 设备,如果您遇到以下提示,请配置[运行环境](#环境配置) -## uts扩展插件 +## uts 扩展插件 -当您运行带有uts插件的项目到Android设备时,会自动安装【uts开发扩展 - Android】插件,请务必安装。具体如下: +当您运行带有 uts 插件的项目到 Android 设备时,会自动安装【uts 开发扩展 - Android】插件,请务必安装。具体如下: ## 环境配置 -> 下载插件后打开 HBuilderX到 【设置 - 插件配置】:如图 -![image](https://qiniu-web-assets.dcloud.net.cn/unidoc/zh/%E9%85%8D%E7%BD%AE.png) +> 下载插件后打开 HBuilderX 到 【设置 - 插件配置】:如图 + +![image](https://web-ext-storage.dcloud.net.cn/hx/uts-android-2.png) #### 上面的截图展示了以下配置: -##### 配置Gradle +##### 配置 Gradle + +1. 点击 Gradle 的下载地址进入下载页面。如图所示,点击红圈部分下载工具包。 + +![image](https://qiniu-web-assets.dcloud.net.cn/unidoc/zh/gradle.png) + +2. 将步骤 1 下载的内容解压后,找到 bin 目录下的执行脚本,填入 Gradle 可执行脚本路径处。 + +**注意** mac 为`%解压路径%/bin/gradle`;window 为`%解压路径%\bin\gradle.bat`。 -1. 点击图标1的下载地址进入下载页面。如图所示,点击红圈部分下载工具包。 +##### 配置 Gradle JDK - ![image](https://qiniu-web-assets.dcloud.net.cn/unidoc/zh/gradle.png) +- 不同版本 Gradle 依赖不同版本的 JDK 。HbuilderX 内置的 JDK 为 11,仅支持到 Gradle8.0 以下。如果需要配置 Gradle 版本 8.0 及以上版本需要手动下载并配置 JDK 路径。[参考文档](https://developer.android.google.cn/build/releases/past-releases?hl=zh-cn) -2. 将步骤1下载的内容解压后,找到bin目录下的执行脚本,填入图标3处。 +1. 点击 Gradle JDK 的下载地址进入下载页面,选择所需要的版本。(如本地已安装 JDK 可跳过此步骤) -**注意** mac为`%解压路径%/bin/gradle`;window为`%解压路径%\bin\gradle.bat`。 +2. 将步骤 1 下载的内容解压后,找到 Home 目录,填入 Gradle JDK 处。 -##### 配置SDK +##### 配置 SDK -点击图标2的下载地址进入安卓官网,提供如下两种形式。 +点击安卓 sdk 的下载地址进入安卓官网,提供如下两种形式。 -###### ◇ 下载Android Studio -1. 如图所示,根据平台下载Android Studio +###### ◇ 下载 Android Studio + +1. 如图所示,根据平台下载 Android Studio ![image](https://qiniu-web-assets.dcloud.net.cn/unidoc/zh/sdk-2.png) -2. 安装后获取Android Studio中sdk的路径地址填入到图标4处。 +2. 安装后获取 Android Studio 中 sdk 的路径地址填入安卓 sdk 路径处。 + +**注意** 默认路径 mac 为`/Users/用户名/Library/Android/sdk`;window 为`C:\Users\用户名\AppData\Local\Android\Sdk` -**注意** 默认路径 mac为`/Users/用户名/Library/Android/sdk`;window为`C:\Users\用户名\AppData\Local\Android\Sdk` +###### ◇ 如不需要安装 Android Studio 可通过下载 Command line tools only -###### ◇ 如不需要安装Android Studio可通过下载Command line tools only -1. 如图所示,根据平台下载Command line tools only。 +1. 如图所示,根据平台下载 Command line tools only。 ![image](https://qiniu-web-assets.dcloud.net.cn/unidoc/zh/sdk.png) -2. 下载解压后通过`%解压目录%/bin/sdkmanager脚本安装build-tools和platforms +2. 下载解压后通过`%解压目录%/bin/sdkmanager 脚本安装 build-tools 和 platforms + ``` sdkmanager --sdk_root=%sdk路径% --install "build-tools;30.0.0" sdkmanager --sdk_root=%sdk路径% --install "platforms;android-30" ``` -4. 将`%sdk路径%`配置到图标4处。 +4. 将`%sdk路径%`配置到安卓 sdk 路径处。 -5. [sdkmanager使用文档](https://developer.android.google.cn/studio/command-line/sdkmanager) +5. [sdkmanager 使用文档](https://developer.android.google.cn/studio/command-line/sdkmanager) -**注意** 下载Android Studio和下载Command line tools only选择一种形式下载sdk即可。 +**注意** 下载 Android Studio 和下载 Command line tools only 选择一种形式下载 sdk 即可。 ##### 配置示例 + 配置后如下图(根据本地目录结构有所不同) - ![image](https://qiniu-web-assets.dcloud.net.cn/unidoc/zh/%E9%85%8D%E7%BD%AE%E5%AE%8C%E6%88%90.png) +![image](https://web-ext-storage.dcloud.net.cn/hx/uts-android-1.png) **注意** - 如果环境已存在可以直接设置本地的工具包路径 -- 此插件依赖sdk目录下build-tools版本不低于30.0.0 -- 此插件依赖sdk目录下platforms版本不低于android-30 +- 此插件依赖 sdk 目录下 build-tools 版本不低于 30.0.0 +- 此插件依赖 sdk 目录下 platforms 版本不低于 android-30