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

تحتوي هذه الصفحة على إرشادات لتحديد المشاكل الشائعة ومشاكل الإعداد في "استوديو Android" وحلّها.

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

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

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

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

نظام التشغيل Mac
بالنسبة إلى شاشات Retina، يتم قياس عناصر واجهة المستخدم بعامل قياس يبلغ% 200، ويتم عرض الصور بدقة عالية. لا يفترض أن تظهر أي عناصر غير واضحة بسبب القياس، حتى في الإعدادات المتعددة الشاشات. يُرجى العِلم أنّه لا يتم دعم عوامل القياس الأخرى غير %100 (لشاشات العرض غير Retina) و%200 (لشاشات Retina).
Windows
يستخدم "استوديو Android" إعدادات نقاط لكل بوصة (DPI) لشاشة العرض الأساسية لتحديد عامل قياس عناصر واجهة المستخدم. بالنسبة إلى الصور، إذا كان عامل القياس أقل من %150، يتم تكبير الصور ذات الدقة العادية. إذا كان عامل القياس أكبر من %150، يتم قياس الصور عالية الدقة بشكل مناسب.
نظام التشغيل Linux
يحدّد "استوديو Android" عامل القياس من خلال الاطّلاع على "عامل قياس النص"، ثم على إعداد نقاط لكل بوصة (DPI) في نظام XWindow.
يتوافق إعداد نقاط لكل بوصة (DPI) يبلغ 96 مع عامل قياس يبلغ %100 (بدون قياس)، ويتوافق إعداد نقاط لكل بوصة (DPI) يبلغ 192 مع عامل قياس يبلغ %200 (يتضاعف حجم عناصر واجهة المستخدم). يتوافق "استوديو Android" حاليًا مع إعدادات نقاط لكل بوصة (DPI) تتراوح بين 96 (قياس% 100) و288 (قياس% 300). إذا لم يرصد "استوديو Android" نقاط لكل بوصة (DPI) الصحيحة للنظام على جهاز Linux أو Windows، يمكنك ضبطها يدويًا من خلال ضبط السمة hidpi في الملف idea.properties كما هو موضّح في تخصيص خصائص بيئة التطوير المتكاملة. يُرجى العِلم أنّ هذه السمة ليس لها أي تأثير على أجهزة Mac. تعمل هذه السمة على النحو التالي:
hidpi=true
يتم ضبط نقاط لكل بوصة (DPI) على 192 (قياس% 200)، مع تجاهل إعدادات النظام.
hidpi=false
يتم ضبط نقاط لكل بوصة (DPI) على 96 (قياس% 100)، مع تجاهل إعدادات النظام.

عناصر غير واضحة أو متقطّعة على شاشات العرض عالية الكثافة

إذا ظهر عنصر واحد أو أكثر من عناصر واجهة مستخدم "استوديو Android" غير واضح أو متقطّع على شاشة العرض عالية الكثافة، قد يكون السبب في ذلك إحدى المشاكل التالية:

  • إذا كانت معظم عناصر واجهة مستخدم "استوديو Android" تبدو جيدة، ولكن ظهر رمز معيّن غير واضح أو متقطّع، أو إذا كان عنصر معيّن في واجهة المستخدم يستخدم خطًا بحجم غير مناسب، من المحتمل أنّه لم يتم بعد تحديث هذا العنصر بالكامل ليتوافق مع شاشات 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" إصدارًا مجمّعًا من أحدث حزمة JDK متوافقة، والتي تتضمّن JDE. لحلّ هذه المشكلة، عليك تحديث Android Studio إلى الإصدار 2.2 أو إصدار أحدث والتبديل إلى استخدام حزمة JDK المجمّعة من خلال النقر على ملف > بنية المشروع > موقع حزمة SDK ووضع علامة في مربّع الاختيار استخدام حزمة JDK المضمّنة.

عناصر بحجم غير مناسب على شاشات العرض عالية الكثافة

إذا كانت واجهة مستخدم "استوديو Android" بأكملها بحجم غير مناسب على شاشة العرض عالية الكثافة، راجِع إعدادات عامل القياس. إذا كانت بعض عناصر واجهة مستخدم "استوديو Android" بحجم غير مناسب على شاشة العرض عالية الكثافة، ولكنّ البعض الآخر بحجم مناسب، قد يكون السبب في ذلك إحدى المشاكل التالية:

  • إذا كنت تستخدم نظام ألوان مخصّصًا للمحرّر، قد يبدو خط المحرّر صغيرًا جدًا أو كبيرًا جدًا مقارنةً ببقية عناصر واجهة المستخدم على شاشة العرض عالية الكثافة. لحلّ هذه المشكلة، انقر على ملف > الإعدادات ثم انقر على المحرّر > الألوان والخطوط > الخط وغيِّر حجم خط المحرّر. يُرجى العِلم أنّه عندما يكون نظام الألوان التلقائي مفعّلاً، يتم قياس حجم خط المحرّر تلقائيًا (راجِع الخطأ 186920).
  • إذا كانت بعض عناصر واجهة مستخدم "استوديو Android" بحجم مناسب، ولكنّ البعض الآخر صغير جدًا أو كبير جدًا، قد يكون السبب في ذلك المشكلة 186923. يُرجى الإبلاغ عن خطأ من خلال النقر على مساعدة > إرسال ملاحظات. يُرجى تضمين لقطة شاشة وتقديم أكبر قدر ممكن من المعلومات حول إعدادات النظام.

مشاكل مزامنة المشروع

عند محاولة مزامنة مشروعك، قد تظهر لك رسالة الخطأ التالية: "تم رفض الاتصال بالإنترنت. ('تم رفض الإذن: الاتصال')". يمكنك حلّ رسالة الخطأ هذه من خلال إضافة خاصية النظام -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" لتصبح التغييرات سارية.
  4. انقر على مزامنة المشروع مع ملفات Gradle‏ لمزامنة مشروعك.

مشاكل في تحديث بيئة التطوير المتكاملة على Windows

على Windows، لا يمكن حذف الملفات التي يستخدمها أحد العمليات. عند محاولة استخدام آلية التحديث المضمّنة في بيئة التطوير المتكاملة، ترفض أحيانًا تثبيت التحديث، وعادةً ما تظهر رسالة خطأ مثل "لا يمكن حذف C:\some\path\file".

لحلّ هذه المشكلة، افتح "إدارة المهام" وحاول إيقاف العمليات التي قد تستخدم الملف، مثل أيّ برامج Gradle daemon.

مشاكل 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"

راجِع تحديد المشاكل في Android Emulator وحلّها.

الأدلة

يستخدم "استوديو 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

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 لإصدارات المرشّح للإصدار والإصدارات التجريبية.
  • VERSION بالإصدار. على سبيل المثال: 2023.1 أو 2023.3.