تحتوي هذه الصفحة على إرشادات حول تحديد المشاكل الشائعة وحلّها ومشاكل الإعداد في "استوديو Android".
الشاشات العالية الكثافة
بدءًا من الإصدار 1.5، سيتوافق "استوديو Android" مع الشاشات العالية الكثافة (مثل شاشات HiDPI وRetina) على جميع الأنظمة الأساسية.
إعدادات عامل القياس
يحدّد "استوديو Android" عامل تغيير الحجم لشاشتك كما يلي:
- نظام التشغيل Mac
- بالنسبة إلى شاشات Retina، يتم ضبط حجم عناصر واجهة المستخدم بنسبة% 200 ويتم عرض الصور بدقة عالية. من المفترض ألا يحدث أي تمويه بسبب تغيير الحجم، حتى في إعدادات الشاشات المتعددة. ويُرجى العلم أنّه لا تتوفّر إمكانية استخدام عوامل تغيير الحجم بخلاف نسبة 100% (للشاشات التي ليست من نوع Retina) ونسبة %200 (للشاشات العادية من نوع Retina).
- أجهزة Windows
- يستخدم "استوديو Android" إعدادات النقاط لكل بوصة (DPI) في الشاشة الأساسية لتحديد عامل ضبط الحجم لعناصر واجهة المستخدم. بالنسبة إلى الصور، إذا كان عامل القياس أقل من %150، يتم تكبير الصور ذات الدقة العادية. إذا كان عامل القياس أكبر من 150%، يتم قياس حجم الصور العالية الدقة بشكل مناسب.
- نظام التشغيل Linux
- يحدّد "استوديو Android" عامل تغيير الحجم من خلال الاطّلاع على "عامل تغيير حجم النص" ثم إلى إعداد عدد النقاط لكل بوصة (DPI) لنظام XWindow.
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" على النحو التالي:
- افتح ملف "
gradle.properties
" في "استوديو Android". - أضِف السطر التالي إلى الملف:
org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true
يُرجى ملاحظة أنّه إذا سبق لك إضافة وسيطات Gradle JVM أخرى إلى ملفgradle.properties
، يمكنك إضافة هذه السمة إلى السطر نفسه كما هو موضّح في المثال التالي:org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -Djava.net.preferIPv4Stack=true
- أعِد تشغيل "استوديو Android" لتصبح التغييرات سارية.
- انقر على مزامنة المشروع مع ملفات 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
ويتم إدراج كل دليل بالتنسيق التالي:
<informal directory name>
(<IDE property>
):<default path>
.
استبدال:
AndroidStudio
يحمل اسم المنتج، وهوAndroidStudio
للإصدارات الثابتة، أوAndroidStudioPreview
للإصدارات التجريبية وإصدار Canary.VERSION
مع الإصدار على سبيل المثال:2023.1
أو2023.3
.