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

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

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

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

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

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

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

   • Ubuntu Linux: ตั้งค่าต่อไปนี้

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

     sudo usermod -aG plugdev $LOGNAME
     

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

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

     apt-get install android-sdk-platform-tools-common
     

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

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

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

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

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

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

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

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

หากต้องการเชื่อมต่ออุปกรณ์ ให้ทำตามขั้นตอนต่อไปนี้

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

   วันที่

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

   วันที่

2. เปิดใช้งานนักพัฒนาซอฟต์แวร์ ตัวเลือก บนอุปกรณ์ของคุณ
3. เปิดใช้งานการแก้ไขข้อบกพร่อง Wi-Fi บนอุปกรณ์ของคุณ

   วันที่

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

      วันที่

5. หลังจากจับคู่แล้ว คุณสามารถลองทำให้แอปใช้งานได้ในอุปกรณ์ของคุณ

วิธีจับคู่อุปกรณ์อื่นหรือไม่จำอุปกรณ์นี้ในเวิร์กสเตชัน

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

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

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

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

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

เมื่อใช้การมิเรอร์อุปกรณ์ คุณจะเปลี่ยนเส้นทางเสียงจากอุปกรณ์ที่เชื่อมต่อได้ อุปกรณ์จริงเข้ากับลำโพงหรือหูฟังคอมพิวเตอร์ของคุณ พร้อมเสียง การเปลี่ยนเส้นทาง ให้หูฟังเชื่อมต่อกับคอมพิวเตอร์เสมอและฟังทั้ง 2 อย่าง คอมพิวเตอร์และโทรศัพท์ที่เชื่อมต่ออยู่โดยไม่ต้องเชื่อมต่อกับเครื่องใดเครื่องหนึ่งด้วยตนเองอีกครั้ง อุปกรณ์แต่ละเครื่อง และอื่นๆ หากต้องการเปิดใช้การเปลี่ยนเส้นทางเสียง ให้ไปที่ไฟล์ (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 ใช้เมนู ปุ่มถัดไปและก่อนหน้าที่ด้านล่างของแผงผู้ช่วยเพื่อ ดำเนินการผ่านหน้าเว็บตามความจำเป็น

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

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

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

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

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

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

ตรวจสอบสาย USB

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

หากมีสาย USB อีกเส้น ให้ทำดังนี้

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

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

1. เชื่อมต่ออุปกรณ์รองกับคอมพิวเตอร์

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

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

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

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

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

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

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

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

เพื่อให้เป็นไปตามข้อกำหนดเบื้องต้นสำหรับการแก้ไขข้อบกพร่องผ่าน Wi-Fi โปรดตรวจสอบว่า

• เวิร์กสเตชันและอุปกรณ์เชื่อมต่อกับเครือข่ายไร้สายเดียวกัน
• อุปกรณ์ของคุณใช้ Android 11 ขึ้นไป สำหรับข้อมูลเพิ่มเติม โปรดดู ตรวจสอบและ อัปเดต Android ของคุณ version
• คุณมี Android Studio เวอร์ชันล่าสุด คุณสามารถดาวน์โหลด จากหน้าหลักของ Android Studio
• คุณมีเวอร์ชันล่าสุดของ เครื่องมือแพลตฟอร์ม SDK ในเวิร์กสเตชันของคุณ

ตรวจสอบปัญหาที่ทราบอื่นๆ

ต่อไปนี้คือรายการปัญหาที่ทราบแล้วในปัจจุบันเกี่ยวกับการแก้ไขข้อบกพร่องผ่าน Wi-Fi ใน Android Studio และวิธีแก้ไข

• Wi-Fi ไม่เชื่อมต่อ: เครือข่าย Wi-Fi บางเครือข่าย เช่น Wi-Fi ขององค์กร เครือข่าย อาจบล็อกการเชื่อมต่อแบบ p2p และไม่ให้คุณเชื่อมต่อผ่าน Wi-Fi ลองเชื่อมต่อโดยใช้สายหรือเครือข่าย Wi-Fi อื่น
• บางครั้ง ADB ผ่าน Wi-Fi จะปิดโดยอัตโนมัติ: กรณีนี้อาจเกิดขึ้นหาก สลับเครือข่าย Wi-Fi หรือยกเลิกการเชื่อมต่อกับเครือข่าย

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

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