إعداد Android Studio

ويوفّر Android Studio معالجات ونماذج تتحقّق من متطلبات النظام، مثل حزمة تطوير البرامج Java (JDK) وذاكرة الوصول العشوائي المتاحة، كما يتيح ضبط الإعدادات التلقائية، مثل محاكاة جهاز Android الافتراضي (AVD) تلقائيًا وصور النظام المعدَّلة. يوضّح هذا المستند إعدادات ضبط إضافية لتخصيص استخدامك لاستوديو Android.

يوفر Android Studio إمكانية الوصول إلى ملفي تهيئة من خلال قائمة المساعدة:

  • studio.vmoptions: يمكنك تخصيص خيارات جهاز Java الافتراضي (JVM) من "استوديو Android"، مثل حجم كومة الذاكرة المؤقتة وحجم ذاكرة التخزين المؤقت. يُرجى العِلم أنّه على الأجهزة التي تعمل بنظام التشغيل Linux، قد تتم تسمية هذا الملف باسم studio64.vmoptions بناءً على إصدار "استوديو Android".
  • idea.properties: يمكنك تخصيص خصائص "استوديو Android"، مثل مسار مجلد المكوّنات الإضافية أو الحد الأقصى لحجم الملف المسموح به.

للحصول على مستندات محدّدة حول إعداد المحاكي والجهاز واستخدامه، يُرجى الاطّلاع على المواضيع التالية:

العثور على ملفات الإعداد

يتم تخزين ملفَّي الإعداد في دليل الإعداد في "استوديو Android". للعثور على دليل الضبط، يُرجى الاطّلاع على الأدلة.

يمكنك استخدام متغيرات البيئة التالية للإشارة إلى ملفات تجاوز محددة في مكان آخر:

  • STUDIO_VM_OPTIONS: حدِّد اسم ملف .vmoptions وموقعه.
  • STUDIO_PROPERTIES: حدِّد اسم ملف .properties وموقعه.

يمكنك تحديد ملفات JDK التي يتم استخدامها من خلال الانتقال إلى إصدارات Java في إصدارات Android.

تخصيص خيارات الجهاز الافتراضي

يتيح لك ملف studio.vmoptions تخصيص خيارات ملف JVM في "استوديو Android". ولتحسين أداء "استوديو Android"، يُعد الخيار الأكثر شيوعًا لتعديله هو الحدّ الأقصى لحجم الحِزمة، ولكن يمكنك أيضًا استخدام ملف studio.vmoptions لتجاوز الإعدادات التلقائية الأخرى، مثل حجم الكومة المبدئية الأولية وحجم ذاكرة التخزين المؤقت ومفاتيح التبديل لمجموعة البيانات المهملة في Java.

لإنشاء ملف studio.vmoptions جديد أو فتح الملف الحالي، اتّبِع الخطوات التالية:

  1. انقر على مساعدة > تعديل خيارات الجهاز الافتراضي المخصَّصة. إذا لم يسبق لك تعديل خيارات الأجهزة الافتراضية في "استوديو Android"، سيطلب منك بيئة التطوير المتكاملة إنشاء ملف studio.vmoptions جديد. انقر على إنشاء لإنشاء الملف.
  2. يتم فتح ملف studio.vmoptions في نافذة تعديل "استوديو Android". عدِّل الملف لإضافة خيارات جهازك الافتراضي المخصَّصة. للحصول على قائمة كاملة بخيارات JVM المخصصة، راجع صفحة خيارات Java HotSpot VM من Oracle.

تتم إضافة ملف studio.vmoptions الذي تنشئه إلى ملف studio.vmoptions التلقائي المتوفّر في دليل bin/ داخل مجلد التثبيت في "استوديو Android".

لا تعدِّل ملف studio.vmoptions الموجود داخل مجلد برنامج "استوديو Android" مباشرةً. ومع أنّه يمكنك الوصول إلى الملف للاطّلاع على الخيارات التلقائية للأجهزة الافتراضية في "استوديو Android"، إلّا أنّ تعديل ملف studio.vmoptions الخاص بك فقط يضمن عدم إلغاء الإعدادات التلقائية المهمة في "استوديو Android". لذلك، في ملف studio.vmoptions، يمكنك إلغاء السمات التي تهمك فقط والسماح لـ "استوديو Android" بمواصلة استخدام القيم التلقائية لأي سمات لم تغيّرها.

الحد الأقصى لحجم الصورة المجمّعة

وفقًا للإعدادات التلقائية، يبلغ حجم كومة الذاكرة المؤقتة في "استوديو Android" 1280 ميغابايت كحدّ أقصى. إذا كنت تعمل في مشروع كبير، أو إذا كان نظامك يحتوي على ذاكرة وصول عشوائي (RAM) كثيرة، يمكنك تحسين الأداء من خلال زيادة الحد الأقصى لحجم الخانة المخصصة لعمليات استوديو Android، مثل بيئة التطوير الأساسية (IDE) وبرنامج Gradle الخفي وبرنامج Kotlin الخفي.

يتحقّق "استوديو Android" تلقائيًا من تحسينات محتملة لحجم الذاكرة ويرسل إليك إشعارًا في حال رصد إمكانية تحسين الأداء.

إعدادات الذاكرة التي تسمح لك بضبط الحد الأقصى من ذاكرة الوصول العشوائي لعمليات "استوديو Android"

الشكل 1. إشعار حول إعدادات الذاكرة المقترَحة

إذا كنت تستخدم نظامًا 64 بت يحتوي على ذاكرة وصول عشوائي (RAM) بسعة 5 غيغابايت على الأقل، فيمكنك أيضًا ضبط أحجام كومة الذاكرة المؤقتة لمشروعك يدويًا. لإجراء ذلك، يُرجى اتباع الخطوات التالية:

  1. انقر على ملف > الإعدادات من شريط القوائم (استوديو Android > الإعدادات المفضّلة على نظام التشغيل macOS).
  2. انقر على المظهر والسلوك > إعدادات النظام > إعدادات الذاكرة.

    إعدادات الذاكرة التي تسمح لك بضبط الحد الأقصى من ذاكرة الوصول العشوائي لعمليات "استوديو Android"

    الشكل 2. يمكنك ضبط الحدّ الأقصى لذاكرة الوصول العشوائي في "إعدادات الذاكرة".

  3. ضبط أحجام كومة الذاكرة المؤقتة

  4. انقر على تطبيق.

    في حال تغيير حجم كومة الذاكرة المؤقتة لبيئة التطوير المتكاملة، يجب إعادة تشغيل "استوديو Android" قبل تطبيق إعدادات الذاكرة الجديدة.

تصدير إعدادات IDE واستيرادها

يمكنك تصدير ملف Settings.jar يحتوي على كل إعدادات IDE المفضّلة لديك أو مجموعة فرعية منها، وذلك لمشروع. يمكنك بعد ذلك استيراد ملف JAR إلى مشاريعك الأخرى و/أو إتاحة ملف JAR لزملائك للاستيراد إلى مشاريعهم.

لمزيد من المعلومات، راجع مشاركة إعدادات IDE في IntelliJ IDEA.

تخصيص خصائص IDE الخاصة بك

يتيح لك الملف idea.properties تخصيص خصائص بيئة تطوير البرامج (IDE) لـ Android Studio، مثل مسار المكوّنات الإضافية التي يثبّتها المستخدم والحد الأقصى لحجم الملف الذي يتوافق مع بيئة التطوير المتكاملة (IDE). يتم دمج الملف idea.properties مع الخصائص التلقائية لبيئة التطوير المتكاملة، لكي تتمكّن من تحديد خصائص الإلغاء فقط.

لإنشاء ملف idea.properties جديد أو فتح الملف الحالي، اتّبِع الخطوات التالية:

  1. انقر على مساعدة > تعديل الخصائص المخصصة. إذا لم يسبق لك تعديل خصائص IDE، سيطلب منك "استوديو Android" إنشاء ملف idea.properties جديد. انقر على نعم لإنشاء الملف.
  2. يتم فتح ملف 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

ضبط بيئة التطوير المتكاملة (IDE) للأجهزة ذات الذاكرة المنخفضة

إذا كنت تستخدم "استوديو Android" على جهاز يتضمّن أقل من المواصفات الموصى بها (راجِع متطلبات النظام)، يمكنك تخصيص بيئة التطوير المتكاملة لتحسين الأداء على جهازك كما يلي:

  • تقليل الحد الأقصى لحجم كومة الذاكرة المؤقتة المتاح لـ "استوديو Android": احرص على خفض الحد الأقصى لحجم لقطة الشاشة الرئيسية في "استوديو Android" إلى 512 ميغابايت. لمزيد من المعلومات حول تغيير الحد الأقصى لحجم الذاكرة، راجِع الحد الأقصى لحجم الصورة المصغّرة.
  • تحديث Gradle والمكوّن الإضافي لنظام Gradle المتوافق مع Android: يمكنك التحديث إلى أحدث إصدارات Gradle والمكوّن الإضافي Android Gradle للاستفادة من آخر تحسينات الأداء. لمعرفة مزيد من المعلومات حول تحديث Gradle ومكوّن Gradle الإضافي Android، يمكنك الاطّلاع على ملاحظات إصدار المكوّن الإضافي لنظام Gradle المتوافق مع Android.
  • تفعيل وضع "توفير الطاقة": يمكنك تفعيل "وضع توفير الطاقة" لإيقاف عدد من العمليات التي تستهلك قدرًا كبيرًا من الذاكرة والبطارية في الخلفية، بما في ذلك تمييز الأخطاء وعمليات الفحص السريع وإكمال الرموز البرمجية المنبثقة تلقائيًا والتجميع التدريجي التلقائي للخلفيات. لتشغيل وضع توفير الطاقة، انقر على ملف > وضع توفير الطاقة.
  • إيقاف عمليات التحقّق من الوبر غير الضرورية: لتغيير أداة التحقق من الوبر التي يستخدمها "استوديو Android" على الرمز البرمجي، اتّبِع الخطوات التالية:

    1. انقر على ملف > الإعدادات (على نظام التشغيل macOS، واستوديو Android > التفضيلات) لفتح مربع حوار الإعدادات.
    2. في اللوحة اليمنى، وسِّع قسم محرِّر وانقر على عمليات الفحص.
    3. انقر فوق مربعات الاختيار لتحديد أو إلغاء تحديد عمليات التحقق من الوبر كما هو مناسب لمشروعك.
    4. انقر على تطبيق أو حسنًا لحفظ التغييرات.
  • تصحيح الأخطاء على جهاز فعلي: يمكنك تحسين الأداء العام لـ "استوديو Android" من خلال تصحيح الأخطاء على جهاز فعلي. يستهلك تصحيح الأخطاء على المحاكي ذاكرة أكبر من تصحيح الأخطاء على جهاز فعلي.

  • تضمين "خدمات Google Play" الضرورية فقط كملحقات: لا تضمِّن "خدمات Google Play" اللازمة إلا كملحقات في مشروعك. تزيد التبعيات من مقدار الذاكرة اللازمة، لذا فإن الحد منها يحسن استخدام الذاكرة وأدائها. لمزيد من المعلومات، يُرجى الاطّلاع على الإفصاح عن تبعيات "خدمات Google Play".

  • تقليل الحد الأقصى المسموح به لكومة الذاكرة المؤقتة في Gradle: قلِّل قيمة الحد الأقصى المسموح به لكومة الذاكرة في Gradle عن القيمة التلقائية التي تبلغ 1,536 ميغابايت، وذلك من خلال تجاوز السمة 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 أن يجمّع وحدات مستقلة بشكل متوازٍ، ولكن بدون تفعيل هذه الميزة إذا كان لديك نظام ذاكرة منخفض. للتحقق من هذا الإعداد، قم بما يلي:

    1. انقر على ملف > الإعدادات (على نظام التشغيل macOS واستوديو Android > الإعدادات المفضّلة) لفتح مربّع حوار الإعدادات.
    2. في اللوحة اليمنى، وسِّع إنشاء، والتنفيذ، والنشر، ثم انقر على برنامج التحويل البرمجي.
    3. تأكّد من عدم وضع علامة في المربّع بجانب خيار تجميع الوحدات المستقلة بالتوازي.
    4. إذا أجريت تغييرًا، انقر على تطبيق أو حسنًا حتى يتم تطبيق التغيير.

ضبط إعدادات الخادم الوكيل

تعمل الأجهزة الوكيلة كنقاط اتصال وسيطة بين عملاء HTTP وخوادم الويب، والتي تضيف الأمان والخصوصية إلى اتصالات الإنترنت.

لإتاحة تشغيل "استوديو Android" مع جدار حماية، استخدِم صفحة إعدادات خادم HTTP IDE في "استوديو Android" لضبط إعدادات الخادم الوكيل HTTP.

عند تشغيل مكوّن Android Gradle الإضافي من سطر الأوامر أو على الأجهزة التي لم يتم تثبيت "استوديو Android" عليها، مثل خوادم التكامل المستمر، يمكنك ضبط إعدادات الخادم الوكيل في ملف إصدار Gradle.

إعداد الخادم الوكيل لاستوديو Android

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

  1. من شريط القوائم، انقر على ملف > الإعدادات (في نظام التشغيل macOS، انقر على استوديو Android > الإعدادات المفضّلة).
  2. في اللوحة اليمنى، انقر على المظهر والسلوك > إعدادات النظام > خادم وكيل HTTP. ستظهر صفحة خادم وكيل HTTP.
  3. حدد اكتشاف إعدادات الخادم الوكيل تلقائيًا لاستخدام عنوان URL لتهيئة الخادم الوكيل تلقائيًا أو تهيئة الخادم الوكيل يدويًا لإدخال كل إعداد من الإعدادات بنفسك. للحصول على شرح تفصيلي لهذه الإعدادات، يُرجى الاطلاع على خادم وكيل HTTP.
  4. انقر على تطبيق أو حسنًا كي تدخل التغييرات حيز التنفيذ.

مكوّن 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، متسببًا في تشغيل الإصدارات بشكل أبطأ إلى حد كبير. عند تشغيل إصدار في "استوديو Android"، تجمع Gradle موارد التطبيق والرمز المصدر ثم تجمع الموارد التي تم تجميعها معًا في حزمة APK أو تنسيق AAB. أثناء هذه العملية، يتم إنشاء العديد من الملفات على جهاز الكمبيوتر. إذا فعَّل برنامج مكافحة الفيروسات الفحص في الوقت الفعلي، قد يفرض برنامج مكافحة الفيروسات إيقاف عملية التصميم في كل مرة يتم فيها إنشاء ملف أثناء فحص هذا الملف.

لتجنب هذه المشكلة، يمكنك استبعاد بعض الدلائل من الفحص في الوقت الفعلي في برنامج مكافحة الفيروسات. بالنسبة إلى نظام التشغيل Windows، يمكن أن تساعدك أداة تحليل الإنشاء في تحديد الدلائل التي يجب استبعادها من الفحص النشط واستبعادها.

تعرض القائمة التالية الموقع التلقائي لكل دليل من دليل "استوديو Android" والذي يمكنك استبعاده من الفحص في الوقت الفعلي:

ذاكرة التخزين المؤقت على Gradle
%USERPROFILE%\.gradle
مشاريع "استوديو Android"
%USERPROFILE%\AndroidStudioProjects
حزمة تطوير البرامج (SDK) لنظام التشغيل Android
%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.
حزمة تطوير البرامج (SDK) لنظام التشغيل Android

اتبع الخطوات التالية لتخصيص الموقع:

  1. في "استوديو Android"، افتح مربّع حوار الإعدادات (الإعدادات المفضّلة على نظام التشغيل macOS)، ثم انتقِل إلى المظهر والسلوك > إعدادات النظام > حزمة تطوير البرامج (SDK) لنظام التشغيل Android.

  2. غيِّر قيمة الموقع الجغرافي لحزمة تطوير البرامج (SDK) لنظام التشغيل Android إلى C:\WorkFolder\AndroidSDK.

    لتجنُّب تنزيل حزمة SDK مرة أخرى، انسخ دليل SDK الحالي، المتوفّر على %USERPROFILE%\AppData\Local\Android\SDK تلقائيًا، إلى المكان الجديد.

ملفات نظام "استوديو Android"

اتبع الخطوات التالية لتخصيص الموقع:

  1. في "استوديو Android"، انقر على مساعدة > تعديل الخصائص المخصّصة.

    تطلب منك "استوديو Android" إنشاء ملف idea.properties إذا لم يكن لديك ملف حالي.

  2. أضِف السطر التالي إلى ملف idea.properties:

    idea.system.path=c:/workfolder/studio/caches/trunk-system