แก้ปัญหาเกี่ยวกับ 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 คุณสามารถตั้งค่าด้วยตนเองได้โดยตั้งค่าพร็อพเพอร์ตี้ hidpi ในไฟล์ idea.properties ตามที่อธิบายไว้ในปรับแต่งพร็อพเพอร์ตี้ IDE โปรดทราบว่าพร็อพเพอร์ตี้นี้จะไม่มีผลกับเครื่อง Mac พร็อพเพอร์ตี้นี้ทำงานดังนี้
hidpi=true
ตั้งค่า DPI เป็น 192 (การปรับขนาด 200%) โดยไม่สนใจการตั้งค่าระบบ
hidpi=false
ตั้งค่า DPI เป็น 96 (การปรับขนาด 100%) โดยไม่สนใจการตั้งค่าระบบ

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

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

  • หาก 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 โปรดรายงานข้อบกพร่องโดยคลิกความช่วยเหลือ > ส่งความคิดเห็น โปรดแนบ ภาพหน้าจอและข้อมูลการกำหนดค่าระบบให้มากที่สุด

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

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

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

ปัญหาในการอัปเดต IDE ใน Windows

ใน Windows คุณจะลบไฟล์ที่กระบวนการใช้งานอยู่ไม่ได้ เมื่อคุณ พยายามใช้กลไกการอัปเดตในตัวใน IDE บางครั้งระบบอาจปฏิเสธที่จะ ติดตั้งการอัปเดต โดยมักจะแสดงข้อความแสดงข้อผิดพลาด เช่น "ลบ 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 ได้ที่การตั้งค่า Support Library

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

ดูการแก้ปัญหา Android Emulator

ไดเรกทอรี

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