يتطلب نقل مشاريعك إلى "استوديو Android" التكيف مع مشروع جديد البنية ونظام التصميم ووظائف بيئة التطوير المتكاملة (IDE).
إذا كنت بصدد نقل البيانات من IntelliJ وكان مشروعك يستخدم Gradle، يمكنك فتح مشروعك الحالي من "استوديو Android" في حال استخدام IntelliJ ولكن مشروعك لا يستخدم Gradle بالفعل، فأنت بحاجة إلى إعداد مشروعك يدويًا قبل استيراده إلى Android استوديو YouTube. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة نقل البيانات من IntelliJ. .
أساسيات "استوديو Android"
فيما يلي بعض الاختلافات الرئيسية التي يجب أن تكون على دراية بها أثناء الاستعداد الانتقال إلى "استوديو Android"
تنظيم المشاريع والوحدات
يستند Android Studio إلى IntelliJ بيئة تطوير متكاملة (IDEA) للتعرف على بأساسيات IDE، مثل التنقل وإكمال التعليمات البرمجية ولوحة المفاتيح يمكنك الاطّلاع على استوديو Android Meet.
يعمل "استوديو 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 Studio. إذا كان مشروع IntelliJ يستخدم Maven أو أي نظام تصميم آخر، يجب إعداده ليعمل مع Gradle قبل أن تتمكّن من الانتقال إلى "استوديو Android"
استيراد مشروع IntelliJ يستند إلى Gradle
إذا كنت تستخدم Gradle مع مشروع IntelliJ بالفعل، فافتحه في "استوديو Android" باتّباع الخطوات التالية:
- انقر على ملف > جديد > استيراد المشروع:
- اختَر دليل مشروع IntelliJ وانقر على OK (حسنًا). سيتم فتح مشروعك في "استوديو Android"
استيراد مشروع غير تابع لـ Gradle IntelliJ
إذا كان مشروع IntelliJ الخاص بك لا يستخدم نظام إصدار Gradle بالفعل، فيجب عليك وهما خياران لاستيراد مشروعك إلى "استوديو Android" الموضحَين في الأقسام التالية:
- أنشِئ مشروعًا جديدًا فارغًا على "استوديو Android" وانسخ المصدر الحالي. التعليمات البرمجية في الأدلة المرتبطة بالمشروع الجديد. لمزيد من المعلومات، راجع القسم حول النقل عن طريق إنشاء مساحة جديدة فارغة مشروعك.
- أنشئ ملف إصدار Gradle جديدًا لمشروعك ثم قم باستيراده المشروع وملف الإصدار الجديد في "استوديو Android". لمزيد من المعلومات، يُرجى مراجعة القسم الخاص بالنقل عن طريق إنشاء ملف إصدار Gradle المخصّص
نقل البيانات من خلال إنشاء مشروع جديد فارغ
لنقل مشروعك إلى "استوديو Android"، عليك إنشاء مشروع جديد فارغ نسخ ملفات المصدر إلى الأدلة الجديدة، اتّبِع الخطوات التالية:
- افتح "استوديو Android" وانقر على ملف > جديد > مشروع جديد:
- أدخِل اسمًا لمشروع تطبيقك وحدِّد الموقع الجغرافي الذي سيظهر فيه. ثم انقر على التالي.
- اختَر أشكال الأجهزة التي يعمل عليها تطبيقك، ثم انقر على التالي.
- انقر على عدم إضافة أي نشاط، ثم على إنهاء.
- في نافذة أداة المشروع، انقر على السهم لفتح العرض. القائمة واختر طريقة عرض المشروع لرؤية واستكشاف لتنظيم مشروعك الجديد على "استوديو Android" لقراءة المزيد حول تغيير الملفات الشخصية وطريقة إنشاء "استوديو Android" للمشاريع، راجِع ملفات المشروع.
- انتقِل إلى الموقع الجغرافي الذي اختَرته لمشروعك الجديد وانقل التعليمات البرمجية واختبارات الوحدة واختبارات الأدوات والموارد من مشروعك القديم الدلائل في المواقع الصحيحة في هيكل مشروعك الجديد.
- في "استوديو Android"، انقر على ملف > بنية المشروع لفتح مربع حوار بنية المشروع. يُرجى التأكّد من اختيار وحدة تطبيقك في الجزء الأيمن.
- عليك إجراء أي تعديلات ضرورية في علامة التبويب الخصائص
(على سبيل المثال، تعديل
minSdk
أوtargetSdk
). - النقر على التبعيات وإضافة أي مكتبات يعتمد عليها مشروعك
كتبعيات Gradle. لإضافة تبعية جديدة، انقر على إضافة
، ثم وحدد نوع التبعية التي ترغب في إضافتها واتبع المطالبات.
- انقر على حسنًا لحفظ التعديلات.
- انقر على إنشاء > إنشاء "مشروع" لاختبار إنشاء مشروعك إذا لزم الأمر، قم بحل أي أخطاء معلقة.
نقل البيانات من خلال إنشاء ملف إصدار Gradle مخصَّص
لنقل مشروعك إلى "استوديو Android"، عليك إنشاء ملف إصدار جديد من Gradle للإشارة إلى ملفات المصدر الحالية، اتّبِع الخطوات التالية:
- قبل البدء، احتفظ بنسخة احتياطية من ملفات مشروعك في ملف منفصل الموقع، حيث تعدل عملية الترحيل محتويات مشروعك في الْمَكَانْ.
- أنشئ ملفًا في دليل مشروعك يسمى
build.gradle
، في حال استخدام تطبيق Groovybuild.gradle.kts
، إذا كنت تستخدم نص Kotlin. هذا الملف يحتوي على جميع المعلومات المطلوبة حتى يتمكن Gradle من تشغيل التصميم الخاص بك.وفقًا للإعدادات التلقائية، يتم تنظيم مشروعك في "استوديو Android" وفقًا لما يلي: كما هو موضح في الشكل 1.
الشكل 1. هيكل المشروع الافتراضي لنظام Android التطبيق. في
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، اطلع على اضبط الإصدار.
بعد ذلك، حدد مشروعات المكتبة التي تستخدمها.
باستخدام Gradle، لا يمكنك بحاجة إلى إضافة هذه المكتبات كمشاريع رمز مصدر. يمكنك بدلاً من ذلك عليك الرجوع إليهم في الجزء
dependencies{}
من ملف الإصدار. تشير رسالة الأشكال البيانية نظام الإصدار ثم يعالج هذه المكتبات نيابةً عنك، بما فيها تنزيل ودمج الموارد ودمج إدخالات البيان. ما يلي: سبيل المثال، عبارات التعريف لعدد من مكتبات AndroidX إلى كتلةdependencies{}
لملف الإصدار.Groovy
... 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. }
- احفظ ملف
build.gradle
، ثم أغلِق المشروع في IntelliJ. انتقل إلى دليل المشروع واحذف دليل.idea
وأي ملفات IML في مشروعك. - شغِّل "استوديو Android" وانقر على ملف > جديد > استيراد المشروع:
- حدِّد مكان دليل مشروعك، واختَر
build.gradle
أو أنشأتِ ملفًا واحدًا (build.gradle.kts
)، ثم انقر على حسنًا لاستيراد مشروعك. - انقر على إنشاء > إنشاء مشروع لاختبار ملف الإصدار من خلال وإنشاء مشروعك ومعالجة أي أخطاء تجدها.
الخطوات التالية
وبعد نقل مشروعك إلى "استوديو Android"، يمكنك الاطّلاع على مزيد من المعلومات حول إنشاء باستخدام Gradle وتشغيل تطبيقك في "استوديو Android" من خلال القراءة إنشاء تطبيقك وتشغيله:
اعتمادًا على مشروعك وسير العمل، قد ترغب أيضًا في معرفة المزيد عن التحكم في الإصدار وإدارة التبعيات وتهيئة Android Studio. للحصول على وبدأت في استخدام "استوديو Android"، قراءة تعرّف على "استوديو Android".
تهيئة التحكم في الإصدار
يتوافق Android Studio مع مجموعة متنوعة من أنظمة التحكم في الإصدارات، بما في ذلك Git وMercurial وSubversion. يمكن إضافة أنظمة التحكم في الإصدار الأخرى من خلال المكونات الإضافية.
إذا كان تطبيقك يخضع للتحكم في المصدر من قبل، قد تحتاج إلى تفعيله في "استوديو Android". من قائمة VCS، انقر على Enable Version Control Integration (تفعيل تكامل التحكم في الإصدار). وحدد نظام التحكم في الإصدار المناسب.
إذا لم يكن تطبيقك خاضعًا للتحكّم في المصدر، يمكنك ضبطه بعد استيراده. تطبيقك إلى "استوديو Android" يمكنك استخدام خيارات قائمة VCS في "استوديو Android" لتفعيل هذه الميزة. دعم VCS لنظام التحكم في الإصدار المطلوب، وإنشاء مستودع، واستيراد الملفات الجديدة إلى التحكم في الإصدار، وتنفيذ عناصر تحكم أخرى في الإصدار العمليات:
- من قائمة Android Studio VCS، انقر على تفعيل التحكم في الإصدار. الدمج:
- حدد نظام التحكم في الإصدار لربطه بجذر المشروع من ثم انقر على حسنًا. تعرض قائمة VCS الآن عددًا من خيارات التحكم في الإصدار بناءً على النظام الذي حددته.
ملاحظة: يمكنك أيضًا استخدام ملف > الإعدادات > التحكّم في الإصدار لإعداد الإصدار وتعديله والتحكم المستمر.
لمزيد من المعلومات عن التعامل مع التحكم في الإصدار، يُرجى الاطّلاع على مرجع التحكّم في إصدارات IntelliJ:
توقيع التطبيق
في حال استخدام شهادة تصحيح أخطاء في السابق، قد يتم رصدها أثناء
عملية الاستيراد. في هذه الحالة، سيواصل "استوديو Android" الإشارة إلى أن
الشهادة. وبخلاف ذلك، تستخدم إعدادات تصحيح الأخطاء أداة
لتصحيح أخطاء ملف تخزين المفاتيح، باستخدام كلمة مرور معروفة ومفتاح افتراضي بمفتاح
الموجودة في $HOME/.android/debug.keystore
. تم ضبط نوع إصدار تصحيح الأخطاء.
لاستخدام إعدادات تصحيح الأخطاء هذه تلقائيًا عند تشغيل مشروعك أو تصحيح الأخطاء فيه
من "استوديو Android"
وبالمثل، قد تكتشف عملية الاستيراد شهادة إصدار حالية.
إذا لم يتم تحديد شهادة الإصدار من قبل، أضِف توقيع الإصدار.
الضبط على ملف build.gradle
أو build.gradle.kts
أو استخدام
إنشاء > خيار القائمة "إنشاء حِزمة APK موقَّعة" لفتح إنشاء حِزمة APK موقَّعة
ساحر لمزيد من المعلومات حول توقيع تطبيقك، يمكنك الاطّلاع على
وقِّع تطبيقك.
ضبط الحد الأقصى لحجم الذاكرة في "استوديو Android"
ويبلغ الحد الأقصى التلقائي لحجم الذاكرة في "استوديو Android" 1280 ميغابايت. إذا كنت كنت تعمل في مشروع كبير، أو كان نظامك يحتوي على ذاكرة وصول عشوائي كبيرة، فيمكنك تحسين الأداء من خلال زيادة الحد الأقصى للذاكرة الحجم.
تحديثات البرامج
يتم تحديث "استوديو Android" بشكل منفصل عن مكوّن Gradle الإضافي وأدوات الإنشاء أدوات SDK. يمكنك تحديد الإصدارات التي تريد استخدامها مع Android استوديو YouTube.
يوفّر "استوديو Android" تلقائيًا تحديثات تلقائية كلما كانت هناك نسخة ثابتة جديدة ، ولكن يمكنك اختيار التحديث بشكل متكرر أكثر يتلقون إصدارات للمعاينة أو الإصدارات التجريبية.
مزيد من المعلومات حول تحديث "استوديو Android" واستخدام المعاينة والإصدار التجريبي اطَّلع على التحديثات.