تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

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 جديد أو لفتح ملفك الحالي، اتّبِع الخطوات التالية:

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

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

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

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

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

يتحقّق Android Studio تلقائيًا من التحسينات الممكنة لحجم الحِزمة ويُعلمك إذا رصد أنّه يمكن تحسين الأداء.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

إعداد الخادم الوكيل في Android Studio

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

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

إعدادات الخادم الوكيل HTTP في المكوّن الإضافي لنظام Gradle المتوافق مع Android

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

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

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

في Android Studio، افتح مربّع حوار الإعدادات (الإعدادات المفضّلة على MacOS)، ثم انتقِل إلى المظهر والسلوك > إعدادات النظام > IDE لنظام التشغيل Android.
غيِّر قيمة موقع حزمة تطوير البرامج (SDK) لنظام التشغيل Android إلى C:\WorkFolder\AndroidSDK.

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

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

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

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

سيطلب منك "استوديو Android" إنشاء ملف idea.properties إذا لم يكن لديك ملف مماثل.
أضِف السطر التالي إلى ملف idea.properties:
```
idea.system.path=c:/workfolder/studio/caches/trunk-system
```