在硬體裝置上執行應用程式

建構 Android 應用程式時,請務必在實際裝置上測試應用程式,再發布給使用者。本頁說明如何設定開發環境和 Android 裝置,以便透過「Android Debug Bridge (ADB)」連線進行測試及偵錯。

設定開發用裝置

在裝置上開始執行偵錯前,請先決定要使用 USB 傳輸線還是 Wi-Fi 連接裝置。接著,按照下列步驟操作:

  1. 在裝置上開啟「設定」應用程式,選取「開發人員選項」,然後啟用「USB 偵錯」(如果適用的話)。

  2. 設定讓系統偵測裝置。

    • Chrome OS:不需額外設定。
    • macOS:不需額外設定。
    • Ubuntu Linux:必須正確配置兩項設定:要使用 ADB 的每位使用者都必須位於 plugdev 群組中,且系統必須安裝與裝置相關的 udev 規則。

      plugdev 群組:如果系統顯示錯誤訊息,指出您不在 plugdev 群組中,您就必須將自己加入 plugdev 群組。如下所示:

      sudo usermod -aG plugdev $LOGNAME
      

      請注意,群組只會在您登入時更新,因此您必須登出再登入,才能讓這項變更生效。重新登入後,您可以使用 id 確認自己目前是否在 plugdev 群組中。

      udev 規則android-sdk-platform-tools-common 套件包含由社群維護、適用於 Android 裝置的 udev 規則預設組合。安裝指令如下:

      apt-get install android-sdk-platform-tools-common
      
    • Windows:安裝 ADB 的 USB 驅動程式 (如適用)。如需安裝指南和原始設備製造商 (OEM) 驅動程式連結,請參閱「安裝 OEM USB 驅動程式」說明文件。

使用 USB 連接裝置

當您完成設定並連接 USB 後,可以在 Android Studio 中按一下「執行」圖示 在裝置上建立及執行應用程式

您也可以使用 ADB 下達指令,方法如下:

  • 執行 android_sdk/platform-tools/ 目錄中的 adb devices 指令,以確認裝置已連線。如果已連線,畫面上就會列出該裝置。
  • 使用 -d 標記下達任何 ADB 指令,以便指定裝置。

使用 Wi-Fi 連接裝置

Android 11 (和以上版本) 支援使用 Android Debug Bridge (ADB),從工作站以無線方式部署應用程式並進行偵錯。舉例來說,您可以將可進行偵錯的應用程式部署至多部遠端裝置,不僅不必實際透過 USB 連接裝置,也不用處理常見的 USB 連線問題 (例如安裝驅動程式)。

如要使用無線偵錯功能,您必須使用配對碼將裝置與工作站配對。請完成下列步驟即可開始:

  1. 確認工作站和裝置已連上同一個無線網路。
  2. 確認您的裝置搭載 Android 11 以上版本。詳情請參閱「檢查及更新 Android 版本」。
  3. 確認您已安裝 Android Studio Bumblebee Canary。按這裡即可下載。
  4. 在工作站上更新至最新版本的 SDK Platform-Tools

如要連接裝置,請按照下列步驟操作:

  1. 開啟 Android Studio,並在從執行設定下拉式選單中選取「Pair Devices Using Wi-Fi」
    執行設定下拉式選單
    圖 1. 執行設定下拉式選單。

    系統會彈出「Pair devices over Wi-Fi」視窗,如下所示。
    「Pair devices over Wi-Fi」彈出式視窗螢幕截圖
    圖 2.要求使用 QR 圖碼或配對碼配對裝置的彈出式視窗。
  2. 在裝置上啟用開發人員選項
  3. 在裝置上啟用透過 Wi-Fi 偵錯功能。
    顯示無線偵錯系統設定的 Pixel 手機螢幕截圖。
    圖 3. Google Pixel 手機上的無線偵錯設定螢幕截圖。
  4. 輕觸「無線偵錯」,然後配對裝置:
    1. 如要透過 QR 圖碼配對裝置,請選取「使用 QR 圖碼配對裝置」,然後掃描從上述步驟取得的 QR 圖碼。
    2. 如要透過配對碼配對裝置,請在上述的「Pair devices over Wi-Fi」(透過 Wi-Fi 配對裝置) 視窗中選取「Pair using pairing code」(使用配對碼配對)。接著,在裝置上選取「使用配對碼配對裝置」,然後記下畫面上隨即顯示的六位數 PIN 碼。當「Pair devices over Wi-Fi」(透過 Wi-Fi 配對裝置) 視窗顯示您的裝置後,請選取「Pair」(配對),然後輸入裝置上顯示的六位數 PIN 碼。
      PIN 碼輸入範例螢幕截圖
      圖 4. 六位數 PIN 碼輸入範例。
  5. 配對完成後,您可以試試將應用程式部署至裝置。

    如要在工作站上配對不同裝置或移除這部裝置,請在裝置上前往「無線偵錯」設定,在「已配對的裝置」底下輕觸要移除的工作站名稱,然後選取「移除裝置」

排解裝置連線問題

如果您的裝置無法連線至 Android Studio,請試試按照下列說明解決問題。

透過 Connection Assistant 排解問題

Connection Assistant 提供逐步操作說明,協助您透過 ADB 連線設定及使用裝置。

如要啟動這個小幫手,請依序選擇「Tools」(工具) >「Connection Assistant」

Connection Assistant 會在「Assistant」(小幫手) 面板的一系列頁面中提供操作說明、關聯控制項和已連線的裝置清單。您可以使用「Assistant」(小幫手) 面板底部的「Next」(下一頁) 和「Previous」(上一頁) 按鈕,視需要瀏覽以下頁面:

  • 透過 USB 連接裝置:Connection Assistant 會先提示您透過 USB 連接裝置,並且會顯示「Rescan USB devices」(重新掃描 USB 裝置) 按鈕,讓您重新掃描已連接的裝置。
  • 啟用 USB 偵錯功能:Connection Assistant 會接著說明如何在裝置端開發人員選項中啟用 USB 偵錯功能。
  • 重新啟動 ADB 伺服器:最後,如果可用裝置清單仍未顯示您的裝置,您可以使用 Connection Assistant 最後一頁的「Restart ADB server」(重新啟動 ADB 伺服器) 按鈕。重新啟動 ADB 伺服器也會促使 ADB 再次掃描裝置。如果您還是沒有在可用裝置清單上找到您的裝置,請試試按照本頁下一節的疑難排解步驟操作。

解決 USB 連線問題

如果 Connection Assistant 無法偵測到透過 USB 連接的裝置,可以試試按照下列疑難排解步驟解決問題:

確認 Android Studio 可連接 Android Emulator

如要檢查這個問題是否是因 Android Studio 和 Android Emulator 之間的連線問題所引起,請按照下列步驟操作:

  1. 開啟 AVD Manager
  2. 建立新的 AVD (如果您尚未建立的話)。
  3. 使用 AVD 執行模擬器
  4. 執行下列其中一項操作:

檢查 USB 傳輸線

如要檢查這個問題是否是因 USB 傳輸線故障所引起,請按照本節說明的步驟操作。

如果您有其他 USB 傳輸線:

  1. 使用其他傳輸線連接裝置。
  2. 檢查 Connection Assistant 現在是否能偵測到裝置。
  3. 如果系統沒有偵測到裝置,請再次使用主要傳輸線。
  4. 如果系統仍未偵測到裝置,請假設問題來自裝置,並確認裝置是否已根據開發程序完成相關設定

如果您沒有其他 USB 傳輸線,但擁有其他 Android 裝置,請按照下列步驟操作:

  1. 將其他裝置連接至電腦。
  2. 如果 Connection Assistant 可偵測到其他裝置,請假設問題來自主要裝置,並確認裝置是否已根據開發程序完成相關設定

    如果未偵測到其他裝置,則問題可能來自於 USB 傳輸線。

檢查裝置是否已針對開發用途配置相關設定

如要確認問題原因是否出在裝置設定,請按照下列步驟操作:

  1. 按照「設定開發用裝置」一節的步驟操作。
  2. 如果仍無法解決問題,請向裝置的原始設備製造商 (OEM) 客戶服務人員尋求協助,將裝置無法透過 ADB 連線至 Android Studio 的問題告知客戶服務代表。

解決無線連線問題

如果您無法以無線連線的方式連接裝置,請試試按照下列疑難排解步驟解決問題。

確認工作站和裝置是否符合必要條件

如要符合無線偵錯功能的必要條件,請確認下列項目:

  1. 工作站和裝置已連上同一個無線網路。
  2. 裝置搭載 Android 11 以上版本。詳情請參閱「檢查及更新 Android 版本」一文。
  3. 裝置已安裝 Android Studio Bumblebee。如要下載,請按這裡
  4. 工作站已安裝最新版 SDK 平台工具

檢查其他已知問題

以下列出 Android Studio 無線偵錯功能目前的已知問題和解決方法。

  1. 無法連上 Wi-Fi:某些 Wi-Fi 網路 (例如企業 Wi-Fi 網路) 可能會封鎖 P2P 連線,進而導致您無法透過 Wi-Fi 連線。請嘗試使用傳輸線或其他 Wi-Fi 網路連線。
  2. 系統有時會自動停止透過 Wi-Fi 使用 ADB:如果裝置改用 Wi-Fi 網路或中斷網路連線,就可能會發生這種問題。

RSA 安全金鑰

將搭載 Android 4.2.2 (API 級別 17) 以上版本的裝置連接到電腦時,系統會顯示對話方塊,詢問您是否接受讓 RSA 金鑰允許透過這部電腦進行偵錯。這項安全機制可保護使用者裝置,原因在於使用者必須解鎖裝置及確認對話方塊內容,系統才會執行 USB 偵錯和其他 ADB 指令。