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

يتطلّب نقل مشاريعك إلى Android Studio التأقلم مع بنية مشاريع جديدة ونظام إنشاء ووظائف بيئة تطوير متكاملة.

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

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

في ما يلي بعض الاختلافات الرئيسية التي يجب أخذها في الاعتبار أثناء التحضير للقيام بعملية النقل إلى Android Studio.

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

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

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

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

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

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

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

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

لمزيد من المعلومات عن استخدام Gradle وضبطه، يُرجى الاطّلاع على مقالة ضبط عملية الإنشاء.

التبعيات

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

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

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

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

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

1. انقر على ملف > جديد > استيراد مشروع.
2. اختَر دليل مشروع IntelliJ وانقر على حسنًا. سيتم فتح مشروعك في "استوديو Android".

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

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

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

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

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

1. افتح Android Studio وانقر على ملف > جديد > مشروع جديد.
2. أدخِل اسمًا لمشروع تطبيقك وحدِّد الموقع الجغرافي الذي يجب إنشاء المشروع فيه، ثم انقر على التالي.
3. اختَر أشكال الأجهزة التي يعمل عليها تطبيقك، ثم انقر على التالي.
4. انقر على إضافة "ما مِن نشاط"، ثم انقر على إنهاء.
5. في نافذة أدوات المشروع، انقر على السهم لفتح قائمة العرض واختَر عرض المشروع للاطّلاع على ملف المشروعات واستكشافه في مشروعك الجديد على استوديو Android. لقراءة المزيد من المعلومات عن تغيير طرق العرض وكيفية تنظيم مشاريع Android Studio، اطّلِع على ملفات المشروع.
6. انتقِل إلى الموقع الذي اخترته لمشروعك الجديد وانقل الرمز البرمجي واختبارات الوحدات واختبارات الأدوات والموارد من أدلة مشروعك القديم إلى المواقع الصحيحة في بنية مشروعك الجديد.
7. في "استوديو Android"، انقر على ملف > بنية المشروع لفتح مربّع الحوار بنية المشروع. تأكَّد من اختيار وحدة تطبيقك في اللوحة اليمنى.
8. أدخِل أي تعديلات ضرورية في علامة التبويب السمات لمشروعك (على سبيل المثال، تعديل minSdk أو targetSdk).
9. انقر على التبعيات وأضِف أي مكتبات يعتمد عليها مشروعك كتبعيات Gradle. لإضافة تبعية جديدة، انقر على إضافة ، ثم اختَر نوع التبعية التي تريد إضافتها واتّبِع التعليمات.
10. انقر على حسنًا لحفظ التعديلات.
11. انقر على الإنشاء > إنشاء المشروع لاختبار إنشاء مشروعك، وحلّ أي أخطاء عالقة إذا لزم الأمر.

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

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

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

   بشكلٍ تلقائي، يتوقّع "استوديو Android" أن يكون مشروعك منظَّمًا على النحو الموضح في الشكل 1.

   

   الشكل 1. بنية المشروع التلقائية لمكوّن تطبيق Android

   في settings.gradle، لبرنامج Groovy، أو settings.gradle.kts، لبرنامج Kotlin script، يمكنك ضبط المستودعات التي يتم استخدامها للعثور على المكوّنات الإضافية والملحقات في كتل 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 وتخصيصه، يُرجى الاطّلاع على مقالة ضبط عملية الإنشاء.

3. بعد ذلك، حدِّد مشاريع المكتبات التي تستخدمها.

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

   رائع

   ...
   dependencies {
       implementation fileTree(dir: 'libs', include: ['*.jar'])
   
       // AndroidX libraries
       implementation 'androidx.core:core-ktx:1.15.0'
       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.9.1'
   
       // 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.15.0")
       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.9.1")
   
       // 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.
4. احفظ ملف build.gradle، ثم أغلِق المشروع في IDE IDE. انتقِل إلى دليل مشروعك واحذِف دليل .idea وأي ملفات IML في مشروعك.
5. افتح Android Studio وانقر على ملف > جديد > استيراد مشروع.
6. حدِّد موقع دليل المشروع، واختَر ملف build.gradle أو build.gradle.kts الذي أنشأته، ثم انقر على حسنًا لاستيراد مشروعك.
7. انقر على الإنشاء > إنشاء المشروع لاختبار ملف الإنشاء من خلال إنشاء مشروعك ومعالجة أي أخطاء تعثر عليها.

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

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

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

ضبط ميزة "التحكم في الإصدارات"

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

إذا كان تطبيقك خاضعًا حاليًا لإدارة مصدر المحتوى، قد تحتاج إلى تفعيل هذه الميزة في IDE Android Studio. من قائمة نظام التحكّم في الإصدارات (VCS)، انقر على تفعيل دمج نظام التحكّم في الإصدارات واختَر نظام التحكّم في الإصدارات المناسب.

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

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

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

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

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

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

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

ضبط الحد الأقصى لحجم الحِزمة في Android Studio

يكون الحد الأقصى لحجم الحِزمة في Android Studio هو 1280 ميغابايت تلقائيًا. إذا كنت مشغولاً بمشروع كبير أو كان نظامك يحتوي على ذاكرة وصول عشوائي كبيرة، يمكنك تحسين الأداء من خلال زيادة الحد الأقصى لحجم ملف heap.

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

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

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

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