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

ทดสอบแอป 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 ใช้ปุ่มถัดไปและก่อนหน้าที่ด้านล่างของแผง 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 กับคอมพิวเตอร์

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 ใช้ไม่ได้ ดำเนินการจนกว่าคุณจะสามารถปลดล็อกอุปกรณ์และรับทราบกล่องโต้ตอบ