Khắc phục sự cố cho Android Studio | Android Developers
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ục lục bài viết
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ẽ hiển thị ở độ phân giải cao. Hình ảnh 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.
Tùy 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à tùy 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
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ị phân thành pixel trên màn hình có mật độ điểm ảnh cao
Tùy 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à tùy 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ínhtrong tệpnhư 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:
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 đủ cho hỗ trợ HiDPI. Vui lòng báo cáo lỗi bằng cách nhấp vào 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 càng nhiều thông tin càng tốt
trên 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 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. - Trên chế độ thiết lập 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. - 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 mới nhất của 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 sai trên màn hình hiển thị mật độ cao, nhưng các kích thước 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 độ 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, kích thước phông 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, nhưng một số thành phần khác
quá nhỏ hoặc quá lớn, 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 Trợ giúp > Gửi phản hồi. Vui lòng cung cấp một ảnh chụp màn hình và càng nhiều thông tin càng tốt 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
của bạn trong Android Studio như sau:
- Mở tệp
gradle.properties
trong Android Studio. - Thêm dòng sau vào tệp:
org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true
Xin lưu ý rằng nếu đã thêm các đối số Gradle JVM khác vào tệp
gradle.properties
, bạn có thể thêm thuộc tính này vào cùng một dòng như ví dụ sau:org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -Djava.net.preferIPv4Stack=true
- Khởi động lại Android Studio để các thay đổi của bạn có hiệu lực.
- 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 mà một quy trình đang sử dụng. 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 lỗi của 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 lỗi của Trình mô phỏng Android
Xem phần Trình khắc phục sự cố của trình mô phỏng Android.