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

إعداد Android Studio

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

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

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

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

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

يتم تخزين ملفَّي الإعداد في مجلد الضبط الخاص بـ "استوديو Android". يعتمد اسم المجلد على إصدار "استوديو Android" الذي تستخدمه.

بالنسبة إلى الإصدار 4.1 من "استوديو Android" والإصدارات الأحدث، تتوفّر ملفات الضبط في المواقع الجغرافية التالية:

نظام التشغيل Windows

البنية: %APPDATA%\Google\<product><version>

مثال: C:\Users\YourUserName\AppData\Roaming\Google\AndroidStudio4.1
نظام التشغيل macOS

البنية: ~/Library/Application Support/Google/<product><version>

مثال: ~/Library/Application Support/Google/AndroidStudio4.1
نظام التشغيل Linux

البنية: ~/.config/Google/<product><version>

مثال: ~/.config/Google/AndroidStudio4.1

بالنسبة إلى الإصدار 4.0 من "استوديو Android" والإصدارات الأقدم، تتوفّر ملفات الضبط في المواقع التالية:

نظام التشغيل Windows: %USERPROFILE%\.CONFIGURATION_FOLDER
نظام التشغيل macOS: ~/Library/Preferences/CONFIGURATION_FOLDER
نظام التشغيل Linux: ~/.CONFIGURATION_FOLDER

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تخصيص خصائص IDE

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

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

انقر على مساعدة > تعديل الخصائص المخصصة. إذا لم يسبق لك تعديل خصائص IDE، سيطلب منك "استوديو 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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