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

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

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

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

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

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

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

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

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

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

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

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

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

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

التبعيات

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

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

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

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

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

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

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

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

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

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

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

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

   

   في settings.gradle، بالنسبة إلى Groovy، أو settings.gradle.kts، بالنسبة إلى نص Kotlin البرمجي، يمكنك ضبط المستودعات المستخدَمة للعثور على المكوّنات الإضافية والملحقات في الكتلتَين pluginManagement وdependencyResolutionManagement على التوالي:

   Groovy

     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{} في ملف الإصدار.

   Groovy

   ...
   dependencies {
       implementation fileTree(dir: 'libs', include: ['*.jar'])
   
       // AndroidX libraries
       implementation 'androidx.core:core-ktx:1.16.0'
       implementation 'androidx.appcompat:appcompat:1.7.1'
       implementation 'androidx.cardview:cardview:1.0.0'
       implementation 'com.google.android.material:material:1.7.0'
       implementation 'androidx.gridlayout:gridlayout:1.1.0'
       implementation 'androidx.leanback:leanback:'
       implementation 'androidx.mediarouter:mediarouter:1.8.1'
       implementation 'androidx.palette:palette-ktx:1.0.0'
       implementation 'androidx.recyclerview:recyclerview:1.4.0'
       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.16.0")
       implementation("androidx.appcompat:appcompat:1.7.1")
       implementation("androidx.cardview:cardview:1.0.0")
       implementation("com.google.android.material:material:1.7.0")
       implementation("androidx.gridlayout:gridlayout:1.1.0")
       implementation("androidx.leanback:leanback:")
       implementation("androidx.mediarouter:mediarouter:1.8.1")
       implementation("androidx.palette:palette-ktx:1.0.0")
       implementation("androidx.recyclerview:recyclerview:1.4.0")
       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، ثم أغلق المشروع في IntelliJ. انتقِل إلى دليل مشروعك واحذف الدليل .idea وأي ملفات IML في مشروعك.
5. شغِّل Android Studio وانقر على ملف (File) > جديد (New) > استيراد مشروع (Import Project).
6. ابحث عن دليل مشروعك، واختَر الملف build.gradle أو build.gradle.kts الذي أنشأته، ثم انقر على موافق لاستيراد مشروعك.
7. انقر على إنشاء > إنشاء مشروع لاختبار ملف الإنشاء من خلال إنشاء مشروعك، ثم عالِج أي أخطاء تجدها.

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

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

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

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

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

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

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

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

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

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

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

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

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

تعديل الحد الأقصى لحجم الذاكرة المخصّصة في Android Studio

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

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

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

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

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