# Hướng dẫn kết nối Appium

Dùng Appium Inspector trên macOS hoặc Windows với mọi điện thoại đám mây MoreLogin có hỗ trợ ADB và đáp ứng yêu cầu của trình điều khiển UiAutomator2. Quy trình đã được kiểm thử từ đầu đến cuối với Android 15 trên Windows và Android 15A trên macOS. Chạy ADB, Appium Server và Inspector trên cùng một máy tính.

## Lấy thông tin kết nối ADB

Trong MoreLogin Desktop, mở **Hồ sơ → Điện thoại đám mây** và khởi động thiết bị. Mở menu **⋯** trên hàng tương ứng và chọn **Bật ADB**. Nếu chưa thấy cột ADB, cuộn ngang bảng rồi di chuột lên trạng thái **Đã bật**.

![Menu bật ADB](/assets/ml-enable.f15fca406b0642892c6d64f82f8293ff2ea998b2247fd5f57ae4c359796fc524.f59a5fd3.png)

Nếu có địa chỉ và mã kết nối, dùng ADB trực tiếp như ví dụ Android 15. Nếu có lệnh và mật khẩu SSH, tạo đường hầm như ví dụ Android 15A. Dùng thông tin hiện tại trong bảng bật lên.

![Thông tin kết nối trực tiếp đã che giá trị](/assets/ml-popup15.59c6a444c67e1d0293f95d90a2b9076847bc6d300dd700dba298dba5ccc639df.f59a5fd3.png)

![Thông tin SSH đã che giá trị](/assets/ml-popup15a.d5026fe728e2d59573d8d7fe1a88187425b447cf3ff9047fbf2b85311195f787.f59a5fd3.png)

## Thiết lập Android SDK, Java và Node.js

Trong SDK Manager của Android Studio, cài SDK Platform phù hợp với phiên bản Android đích và **Android SDK Platform-Tools**. Cài JDK 17 và Node.js 24 LTS với npm 10 trở lên. Trên macOS, thay đường dẫn theo vị trí cài đặt. Trên Windows, đặt biến môi trường người dùng hoặc chạy các lệnh bên dưới trong cùng cửa sổ PowerShell dùng để khởi động Appium.

### macOS

```bash
export ANDROID_HOME="$HOME/Library/Android/sdk"
export JAVA_HOME="$(/usr/libexec/java_home -v 17)"
export PATH="$ANDROID_HOME/platform-tools:$JAVA_HOME/bin:$PATH"
```

### Windows PowerShell

```powershell
$env:ANDROID_HOME = 'C:\Android\Sdk'
$env:JAVA_HOME = 'C:\Program Files\Java\jdk-17'
$env:Path = "$env:JAVA_HOME\bin;$env:ANDROID_HOME\platform-tools;$env:Path"
java -version
adb version
```

Nếu `adb version` chạy được nhưng Doctor không tìm thấy SDK, dùng `(Get-Command adb).Source` trên Windows. Thư mục gốc SDK chứa `platform-tools`. Đặt thư mục `bin` của JDK 17 trước các bản Java cũ trong Path. Mở lại PowerShell sau khi đổi biến môi trường người dùng.

## Kết nối ADB

Khi kết nối trực tiếp, thay `DEVICE_ADDRESS` và `CONNECTION_CODE` bằng thông tin từ MoreLogin. Giữ nguyên chữ hoa và chữ thường của mã. Trạng thái `device` cho biết kết nối ADB đã được thiết lập. Khi gặp `Access denied! Invalid password.`, xác thực bằng mã hiện tại. Thành công có thể hiện `OK! Login successful.`. Nếu vào shell của thiết bị, gõ `exit` để quay lại.

```text
adb connect DEVICE_ADDRESS
adb -s DEVICE_ADDRESS shell CONNECTION_CODE
```

Khi kết nối qua SSH, chạy `ssh -V` để kiểm tra. Nếu thiếu, cài **OpenSSH Client** trong Tính năng tùy chọn của Windows. Chạy đầy đủ lệnh SSH và nhập mật khẩu từ MoreLogin. Nếu SSH trên Windows không chấp nhận `-Nf`, đổi thành `-N` và giữ cửa sổ đó mở. Trong cửa sổ khác, kết nối địa chỉ hiển thị trong MoreLogin. Cổng 9897 chỉ là ví dụ.

```text
adb connect localhost:9897
```

Chạy `adb devices -l` và xác nhận hàng thiết bị có trạng thái `device`. Dùng đúng giá trị cột đầu trong `adb -s DEVICE_IDENTIFIER shell getprop ro.build.version.release`. Nếu nhận được phiên bản Android, dùng cùng mã thiết bị cho `appium:udid`.

[Hướng dẫn kết nối ADB](/vi/api-reference/cloud-phone/adb)

## Cài Appium, UiAutomator2 và khởi động máy chủ

Nếu đã cài Appium 3 hoặc UiAutomator2, bỏ qua lệnh cài tương ứng. Dừng máy chủ trước khi cài trình điều khiển. Kiểm tra danh sách có `uiautomator2` và xử lý lỗi ADB hoặc Java do Doctor báo. Nếu Doctor tìm thấy cả hai và chỉ thiếu `emulator`, có thể tiếp tục với điện thoại đám mây đã kết nối ADB.

### macOS

```bash
npm install -g appium@3
appium driver install uiautomator2
appium driver list --installed
appium driver doctor uiautomator2
appium --address 127.0.0.1 --port 4723 --base-path /
```

### Windows PowerShell

```powershell
npm.cmd install -g appium@3
appium.cmd driver install uiautomator2
appium.cmd driver list --installed
appium.cmd driver doctor uiautomator2
appium.cmd --address 127.0.0.1 --port 4723 --base-path /
```

Giữ cửa sổ máy chủ mở. Kiểm tra trạng thái trong cửa sổ khác. Tiếp tục khi `value.ready` bằng `true`.

`curl http://127.0.0.1:4723/status` (macOS)

`curl.exe http://127.0.0.1:4723/status` (Windows PowerShell)

[Cài đặt UiAutomator2](https://appium.io/docs/en/latest/quickstart/uiauto2-driver/)

## Cài đặt và cấu hình Appium Inspector

Trên macOS, tải DMG arm64 cho Apple Silicon hoặc x64 cho Intel rồi kéo ứng dụng vào **Applications**. Trên Windows, chạy tệp EXE chính thức, chọn cài cho người dùng hiện tại, chọn thư mục và hoàn tất cài đặt.

[Bản tải chính thức của Appium Inspector](https://github.com/appium/appium-inspector/releases)

*Chữ trên giao diện đã được dịch sang tiếng Anh*

![Phạm vi và thư mục cài đặt trên Windows (chữ trên giao diện đã được dịch sang tiếng Anh)](/assets/win-setup-steps.1d5d82f64c8166a167cba488022ac777eaafafbce700516aed6ec330180376dd.f59a5fd3.png)

![Hoàn tất cài đặt trên Windows (chữ trên giao diện đã được dịch sang tiếng Anh)](/assets/win-finish.cd7d1848bbff51814fc0a58112d0a52be56099e1e63272c0f1f420bcef51e69b.f59a5fd3.png)

Trong **Appium Server**, đặt **Remote Host** là `127.0.0.1`, **Remote Port** là `4723` và **Remote Path** là `/`. Bỏ chọn **SSL** và **Use Proxy**. Trong **Capability Builder**, sửa **JSON Representation** và thay `localhost:9897` bằng đúng mã thiết bị ADB.

```json
{
  "platformName": "Android",
  "appium:automationName": "UiAutomator2",
  "appium:udid": "localhost:9897",
  "appium:noReset": true
}
```

![Cấu hình Inspector trên Windows](/assets/win-config.2d5344fa51514e241c2ec951a9df46ae0e952fbc67d78b74f68840f653f211c8.f59a5fd3.png)

Lưu cấu hình và chọn **Start Session**. Kết nối thành công khi màn hình thiết bị và **App Source** xuất hiện. Nếu không kết nối được máy chủ, kiểm tra `/status`. Nếu không thấy thiết bị, kiểm tra mã thiết bị, xác thực hoặc đường hầm. Xử lý trạng thái `offline` hoặc `unauthorized` trước khi thử lại.

![Phiên Android 15 trên Windows](/assets/win-android15-session.c59074d8c5ae9c482ba5ae6a7b0e274bfb54fdbbdc8da8221fe1b6c2aad33564.f59a5fd3.png)

![Phiên Android 15A trên macOS](/assets/ins-live-session.5ddc67ab553c8e01fff640fcadcaf3101e727d67d6a1218b8c6a5f2f37fb5d07.f59a5fd3.png)