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

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

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

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

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

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

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

يمكنك استخدام متغيرات البيئة التالية للإشارة إلى أنواع تجاوز الملفات في مكان آخر:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  2. انقر على المظهر السلوك > إعدادات النظام > إعدادات الذاكرة

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

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

  3. تعديل أحجام لقطات لأجزاء من الذاكرة

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

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

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

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

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

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

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

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

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

  • إيقاف عمليات فحص Lint غير الضرورية: لتغيير عملية فحص Lint في Android يتم تشغيل "استوديو YouTube" على رمزك، اتّبِع الخطوات التالية:

    1. انقر على ملف > الإعدادات (على نظام التشغيل macOS واستوديو Android > الإعدادات المفضّلة) لفتح مربّع حوار الإعدادات.
    2. في اللوحة اليمنى، وسِّع قسم المحرِّر وانقر على. عمليات الفحص:
    3. انقر فوق مربعات الاختيار لتحديد أو إلغاء تحديد عمليات فحص Lint بشكل مناسب لمشروعك.
    4. انقر على تطبيق أو حسنًا لحفظ التغييرات.

  • تصحيح الأخطاء على جهاز فعلي: يمكنك تحسين الأداء العام "استوديو Android" من خلال تصحيح الأخطاء على جهاز فعلي. يستهلك تصحيح الأخطاء في المحاكي مساحة في الذاكرة أكبر من استخدام تصحيح الأخطاء على جهاز فعلي.

  • لا تتضمن سوى "خدمات Google Play" الضرورية كملحقات: يجب تضمين فقط خدمات Google Play اللازمة باعتبارها عناصر تبعية في مشروعك. زيادة التبعيات مقدار الذاكرة اللازم، لذا فإن الحد منه يحسن استخدام الذاكرة والأداء. لمزيد من المعلومات، يُرجى مراجعة توضيح الموارد التابعة لـ "خدمات Google Play"

  • تقليل الحد الأقصى لحجم الذاكرة المتاحة لنظام Gradle: يجب تقليل قيمة الحد الأقصى لحجم الذاكرة في Gradle هو 1536 ميغابايت افتراضيًا عن طريق تجاوز السمة 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":

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

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

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

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

تعرض القائمة التالية الموقع الجغرافي التلقائي لكل دليل على "استوديو Android" التي يمكنك استبعادها من عملية الفحص في الوقت الفعلي:

ذاكرة التخزين المؤقت لقاعدة 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

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

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

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

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

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

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

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

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

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

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