ci: detect local harmonyos hdc tool

Author: feigeCode

ohos/README.md

@@ -68,6 +68,17 @@ hdc version
 hdc list targets
 ```
 
+If `hdc` is not on `PATH`, either add the DevEco SDK `toolchains` directory to
+`PATH` or pass it explicitly:
+
+```bash
+HDC=/path/to/hdc script/run-harmonyos-device.sh
+```
+
+The run script also checks common SDK roots from `DEVECO_SDK_HOME`,
+`OHOS_SDK_HOME`, `OHOS_BASE_SDK_HOME`, `~/Library/Huawei/Sdk`, and
+`~/Library/OpenHarmony/Sdk`.
+
 Build the package, then install and start the entry ability:
 
 ```bash

script/run-harmonyos-device.sh

@@ -6,6 +6,7 @@ DEFAULT_HAP_GLOB="${ROOT_DIR}/ohos/entry/build/default/outputs/default/"*.hap
 BUNDLE_NAME="${OHOS_BUNDLE_NAME:-com.onetcli.app}"
 ABILITY_NAME="${OHOS_ABILITY_NAME:-EntryAbility}"
 HDC_TARGET="${HDC_TARGET:-}"
+HDC_BIN="${HDC:-}"
 
 usage() {
   cat <<'USAGE'
@@ -15,6 +16,7 @@ Installs a built HarmonyOS/OpenHarmony HAP on the connected hdc target and
 starts the OnetCli entry ability.
 
 Environment:
+  HDC               Optional path to the hdc executable.
   HDC_TARGET        Optional hdc target id. Defaults to the first listed target.
   OHOS_BUNDLE_NAME Bundle name to start. Default: com.onetcli.app
   OHOS_ABILITY_NAME Ability name to start. Default: EntryAbility
@@ -26,13 +28,54 @@ Build first when no explicit HAP path is supplied:
 USAGE
 }
 
-require_tool() {
-  local tool="$1"
-  if ! command -v "${tool}" >/dev/null 2>&1; then
-    echo "missing required tool: ${tool}" >&2
-    echo "Install DevEco Studio and add its command-line tools to PATH." >&2
-    exit 127
+find_hdc() {
+  if [[ -n "${HDC_BIN}" ]]; then
+    if [[ ! -x "${HDC_BIN}" ]]; then
+      echo "HDC is not executable: ${HDC_BIN}" >&2
+      exit 127
+    fi
+    echo "${HDC_BIN}"
+    return
+  fi
+
+  if command -v hdc >/dev/null 2>&1; then
+    command -v hdc
+    return
   fi
+
+  local candidates=()
+  local roots=(
+    "${DEVECO_SDK_HOME:-}"
+    "${OHOS_SDK_HOME:-}"
+    "${OHOS_BASE_SDK_HOME:-}"
+    "${HOME}/Library/Huawei/Sdk"
+    "${HOME}/Library/OpenHarmony/Sdk"
+  )
+  local root
+  for root in "${roots[@]}"; do
+    [[ -n "${root}" && -d "${root}" ]] || continue
+    shopt -s nullglob
+    candidates+=(
+      "${root}"/toolchains/hdc
+      "${root}"/*/toolchains/hdc
+      "${root}"/*/*/toolchains/hdc
+    )
+    shopt -u nullglob
+  done
+
+  local candidate
+  if [[ "${#candidates[@]}" -gt 0 ]]; then
+    for candidate in "${candidates[@]}"; do
+      if [[ -x "${candidate}" ]]; then
+        echo "${candidate}"
+        return
+      fi
+    done
+  fi
+
+  echo "missing required tool: hdc" >&2
+  echo "Install DevEco Studio and add hdc to PATH, or set HDC=/path/to/hdc." >&2
+  exit 127
 }
 
 resolve_hap() {
@@ -62,14 +105,15 @@ resolve_hap() {
 }
 
 select_target() {
+  local hdc_bin="$1"
   if [[ -n "${HDC_TARGET}" ]]; then
     echo "${HDC_TARGET}"
     return
   fi
 
   local target
   target="$(
-    hdc list targets \
+    "${hdc_bin}" list targets \
       | sed '/^[[:space:]]*$/d;/^\[Empty\]$/d;/^List of devices/d' \
       | head -1
   )"
@@ -82,12 +126,14 @@ select_target() {
 }
 
 hdc_target_cmd() {
+  local hdc_bin="$1"
+  shift
   local target="$1"
   shift
   if [[ -n "${target}" ]]; then
-    hdc -t "${target}" "$@"
+    "${hdc_bin}" -t "${target}" "$@"
   else
-    hdc "$@"
+    "${hdc_bin}" "$@"
   fi
 }
 
@@ -97,19 +143,20 @@ main() {
     exit 0
   fi
 
-  require_tool hdc
-
+  local hdc_bin
   local hap_path
   local target
   hap_path="$(resolve_hap "${1:-}")"
-  target="$(select_target)"
+  hdc_bin="$(find_hdc)"
+  target="$(select_target "${hdc_bin}")"
 
+  echo "Using hdc: ${hdc_bin}"
   echo "Using hdc target: ${target}"
   echo "Installing HAP: ${hap_path}"
-  hdc_target_cmd "${target}" install -r "${hap_path}"
+  hdc_target_cmd "${hdc_bin}" "${target}" install -r "${hap_path}"
 
   echo "Starting ability: ${BUNDLE_NAME}/${ABILITY_NAME}"
-  hdc_target_cmd "${target}" shell aa start -b "${BUNDLE_NAME}" -a "${ABILITY_NAME}"
+  hdc_target_cmd "${hdc_bin}" "${target}" shell aa start -b "${BUNDLE_NAME}" -a "${ABILITY_NAME}"
 }
 
 main "$@"