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

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

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

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

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

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

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

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

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

  • إذا كانت معظم واجهة مستخدم "استوديو Android" تبدو جيدة، ولكن هناك رمز واحد مموّهة أو متقطّعة أو يستخدم عنصر معيّن في واجهة المستخدم خطًا بحجم غير صحيح ربما لم يتم تحديث هذا العنصر المحدد بشكل كامل بعد لـ HiDPI والدعم. يُرجى الإبلاغ عن الخطأ من خلال النقر على مساعدة >. إرسال ملاحظات من فضلك تضمين لقطة شاشة وأكبر قدر ممكن من المعلومات على نظامك التكوين.
  • إذا كنت تستخدم جهاز Windows أو Linux ويستخدم جهاز العرض عامل تحجيم بخلاف 100% أو 200%، قد تظهر الصور مموَّهة قليلاً بسبب إلى التحجيم.
  • إذا كنت تستخدم جهازًا يعمل بنظام Windows وغيّرت عنوان URL حجم الخط في لوحة التحكم، فقد تظهر لك خطوط مموَّهة أو متقطّعة. ويمكنك حل هذه المشكلة من خلال تسجيل الخروج من نظام التشغيل Windows ثم تسجيل الدخول مرة أخرى.
  • في إعداد متعدد الشاشات يعمل بنظام Windows 8.1 أو إصدار أحدث، عند نقل من شاشة عرض إلى أخرى ذات دقة مختلفة أو عدد نقاط لكل بوصة (DPI). قد تواجه مشاكل في الخطوط أو الصور (راجع الخطأ 186007). ما مِن حل بديل معروف في الوقت الحالي.
  • كانت هناك مشكلة في الخطوط المعتمة في الإصدارات القديمة من JRE 1.8 (JRE 1.8.0_25-b18 amd64 بالتحديد، يرجى مراجعة الخطأ 192316.) بدءًا من الإصدار 2.2، أصبح "استوديو Android" يتضمّن إصدارًا مجمّعًا من أحدث إصدار كما هو الحال مع JDK، الذي يتضمن JDE. لحلّ هذه المشكلة، يجب تحديث Android. يمكنك استخدام "استوديو YouTube" إلى الإصدار 2.2 أو إصدار أحدث والتبديل لاستخدام حزمة JDK المجمَّعة عن طريق النقر على ملف > هيكل المشروع > موقع حزمة SDK والتحقق من استخدام JDK المضمنة.

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

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

  • في حال استخدام مخطط محرّر مخصّص، قد يظهر خط المحرِّر أيضًا. صغيرة أو كبيرة جدًا مقارنة ببقية عناصر واجهة المستخدم بكثافة العرض. لإصلاح هذه المشكلة، انقر على ملف > الإعدادات ثم انقر على المحرّر > الألوان والخطوط > الخط وغيِّر حجم خط المحرِّر. ملاحظة أنه عندما يكون المخطط الافتراضي نشطًا، يتم تقليص حجم خط المحرر تلقائيًا (راجع الخطأ 186920).
  • إذا كانت بعض عناصر واجهة المستخدم في Android Studio بالحجم الصحيح، بينما يكون البعض الآخر صغيرة جدًا أو كبيرة جدًا، يُحتمَل أنّك تواجه المشكلة 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 لمزامنة مشروعك.

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

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