เรียกใช้แอปในอุปกรณ์ฮาร์ดแวร์

ทดสอบแอป Android บนอุปกรณ์จริงก่อนเผยแพร่ให้ผู้ใช้เสมอ หน้านี้อธิบายวิธีตั้งค่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์และอุปกรณ์ที่ทำงานด้วยระบบ Android สำหรับการทดสอบและการแก้ไขข้อบกพร่องผ่านการเชื่อมต่อ Android Debug Bridge (ADB)

ตั้งค่าอุปกรณ์สำหรับการพัฒนา

ก่อนที่จะเริ่มแก้ไขข้อบกพร่องในอุปกรณ์ ให้ตัดสินใจว่าต้องการเชื่อมต่อกับอุปกรณ์โดยใช้สาย USB หรือ Wi-Fi จากนั้นทำดังต่อไปนี้

  1. ในอุปกรณ์ ให้เปิดแอปการตั้งค่า เลือกตัวเลือกสำหรับนักพัฒนาแอป แล้วเปิดใช้การแก้ไขข้อบกพร่อง USB (หากมี)

  2. ตั้งค่าระบบให้ตรวจหาอุปกรณ์ของคุณ

    • ChromeOS: ไม่จำเป็นต้องกำหนดค่าเพิ่มเติม
    • macOS: ไม่จำเป็นต้องกำหนดค่าเพิ่มเติม
    • Windows: ติดตั้งไดรเวอร์ USB สำหรับ ADB (หากมี) ดูคู่มือการติดตั้งและลิงก์ไปยังไดรเวอร์ OEM ได้ที่ติดตั้งไดรเวอร์ USB ของ OEM
    • Ubuntu Linux: ตั้งค่าต่อไปนี้

      • ผู้ใช้แต่ละรายที่ต้องการใช้ ADB จะต้องอยู่ในกลุ่ม plugdev หากเห็นข้อความแสดงข้อผิดพลาดที่ระบุว่าคุณไม่ได้อยู่ในกลุ่ม plugdev ให้เพิ่มตัวเองลงในกลุ่มโดยใช้คำสั่งต่อไปนี้
      sudo usermod -aG plugdev $LOGNAME
      

      กลุ่มจะอัปเดตเมื่อเข้าสู่ระบบเท่านั้น ดังนั้นคุณต้องออกจากระบบเพื่อให้การเปลี่ยนแปลงนี้มีผล เมื่อเข้าสู่ระบบอีกครั้ง คุณสามารถใช้ id เพื่อตรวจสอบว่าคุณอยู่ในกลุ่ม plugdev

      • ระบบต้องติดตั้งกฎ udev ที่ครอบคลุมอุปกรณ์ แพ็กเกจ android-sdk-platform-tools-common มีชุดกฎ udev เริ่มต้นที่ชุมชนดูแลรักษาสำหรับอุปกรณ์ Android หากต้องการติดตั้ง ให้ใช้คำสั่งต่อไปนี้
      apt-get install android-sdk-platform-tools-common
      

เชื่อมต่ออุปกรณ์โดยใช้ USB

เมื่อตั้งค่าและเสียบปลั๊กผ่าน USB แล้ว ให้คลิกเรียกใช้ ใน Android Studio เพื่อสร้างและเรียกใช้แอปในอุปกรณ์

นอกจากนี้ คุณยังใช้ adb เพื่อออกคำสั่งได้ดังนี้

  • ยืนยันว่าอุปกรณ์เชื่อมต่ออยู่โดยเรียกใช้คำสั่ง adb devices จากไดเรกทอรี android_sdk/platform-tools/ หากเชื่อมต่อแล้ว คุณจะเห็นอุปกรณ์แสดงอยู่ในรายการ
  • ออกคำสั่ง adb ใดก็ได้ที่มีแฟล็ก -d เพื่อกำหนดเป้าหมายอุปกรณ์

เชื่อมต่ออุปกรณ์โดยใช้ Wi-Fi

Android 11 ขึ้นไปรองรับการติดตั้งใช้งานและการแก้ไขข้อบกพร่องของแอปแบบไร้สายจากเวิร์กสเตชันโดยใช้ Android Debug Bridge (ADB) ตัวอย่างเช่น คุณสามารถติดตั้งใช้งานแอปที่แก้ไขข้อบกพร่องได้ไปยังอุปกรณ์ระยะไกลหลายเครื่องโดยไม่ต้องเชื่อมต่ออุปกรณ์โดยใช้ USB และไม่ต้องเผชิญกับปัญหาการเชื่อมต่อ USB ที่พบได้ทั่วไป เช่น การติดตั้งไดรเวอร์

Android 17 พร้อมกับ adb 37.0.0 เปิดตัว adb Wi-Fi 2.0 ซึ่งช่วยแก้ปัญหาความสามารถในการใช้งานหลายอย่างในเวอร์ชันก่อนหน้า โดยเฉพาะอย่างยิ่ง อุปกรณ์จะเชื่อมต่อกับเวิร์กสเตชันโดยอัตโนมัติเมื่ออุปกรณ์เชื่อมต่อกับเครือข่ายที่เชื่อถือได้สำหรับการแก้ไขข้อบกพร่องผ่าน Wi-Fi

หากต้องการใช้การแก้ไขข้อบกพร่องผ่าน Wi-Fi คุณต้องจับคู่อุปกรณ์กับเวิร์กสเตชันโดยใช้รหัสการจับคู่ เริ่มต้นด้วยการทำตามขั้นตอนต่อไปนี้

  1. ตรวจสอบว่าเวิร์กสเตชันและอุปกรณ์เชื่อมต่อกับเครือข่ายไร้สายเดียวกัน
  2. ตรวจสอบว่าอุปกรณ์ใช้ Android 11 ขึ้นไป ดูข้อมูลเพิ่มเติมได้ที่ตรวจสอบและอัปเดตเวอร์ชัน Android
  3. ตรวจสอบว่าคุณได้ติดตั้ง Android Studio เวอร์ชันล่าสุดแล้ว ดาวน์โหลดได้ที่นี่
  4. ในเวิร์กสเตชัน ให้อัปเดตเป็นเครื่องมือแพลตฟอร์ม SDK เวอร์ชันล่าสุด

หากต้องการจับคู่กับอุปกรณ์ ให้ทำตามขั้นตอนต่อไปนี้

  1. เปิดใช้ตัวเลือกสำหรับนักพัฒนาแอปในอุปกรณ์
  2. แตะ "การแก้ไขข้อบกพร่องผ่าน Wi-Fi" ในอุปกรณ์

    โทรศัพท์ Pixel แสดงข้อความแจ้งการแก้ไขข้อบกพร่องผ่าน Wi-Fi
    รูปที่ 1 ข้อความแจ้งการแก้ไขข้อบกพร่องผ่าน Wi-Fi ในโทรศัพท์ Google Pixel

  3. อนุญาตการแก้ไขข้อบกพร่องผ่าน Wi-Fi ในเครือข่าย โปรดทราบว่าการคลิกช่องทำเครื่องหมายอนุญาตในเครือข่ายนี้เสมอจะทำให้เครือข่ายเป็นเครือข่ายการแก้ไขข้อบกพร่องผ่าน Wi-Fi ที่เชื่อถือได้ อุปกรณ์จะอนุญาตการแก้ไขข้อบกพร่องผ่าน Wi-Fi ในเครือข่ายนี้เสมอทันทีที่อุปกรณ์เชื่อมต่อกับเครือข่าย

    โทรศัพท์ Pixel แสดงการตั้งค่าระบบการแก้ไขข้อบกพร่องผ่าน Wi-Fi
    รูปที่ 2 การตั้งค่าการแก้ไขข้อบกพร่องผ่าน Wi-Fi ในโทรศัพท์ Google Pixel

  4. เปิด Android Studio แล้วเลือกจับคู่อุปกรณ์โดยใช้ Wi-Fi จากเมนูการกำหนดค่าการเรียกใช้

    เมนูแบบเลื่อนลงของการกำหนดค่าการเรียกใช้
    รูปที่ 3 เมนูการกำหนดค่าการเรียกใช้

  5. กล่องโต้ตอบจับคู่อุปกรณ์ผ่าน Wi-Fi จะปรากฏขึ้นดังที่แสดงในรูปที่ 4

    หน้าต่างป๊อปอัปจับคู่อุปกรณ์ผ่าน Wi-Fi
    รูปที่ 4 กล่องโต้ตอบเพื่อจับคู่อุปกรณ์ผ่าน Wi-Fi

    หรือจะจับคู่อุปกรณ์จากโปรแกรมจัดการอุปกรณ์ก็ได้ ตัวอย่างเช่น My Pixel

    โปรแกรมจัดการอุปกรณ์ที่มีอุปกรณ์พร้อมใช้งานสำหรับการจับคู่ Wi-Fi
    รูปที่ 5 โปรแกรมจัดการอุปกรณ์ที่มีอุปกรณ์ที่พร้อมสำหรับการจับคู่ Wi-Fi

  6. คลิก Pair บนอุปกรณ์ที่ต้องการจับคู่ กล่องโต้ตอบการจับคู่อุปกรณ์จะปรากฏขึ้น

    1. หากต้องการจับคู่อุปกรณ์ด้วยคิวอาร์โค้ด ให้เลือกจับคู่อุปกรณ์ด้วยคิวอาร์โค้ด แล้วสแกนคิวอาร์โค้ด
      หน้าต่างป๊อปอัปจับคู่อุปกรณ์ผ่าน Wi-Fi
      รูปที่ 6 กล่องโต้ตอบเพื่อจับคู่อุปกรณ์โดยใช้คิวอาร์โค้ด
    2. หากต้องการจับคู่อุปกรณ์ด้วยรหัสการจับคู่ ให้เลือกจับคู่อุปกรณ์ด้วยรหัสการจับคู่จากกล่องโต้ตอบจับคู่อุปกรณ์ใหม่ผ่าน Wi-Fi ในอุปกรณ์ ให้เลือกจับคู่โดยใช้รหัสการจับคู่ รหัส 6 หลักจะปรากฏขึ้น เมื่ออุปกรณ์ปรากฏในหน้าต่างจับคู่อุปกรณ์ผ่าน Wi-Fi ให้ป้อนรหัส 6 หลักที่แสดงในอุปกรณ์ แล้วเลือกจับคู่
      ตัวอย่างการป้อนรหัสการจับคู่
      รูปที่ 7 ตัวอย่างการป้อนรหัสการจับคู่ 6 หลัก
  7. หลังจากจับคู่แล้ว คุณจะพยายามติดตั้งใช้งานแอปในอุปกรณ์ได้

หากต้องการเลิกจับคู่เวิร์กสเตชัน ให้ไปที่การแก้ไขข้อบกพร่องผ่าน Wi-Fi ในอุปกรณ์ แตะชื่อเวิร์กสเตชันในส่วนอุปกรณ์ที่จับคู่แล้ว แล้วเลือกเลิกจำ หรือจะคลิกเพิกถอนการให้สิทธิ์การแก้ไขข้อบกพร่อง adb ในหน้าการตั้งค่าอุปกรณ์เพื่อเลิกจับคู่เวิร์กสเตชันและเวิร์กสเตชันอื่นๆ ทั้งหมดที่จับคู่ไว้ก่อนหน้านี้ก็ได้

การมิเรอร์อุปกรณ์

คุณสามารถมิเรอร์อุปกรณ์จริงในหน้าต่าง Running Devices ใน Android Studio ได้ การสตรีมการแสดงผลของอุปกรณ์ไปยัง Android Studio โดยตรงช่วยให้คุณใช้ Studio IDE เพื่อดำเนินการทั่วไปได้ เช่น การเริ่มแอปและการโต้ตอบกับแอป การหมุนหน้าจอ การพับและกางโทรศัพท์ และการเปลี่ยนระดับเสียง

การมิเรอร์อุปกรณ์จะพร้อมใช้งานเสมอเมื่อมีอุปกรณ์ที่เชื่อมต่อกับคอมพิวเตอร์ซึ่งเปิดใช้การแก้ไขข้อบกพร่องผ่าน USB หรือ Wi-Fi คุณเริ่มและหยุดการมิเรอร์ได้โดยใช้หน้าต่าง Running Devices หรือโปรแกรมจัดการอุปกรณ์ (View > หน้าต่างเครื่องมือ > Device Manager) นอกจากนี้ คุณยังปรับแต่งเวลาที่เปิดใช้งานการมิเรอร์อุปกรณ์ได้ในการตั้งค่า (การตั้งค่า > เครื่องมือ > การมิเรอร์อุปกรณ์)

การมิเรอร์อุปกรณ์ในหน้าต่าง Running Devices ใน Android Studio
รูปที่ 8 UI ของ Running Devices

เปลี่ยนเส้นทางเสียง

เมื่อใช้การมิเรอร์อุปกรณ์ คุณสามารถเปลี่ยนเส้นทางเสียงจากอุปกรณ์จริงที่เชื่อมต่ออยู่ไปยังลำโพงหรือหูฟังของคอมพิวเตอร์ได้ การเปลี่ยนเส้นทางเสียงช่วยให้คุณเชื่อมต่อหูฟังกับคอมพิวเตอร์และฟังเสียงจากทั้งคอมพิวเตอร์และโทรศัพท์ที่เชื่อมต่อได้โดยไม่ต้องเชื่อมต่อกับอุปกรณ์เครื่องหนึ่งแล้วเปลี่ยนไปเชื่อมต่อกับอีกเครื่องหนึ่งด้วยตนเอง หากต้องการเปิดใช้การเปลี่ยนเส้นทางเสียง ให้ไปที่ไฟล์ (Android Studio ใน macOS) > การตั้งค่า > เครื่องมือ > การมิเรอร์อุปกรณ์ แล้วเลือกเปลี่ยนเส้นทางเสียงจากอุปกรณ์ในเครื่อง โปรดทราบว่าระบบจะเปลี่ยนเส้นทางเสียงเสมอ ไม่ว่าจะตั้งค่าไว้อย่างไร สำหรับอุปกรณ์ Firebase Test Lab ที่ใช้ Android 12 ขึ้นไป

ปัญหาที่ทราบแล้ว

อุปกรณ์บางเครื่องอาจไม่สามารถเข้ารหัสที่อัตราบิตที่เพียงพอเพื่อรองรับการมิเรอร์อุปกรณ์ ในสถานการณ์เหล่านี้ คุณอาจเห็นข้อผิดพลาดในหน้าต่าง Running Devices รวมถึงบันทึกที่คล้ายกับต่อไปนี้

2023-06-01 15:32:22,675 [  56094]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - Too many video encoder errors:
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - encoder: c2.android.vp8.encoder
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - mime type: video/x-vnd.on2.vp8
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max resolution: 640x640
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - min resolution: 2x2
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - alignment: 2x2
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max frame rate: 960
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max frame rate for 288x640: 960
2023-06-01 15:32:22,870 [  56289]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max bitrate: 20000000
2023-06-01 15:32:22,871 [  56290]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - terminated with code 1

ประกาศเกี่ยวกับนโยบายความเป็นส่วนตัว

Android Studio จะเริ่มการมิเรอร์อุปกรณ์โดยอัตโนมัติสำหรับอุปกรณ์ที่เชื่อมต่อและจับคู่แล้ว โดยอิงตามการตั้งค่าการมิเรอร์อุปกรณ์ ซึ่งอาจส่งผลให้มีการเปิดเผยข้อมูลสำหรับอุปกรณ์ที่เชื่อมต่อด้วยคำสั่ง adb tcpip เนื่องจากข้อมูลการมิเรอร์และคำสั่งจะส่งผ่านช่องทางที่ไม่ได้เข้ารหัส นอกจากนี้ Android Studio ยังใช้ช่องทางที่ไม่ได้เข้ารหัสเพื่อสื่อสารกับเซิร์ฟเวอร์ adb ดังนั้นผู้ใช้รายอื่นในเครื่องโฮสต์จึงอาจสกัดกั้นข้อมูลการมิเรอร์ได้

แก้ปัญหาการเชื่อมต่ออุปกรณ์

หากอุปกรณ์ไม่เชื่อมต่อกับ Android Studio ให้ลองทำตามขั้นตอนต่อไปนี้เพื่อแก้ไขปัญหา

แก้ปัญหาด้วยผู้ช่วยการเชื่อมต่อ

ผู้ช่วยการเชื่อมต่อจะแสดงวิธีการทีละขั้นตอนเพื่อช่วยคุณตั้งค่าและใช้อุปกรณ์ผ่านการเชื่อมต่อ ADB

หากต้องการเริ่มใช้ผู้ช่วย ให้เลือกเครื่องมือ > แก้ปัญหาการเชื่อมต่ออุปกรณ์

ผู้ช่วยการเชื่อมต่อจะแสดงวิธีการ การควบคุมตามบริบท และรายการอุปกรณ์ที่เชื่อมต่อในชุดหน้าต่างๆ ในแผงผู้ช่วย ใช้ปุ่มถัดไปและก่อนหน้าที่ด้านล่างของแผงผู้ช่วยเพื่อไปยังหน้าต่างๆ ตามต้องการ ดังนี้

  • เชื่อมต่ออุปกรณ์ผ่าน USB: ผู้ช่วยการเชื่อมต่อจะแจ้งให้คุณเชื่อมต่ออุปกรณ์ผ่าน USB ก่อน และมีปุ่มสแกนอุปกรณ์ USB อีกครั้งเพื่อให้คุณเริ่มสแกนหาอุปกรณ์ที่เชื่อมต่อใหม่ได้
  • เปิดใช้การแก้ไขข้อบกพร่อง USB: จากนั้นผู้ช่วยการเชื่อมต่อจะบอกวิธีเปิดใช้การแก้ไขข้อบกพร่อง USB ในตัวเลือกสำหรับนักพัฒนาแอปในอุปกรณ์
  • รีสตาร์ทเซิร์ฟเวอร์ ADB: หากยังไม่เห็นอุปกรณ์ในรายการอุปกรณ์ที่พร้อมใช้งาน ให้ใช้ปุ่มรีสตาร์ทเซิร์ฟเวอร์ ADB ในหน้าสุดท้ายของ Connection Assistant การรีสตาร์ทเซิร์ฟเวอร์ ADB จะทำให้ ADB สแกนหาอุปกรณ์อีกครั้งด้วย หากยังไม่เห็นอุปกรณ์ในรายการอุปกรณ์ที่พร้อมใช้งาน ให้ลองทำตามขั้นตอนการแก้ปัญหาในส่วนถัดไป

แก้ปัญหาการเชื่อมต่อ USB

หากผู้ช่วยการเชื่อมต่อไม่ตรวจพบอุปกรณ์ของคุณผ่าน USB ให้ลองทำตามขั้นตอนการแก้ปัญหาต่อไปนี้เพื่อแก้ไขปัญหา

ตรวจสอบว่า Android Studio เชื่อมต่อกับโปรแกรมจำลองของ Android

หากต้องการตรวจสอบว่าปัญหาเกิดจากการเชื่อมต่อระหว่าง Android Studio กับโปรแกรมจำลองของ Android หรือไม่ ให้ทำตามขั้นตอนต่อไปนี้

  1. เปิดโปรแกรมจัดการอุปกรณ์
  2. สร้าง AVD ใหม่หากยังไม่มี
  3. เรียกใช้โปรแกรมจำลองโดยใช้ AVD
  4. ทำตามข้อใดข้อหนึ่งต่อไปนี้
    • หาก Android Studio เชื่อมต่อกับโปรแกรมจำลองไม่ได้ ให้ดาวน์โหลด SDK Platform Tools เวอร์ชันล่าสุด แล้วลองอีกครั้ง
    • หากโปรแกรมจำลองเริ่มต้นสำเร็จ ให้ตรวจสอบสาย USB ตามที่อธิบายไว้ในส่วนต่อไปนี้

ตรวจสอบสาย USB

หากต้องการตรวจสอบว่าปัญหาเกิดจากสาย USB ที่ชำรุดหรือไม่ ให้ทำตามขั้นตอนในส่วนนี้

หากคุณมีสาย USB อื่น ให้ทำดังนี้

  1. เชื่อมต่ออุปกรณ์โดยใช้สายสำรอง
  2. ตรวจสอบว่าตอนนี้ผู้ช่วยด้านการเชื่อมต่อตรวจพบอุปกรณ์หรือไม่
  3. หากตรวจไม่พบอุปกรณ์ ให้ลองใช้สายหลักอีกครั้ง
  4. หากยังตรวจไม่พบอุปกรณ์ ให้ถือว่าปัญหาอยู่ที่อุปกรณ์ และตรวจสอบว่าอุปกรณ์ได้รับการตั้งค่าสำหรับการพัฒนาหรือไม่ตามที่อธิบายไว้ในส่วนต่อไปนี้

หากไม่มีสาย USB อื่น แต่มีอุปกรณ์ที่ใช้ Android เครื่องอื่น ให้ทำดังนี้

  1. เชื่อมต่ออุปกรณ์รองกับคอมพิวเตอร์
  2. หากผู้ช่วยการเชื่อมต่อตรวจพบอุปกรณ์รอง ให้ถือว่าปัญหาอยู่ที่อุปกรณ์หลัก และตรวจสอบว่าอุปกรณ์ได้รับการตั้งค่าสำหรับการพัฒนาหรือไม่

    หากตรวจไม่พบอุปกรณ์รอง ปัญหาอาจเกิดจากสาย USB

ตรวจสอบว่าอุปกรณ์ได้รับการตั้งค่าสำหรับการพัฒนาหรือไม่

หากต้องการตรวจสอบว่าปัญหาเกิดจากการตั้งค่าในอุปกรณ์หรือไม่ ให้ทำตามขั้นตอนต่อไปนี้

  1. ทำตามขั้นตอนในส่วนตั้งค่าอุปกรณ์สำหรับการพัฒนา
  2. หากยังแก้ปัญหาไม่ได้ โปรดติดต่อทีมสนับสนุนลูกค้าของผู้ผลิตอุปกรณ์เพื่อขอความช่วยเหลือ แจ้งตัวแทนฝ่ายสนับสนุนลูกค้าว่าอุปกรณ์ไม่เชื่อมต่อกับ Android Studio โดยใช้ ADB

แก้ปัญหาการเชื่อมต่อแบบไร้สาย

หากพบปัญหาในการเชื่อมต่ออุปกรณ์แบบไร้สาย ให้ลองทำตามขั้นตอนการแก้ปัญหาต่อไปนี้เพื่อแก้ไขปัญหา

ตรวจสอบว่าเวิร์กสเตชันและอุปกรณ์ของคุณเป็นไปตามข้อกำหนดเบื้องต้นหรือไม่

ตรวจสอบว่าเวิร์กสเตชันและอุปกรณ์เป็นไปตามข้อกำหนดเบื้องต้น

ดูคู่มือการแก้ปัญหา adb

ทำตามคำแนะนำในการแก้ปัญหา adb

คีย์ความปลอดภัย RSA

เมื่อคุณเชื่อมต่ออุปกรณ์ที่ใช้ Android 4.2.2 (ระดับ API 17) ขึ้นไปกับคอมพิวเตอร์ ระบบจะแสดงกล่องโต้ตอบที่ถามว่าจะยอมรับคีย์ RSA ที่อนุญาตให้แก้ไขข้อบกพร่องผ่านคอมพิวเตอร์เครื่องนี้หรือไม่ กลไกการรักษาความปลอดภัยนี้จะปกป้องอุปกรณ์ของผู้ใช้เนื่องจากไม่สามารถดำเนินการแก้ไขข้อบกพร่อง USB และคำสั่ง adb อื่นๆ ได้ เว้นแต่คุณจะปลดล็อกอุปกรณ์และรับทราบกล่องโต้ตอบ