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

نقل البيانات إلى "استوديو Android"

يتطلب نقل مشاريعك إلى "استوديو Android" التكيف مع بنية مشروع جديدة ونظام تصميم ووظيفة بيئة تطوير متكاملة (IDE).

في حال نقل البيانات من IntelliJ وكان مشروعك يستخدم Gradle، يمكنك فتح مشروعك الحالي من "استوديو Android". إذا كنت تستخدم IntelliJ ولكن مشروعك لا يستخدم Gradle، عليك إعداد مشروعك يدويًا قبل استيراده إلى "استوديو Android". لمزيد من المعلومات، يُرجى الاطّلاع على قسم النقل من IntelliJ.

أساسيات "استوديو Android"

في ما يلي بعض الاختلافات الأساسية التي يجب أن تكون على دراية بها أثناء الاستعداد لنقل البيانات إلى "استوديو Android".

تنظيم المشاريع والوحدات

ويستند "استوديو Android" إلى بيئة تطوير متكاملة IntelliJ IDEA. للتعرّف على أساسيات بيئة التطوير المتكاملة (IDE)، مثل التنقّل وإكمال الرموز البرمجية واختصارات لوحة المفاتيح، اطّلِع على التعرّف على "استوديو Android".

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

لمزيد من المعلومات حول المشاريع والوحدات في "استوديو Android"، يُرجى الاطّلاع على مقالة نظرة عامة على المشاريع.

نظام تصميم مستنِد إلى Gradle

ويستند نظام التصميم في "استوديو Android" إلى Gradle ويستخدم ملفات إعداد إنشاء مكتوبة بنص برمجي Groovy أو Kotlin لسهولة قابلية التوسّع والتخصيص.

تقدم المشروعات القائمة على Gradle ميزات مهمة لتطوير Android، بما في ذلك ما يلي:

إتاحة المكتبات الثنائية (AAR). لم تعد بحاجة إلى نسخ مصادر المكتبة إلى مشاريعك الخاصة؛ يمكنك توضيح التبعية وسيتم تنزيل المكتبة ودمجها تلقائيًا في مشروعك. ويشمل ذلك الدمج التلقائي للموارد وإدخالات البيان وقواعد استبعاد Proguard وقواعد Lint المخصّصة وما إلى ذلك في وقت الإصدار.
دعم إنشاء الصيغ، التي تتيح لك إنشاء إصدارات مختلفة من تطبيقك (مثل الإصدار المجاني والإصدار الاحترافي) من المشروع نفسه.
إنشاء تصميم وتخصيص سهل. على سبيل المثال، يمكنك سحب أسماء الإصدارات ورموز الإصدارات من علامات Git كجزء من عملية التصميم.
يمكن استخدام Gradle من بيئة التطوير المتكاملة (IDE) ومن سطر الأوامر ومن خوادم الدمج المستمر مثل Jenkins، ما يتيح لنا تقديم الإصدار ذاته في كل مكان وفي كل مرة.

لمزيد من المعلومات عن استخدام أداة Gradle وإعدادها، راجِع ضبط الإصدار.

التبعيات

تستخدم تبعيات المكتبات في "استوديو Android" تعريفات تبعية Gradle وتبعيات Maven للمصادر المحلية المعروفة والمكتبات الثنائية مع إحداثيات Maven. لمزيد من المعلومات، يُرجى الاطّلاع على بيان التبعيات.

نقل البيانات من IntelliJ

إذا كان مشروعك من IntelliJ يستخدم نظام إصدار Gradle، يمكنك استيراد مشروعك مباشرةً إلى "استوديو Android". إذا كان مشروعك من IntelliJ يستخدم Maven أو نظام تصميم آخر، عليك إعداده للتوافق مع Gradle قبل أن تتمكّن من الانتقال إلى "استوديو Android".

استيراد مشروع IntelliJ يستند إلى Gradle

إذا كنت تستخدم Gradle مع مشروع IntelliJ، يمكنك فتحه في "استوديو Android" باتّباع الخطوات التالية:

انقر على ملف > جديد > استيراد مشروع.
اختَر دليل مشروع IntelliJ وانقر على OK (حسنًا). سيفتح مشروعك في Android Studio.

استيراد مشروع غير تابع لـ Gradle IntelliJ

إذا كان مشروع IntelliJ لا يستخدم حاليًا نظام إصدار Gradle، يكون لديك خياران لاستيراد مشروعك إلى Android Studio، كما هو موضحان في الأقسام التالية:

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

أنشِئ ملف إصدار Gradle جديدًا لمشروعك، ثم استورِد المشروع وملف الإصدار الجديد إلى "استوديو Android". ولمزيد من المعلومات، يمكنك الاطّلاع على القسم المتعلّق بالنقل عن طريق إنشاء ملف إصدار Gradle المخصّص.

نقل البيانات من خلال إنشاء مشروع جديد فارغ

لنقل مشروعك إلى "استوديو Android" من خلال إنشاء مشروع جديد فارغ ونسخ الملفات المصدر إلى الأدلة الجديدة، يمكنك اتّباع الخطوات التالية:

افتح "استوديو Android" وانقر على ملف > جديد > مشروع جديد.
أدخِل اسمًا لمشروع تطبيقك وحدِّد الموقع الجغرافي الذي من المفترض أن يتم إنشاؤه فيه، ثم انقر على التالي.
اختَر أشكال الأجهزة التي يعمل عليها تطبيقك، ثم انقر على التالي.
انقر على عدم إضافة أي نشاط، ثم على إنهاء.
في نافذة أداة المشروع، انقر على السهم لفتح قائمة العرض واختَر طريقة عرض المشروع للاطّلاع على تنظيم مشروعك الجديد على "استوديو Android" واستكشافه. لمزيد من المعلومات حول تغيير طرق العرض وكيفية تنظيم "استوديو Android" للمشاريع، يُرجى الاطّلاع على ملفات المشروع.
انتقل إلى الموقع الذي اخترته لمشروعك الجديد وانقل الرمز واختبارات الوحدات واختبارات الأدوات والموارد من أدلة المشروع القديم إلى المواقع الصحيحة في بنية المشروع الجديد.
في "استوديو Android"، انقر على ملف > بنية المشروع لفتح مربّع الحوار بنية المشروع. يُرجى التأكّد من اختيار وحدة تطبيقك في اللوحة اليمنى.
أجرِ أي تعديلات ضرورية في علامة التبويب الخصائص لمشروعك (مثل تعديل minSdk أو targetSdk).
انقر على التبعيات وأضِف أي مكتبات يعتمد عليها مشروعك باعتبارها تبعيات من Gradle. لإضافة تبعية جديدة، انقر على إضافة ، ثم اختَر نوع التبعية التي تريد إضافتها واتّبِع التعليمات.
انقر على حسنًا لحفظ التعديلات.
انقر على إنشاء > إنشاء مشروع لاختبار إنشاء مشروعك، وإذا لزم الأمر، حل أي أخطاء معلقة.

نقل البيانات من خلال إنشاء ملف إصدار Gradle مخصَّص

لنقل مشروعك إلى Android Studio من خلال إنشاء ملف إصدار Gradle جديد للإشارة إلى ملفات المصدر الحالية، يمكنك المتابعة على النحو التالي:

قبل البدء، عليك الاحتفاظ بنسخة احتياطية من ملفات مشروعك في موقع منفصل، لأنّ عملية نقل البيانات تؤدي إلى تعديل محتوى مشروعك الحالي.
أنشِئ ملفًا في دليل مشروعك باسم build.gradle، إذا كنت تستخدم Groovy، أو build.gradle.kts، إذا كنت تستخدم نص Kotlin البرمجي. ويحتوي هذا الملف على جميع المعلومات المطلوبة لكي تشغّل أداة Gradle التصميم الخاص بك.
تتوقّع أداة "استوديو Android" تلقائيًا تنظيم مشروعك على النحو الموضّح في الشكل 1.

الشكل 1. تمثّل هذه السمة بنية المشروع التلقائية لوحدة تطبيق Android.

في settings.gradle، بالنسبة إلى Groovy أو settings.gradle.kts للنص البرمجي بلغة Kotlin، يمكنك ضبط المستودعات المستخدمة للعثور على المكوّنات الإضافية والتبعيات في الوحدة pluginManagement وdependencyResolutionManagement على التوالي:
رائع
```
  pluginManagement {
      repositories {
          google()
          mavenCentral()
          gradlePluginPortal()
      }
  }
  dependencyResolutionManagement {
      repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
      repositories {
          google()
          mavenCentral()
      }
  }
  rootProject.name = "Test App"
  include ':app'
  
```
Kotlin
```
  pluginManagement {
      repositories {
          google()
          mavenCentral()
          gradlePluginPortal()
      }
  }
  dependencyResolutionManagement {
      repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
      repositories {
          google()
          mavenCentral()
      }
  }
  rootProject.name = "Test App"
  include(":app")
  
```
تحذير: أصبح مستودع JCenter للقراءة فقط في 31 آذار (مارس) 2021. لمزيد من المعلومات، يُرجى الاطّلاع على تحديث خدمة JCenter.

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

لمزيد من المعلومات عن إعداد ملف إصدار Gradle وتخصيصه، يُرجى الاطّلاع على ضبط الإصدار.

بعد ذلك، حدد مشروعات المكتبة التي تستخدمها.

باستخدام Gradle، لم تعد بحاجة إلى إضافة هذه المكتبات كمشروعات تعليمات برمجية المصدر. يمكنك بدلاً من ذلك الرجوع إليها في كتلة dependencies{} من ملف الإصدار. ويعالج نظام الإصدار هذه المكتبات نيابةً عنك، بما في ذلك تنزيل المكتبات ودمج الموارد ودمج إدخالات البيان. ويضيف المثال التالي عبارات التعريف لعدد من مكتبات AndroidX إلى كتلة dependencies{} من ملف إصدار.

رائع

...
dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])

    // AndroidX libraries
    implementation 'androidx.core:core-ktx:1.13.1'
    implementation 'androidx.appcompat:appcompat:1.7.0'
    implementation 'androidx.cardview:cardview:1.0.0'
    implementation 'com.google.android.material:material:1.7.0'
    implementation 'androidx.gridlayout:gridlayout:1.0.0'
    implementation 'androidx.leanback:leanback:1.1.0-rc02'
    implementation 'androidx.mediarouter:mediarouter:1.7.0'
    implementation 'androidx.palette:palette-ktx:1.0.0'
    implementation 'androidx.recyclerview:recyclerview:1.3.2'
    implementation 'androidx.annotation:annotation:1.8.0'

    // Note: these libraries require that the Google repository has been declared
    // in the pluginManagement section of the top-level build.gradle file.
}

Kotlin

...
dependencies {
    implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.jar"))))

    // AndroidX libraries
    implementation("androidx.core:core-ktx:1.13.1")
    implementation("androidx.appcompat:appcompat:1.7.0")
    implementation("androidx.cardview:cardview:1.0.0")
    implementation("com.google.android.material:material:1.7.0")
    implementation("androidx.gridlayout:gridlayout:1.0.0")
    implementation("androidx.leanback:leanback:1.1.0-rc02")
    implementation("androidx.mediarouter:mediarouter:1.7.0")
    implementation("androidx.palette:palette-ktx:1.0.0")
    implementation("androidx.recyclerview:recyclerview:1.3.2")
    implementation("androidx.annotation:annotation:1.8.0")

    // Note: these libraries require that the Google repository has been declared
    // in the pluginManagement section of the top-level build.gradle.kts file.
}

للمساعدة في تحديد عبارات التعريف الصحيحة لمكتباتك، ابحث في مستودع Google Maven أو Maven Central.

احفظ ملف build.gradle، ثم أغلِق المشروع في IntelliJ. انتقِل إلى دليل مشروعك واحذف دليل .idea وأي ملفات IML في مشروعك.
افتح "استوديو Android" وانقر على ملف > جديد > استيراد مشروع.
ابحث عن دليل مشروعك، واختَر الملف build.gradle أو build.gradle.kts الذي أنشأته، ثم انقر على حسنًا لاستيراد مشروعك.
انقر على إنشاء > إنشاء مشروع لاختبار ملف الإصدار من خلال إنشاء مشروعك ومعالجة أي أخطاء تكتشفها.

الخطوات التالية

بعد نقل مشروعك إلى Android Studio، تعرَّف على مزيد من المعلومات حول كيفية إنشاء تطبيق Gradle وتشغيله في Android Studio من خلال قراءة إنشاء تطبيقك وتشغيله.

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

تهيئة التحكم في الإصدار

يتوافق "استوديو Android" مع مجموعة متنوعة من أنظمة التحكم في الإصدارات، بما في ذلك Git وMercurial وSubversion. يمكن إضافة أنظمة التحكم في الإصدار الأخرى من خلال المكونات الإضافية.

إذا كان تطبيقك يخضع للتحكم في المصدر، قد تحتاج إلى تفعيله في "استوديو Android". من قائمة VCS، انقر على تفعيل تكامل التحكم في الإصدار وحدد نظام التحكم في الإصدار المناسب.

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

من قائمة Android Studio VCS، انقر على تفعيل دمج التحكم في الإصدار.
اختَر نظام التحكم في الإصدار لربطه بجذر المشروع من القائمة، ثم انقر على حسنًا. تعرض قائمة VCS الآن عددًا من خيارات التحكم في الإصدار بناءً على النظام الذي حددته.

ملاحظة: يمكنك أيضًا استخدام خيار القائمة ملف > الإعدادات > التحكم في الإصدار لإعداد عنصر التحكّم في الإصدار وتعديله.

لمزيد من المعلومات حول استخدام التحكّم في الإصدار، يُرجى الاطّلاع على مرجع التحكّم في الإصدارات من IntelliJ.

توقيع التطبيق

وفي حال استخدام شهادة تصحيح أخطاء في السابق، قد يتم رصدها أثناء عملية الاستيراد. وفي هذه الحالة، يستمر "استوديو Android" في الإشارة إلى تلك الشهادة. بخلاف ذلك، تستخدم إعدادات تصحيح الأخطاء ملف تخزين مفاتيح تصحيح الأخطاء الذي أنشأه "استوديو Android" باستخدام كلمة مرور معروفة ومفتاح تلقائي بكلمة مرور معروفة في $HOME/.android/debug.keystore. تم ضبط نوع إصدار تصحيح الأخطاء على استخدام إعدادات تصحيح الأخطاء هذه تلقائيًا عند تشغيل مشروعك أو تصحيح الأخطاء فيه من "استوديو Android".

وبالمثل، قد تكتشف عملية الاستيراد شهادة إصدار حالية. إذا لم يتم تحديد أي شهادة إصدار من قبل، يمكنك إضافة إعدادات توقيع الإصدار إلى ملف build.gradle أو build.gradle.kts أو استخدام خيار القائمة إنشاء > إنشاء حزمة APK موقَّعة لفتح معالجات إنشاء حِزمة APK الموقَّعة. لمزيد من المعلومات حول توقيع تطبيقك، يُرجى الاطّلاع على المقالة توقيع تطبيقك.

ضبط الحد الأقصى لحجم الذاكرة في "استوديو Android"

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

تحديثات البرامج

يتم تحديث "استوديو Android" بشكل منفصل عن مكوّن Gradle الإضافي وأدوات الإنشاء وأدوات حزمة تطوير البرامج (SDK). يمكنك تحديد الإصدارات التي تريد استخدامها مع "استوديو Android"

يوفّر "استوديو Android" تلقائيًا التحديثات التلقائية كلّما تم طرح إصدار جديد وثابت، ولكن يمكنك اختيار التحديث بوتيرة أكبر والحصول على إصدارات تجريبية أو إصدارات تجريبية.

لمزيد من المعلومات حول تحديث "استوديو Android" واستخدام إصدارات المعاينة والإصدارات التجريبية، يمكنك الاطّلاع على التحديثات.