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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تصدير إعدادات بيئة التطوير المتكاملة (IDE) واستيرادها

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

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

تخصيص خصائص بيئة التطوير المتكاملة (IDE)

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

لإنشاء ملف 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

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

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

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

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

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

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

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

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

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

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

مكوّن 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

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

في "استوديو 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
```