تحديد المشاكل في "استوديو 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" حاليًا مع إعدادات عدد النقاط لكل بوصة بين 96 (تحجيم بنسبة 100%) و288 (تحجيم بنسبة 300%). إذا لم يرصد "استوديو Android" نقاط لكل بوصة (DPI) الصحيحة للنظام على جهازك الذي يعمل بنظام التشغيل Linux أو Windows، يمكنك ضبطها يدويًا من خلال ضبط السمة hidpi في ملف idea.properties كما هو موضّح في القسم تخصيص خصائص IDE. تجدر الإشارة إلى أنّ هذه الخاصية ليس لها أي تأثير في أجهزة 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" إلى الإصدار 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 لمزامنة مشروعك.

مشكلات في تحديث بيئة التطوير المتكاملة (IDE) في نظام التشغيل Windows

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

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