تحديد المشاكل في "استوديو Android" وحلّها

تحتوي هذه الصفحة على إرشادات لتحديد المشاكل الشائعة وحلّها، بالإضافة إلى مشاكل الإعداد في Android Studio.

الشاشات العالية الكثافة

بدءًا من الإصدار 1.5، يتيح Android Studio استخدام شاشات عالية الكثافة (مثل شاشات HiDPI وRetina) على جميع المنصات.

إعدادات عامل القياس

يحدّد "استوديو Android" عامل القياس لشاشتك على النحو التالي:

Mac
بالنسبة إلى شاشات Retina، يتم تغيير حجم عناصر واجهة المستخدم بمقدار% 200، ويتم عرض الصور بدقة عالية. يجب ألا يكون هناك أي تشويش بسبب تغيير الحجم، حتى في عمليات الضبط التي تتضمّن شاشات متعددة. يُرجى العِلم أنّه لا تتوفّر إمكانية استخدام عوامل قياس أخرى غير %100 (للشاشات غير المحسّنة) و%200 (للشاشات المحسّنة).
نظام التشغيل Windows
يستخدم Android Studio إعدادات عدد النقاط لكل بوصة (DPI) للشاشة الأساسية لتحديد عامل القياس لعناصر واجهة المستخدم. بالنسبة إلى الصور، إذا كان عامل القياس أقل من %150، يتم تكبير الصور ذات الدقة العادية. إذا كان عامل القياس أكبر من %150، يتم قياس الصور العالية الدقة بشكل مناسب.
Linux
يحدّد "استوديو Android" عامل القياس من خلال البحث عن "عامل قياس النص"، ثم عن إعدادات النقاط في البوصة لنظام XWindow.
يتوافق إعداد النقاط في البوصة (DPI) البالغ 96 مع عامل قياس يبلغ %100 (بدون تغيير الحجم)، ويتوافق إعداد النقاط في البوصة (DPI) البالغ 192 مع عامل قياس يبلغ %200 (يتضاعف حجم عناصر واجهة المستخدم). يتيح Android Studio حاليًا إعدادات النقاط في البوصة (DPI) التي تتراوح بين 96 (التحجيم بنسبة% 100) و288 (التحجيم بنسبة% 300). إذا لم يرصد Android Studio معدّل وحدات البكسل لكل بوصة (DPI) الصحيح على جهاز Linux أو Windows، يمكنك ضبطه يدويًا من خلال ضبط السمة 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" على النحو التالي:

  1. افتح ملف gradle.properties في "استوديو Android".
  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 لمزامنة مشروعك.

مشاكل في تحديث بيئة التطوير المتكاملة على 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

يتم إدراج كل دليل بالتنسيق التالي:

الاستبدال:

  • AndroidStudio مع اسم المنتج، وهو AndroidStudio للإصدارات الثابتة أو AndroidStudioPreview لإصدارات RC وCanary.
  • VERSION مع الإصدار على سبيل المثال: 2023.1 أو 2023.3.