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

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

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

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

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

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

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

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

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

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

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

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

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

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

انقر على المساعدة > تعديل خيارات الأجهزة الافتراضية المخصّصة. في حال لم يسبق لك تعديل الجهاز الافتراضي خيارات "استوديو Android" من قبل، يطلب منك 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 تلقائيًا من التحسينات المحتملة لحجم الحِزمة ويُعلمك إذا رصد أنّه يمكن تحسين الأداء.

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

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

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

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

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

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

تصدير إعدادات بيئة التطوير المتكاملة (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

ضبط IDE للأجهزة ذات الذاكرة المنخفضة

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

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

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

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

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

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

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

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

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

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

عند تشغيل مكوّن 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 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" إلى أحد المواقع التي تستبعدها سياسة المجموعة المركزية.

تعرض القائمة التالية كيفية تخصيص الموقع الجغرافي لكل "استوديو Android". الدليل، حيث 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 مرة أخرى، يُرجى نسخ الحزمة الحالية الدليل الموجود في %USERPROFILE%\AppData\Local\Android\SDK تلقائيًا، إلى الموقع الجديد.

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

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

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

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