Khắc phục sự cố cho Android Studio

Trang này chứa hướng dẫn khắc phục các sự cố thường gặp và sự cố về cấu hình trong Android Studio.

Màn hình mật độ điểm ảnh cao

Kể từ phiên bản 1.5, Android Studio sẽ hỗ trợ các màn hình có mật độ hiển thị cao (như màn hình HiDPI và Retina) trên mọi nền tảng.

Cài đặt hệ số tỷ lệ

Android Studio xác định hệ số tỷ lệ cho màn hình của bạn như sau:

Mac
Đối với màn hình Retina, các phần tử trên giao diện người dùng được thay đổi tỷ lệ theo hệ số 200% và hình ảnh sẽ kết xuất ở độ phân giải cao. Hình ảnh sẽ không bị mờ do việc mở rộng quy mô, ngay cả trong cấu hình nhiều màn hình. Lưu ý rằng hệ thống không hỗ trợ cho các hệ số tỷ lệ khác 100% (đối với màn hình không phải Retina) và 200% (đối với màn hình Retina).
Windows
Android Studio sử dụng chế độ cài đặt DPI của màn hình chính để xác định hệ số tỷ lệ của các phần tử trên giao diện người dùng. Đối với hình ảnh, nếu hệ số tỷ lệ nhỏ hơn 150%, thì hình ảnh có độ phân giải bình thường sẽ được chia tỷ lệ. Nếu hệ số tỷ lệ lớn hơn 150%, thì hình ảnh có độ phân giải cao sẽ được điều chỉnh theo tỷ lệ thích hợp.
Linux
Android Studio xác định hệ số tỷ lệ bằng cách xem xét "Hệ số tỷ lệ văn bản" trong chế độ cài đặt DPI của hệ thống XWindow.
Tuỳ chọn cài đặt DPI là 96 tương ứng với hệ số chia tỷ lệ là 100% (không có tỷ lệ) và tuỳ chọn cài đặt DPI là 192 tương ứng với hệ số tỷ lệ là 200% (kích thước của các phần tử giao diện người dùng tăng gấp đôi). Android Studio hiện hỗ trợ các chế độ cài đặt DPI trong khoảng từ 96 (tỷ lệ 100%) đến 288 (tỷ lệ 300%). Nếu Android Studio không phát hiện được đúng DPI của hệ thống trên máy Linux hoặc Windows, thì bạn có thể đặt thủ công chế độ này bằng cách đặt thuộc tính hidpi trong tệp idea.properties như mô tả trong phần Tuỳ chỉnh các thuộc tính IDE. Lưu ý rằng thuộc tính này không ảnh hưởng đến máy Mac. Thuộc tính này có chức năng như sau:
hidpi=true
Đặt DPI ở mức 192 (tỷ lệ 200%), bỏ qua các chế độ cài đặt hệ thống.
hidpi=false
Đặt DPI ở mức 96 (chia tỷ lệ 100%) và bỏ qua các chế độ cài đặt hệ thống.

Các phần tử bị làm mờ hoặc bị vỡ nét trên màn hình có mật độ điểm ảnh cao

Nếu một hoặc nhiều phần tử trên giao diện người dùng của Android Studio bị mờ hoặc vỡ nét trên màn hình có mật độ điểm ảnh cao, bạn có thể đang gặp phải một trong những vấn đề sau:

  • Nếu hầu hết các giao diện người dùng trên Android Studio đều ổn, nhưng một biểu tượng cụ thể bị mờ hoặc vỡ nét, hoặc một phần tử cụ thể trên giao diện người dùng sử dụng phông chữ có kích thước sai, thì có thể phần tử đó chưa được cập nhật đầy đủ để hỗ trợ HiDPI. Vui lòng báo cáo lỗi bằng cách nhấp vào Help > Submit Feedback (Trợ giúp > Gửi phản hồi). Vui lòng đính kèm ảnh chụp màn hình và cung cấp nhiều thông tin nhất có thể về cấu hình hệ thống của bạn.
  • Nếu bạn đang sử dụng máy Windows hoặc Linux và màn hình của bạn sử dụng hệ số tỷ lệ không phải 100% hoặc 200%, hình ảnh có thể bị mờ một chút do việc chia tỷ lệ.
  • Nếu đang dùng máy Windows và đã thay đổi cỡ chữ của Windows trong Control Panel (Bảng điều khiển), thì bạn có thể thấy phông chữ bị mờ hoặc vỡ nét. Bạn có thể giải quyết sự cố này bằng cách đăng xuất khỏi Windows rồi đăng nhập lại.
  • Nếu thiết lập máy tính với nhiều màn hình chạy Windows 8.1 trở lên, khi di chuyển một cửa sổ từ màn hình này sang màn hình khác có độ phân giải hoặc DPI khác, bạn có thể gặp sự cố với phông chữ hoặc hình ảnh (xem lỗi 186007). Hiện chưa có giải pháp đã biết nào cho việc này.
  • Các phiên bản cũ hơn của JRE 1.8 gặp vấn đề đối với phông chữ bị mờ (cụ thể là JRE 1.8.0_25-b18 amd64, hãy xem lỗi 192316.) Kể từ phiên bản 2.2, Android Studio bao gồm một phiên bản JDK được hỗ trợ mới nhất, trong đó có JDE. Để giải quyết vấn đề này, hãy cập nhật Android Studio lên phiên bản 2.2 trở lên và chuyển sang sử dụng JDK đi kèm bằng cách nhấp vào File > Project Structure > SDK Location (Tệp > Cấu trúc dự án > Vị trí SDK) rồi chọn hộp kiểm Use embedded JDK (Sử dụng JDK được nhúng).

Các phần tử có kích thước không chính xác trên màn hình có mật độ điểm ảnh cao

Nếu toàn bộ giao diện người dùng của Android Studio có kích thước không chính xác trên màn hình có mật độ điểm ảnh cao, hãy xem phần Cài đặt hệ số tỷ lệ. Nếu một số phần tử của giao diện người dùng Android Studio có kích thước không chính xác trên màn hình với mật độ cao, trong khi các phần tử khác có kích thước chính xác, thì bạn có thể đang gặp phải một trong các vấn đề sau:

  • Nếu bạn đang sử dụng một lược đồ chỉnh sửa tuỳ chỉnh, thì phông chữ của trình chỉnh sửa có thể quá nhỏ hoặc quá lớn so với các phần tử còn lại của giao diện người dùng trên màn hình mật độ điểm ảnh cao. Để khắc phục sự cố này, hãy nhấp vào File > Settings (Tệp > Cài đặt), sau đó nhấp vào Editor > Colors and Fonts > Font (Trình chỉnh sửa > Màu sắc và phông chữ > Phông chữ) và thay đổi kích thước phông chữ của trình chỉnh sửa. Lưu ý rằng khi lược đồ mặc định đang hoạt động, cỡ chữ của trình chỉnh sửa sẽ được tự động điều chỉnh (xem lỗi 186920).
  • Nếu một số thành phần giao diện người dùng của Android Studio có kích thước phù hợp, trong khi một số thành phần khác quá to hoặc quá nhỏ, thì bạn có thể đang gặp vấn đề 186923. Vui lòng báo cáo lỗi bằng cách nhấp vào Help > Submit Feedback (Trợ giúp > Gửi phản hồi). Vui lòng cung cấp ảnh chụp màn hình và nhiều thông tin nhất có thể về cấu hình hệ thống của bạn.

Vấn đề đồng bộ hoá dự án

Khi cố gắng đồng bộ hoá dự án, bạn có thể nhận được thông báo lỗi sau: "Connection to the Internet denied. ('Permission denied: connect')" (Kết nối với Internet bị từ chối. ("Quyền bị từ chối: kết nối")). Bạn có thể giải quyết thông báo lỗi này bằng cách thêm thuộc tính hệ thống -Djava.net.preferIPv4Stack=true vào tệp gradle.properties trong Android Studio như sau:

  1. Mở tệp gradle.properties trong Android Studio.
  2. Thêm dòng sau vào tệp:
    org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true
    
    Lưu ý rằng nếu bạn đã thêm các đối số Gradle JVM khác vào gradle.properties, bạn có thể thêm thuộc tính này vào cùng như trong ví dụ sau:
    org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -Djava.net.preferIPv4Stack=true
    
  3. Khởi động lại Android Studio để các thay đổi của bạn có hiệu lực.
  4. Nhấp vào Sync Project with Gradle Files (Đồng bộ hoá dự án với tệp Gradle) để đồng bộ hoá dự án của bạn.

Sự cố khi cập nhật IDE trên Windows

Trên Windows, bạn không thể xoá các tệp đang được sử dụng bởi một quy trình. Khi bạn cố sử dụng cơ chế cập nhật tích hợp trong IDE, đôi khi cơ chế này sẽ từ chối cài đặt bản cập nhật và thường sẽ cung cấp một thông báo lỗi như "Can't delete C:\some\path\file" (Không thể xoá C:\some\path\file).

Để xử lý vấn đề này, hãy mở trình quản lý tác vụ và cố gắng loại bỏ các quy trình có thể đang sử dụng tệp, chẳng hạn như bất kỳ trình nền Gradle nào.

Các vấn đề về minSdkVersion

Nếu đang sử dụng phiên bản đã lỗi thời của Thư viện hỗ trợ Android, bạn có thể nhận được thông báo lỗi như sau:

: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

Để giải quyết vấn đề này, hãy sử dụng trình quản lý SDK để cập nhật lên các phiên bản mới nhất (không phải bản xem trước) của Thư viện hỗ trợ Android. Để biết thêm thông tin về cách thiết lập Thư viện hỗ trợ, hãy xem bài viết Thiết lập Thư viện hỗ trợ.

Các vấn đề về Trình mô phỏng Android

Xem phần Khắc phục sự cố về trình mô phỏng Android.

Thư mục

Android Studio sử dụng các thư mục sau đây để lưu trữ chế độ cài đặt, bộ nhớ đệm, trình bổ trợ và nhật ký.

Windows

  • Cấu hình (idea.config.path): %APPDATA%\Google\AndroidStudioVERSION
  • Trình bổ trợ (idea.plugin.path): %APPDATA%\Google\AndroidStudioVERSION\plugins
  • Hệ thống (idea.system.path): %LOCALAPPDATA%\Google\AndroidStudioVERSION
  • Nhật ký (idea.log.path): %LOCALAPPDATA%\Google\AndroidStudioVERSION\log
  • Ví dụ về %APPDATA%: C:\Users\YourUserName\AppData\Roaming
  • Ví dụ về %LOCALAPPDATA%: C:\Users\YourUserName\AppData\Local

macOS

  • Cấu hình (idea.config.path): ~/Library/Application Support/Google/AndroidStudioVERSION
  • Trình bổ trợ (idea.plugin.path): ~/Library/Application Support/Google/AndroidStudioVERSION/plugins
  • Hệ thống (idea.system.path): ~/Library/Caches/Google/AndroidStudioVERSION
  • Nhật ký (idea.log.path): ~/Library/Logs/Google/AndroidStudioVERSION

Linux

  • Cấu hình (idea.config.path): ~/.config/Google/AndroidStudioVERSION
  • Trình bổ trợ (idea.plugin.path): ~/.local/share/Google/AndroidStudioVERSION
  • Hệ thống (idea.system.path): ~/.cache/Google/AndroidStudioVERSION
  • Nhật ký (idea.log.path): ~/.cache/Google/AndroidStudioVERSION/log

Mỗi thư mục được liệt kê ở định dạng sau:

Thay thế:

  • AndroidStudio với tên sản phẩm, là AndroidStudio đối với bản phát hành chính thức hoặc AndroidStudioPreview đối với bản phát hành Beta và Canary.
  • VERSION kèm theo phiên bản. Ví dụ: 2023.1 hoặc 2023.3.