تحتوي هذه الصفحة على إرشادات لتحديد المشاكل الشائعة وحلّها، بالإضافة إلى مشاكل الإعداد في Android Studio.
الشاشات العالية الكثافة
بدءًا من الإصدار 1.5، يتيح Android Studio استخدام شاشات عالية الكثافة (مثل شاشات HiDPI وRetina) على جميع المنصات.
إعدادات عامل القياس
يحدّد "استوديو Android" عامل القياس لشاشتك على النحو التالي:
- Mac
- بالنسبة إلى شاشات Retina، يتم تغيير حجم عناصر واجهة المستخدم بمقدار% 200، ويتم عرض الصور بدقة عالية. يجب ألا يكون هناك أي تشويش بسبب تغيير الحجم، حتى في عمليات الضبط التي تتضمّن شاشات متعددة. يُرجى العِلم أنّه لا تتوفّر إمكانية استخدام عوامل قياس أخرى غير %100 (للشاشات غير المحسّنة) و%200 (للشاشات المحسّنة).
- نظام التشغيل Windows
- يستخدم Android Studio إعدادات عدد النقاط لكل بوصة (DPI) للشاشة الأساسية لتحديد عامل القياس لعناصر واجهة المستخدم. بالنسبة إلى الصور، إذا كان عامل القياس أقل من %150، يتم تكبير الصور ذات الدقة العادية. إذا كان عامل القياس أكبر من %150، يتم قياس الصور العالية الدقة بشكل مناسب.
- Linux
- يحدّد "استوديو Android" عامل القياس من خلال البحث عن "عامل قياس النص"، ثم عن إعدادات النقاط في البوصة لنظام XWindow.
hidpi
في ملف idea.properties
كما هو موضّح في تخصيص سمات بيئة التطوير المتكاملة. يُرجى العِلم أنّ هذه السمة ليس لها أي تأثير على أجهزة Mac.
تعمل هذه السمة على النحو التالي:
hidpi=true
- يضبط هذا الخيار معدّل وحدات البوصة لكل نقطة على 192 (توسيع نطاق بنسبة% 200)، مع تجاهل إعدادات النظام.
hidpi=false
- يضبط هذا الخيار معدّل وحدات البوصة المربعة على 96 (تغيير الحجم بنسبة% 100)، مع تجاهل إعدادات النظام.
عناصر غير واضحة أو متقطّعة على شاشات عالية الكثافة
إذا ظهر عنصر واحد أو أكثر من عناصر واجهة مستخدم Android Studio بشكل غير واضح أو على شكل وحدات بكسل على شاشة العرض عالية الكثافة، قد تكون تواجه إحدى المشاكل التالية:
- إذا كانت معظم عناصر واجهة مستخدم Android Studio تبدو جيدة، ولكن كان أحد الرموز غير واضح أو منقّطًا، أو كان أحد عناصر واجهة المستخدم يستخدم حجم خط غير صحيح، فمن المحتمل أنّ هذا العنصر لم يتم تحديثه بالكامل بعد ليتوافق مع شاشات HiDPI. يُرجى الإبلاغ عن الخطأ من خلال النقر على مساعدة > إرسال ملاحظات. يُرجى تضمين لقطة شاشة وأكبر قدر ممكن من المعلومات حول إعدادات نظامك.
- إذا كنت تستخدم جهاز Windows أو Linux وكان العرض يستخدم عامل تحجيم غير% 100 أو %200، قد تظهر الصور مشوّشة قليلاً بسبب التحجيم.
- إذا كنت تستخدم جهاز Windows وغيّرت حجم خط Windows في "لوحة التحكّم"، قد يظهر الخط مشوّهًا أو منقّطًا. يمكنك حلّ هذه المشكلة من خلال تسجيل الخروج من Windows ثم إعادة تسجيل الدخول.
- عند نقل نافذة من شاشة إلى أخرى بدقة أو نقطة لكل بوصة مختلفة في إعدادات شاشات متعددة تعمل بنظام التشغيل Windows 8.1 أو إصدار أحدث، قد تواجه مشاكل في الخط أو الصورة (راجِع الخطأ 186007). ليس هناك حل بديل معروف في الوقت الحالي.
- كانت الإصدارات القديمة من JRE 1.8 تعاني مشكلة في الخطوط غير الواضحة (الإصدار 1.8.0_25-b18 amd64 تحديدًا، يُرجى الاطّلاع على الخطأ 192316). اعتبارًا من الإصدار 2.2، يتضمّن Android Studio إصدارًا مجمّعًا من أحدث إصدارات JDK المتوافقة، والذي يتضمّن JDE. لحلّ هذه المشكلة، عليك تحديث "استوديو Android" إلى الإصدار 2.2 أو إصدار أحدث، ثم التبديل إلى استخدام حزمة تطوير البرامج (JDK) المضمّنة من خلال النقر على ملف > بنية المشروع > موقع حزمة تطوير البرامج (SDK) ووضع علامة في مربّع الاختيار استخدام حزمة تطوير البرامج (JDK) المضمّنة.
عناصر ذات حجم غير صحيح على شاشات العرض عالية الكثافة
إذا كان حجم واجهة مستخدم Android Studio بأكملها غير صحيح على شاشة العرض عالية الكثافة، راجِع إعدادات عامل القياس. إذا كانت بعض عناصر واجهة مستخدم Android Studio تظهر بحجم غير صحيح على شاشة العرض عالية الكثافة، بينما تظهر عناصر أخرى بالحجم الصحيح، قد تكون المشكلة إحدى المشاكل التالية:
- إذا كنت تستخدم نظامًا مخصّصًا للمحرّر، قد يظهر خط المحرّر صغيرًا جدًا أو كبيرًا جدًا مقارنةً ببقية عناصر واجهة المستخدم على شاشة عالية الكثافة. لحلّ هذه المشكلة، انقر على ملف > الإعدادات، ثم انقر على المحرّر > الألوان والخطوط > الخط وغيِّر حجم خط المحرّر. يُرجى العِلم أنّه عند تفعيل المخطّط التلقائي، يتم تغيير حجم خط المحرّر تلقائيًا (راجِع الخطأ 186920).
- إذا كان حجم بعض عناصر واجهة المستخدم في "استوديو Android" مناسبًا، ولكن البعض الآخر صغيرًا جدًا أو كبيرًا جدًا، قد تواجه المشكلة 186923. يُرجى الإبلاغ عن الخطأ من خلال النقر على مساعدة > إرسال ملاحظات. يُرجى تضمين لقطة شاشة وأكبر قدر ممكن من المعلومات حول إعدادات النظام.
مشاكل مزامنة المشاريع
عند محاولة مزامنة مشروعك، قد تظهر لك رسالة الخطأ التالية: "تم رفض الاتصال بالإنترنت. (Permission denied: connect)".
يمكنك حلّ رسالة الخطأ هذه من خلال إضافة خاصية النظام
-Djava.net.preferIPv4Stack=true
إلى ملف
gradle.properties
في "استوديو Android" على النحو التالي:
- افتح ملف
gradle.properties
في "استوديو Android". - أضِف السطر التالي إلى الملف:
يُرجى العِلم أنّه إذا سبق لك إضافة وسيطات أخرى إلى Gradle JVM في ملفorg.gradle.jvmargs=-Djava.net.preferIPv4Stack=true
gradle.properties
، يمكنك إضافة هذه السمة إلى السطر نفسه كما هو موضّح في المثال التالي:org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -Djava.net.preferIPv4Stack=true
- أعِد تشغيل Android Studio لتفعيل التغييرات.
- انقر على مزامنة المشروع مع ملفات Gradle
لمزامنة مشروعك.
مشاكل في تحديث بيئة التطوير المتكاملة على Windows
على نظام التشغيل Windows، لا يمكن حذف الملفات التي يستخدمها أحد العمليات. عند محاولة استخدام آلية التحديث المضمّنة في بيئة التطوير المتكاملة، قد ترفض أحيانًا تثبيت التحديث، وعادةً ما تعرض رسالة خطأ مثل "يتعذّر حذف C:\some\path\file".
لحلّ هذه المشكلة، افتح "مدير المهام" وحاوِل إنهاء العمليات التي قد تستخدم الملف، مثل أي برامج Gradle خفية.
مشاكل minSdkVersion
إذا كنت تستخدم إصدارًا قديمًا من "مكتبات دعم Android"، قد تتلقّى رسالة خطأ مشابهة لما يلي:
: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" لتثبيت أحدث إصدارات (غير تجريبية) من "مكتبات دعم Android". لمزيد من المعلومات حول إعداد مكتبات الدعم، يُرجى الاطّلاع على إعداد مكتبة الدعم.
مشاكل في Android Emulator
اطّلِع على تحديد مشاكل "محاكي Android" وحلّها.
الأدلة
تستخدم "استوديو Android" الدلائل التالية لتخزين الإعدادات وذاكرات التخزين المؤقت والمكوّنات الإضافية والسجلات.
نظام التشغيل 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
نظام التشغيل Mac
- الإعداد (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
يتم إدراج كل دليل بالتنسيق التالي:
<informal directory name>
(<IDE property>
):<default path>
.
الاستبدال:
AndroidStudio
مع اسم المنتج، وهوAndroidStudio
للإصدارات الثابتة أوAndroidStudioPreview
لإصدارات RC وCanary.VERSION
مع الإصدار على سبيل المثال:2023.1
أو2023.3
.