แก้ปัญหาเกี่ยวกับ Android Studio

หน้านี้มีคำแนะนำสำหรับการแก้ปัญหาทั่วไปและปัญหาการกำหนดค่าใน Android Studio

จอแสดงผลความหนาแน่นสูง

ตั้งแต่เวอร์ชัน 1.5 เป็นต้นมา Android Studio รองรับจอแสดงผลความหนาแน่นสูง (เช่น จอภาพ HiDPI และ Retina) ในทุกแพลตฟอร์ม

การตั้งค่าค่าตัวคูณมาตราส่วน

Android Studio จะกำหนดค่าตัวคูณมาตราส่วนสำหรับจอแสดงผลดังนี้

Mac
สำหรับจอแสดงผล Retina องค์ประกอบ UI จะปรับขนาดด้วยค่าตัวคูณ 200% และรูปภาพ จะแสดงผลด้วยความละเอียดสูง จึงไม่ควรมีภาพเบลอเนื่องจาก การปรับขนาด แม้ในการกำหนดค่าจอภาพหลายจอ โปรดทราบว่าระบบไม่รองรับ ค่าตัวคูณมาตราส่วนอื่นๆ นอกเหนือจาก 100% (สำหรับจอแสดงผลที่ไม่ใช่ Retina) และ 200% (สำหรับ จอแสดงผล Retina)
Windows
Android Studio ใช้การตั้งค่า DPI ของจอแสดงผลหลัก เพื่อกำหนดค่าตัวคูณมาตราส่วนขององค์ประกอบ UI สำหรับรูปภาพ หากค่าตัวคูณมาตราส่วน น้อยกว่า 150% ระบบจะปรับขนาดรูปภาพความละเอียดปกติให้ใหญ่ขึ้น หากค่าตัวคูณมาตราส่วนมากกว่า 150% ระบบจะปรับขนาดรูปภาพความละเอียดสูงอย่างเหมาะสม
Linux
Android Studio จะกำหนดค่าตัวคูณมาตราส่วนโดยดูที่ "ค่าตัวคูณมาตราส่วนข้อความ" จากนั้นดูที่การตั้งค่า DPI ของระบบ XWindow
การตั้งค่า DPI เป็น 96 จะสอดคล้องกับค่าตัวคูณมาตราส่วน 100% (ไม่มีการปรับขนาด) และการตั้งค่า DPI เป็น 192 จะสอดคล้องกับค่าตัวคูณมาตราส่วน 200% (ขนาดของ องค์ประกอบ UI จะเพิ่มเป็น 2 เท่า) ปัจจุบัน Android Studio รองรับการตั้งค่า DPI ระหว่าง 96 (การปรับขนาด 100%) ถึง 288 (การปรับขนาด 300%) หาก Android Studio ตรวจไม่พบ DPI ของระบบที่ถูกต้องในเครื่อง Linux หรือ Windows คุณสามารถตั้งค่า DPI ด้วยตนเองได้โดยตั้งค่าพร็อพเพอร์ตี้ hidpi ในไฟล์ idea.properties ตามที่อธิบายไว้ในหัวข้อ ปรับแต่งพร็อพเพอร์ตี้ IDE โปรดทราบว่าพร็อพเพอร์ตี้นี้ไม่มีผลกับเครื่อง Mac โดยพร็อพเพอร์ตี้นี้จะทำงานดังนี้
hidpi=true
ตั้งค่า DPI เป็น 192 (การปรับขนาด 200%) โดยไม่สนใจการตั้งค่าระบบ
hidpi=false
ตั้งค่า DPI เป็น 96 (การปรับขนาด 100%) โดยไม่สนใจการตั้งค่าระบบ

องค์ประกอบเบลอหรือมีการปิดบังบางส่วนในจอแสดงผลความหนาแน่นสูง

หากองค์ประกอบ UI ของ Android Studio อย่างน้อย 1 รายการปรากฏเป็นภาพเบลอหรือมีการปิดบังบางส่วนใน จอแสดงผลความหนาแน่นสูง คุณอาจพบปัญหาอย่างใดอย่างหนึ่งต่อไปนี้

  • หาก UI ส่วนใหญ่ของ Android Studio ดูปกติ แต่ไอคอนบางรายการ เบลอหรือมีการปิดบังบางส่วน หรือองค์ประกอบ UI บางรายการใช้แบบอักษรขนาดไม่ถูกต้อง แสดงว่าองค์ประกอบนั้นอาจยังไม่ได้อัปเดตอย่างสมบูรณ์เพื่อรองรับ HiDPI โปรดรายงานข้อบกพร่องโดยคลิกความช่วยเหลือ > ส่งความคิดเห็น และแนบภาพหน้าจอพร้อมข้อมูลการกำหนดค่าระบบให้ได้มากที่สุด
  • หากคุณใช้เครื่อง Windows หรือ Linux และจอแสดงผลใช้ค่าตัวคูณมาตราส่วนอื่นที่ไม่ใช่ 100% หรือ 200% รูปภาพอาจปรากฏเบลอเล็กน้อยเนื่องจากการปรับขนาด
  • หากคุณใช้เครื่อง Windows และเปลี่ยนขนาดแบบอักษรของ Windows ในแผงควบคุม คุณอาจพบว่าแบบอักษรเบลอหรือมีการปิดบังบางส่วน คุณสามารถแก้ไขปัญหานี้ได้โดยออกจากระบบ Windows แล้วลงชื่อเข้าใช้อีกครั้ง
  • ในการตั้งค่าจอภาพหลายจอที่ใช้ Windows 8.1 ขึ้นไป เมื่อคุณย้ายหน้าต่างจากจอแสดงผลหนึ่งไปยังอีกจอแสดงผลหนึ่งที่มีความละเอียดหรือ DPI ต่างกัน คุณอาจพบปัญหาเกี่ยวกับแบบอักษรหรือรูปภาพ (ดูข้อบกพร่อง 186007) ซึ่งขณะนี้ยังไม่มีวิธีแก้ปัญหาที่ทราบ
  • JRE 1.8 เวอร์ชันเก่ามีปัญหาเกี่ยวกับแบบอักษรเบลอ (โดยเฉพาะ JRE 1.8.0_25-b18 amd64 ดูข้อบกพร่อง 192316) ตั้งแต่เวอร์ชัน 2.2 เป็นต้นมา Android Studio มี JDK เวอร์ชันล่าสุดที่รองรับ รวมอยู่ด้วย ซึ่งรวมถึง JDE หากต้องการแก้ไขปัญหานี้ ให้อัปเดต Android Studio เป็นเวอร์ชัน 2.2 ขึ้นไป แล้วเปลี่ยนไปใช้ JDK ที่รวมไว้โดยคลิก ไฟล์ > โครงสร้างโปรเจ็กต์ > ตำแหน่ง SDK แล้วเลือกช่องทำเครื่องหมายใช้ JDK ที่ฝังไว้

องค์ประกอบขนาดไม่ถูกต้องในจอแสดงผลความหนาแน่นสูง

หาก UI ทั้งหมดของ Android Studio มีขนาดไม่ถูกต้องในจอแสดงผลความหนาแน่นสูง โปรดดู การตั้งค่าค่าตัวคูณมาตราส่วน หากองค์ประกอบ UI บางรายการของ Android Studio มีขนาดไม่ถูกต้องในจอแสดงผลความหนาแน่นสูง แต่รายการอื่นๆ มีขนาดถูกต้อง คุณอาจพบปัญหาอย่างใดอย่างหนึ่งต่อไปนี้

  • หากคุณใช้ธีมของเอดิเตอร์ที่กำหนดเอง แบบอักษรของเอดิเตอร์อาจปรากฏเล็กหรือใหญ่เกินไปเมื่อเทียบกับองค์ประกอบ UI อื่นๆ ในจอแสดงผลความหนาแน่นสูง หากต้องการแก้ไขปัญหานี้ ให้คลิกไฟล์ > การตั้งค่า แล้วคลิก เอดิเตอร์ > สีและแบบอักษร > แบบอักษร แล้วเปลี่ยนขนาดแบบอักษรของเอดิเตอร์ โปรดทราบ ว่าเมื่อธีมเริ่มต้นทำงานอยู่ ระบบจะปรับขนาดแบบอักษรของเอดิเตอร์โดยอัตโนมัติ (ดูข้อบกพร่อง 186920)
  • หากองค์ประกอบ UI บางรายการของ Android Studio มีขนาดถูกต้อง แต่รายการอื่นๆ เล็กหรือใหญ่เกินไป คุณอาจพบปัญหา 186923 โปรดรายงานข้อบกพร่องโดยคลิกความช่วยเหลือ > ส่งความคิดเห็น และแนบภาพหน้าจอพร้อมข้อมูลการกำหนดค่าระบบให้ได้มากที่สุด

ปัญหาเกี่ยวกับการซิงค์โปรเจ็กต์

เมื่อพยายามซิงค์โปรเจ็กต์ คุณอาจได้รับข้อความแสดงข้อผิดพลาดต่อไปนี้ "Connection to the Internet denied. ('Permission denied: connect')" คุณสามารถแก้ไขข้อความแสดงข้อผิดพลาดนี้ได้โดยเพิ่มพร็อพเพอร์ตี้ของระบบ -Djava.net.preferIPv4Stack=true ลงในไฟล์ gradle.properties ใน Android Studio ดังนี้

  1. เปิดไฟล์ gradle.properties ใน Android Studio
  2. เพิ่มบรรทัดต่อไปนี้ลงในไฟล์ 
    org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true
    โปรดทราบว่าหากคุณได้เพิ่มอาร์กิวเมนต์อื่นๆ ของ Gradle JVM ลงใน gradle.properties ไฟล์แล้ว คุณสามารถเพิ่มพร็อพเพอร์ตี้นี้ลงใน บรรทัดเดียวกันได้ดังที่แสดงในตัวอย่างต่อไปนี้ 
    org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -Djava.net.preferIPv4Stack=true
  3. รีสตาร์ท Android Studio เพื่อให้การเปลี่ยนแปลงมีผล
  4. คลิกซิงค์โปรเจ็กต์กับไฟล์ Gradle เพื่อซิงค์โปรเจ็กต์

ปัญหาเกี่ยวกับการอัปเดต IDE ใน Windows

ใน Windows คุณจะลบไฟล์ที่กระบวนการกำลังใช้อยู่ไม่ได้ เมื่อคุณพยายามใช้กลไกการอัปเดตในตัวใน IDE บางครั้งระบบจะปฏิเสธที่จะติดตั้งการอัปเดต โดยมักจะแสดงข้อความแสดงข้อผิดพลาด เช่น "Can't delete C:\some\path\file"

หากต้องการหลีกเลี่ยงปัญหานี้ ให้เปิดตัวจัดการงานแล้วพยายามหยุดกระบวนการที่อาจใช้ไฟล์ดังกล่าว เช่น Daemon ของ Gradle

ปัญหาเกี่ยวกับ minSdkVersion

หากคุณใช้ Android Support Libraries เวอร์ชันเก่า คุณอาจได้รับข้อความแสดงข้อผิดพลาดต่อไปนี้

:app:processDebugManifest app/src/main/AndroidManifest.xml:0:0 Error:
uses-sdk:minSdkVersion 19 cannot be smaller than version L declared in library app/build/intermediates/exploded-aar/com.android.support/appcompat-v7/21.0.0-rc1/AndroidManifest.xml
Suggestion: use tools:overrideLibrary="android.support.v7.appcompat" to force usage

หากต้องการแก้ไขปัญหานี้ ให้ใช้ SDK Manager เพื่ออัปเดตเป็น Android Support Libraries เวอร์ชันล่าสุด (ที่ไม่ใช่เวอร์ชันตัวอย่าง) ดูข้อมูลเพิ่มเติมเกี่ยวกับการตั้งค่า ไลบรารีการสนับสนุน ได้ที่ หัวข้อการตั้งค่า Support Library

ปัญหาเกี่ยวกับโปรแกรมจำลองของ Android

ดูการแก้ปัญหา โปรแกรมจำลองของ Android

ไดเรกทอรี

Android Studio ใช้ไดเรกทอรีต่อไปนี้เพื่อจัดเก็บการตั้งค่า แคช ปลั๊กอิน และบันทึก

Windows

  • การกำหนดค่า (idea.config.path): %APPDATA%\Google\AndroidStudioVERSION
  • ปลั๊กอิน (idea.plugins.path): %APPDATA%\Google\AndroidStudioVERSION\plugins
  • ระบบ (idea.system.path): %LOCALAPPDATA%\Google\AndroidStudioVERSION
  • บันทึก (idea.log.path): %LOCALAPPDATA%\Google\AndroidStudioVERSION\log
  • ตัวอย่าง %APPDATA%: C:\Users\YourUserName\AppData\Roaming
  • ตัวอย่าง %LOCALAPPDATA%: C:\Users\YourUserName\AppData\Local

macOS

  • การกำหนดค่า (idea.config.path): ~/Library/Application Support/Google/AndroidStudioVERSION
  • ปลั๊กอิน (idea.plugins.path): ~/Library/Application Support/Google/AndroidStudioVERSION/plugins
  • ระบบ (idea.system.path): ~/Library/Caches/Google/AndroidStudioVERSION
  • บันทึก (idea.log.path): ~/Library/Logs/Google/AndroidStudioVERSION

Linux

  • การกำหนดค่า (idea.config.path): ~/.config/Google/AndroidStudioVERSION
  • ปลั๊กอิน (idea.plugins.path): ~/.local/share/Google/AndroidStudioVERSION
  • ระบบ (idea.system.path): ~/.cache/Google/AndroidStudioVERSION
  • บันทึก (idea.log.path): ~/.cache/Google/AndroidStudioVERSION/log

แต่ละไดเรกทอรีจะแสดงในรูปแบบต่อไปนี้

โดยให้แทนที่

  • AndroidStudio ด้วยชื่อผลิตภัณฑ์ ซึ่งคือ AndroidStudio สำหรับเวอร์ชันเสถียร หรือ AndroidStudioPreview สำหรับเวอร์ชัน RC และ Canary
  • VERSION ด้วยเวอร์ชัน เช่น 2023.1 หรือ 2023.3