إعداد "استوديو Android"

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

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

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

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

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

يتم تخزين ملفّي الإعداد في دليل الإعدادات الخاص بتطبيق Android Studio. للعثور على دليل الإعدادات، يُرجى الاطّلاع على الأدلة.

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

  • STUDIO_VM_OPTIONS: ضبط اسم ملف .vmoptions وموقعه
  • STUDIO_PROPERTIES: ضبط اسم ملف .properties وموقعه

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

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

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

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

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

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

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

الحدّ الأقصى لحجم الذاكرة

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

يتحقق Android Studio تلقائيًا من أي تحسينات محتملة لعناصر التخزين ويُعلمك إذا اكتشف إمكانية تحسين الأداء.

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

الشكل 1: إشعار بشأن الإعدادات المُقترَحة للذاكرة

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

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

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

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

  3. عدِّل أحجام الحِزم.

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

    في حال تغيير حجم الحِزمة لبيئة تطوير البرامج (IDE)، يجب إعادة تشغيل Android Studio قبل تطبيق إعدادات الذاكرة الجديدة.

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

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

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

تخصيص سمات حزمة IDE

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

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

  1. انقر على المساعدة > تعديل السمات المخصّصة. إذا لم يسبق لك تعديل ملف IDE ، سيطلب منك Android Studio إنشاء ملف idea.properties جديد. انقر على Yes (نعم) لإنشاء الملف.
  2. يتم فتح ملف idea.properties في نافذة المحرِّر في Android Studio. عدِّل الملف لإضافة خصائص 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" على جهاز لا يتوافق مع المواصفات التي يُنصح بها (اطّلِع على متطلبات النظام)، يمكنك تخصيص بيئة التطوير المتكاملة (IDE) لتحسين الأداء على جهازك على النحو التالي:

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

    1. انقر على ملف > الإعدادات (على نظام التشغيل macOS، استوديو Android > الإعدادات المفضّلة) لفتح مربّع حوار الإعدادات.
    2. في اللوحة اليمنى، وسِّع قسم أداة التعديل وانقر على عمليات الفحص.
    3. انقر فوق مربعات الاختيار لتحديد أو إلغاء تحديد عمليات فحص Lint بشكل مناسب لمشروعك.
    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 Studio تجميع وحدات مستقلة بشكل موازٍ، ولكن يجب إبقاء هذه الميزة غير مفعّلة إذا كان لديك نظام ذو ذاكرة منخفضة. للتحقق من هذا الإعداد، قم بما يلي:

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

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

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

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

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

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

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

  1. من شريط القوائم، انقر على ملف > الإعدادات (على نظام التشغيل macOS، انقر على Android Studio > الإعدادات المفضّلة).
  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 Studio على نظام التشغيل Windows بمجموعة متنوّعة من العوامل. يوضّح هذا القسم كيفية تحسين إعدادات "استوديو Android" للحصول على أفضل أداء ممكن على نظام التشغيل Windows.

تقليل تأثير برامج مكافحة الفيروسات على سرعة إنشاء الإصدار

يمكن أن تتداخل بعض برامج مكافحة الفيروسات مع عملية الإصدار في "استوديو Android"، مما يؤدي إلى بطء عمليات التصميم بشكلٍ كبير. عند تشغيل عملية إنشاء في Android Studio، يُجمِّع Gradle موارد تطبيقك ورمز المصدر، ثم يُجمِّع الموارد المجمَّعة معًا في حزمة APK أو حزمة AAB. أثناء هذه العملية، يتم إنشاء العديد من الملفات على جهاز الكمبيوتر. إذا كان برنامج مكافحة الفيروسات مفعَّلاً فيه فحص في الوقت الفعلي، يمكن أن يفرض برنامج مكافحة الفيروسات إيقاف عملية الإنشاء في كل مرة يتم فيها إنشاء ملف أثناء فحص هذا الملف.

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

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

ذاكرة التخزين المؤقت لقاعدة 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 Studio إلى أحد المواقع التي تستبعدها سياسة المجموعة المركزية.

توضِّح القائمة التالية كيفية تخصيص موقع كل دليل في Android Studio، حيث يكون C:\WorkFolder هو الدليل الذي تم استبعاده من خلال "سياسة المجموعة":

ذاكرة التخزين المؤقت لقاعدة Gradle
حدِّد متغيّر البيئة GRADLE_USER_HOME للإشارة إلى C:\WorkFolder\.gradle.
مشاريع "استوديو Android"
انقل أدلة المشاريع أو أنشئها في دليل فرعي مناسب من C:\WorkFolder. على سبيل المثال، C:\WorkFolder\AndroidStudioProjects.
Android SDK

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

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

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

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

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

اتّبِع الخطوات التالية لتخصيص الموقع الجغرافي:

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

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

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

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