โปรดทดสอบแอป Android ใน อุปกรณ์จริงเสมอก่อนเผยแพร่ให้ผู้ใช้ หน้าเว็บนี้อธิบายวิธีตั้งค่า สภาพแวดล้อมในการพัฒนาซอฟต์แวร์และอุปกรณ์ Android สำหรับการทดสอบและการแก้ไขข้อบกพร่องผ่าน การเชื่อมต่อ Android Debug Bridge (ADB)
ตั้งค่าอุปกรณ์สำหรับการพัฒนา
ก่อนที่จะเริ่มแก้ไขข้อบกพร่องในอุปกรณ์ได้ คุณต้องเลือกว่าจะเชื่อมต่อ กับอุปกรณ์โดยใช้สาย USB หรือ Wi-Fi จากนั้นทำดังนี้
เปิดแอปการตั้งค่าในอุปกรณ์ เลือกตัวเลือกสำหรับนักพัฒนาแอป แล้ว เปิดใช้การแก้ไขข้อบกพร่อง USB (หากมี)
ตั้งค่าระบบให้ตรวจหาอุปกรณ์
- 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- ผู้ใช้แต่ละรายที่ต้องการใช้ ADB ต้องอยู่ในกลุ่ม
เชื่อมต่อกับอุปกรณ์โดยใช้ 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 คุณต้องจับคู่อุปกรณ์กับเวิร์กสเตชันโดยใช้รหัสการจับคู่ หากต้องการเริ่มต้น ให้ทำตามขั้นตอนต่อไปนี้
- ตรวจสอบว่าเวิร์กสเตชันและอุปกรณ์เชื่อมต่อกับเครือข่ายไร้สายเดียวกัน
- ตรวจสอบว่าอุปกรณ์ใช้ Android 11 ขึ้นไป ดูข้อมูลเพิ่มเติมได้ที่ตรวจสอบและอัปเดตเวอร์ชัน Android
- ตรวจสอบว่าคุณได้ติดตั้ง Android Studio เวอร์ชันล่าสุดแล้ว ดาวน์โหลดที่นี่
- ในเวิร์กสเตชัน ให้อัปเดตเป็น SDK Platform Tools เวอร์ชันล่าสุด
หากต้องการจับคู่กับอุปกรณ์ ให้ทำตามขั้นตอนต่อไปนี้
- เปิดใช้ตัวเลือกสำหรับนักพัฒนาแอปในอุปกรณ์
แตะการแก้ไขข้อบกพร่องแบบไร้สายในอุปกรณ์
รูปที่ 1 พรอมต์การแก้ไขข้อบกพร่องแบบไร้สายในโทรศัพท์ Google Pixel อนุญาตให้แก้ไขข้อบกพร่องผ่าน Wi-Fi ในเครือข่าย โปรดทราบว่าการคลิกช่องทําเครื่องหมาย อนุญาตเสมอในเครือข่ายนี้จะทําให้เครือข่ายกลายเป็น เครือข่ายการแก้ไขข้อบกพร่องผ่าน Wi-Fi ที่เชื่อถือได้ อุปกรณ์จะอนุญาตการแก้ไขข้อบกพร่องผ่าน Wi-Fi ในเครือข่ายนี้เสมอทันทีที่อุปกรณ์เชื่อมต่อกับเครือข่าย
รูปที่ 2 การตั้งค่าการแก้ไขข้อบกพร่องผ่าน Wi-Fiในโทรศัพท์ Google Pixel เปิด Android Studio แล้วเลือกจับคู่อุปกรณ์โดยใช้ Wi-Fi จากเมนูการกำหนดค่าการเรียกใช้
รูปที่ 3 เมนู เรียกใช้การกำหนดค่า
กล่องโต้ตอบจับคู่อุปกรณ์ผ่าน Wi-Fi จะปรากฏขึ้นดังแสดงในรูปที่ 4
รูปที่ 4 กล่องโต้ตอบเพื่อจับคู่ อุปกรณ์ผ่าน Wi-Fi หรือจะจับคู่อุปกรณ์จากโปรแกรมจัดการอุปกรณ์ก็ได้ เช่น
My Pixel
รูปที่ 5 โปรแกรมจัดการอุปกรณ์พร้อมอุปกรณ์ พร้อมใช้งานสำหรับการจับคู่ Wi-Fi
คลิก
Pairในอุปกรณ์ที่ต้องการจับคู่ กล่องโต้ตอบการจับคู่อุปกรณ์จะปรากฏขึ้น- หากต้องการจับคู่อุปกรณ์ด้วยคิวอาร์โค้ด ให้เลือกจับคู่อุปกรณ์ด้วยคิวอาร์โค้ด
แล้วสแกนคิวอาร์โค้ด
รูปที่ 6 กล่องโต้ตอบเพื่อจับคู่อุปกรณ์ โดยใช้คิวอาร์โค้ด - หากต้องการจับคู่อุปกรณ์ด้วยรหัสการจับคู่ ให้เลือกจับคู่อุปกรณ์ด้วยรหัสการจับคู่จากกล่องโต้ตอบจับคู่อุปกรณ์ใหม่ผ่าน Wi-Fi ในอุปกรณ์ ให้เลือกจับคู่โดยใช้รหัสการจับคู่ รหัส 6 หลักจะปรากฏขึ้น
เมื่ออุปกรณ์ปรากฏในหน้าต่างจับคู่อุปกรณ์ผ่าน Wi-Fi
ให้ป้อนรหัส 6 หลักที่แสดงบนอุปกรณ์ แล้วเลือกจับคู่
รูปที่ 7 ตัวอย่างการป้อนรหัสการจับคู่ 6 หลัก
- หากต้องการจับคู่อุปกรณ์ด้วยคิวอาร์โค้ด ให้เลือกจับคู่อุปกรณ์ด้วยคิวอาร์โค้ด
แล้วสแกนคิวอาร์โค้ด
หลังจากจับคู่แล้ว คุณจะพยายามติดตั้งใช้งานแอปในอุปกรณ์ได้
หากต้องการเลิกจับคู่เวิร์กสเตชัน ให้ไปที่การแก้ไขข้อบกพร่องผ่าน Wi-Fiในอุปกรณ์ แตะชื่อเวิร์กสเตชันในส่วนอุปกรณ์ที่จับคู่ แล้วเลือกเลิกจำ หรือคลิกเพิกถอนการให้สิทธิ์การแก้ไขข้อบกพร่อง adb ในหน้าการตั้งค่าของอุปกรณ์เพื่อยกเลิกการจับคู่เวิร์กสเตชันและเวิร์กสเตชันอื่นๆ ทั้งหมด ที่จับคู่ไว้ก่อนหน้านี้
การมิเรอร์อุปกรณ์
คุณสามารถมิเรอร์อุปกรณ์จริงในหน้าต่างอุปกรณ์ที่กำลังทำงานใน Android Studio ได้ การสตรีมจอแสดงผลของอุปกรณ์ไปยัง Android Studio โดยตรงจะช่วยให้คุณ ใช้ IDE ของ Studio เองเพื่อดำเนินการทั่วไป เช่น การเริ่มต้นแอปและการ โต้ตอบกับแอป การหมุนหน้าจอ การพับและกางโทรศัพท์ และ การเปลี่ยนระดับเสียง
การมิเรอร์อุปกรณ์จะพร้อมใช้งานเสมอเมื่อมีอุปกรณ์ที่เชื่อมต่อกับคอมพิวเตอร์ซึ่งเปิดใช้การแก้ไขข้อบกพร่องผ่าน USB หรือการแก้ไขข้อบกพร่องผ่าน Wi-Fi คุณเริ่มและหยุดการมิเรอร์ได้โดยใช้หน้าต่างอุปกรณ์ที่ทำงานหรือโปรแกรมจัดการอุปกรณ์ (ดู > หน้าต่างเครื่องมือ > โปรแกรมจัดการอุปกรณ์) นอกจากนี้ คุณยังปรับแต่งเวลาที่ระบบเปิดใช้งานการมิเรอร์อุปกรณ์ได้ในการตั้งค่า (การตั้งค่า > เครื่องมือ > การมิเรอร์อุปกรณ์)
เปลี่ยนเส้นทางเสียง
เมื่อใช้การมิเรอร์อุปกรณ์ คุณจะเปลี่ยนเส้นทางเสียงจากอุปกรณ์จริงที่เชื่อมต่ออยู่ไปยังลำโพงหรือหูฟังของคอมพิวเตอร์ได้ การเปลี่ยนเส้นทางเสียงจะช่วยให้คุณเชื่อมต่อหูฟังกับคอมพิวเตอร์และฟังทั้งคอมพิวเตอร์และโทรศัพท์ที่เชื่อมต่ออยู่ได้โดยไม่ต้องเชื่อมต่อกับอุปกรณ์หนึ่งแล้วจึงเชื่อมต่อกับอีกอุปกรณ์หนึ่งด้วยตนเอง หากต้องการเปิดใช้การเปลี่ยนเส้นทางเสียง ให้ไปที่ไฟล์ (Android Studio ใน macOS) > การตั้งค่า > เครื่องมือ > การมิเรอร์อุปกรณ์ แล้วเลือกเปลี่ยนเส้นทางเสียงจากอุปกรณ์ในเครื่อง โปรดทราบว่าระบบจะเปลี่ยนเส้นทางเสียงเสมอ ไม่ว่าการตั้งค่าจะเป็นอย่างไร สำหรับอุปกรณ์ Firebase Test Lab ที่ใช้ Android 12 ขึ้นไป
ปัญหาที่ทราบแล้ว
อุปกรณ์บางเครื่องอาจเข้ารหัสที่บิตเรตไม่เพียงพอ ที่จะรองรับการมิเรอร์อุปกรณ์ ในกรณีเหล่านี้ คุณอาจเห็นข้อผิดพลาดในหน้าต่างอุปกรณ์ที่กำลังทำงาน รวมถึงบันทึกที่คล้ายกับบันทึกต่อไปนี้
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
หากต้องการเริ่มใช้ผู้ช่วย ให้เลือกเครื่องมือ > แก้ปัญหาการเชื่อมต่ออุปกรณ์
ผู้ช่วยการเชื่อมต่อจะแสดงวิธีการ ตัวควบคุมในบริบท และรายการ อุปกรณ์ที่เชื่อมต่อในชุดหน้าในแผง Assistant ใช้ปุ่มถัดไปและก่อนหน้าที่ด้านล่างของแผง Assistant เพื่อ เลื่อนดูหน้าต่างๆ ตามต้องการ
- เชื่อมต่ออุปกรณ์ผ่าน USB: ผู้ช่วยการเชื่อมต่อจะแจ้งให้คุณเชื่อมต่ออุปกรณ์ผ่าน USB ก่อน และแสดงปุ่มสแกนอุปกรณ์ USB อีกครั้ง ซึ่งคุณสามารถเริ่มการสแกนใหม่สำหรับอุปกรณ์ที่เชื่อมต่อได้
- เปิดใช้การแก้ไขข้อบกพร่อง USB: จากนั้นผู้ช่วยการเชื่อมต่อจะบอกวิธี เปิดใช้การแก้ไขข้อบกพร่อง USB ในตัวเลือกสำหรับนักพัฒนาแอปในอุปกรณ์
- รีสตาร์ทเซิร์ฟเวอร์ ADB: หากยังไม่เห็นอุปกรณ์ในรายการอุปกรณ์ที่พร้อมใช้งาน ให้ใช้ปุ่มรีสตาร์ทเซิร์ฟเวอร์ ADB ในหน้าสุดท้ายของผู้ช่วยการเชื่อมต่อ การรีสตาร์ทเซิร์ฟเวอร์ ADB ยังทำให้ ADB สแกนหาอุปกรณ์อีกครั้งด้วย หากยังไม่เห็นอุปกรณ์ในรายการอุปกรณ์ที่พร้อมใช้งาน ให้ลองทำตามขั้นตอนการแก้ปัญหาในส่วนต่อไปนี้
แก้ปัญหาการเชื่อมต่อ USB
หากผู้ช่วยการเชื่อมต่อตรวจไม่พบอุปกรณ์ผ่าน USB ให้ลองทำตามขั้นตอนการแก้ปัญหาต่อไปนี้เพื่อแก้ไขปัญหา
ตรวจสอบว่า Android Studio เชื่อมต่อกับโปรแกรมจำลองของ Android
หากต้องการตรวจสอบว่าปัญหาเกิดจากปัญหาการเชื่อมต่อระหว่าง Android Studio กับโปรแกรมจำลองของ Android หรือไม่ ให้ทำตามขั้นตอนต่อไปนี้
- เปิดโปรแกรมจัดการอุปกรณ์
- สร้าง AVD ใหม่หากยังไม่มี
- เรียกใช้โปรแกรมจำลองโดยใช้ AVD
- ทำตามข้อใดข้อหนึ่งต่อไปนี้
- หาก Android Studio เชื่อมต่อกับโปรแกรมจำลองไม่ได้ ให้ดาวน์โหลด เครื่องมือแพลตฟอร์ม SDK เวอร์ชันล่าสุด แล้วลองอีกครั้ง
- หากโปรแกรมจำลองเริ่มต้นได้สำเร็จ ให้ตรวจสอบสาย USB ตามที่อธิบายไว้ในส่วนต่อไปนี้
ตรวจสอบสาย USB
หากต้องการตรวจสอบว่าปัญหาเกิดจากสาย USB ที่ชำรุดหรือไม่ ให้ทำตามขั้นตอนใน ส่วนนี้
หากมีสาย USB อื่น ให้ทำดังนี้
- เชื่อมต่ออุปกรณ์โดยใช้สายเคเบิลสำรอง
- ตรวจสอบว่าตอนนี้ผู้ช่วยการเชื่อมต่อตรวจพบอุปกรณ์หรือไม่
- หากตรวจไม่พบอุปกรณ์ ให้ลองใช้สายหลักอีกครั้ง
- หากยังตรวจไม่พบอุปกรณ์ ให้ถือว่าปัญหาเกิดจากอุปกรณ์ และตรวจสอบว่าได้ตั้งค่าอุปกรณ์สำหรับการพัฒนาตามที่อธิบายไว้ในส่วนต่อไปนี้หรือไม่
หากไม่มีสาย USB อื่น แต่มีอุปกรณ์ Android เครื่องอื่น ให้ทำดังนี้
- เชื่อมต่ออุปกรณ์รองกับคอมพิวเตอร์
หากผู้ช่วยการเชื่อมต่อตรวจพบอุปกรณ์รอง ให้ถือว่าปัญหาเกิดจากอุปกรณ์หลัก และตรวจสอบว่าอุปกรณ์ตั้งค่าสำหรับการพัฒนาแล้วหรือไม่
หากตรวจไม่พบอุปกรณ์รอง ปัญหาอาจเกิดจากสาย USB
ตรวจสอบว่าตั้งค่าอุปกรณ์สำหรับการพัฒนาแล้วหรือยัง
หากต้องการตรวจสอบว่าปัญหาเกิดจากการตั้งค่าในอุปกรณ์หรือไม่ ให้ทำตามขั้นตอนต่อไปนี้
- ทำตามขั้นตอนในส่วนตั้งค่าอุปกรณ์สำหรับการพัฒนา
- หากวิธีนี้ยังแก้ปัญหาไม่ได้ โปรดติดต่อฝ่ายสนับสนุนลูกค้าของ OEM อุปกรณ์เพื่อขอความช่วยเหลือ และแจ้งตัวแทนฝ่ายสนับสนุนลูกค้าว่าอุปกรณ์เชื่อมต่อกับ Android Studio โดยใช้ ADB ไม่ได้
แก้ไขปัญหาการเชื่อมต่อแบบไร้สาย
หากพบปัญหาในการเชื่อมต่อกับอุปกรณ์แบบไร้สาย ให้ลองทำตามขั้นตอนการแก้ปัญหาต่อไปนี้เพื่อแก้ไขปัญหา
ตรวจสอบว่าเวิร์กสเตชันและอุปกรณ์ของคุณมีคุณสมบัติตรงตามข้อกำหนดเบื้องต้นหรือไม่
ตรวจสอบว่าเวิร์กสเตชันและอุปกรณ์เป็นไปตามข้อกำหนดเบื้องต้น
ดูคู่มือการแก้ปัญหา adb
ทำตามคู่มือการแก้ปัญหา adb
คีย์ความปลอดภัย RSA
เมื่อเชื่อมต่ออุปกรณ์ที่ใช้ Android 4.2.2 (ระดับ API 17) ขึ้นไปกับคอมพิวเตอร์ ระบบจะแสดงกล่องโต้ตอบที่ถามว่ายอมรับคีย์ RSA ที่อนุญาตให้แก้ไขข้อบกพร่องผ่านคอมพิวเตอร์เครื่องนี้หรือไม่ กลไกด้านความปลอดภัยนี้ช่วยปกป้องอุปกรณ์ของผู้ใช้ เนื่องจากคุณจะเรียกใช้การแก้ไขข้อบกพร่อง USB และคำสั่ง adb อื่นๆ ไม่ได้จนกว่าจะปลดล็อกอุปกรณ์และรับทราบกล่องโต้ตอบ