يوفّر "استوديو Android" المعالجات والنماذج التي تعمل على التأكّد من صحة النظام. مثل مجموعة أدوات تطوير Java (JDK) وذاكرة الوصول العشوائي المتاحة ضبط الإعدادات التلقائية، مثل Android افتراضي محسّن ميزة محاكاة الجهاز (AVD) وصور النظام المعدّلة يصف هذا المستند إعدادات الضبط الإضافية لتخصيص استخدامك من نظام التشغيل Android استوديو YouTube.
يوفّر "استوديو Android" إمكانية الوصول إلى ملفَّي إعداد من خلال صفحة المساعدة القائمة:
studio.vmoptions
: تخصيص خيارات "استوديو Android" جهاز Java الافتراضي (JVM)، مثل حجم الذاكرة وحجم ذاكرة التخزين المؤقت. لاحظ أنه في قد تتم تسمية هذا الملف على الأجهزة التي تعمل بنظام التشغيل Linux باسمstudio64.vmoptions
، وذلك حسب من "استوديو Android"idea.properties
: تخصيص خصائص "استوديو Android"، مثل كمسار مجلد المكونات الإضافية أو الحد الأقصى لحجم الملف المتوافق.
للحصول على مستندات محددة حول المحاكي وإعداد الجهاز واستخدامه، راجع الموضوعات التالية:
- إنشاء الأجهزة الافتراضية وإدارتها
- تشغيل التطبيقات على جهاز
- تثبيت برامج تشغيل أجهزة USB التابعة للمصنّعين الأصليين
العثور على ملفات الإعداد
يتم تخزين ملفَّي الإعداد كليهما في دليل الإعدادات لنظام التشغيل Android. استوديو YouTube. للعثور على دليل الضبط، راجِع الأدلة:
يمكنك استخدام متغيرات البيئة التالية للإشارة إلى أنواع تجاوز الملفات في مكان آخر:
STUDIO_VM_OPTIONS
: ضبط اسم ملف.vmoptions
وموقعهSTUDIO_PROPERTIES
: ضبط اسم ملف.properties
وموقعه
يمكنك تحديد JDKs التي يتم استخدامها من خلال الانتقال إلى إصدارات Java في إصدارات Android:
تخصيص خيارات الجهاز الافتراضي
يتيح لك ملف studio.vmoptions
تخصيص خيارات "استوديو Android"
آلة متجه الدعم
لتحسين أداء "استوديو Android"، يكون الخيار الأكثر شيوعًا لتعديله هو
الحدّ الأقصى لحجم الذاكرة، ولكن يمكنك أيضًا استخدام الملف studio.vmoptions
لإلغاء
إعدادات تلقائية أخرى مثل حجم الذاكرة الأولية وحجم ذاكرة التخزين المؤقت والبيانات غير المرغوب فيها في Java
مفاتيح التبديل الخاصة بجمع البيانات.
لإنشاء ملف studio.vmoptions
جديد أو لفتح الملف الحالي، اتّبِع الخطوات التالية:
الخطوات التالية:
- انقر على مساعدة > تعديل الخيارات المخصّصة للأجهزة الافتراضية: في حال لم يسبق لك تعديل الجهاز الافتراضي
خيارات "استوديو Android" من قبل، يطلب منك IDE إنشاء إصدار
ملف
studio.vmoptions
. انقر على إنشاء لإنشاء الملف. - يتم فتح ملف
studio.vmoptions
في نافذة التعديل في "استوديو Android". عدِّل الملف لإضافة الخيارات المخصّصة للأجهزة الافتراضية. للحصول على قائمة كاملة خيارات JVM القابلة للتخصيص، راجع صفحة خيارات Java HotSpot VM من Oracle.
تتم إضافة ملف studio.vmoptions
الذي تنشئه إلى الملف التلقائي.
ملف studio.vmoptions
، موجود في دليل bin/
داخل جهاز Android
مجلد تثبيت "استوديو YouTube".
عدم إجراء تعديل مباشر على ملف "studio.vmoptions
" الذي تم العثور عليه
داخل مجلد برنامج Android Studio. بينما يمكنك الوصول إلى الملف إلى
الاطّلاع على الخيارات التلقائية للأجهزة الافتراضية في "استوديو Android" وتعديل جهازك فقط
يضمن ملف studio.vmoptions
عدم إلغاء الإعدادات التلقائية المهمة
الإعدادات الخاصة بـ "استوديو Android" لذلك، في ملف studio.vmoptions
،
إلغاء السمات التي تهمك فقط والسماح بمتابعة "استوديو Android"
باستخدام القيم الافتراضية لأي سمات لم يتم تغييرها.
الحدّ الأقصى لحجم الذاكرة
ويبلغ الحد الأقصى التلقائي لحجم الذاكرة في "استوديو Android" 1280 ميغابايت. إذا كنت تعمل في مشروع كبير، أو كان نظامك يحتوي على ذاكرة وصول عشوائي (RAM) كبيرة، فيمكنك تحسين الأداء من خلال زيادة الحد الأقصى لحجم الذاكرة في عمليات "استوديو Android"، مثل برنامج IDE أساسي، وخفي لـ Gradle الخفي، وبرنامج خفي Kotlin.
يتحقق Android Studio تلقائيًا من عمليات التحسين المحتملة المحتملة لأجزاء من الذاكرة إذا اكتشف إمكانية تحسين الأداء.
الشكل 1. إشعار حول إعدادات الذاكرة المقترَحة.
إذا كنت تستخدم نظامًا 64 بت وذاكرة وصول عشوائي (RAM) بسعة 5 غيغابايت على الأقل، يمكنك أيضًا تعديل لأحجام كومة الذاكرة المؤقتة لمشروعك يدويًا. ولإجراء ذلك، اتبع الخطوات التالية:
- انقر على ملف > الإعدادات من شريط القوائم (استوديو Android > الإعدادات المفضّلة على نظام التشغيل macOS)
انقر على المظهر السلوك > إعدادات النظام > إعدادات الذاكرة
الشكل 2. ضبط الحدّ الأقصى مقدار ذاكرة الوصول العشوائي (RAM) في "إعدادات الذاكرة".
تعديل أحجام لقطات لأجزاء من الذاكرة
انقر على تطبيق.
في حال تغيير حجم الذاكرة لحزمة IDE، يجب إعادة تشغيل "استوديو Android". قبل تطبيق إعدادات الذاكرة الجديدة.
تصدير إعدادات بيئة التطوير المتكاملة (IDE) واستيرادها
يمكنك تصدير ملف Settings.jar
يحتوي على كل أو مجموعة فرعية من
إعدادات IDE المفضل لمشروع ما. يمكنك بعد ذلك استيراد ملف JAR إلى
أخرى و/أو إتاحة ملف JAR لزملائك لاستيراده
في مشروعاتهم.
لمزيد من المعلومات، يُرجى مراجعة مشاركة إعدادات بيئة التطوير المتكاملة (IDE) في IntelliJ IDEA.
تخصيص خصائص بيئة التطوير المتكاملة (IDE)
يتيح لك ملف idea.properties
تخصيص خصائص IDE لنظام التشغيل Android.
الاستوديو، مثل المسار إلى المكوّنات الإضافية التي يثبتها المستخدم والحد الأقصى لحجم الملف
مدعومة من بيئة التطوير المتكاملة (IDE). تم دمج ملف idea.properties
مع الملف التلقائي.
لبيئة التطوير المتكاملة (IDE)، لذا يمكنك تحديد خصائص الإلغاء فقط.
لإنشاء ملف idea.properties
جديد أو لفتح الملف الحالي، اتّبِع الخطوات التالية:
الخطوات التالية:
- انقر على مساعدة > تعديل الخصائص المخصصة. إذا لم يسبق لك تعديل بيئة التطوير المتكاملة
المواقع في السابق، سيطلب منك "استوديو Android" إنشاء ملف
idea.properties
جديد الملف. انقر على Yes (نعم) لإنشاء الملف. - يتم فتح ملف
idea.properties
في نافذة التعديل في "استوديو Android". تعديل الملف لإضافة خصائص IDE المخصّصة
يتضمن ملف idea.properties
التالي بيئة تطوير متكاملة (IDE) مخصصة بشكل شائع
المواقع. للحصول على قائمة كاملة بالمواقع، يمكنك الاطّلاع على
ملف واحد (idea.properties
) لـ IntelliJ IDEA.
#---------------------------------------------------------------------
# Uncomment this option if you want to customize path to user installed plugins folder. Make sure
# you're using forward slashes.
#---------------------------------------------------------------------
# idea.plugins.path=${idea.config.path}/plugins
#---------------------------------------------------------------------
# Maximum file size (kilobytes) IDE should provide code assistance for.
# The larger the file is, the slower its editor works and higher overall system memory requirements are
# if code assistance is enabled. Remove this property or set to very large number if you need
# code assistance for any files available regardless their size.
#---------------------------------------------------------------------
idea.max.intellisense.filesize=2500
#---------------------------------------------------------------------
# This option controls console cyclic buffer: keeps the console output size not higher than the
# specified buffer size (Kb). Older lines are deleted. In order to disable cycle buffer use
# idea.cycle.buffer.size=disabled
#---------------------------------------------------------------------
idea.cycle.buffer.size=1024
#---------------------------------------------------------------------
# Configure if a special launcher should be used when running processes from within IDE.
# Using Launcher enables "soft exit" and "thread dump" features.
#---------------------------------------------------------------------
idea.no.launcher=false
#---------------------------------------------------------------------
# To avoid too long classpath
#---------------------------------------------------------------------
idea.dynamic.classpath=false
#---------------------------------------------------------------------
# There are two possible values of idea.popup.weight property: "heavy" and "medium".
# If you have WM configured as "Focus follows mouse with Auto Raise", then you have to
# set this property to "medium". It prevents problems with popup menus on some
# configurations.
#---------------------------------------------------------------------
idea.popup.weight=heavy
#---------------------------------------------------------------------
# Use default anti-aliasing in system, i.e. override value of
# "Settings|Editor|Appearance|Use anti-aliased font" option. May be useful when using Windows
# Remote Desktop Connection for instance.
#---------------------------------------------------------------------
idea.use.default.antialiasing.in.editor=false
#---------------------------------------------------------------------
# Disabling this property may lead to visual glitches like blinking and fail to repaint
# on certain display adapter cards.
#---------------------------------------------------------------------
sun.java2d.noddraw=true
#---------------------------------------------------------------------
# Removing this property may lead to editor performance degradation under Windows.
#---------------------------------------------------------------------
sun.java2d.d3d=false
#---------------------------------------------------------------------
# Workaround for slow scrolling in JDK6.
#---------------------------------------------------------------------
swing.bufferPerWindow=false
#---------------------------------------------------------------------
# Removing this property may lead to editor performance degradation under X Window.
#---------------------------------------------------------------------
sun.java2d.pmoffscreen=false
#---------------------------------------------------------------------
# Workaround to avoid long hangs while accessing clipboard under Mac OS X.
#---------------------------------------------------------------------
# ide.mac.useNativeClipboard=True
#---------------------------------------------------------------------
# Maximum size (kilobytes) IDEA will load for showing past file contents -
# in Show Diff or when calculating Digest Diff.
#---------------------------------------------------------------------
# idea.max.vcs.loaded.size.kb=20480
إعداد بيئة التطوير المتكاملة للأجهزة ذات الذاكرة المنخفضة
في حال تشغيل "استوديو Android" على جهاز يتضمّن سعرًا أقل من القيمة المقترَحة المواصفات (اطّلِع على متطلبات النظام) يمكنك تخصيص بيئة التطوير المتكاملة (IDE) لتحسين الأداء على جهازك على النحو التالي:
- تقليل الحد الأقصى لحجم الذاكرة المتاحة في "استوديو Android": الحدّ الأقصى لحجم الذاكرة في Android Studio إلى 512 ميغابايت. لمزيد من المعلومات حول تغيير الحدّ الأقصى لحجم الذاكرة، راجِع الحد الأقصى لحجم الذاكرة.
- تحديث Gradle والمكوّن الإضافي لنظام Gradle المتوافق مع Android: يُرجى التحديث إلى آخر إصدار. من Gradle والمكون الإضافي لنظام Gradle المتوافق مع Android لأخذ للاستفادة من آخر تحسينات الأداء. لمزيد من المعلومات حول تحديث Gradle والمكوّن الإضافي لنظام Gradle المتوافق مع Android، اطّلِع على ملاحظات إصدار المكوّن الإضافي لنظام Gradle المتوافق مع Android
- تفعيل وضع توفير الطاقة: يمكنك تفعيل "وضع توفير الطاقة" لإيقاف بعض العمليات التي تستهلك قدرًا كبيرًا من طاقة البطارية في الخلفية، بما في ذلك الأخطاء وتسليط الضوء على الفحوصات الفورية، وإكمال التعليمات البرمجية للنافذة المنبثقة التلقائي، التجميع التلقائي التزايدي للخلفية. لتفعيل "وضع توفير الطاقة"، عليك اتّباع الخطوات التالية: انقر على ملف > وضع توفير الطاقة
إيقاف عمليات فحص Lint غير الضرورية: لتغيير عملية فحص Lint في Android يتم تشغيل "استوديو YouTube" على رمزك، اتّبِع الخطوات التالية:
- انقر على ملف > الإعدادات (على نظام التشغيل macOS واستوديو Android > الإعدادات المفضّلة) لفتح مربّع حوار الإعدادات.
- في اللوحة اليمنى، وسِّع قسم المحرِّر وانقر على. عمليات الفحص:
- انقر فوق مربعات الاختيار لتحديد أو إلغاء تحديد عمليات فحص Lint بشكل مناسب لمشروعك.
- انقر على تطبيق أو حسنًا لحفظ التغييرات.
تصحيح الأخطاء على جهاز فعلي: يمكنك تحسين الأداء العام "استوديو Android" من خلال تصحيح الأخطاء على جهاز فعلي. يستهلك تصحيح الأخطاء في المحاكي مساحة في الذاكرة أكبر من استخدام تصحيح الأخطاء على جهاز فعلي.
لا تتضمن سوى "خدمات Google Play" الضرورية كملحقات: يجب تضمين فقط خدمات Google Play اللازمة باعتبارها عناصر تبعية في مشروعك. زيادة التبعيات مقدار الذاكرة اللازم، لذا فإن الحد منه يحسن استخدام الذاكرة والأداء. لمزيد من المعلومات، يُرجى مراجعة توضيح الموارد التابعة لـ "خدمات Google Play"
تقليل الحد الأقصى لحجم الذاكرة المتاحة لنظام Gradle: يجب تقليل قيمة الحد الأقصى لحجم الذاكرة في Gradle هو 1536 ميغابايت افتراضيًا عن طريق تجاوز السمة
org.gradle.jvmargs
في ملفgradle.properties
، كما هو موضّح:# Make sure to gradually decrease this value and note # changes in performance. Allocating too little memory can # also decrease performance. org.gradle.jvmargs = -Xmx1536m
التأكّد من عدم تفعيل تقنية التجميع الموازي: يمكن لـ "استوديو Android" تجميع وحدات مستقلة بالتوازي، ولكن يمكنك ترك هذه الميزة معطلة إذا كان لديك منخفض الذاكرة. للتحقق من هذا الإعداد، قم بما يلي:
- انقر على ملف > الإعدادات (على نظام التشغيل macOS واستوديو Android > الإعدادات المفضّلة) إلى افتح مربّع حوار الإعدادات.
- في الجزء الأيمن، وسِّع Build, Execution, Deployment (الإنشاء، التنفيذ، النشر) ثم انقر على Compliment:
- تأكَّد من أنّ خيار تجميع الوحدات المستقلة بالتوازي هو بدون علامة.
- إذا أجريت تغييرًا، انقر على تطبيق أو حسنًا لإدخال التغيير. تدخل حيز التنفيذ.
ضبط إعدادات الخادم الوكيل
تعمل الخوادم الوكيلة كنقاط اتصال وسيطة بين برامج HTTP والويب الخوادم التي تضيف الأمان والخصوصية لاتصالات الإنترنت.
لدعم تشغيل "استوديو Android" خلف جدار حماية، يمكنك استخدام "استوديو Android" صفحة إعدادات خادم وكيل HTTP في IDE لضبط إعدادات خادم وكيل HTTP.
عند تشغيل المكوّن الإضافي لنظام Gradle المتوافق مع Android من سطر الأوامر أو على الأجهزة إذا لم يكن "استوديو Android" مثبّتًا، مثل خوادم الدمج المستمر اضبط إعدادات الخادم الوكيل في ملف إصدار Gradle.
إعداد الخادم الوكيل لـ "استوديو Android"
يتوافق "استوديو Android" مع إعدادات خادم HTTP الوكيل، ما يتيح لك تشغيل "استوديو Android" في الخلفية. بجدار حماية أو شبكة آمنة. لضبط إعدادات خادم وكيل HTTP في "استوديو Android":
- من شريط القوائم، انقر على ملف > الإعدادات (على نظام التشغيل macOS، انقر على استوديو Android > الإعدادات المفضّلة).
- في الجزء الأيمن، انقر على المظهر السلوك > إعدادات النظام > بروتوكول HTTP الخادم الوكيل تظهر صفحة وكيل HTTP.
- اختَر اكتشاف إعدادات الخادم الوكيل تلقائيًا لاستخدام إعداد تلقائي للخادم الوكيل. عنوان URL لإعدادات الخادم الوكيل أو ضبط الخادم الوكيل يدويًا لإدخال كل من الإعدادات بنفسك. للحصول على شرح تفصيلي لهذه الإعدادات، يمكنك الاطّلاع على خادم وكيل HTTP.
- انقر على تطبيق أو حسنًا لتدخل التغييرات حيز التنفيذ.
مكوّن Android الإضافي لإعدادات الخادم الوكيل لـ Gradle HTTP
عند تشغيل مكوّن Android الإضافي من سطر الأوامر أو على أجهزة حيث لم يتم تثبيت "استوديو Android". يُرجى ضبط الخادم الوكيل للمكوّن الإضافي لنظام Gradle المتوافق مع Android الإعدادات في ملف إصدار Gradle.
بالنسبة إلى إعدادات خادم وكيل HTTP الخاصة بالتطبيقات، اضبط إعدادات الخادم الوكيل في
ملف build.gradle
على النحو المطلوب لكل وحدة تطبيق:
plugins {
id 'com.android.application'
}
android {
...
defaultConfig {
...
systemProp.http.proxyHost=proxy.company.com
systemProp.http.proxyPort=443
systemProp.http.proxyUser=userid
systemProp.http.proxyPassword=password
systemProp.http.auth.ntlm.domain=domain
}
...
}
بالنسبة إلى إعدادات خادم وكيل HTTP على مستوى المشروع، عيِّن إعدادات الخادم الوكيل في
ملف gradle/gradle.properties
:
# Project-wide Gradle settings.
...
systemProp.http.proxyHost=proxy.company.com
systemProp.http.proxyPort=443
systemProp.http.proxyUser=username
systemProp.http.proxyPassword=password
systemProp.http.auth.ntlm.domain=domain
systemProp.https.proxyHost=proxy.company.com
systemProp.https.proxyPort=443
systemProp.https.proxyUser=username
systemProp.https.proxyPassword=password
systemProp.https.auth.ntlm.domain=domain
...
للحصول على معلومات عن استخدام خصائص Gradle لإعدادات الخادم الوكيل، راجع دليل مستخدم Gradle.
تحسين أداء "استوديو Android" على أجهزة Windows
يمكن أن يتأثر أداء "استوديو Android" على نظام التشغيل Windows بمجموعة من العوامل. يوضّح هذا القسم كيفية تحسين إعدادات "استوديو Android" للحصول على بأفضل أداء ممكن على Windows.
تقليل تأثير برامج مكافحة الفيروسات على سرعة الإصدار
فبعض برامج مكافحة الفيروسات يمكن أن تتداخل مع عملية إصدار Android Studio، الأمر الذي يتسبب في تشغيل الإصدارات بشكل أبطأ بشكل كبير. عند تشغيل إصدار في Android ستجمع Gradle موارد التطبيق ورمز المصدر ثم حزمها الموارد التي تم تجميعها معًا في حزمة APK أو AAB. خلال هذه العملية، يستخدم العديد يتم إنشاؤها على جهاز الكمبيوتر. إذا كان برنامج مكافحة الفيروسات لديك يعمل في الوقت الفعلي تم تفعيل الفحص، يمكن لبرنامج مكافحة الفيروسات أن يفرض إيقاف عملية التصميم في كل مرة يتم فيها إنشاء ملف أثناء فحصه لهذا الملف.
ولتجنب هذه المشكلة، يمكنك استبعاد أدلة معينة من الوقت الفعلي فحصها في برنامج مكافحة الفيروسات. بالنسبة إلى Windows، يمكن أن تساعدك أداة تحليل الإصدار في تحديد الأدلة التي يجب استبعادها من الفحص النشط واستبعادها.
تعرض القائمة التالية الموقع الجغرافي التلقائي لكل دليل على "استوديو Android" التي يمكنك استبعادها من عملية الفحص في الوقت الفعلي:
- ذاكرة التخزين المؤقت لقاعدة Gradle
%USERPROFILE%\.gradle
- مشاريع "استوديو Android"
%USERPROFILE%\AndroidStudioProjects
- Android SDK
%USERPROFILE%\AppData\Local\Android\SDK
ملفات النظام في "استوديو Android"
البنية: %LOCALAPPDATA%\Google\<product><version>
مثال: C:\Users\YourUserName\AppData\Local\Google\AndroidStudio4.1
تخصيص مواقع الدليل للبيئات التي يتم التحكم فيها من خلال "سياسة المجموعة"
في حال كانت "سياسة المجموعة" تفرض قيودًا على الأدلة التي يمكنك استبعادها من الوقت الفعلي على جهاز الكمبيوتر، يمكنك نقل أدلة "استوديو Android" إلى أحد المواقع التي تستبعدها سياسة المجموعة المركزية.
تعرض القائمة التالية كيفية تخصيص الموقع الجغرافي لكل "استوديو Android".
الدليل، حيث C:\WorkFolder
هو الدليل الذي
تستبعد سياسة المجموعة بالفعل:
- ذاكرة التخزين المؤقت لقاعدة Gradle
- تحديد متغيّر البيئة
GRADLE_USER_HOME
للإشارة إليهC:\WorkFolder\.gradle
- مشاريع "استوديو Android"
- نقل أو إنشاء أدلة المشاريع في دليل فرعي مناسب من
C:\WorkFolder
على سبيل المثال:C:\WorkFolder\AndroidStudioProjects
- Android SDK
اتبع الخطوات التالية لتخصيص الموقع:
في "استوديو Android"، افتح مربّع الحوار الإعدادات (الإعدادات المفضّلة على macOS)، ثم انتقِل إلى المظهر السلوك > إعدادات النظام > حزمة تطوير البرامج (SDK) لنظام التشغيل Android
غيِّر قيمة موقع حزمة تطوير البرامج (SDK) لنظام التشغيل Android إلى
C:\WorkFolder\AndroidSDK
لتجنُّب تنزيل حزمة SDK مرة أخرى، يُرجى نسخ الحزمة الحالية الدليل الموجود في
%USERPROFILE%\AppData\Local\Android\SDK
تلقائيًا، إلى الموقع الجديد.
- ملفات النظام في "استوديو Android"
اتبع الخطوات التالية لتخصيص الموقع:
في "استوديو Android"، انقر على مساعدة > تعديل الخصائص المخصَّصة
يطلب منك "استوديو Android" إنشاء ملف
idea.properties
إذا لم تنشئ الملف. لديك بالفعل واحدة.أضِف السطر التالي إلى ملف
idea.properties
:idea.system.path=c:/workfolder/studio/caches/trunk-system