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

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

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

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

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

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

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

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

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

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

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

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

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

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

التبعيات

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

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

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

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

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

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

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

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

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

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

  1. افتح "استوديو Android" وانقر على ملف > جديد > مشروع جديد:
  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.

    الشكل 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 وتخصيصه، يُرجى الاطّلاع على مقالة ضبط عملية الإنشاء.

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

    باستخدام 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.2'
    
        // 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.2")
    
        // 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 المركزية.
  4. احفظ ملف build.gradle، ثم أغلِق المشروع في IntelliJ. انتقل إلى دليل المشروع واحذف دليل .idea وأي ملفات IML في مشروعك.
  5. شغِّل "استوديو Android" وانقر على ملف > جديد > استيراد المشروع:
  6. حدِّد موقع دليل المشروع، واختَر ملف build.gradle أو build.gradle.kts الذي أنشأته، ثم انقر على حسنًا لاستيراد مشروعك.
  7. انقر على إنشاء > إنشاء مشروع لاختبار ملف الإصدار من خلال وإنشاء مشروعك ومعالجة أي أخطاء تجدها.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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