إنشاء مشروع

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

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

إذا كان لديك مشروع مفتوح، أنشئ مشروعًا جديدًا من خلال النقر على ملف > جديد > مشروع جديد من القائمة الرئيسية.

ملاحظة: لاستخدام وكيل ذكاء اصطناعي توليدي لإنشاء مشروع، يُرجى الاطّلاع على مقالة إنشاء مشروع باستخدام الذكاء الاصطناعي.

Android CLI

تنزيل Android CLI

تجربة Android CLI لإنشاء مشروع جديد

يمكنك تجربة Android CLI إذا كنت لا تستخدم "استوديو Android" أو كنت تفضّل تنفيذ المهام من سطر الأوامر.

على سبيل المثال، استخدِم الأمر android create عندما تحتاج إلى إنشاء مشروع جديد.

android create empty-activity --name=MyApp

اختيار نوع مشروعك

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

الشكل 1. اختَر نوع المشروع الذي تريد إنشاءه في شاشة مشروع جديد.

يسمح لك اختيار نوع المشروع الذي تريد إنشاءه بأن يضمّن "استوديو Android" رمزًا نموذجيًا وموارد في مشروعك لمساعدتك في البدء.

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

بعد اختيار نوع مشروعك، انقر على التالي.

إعداد مشروعك

الخطوة التالية في إنشاء مشروعك هي إعداد بعض الإعدادات، كما هو موضّح في الشكل 2. إذا كنت تنشئ مشروع Native C++ ، يُرجى الاطّلاع على مقالة إنشاء مشروع جديد يتضمّن دعم C/C++ لمزيد من المعلومات حول الخيارات التي عليك إعدادها.

الشكل 2. يمكنك إعداد مشروعك الجديد باستخدام بعض الإعدادات.

1. حدِّد اسم مشروعك.
2. حدِّد اسم الحزمة. تلقائيًا، يصبح اسم الحزمة هذا مساحة اسم مشروعك (المستخدَمة للوصول إلى موارد مشروعك) ومعرّف تطبيق مشروعك (المستخدَم كمعرّف للنشر). لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إعداد وحدة التطبيق.

3. حدِّد موقع الحفظ الذي تريد تخزين مشروعك فيه محليًا.

   ملاحظة: على نظام التشغيل macOS، ننصحك بحفظ مشروعك في الدليل /Users/user_name/AndroidStudioProjects. تتضمّن بعض إصدارات macOS ميزة أمان تُعرف باسم "الشفافية والموافقة والتحكّم" (TCC) تحمي مجلدات معيّنة، بما في ذلك Documents وDesktop وDownloads. إذا كنت تستخدم هذه المجلدات، قد لا تظهر ملفات المشروع بشكل صحيح في "استوديو Android" ما لم تمنح "استوديو Android" إذنًا خاصًا للوصول إلى هذه المجلدات.

4. اختَر اللغة التي تريد أن يستخدمها "استوديو Android" عند إنشاء نموذج رمز لمشروعك الجديد. اللغة المقترَحة هي Kotlin وهي مطلوبة للأُطر الحديثة، مثل Jetpack Compose. اللغة Java متوافقة ولكن لا يُنصح بها للمشاريع الجديدة.

5. اختَر الحد الأدنى لمستوى واجهة برمجة التطبيقات الذي تريد أن يتوافق معه تطبيقك. عند اختيار مستوى واجهة برمجة تطبيقات أقل، لا يمكن لتطبيقك استخدام العديد من واجهات برمجة تطبيقات Android الحديثة. ومع ذلك، يمكن لنسبة أكبر من أجهزة Android تشغيل تطبيقك. وينطبق العكس عند اختيار مستوى واجهة برمجة تطبيقات أعلى.

   إذا أردت الاطّلاع على مزيد من البيانات لمساعدتك في اتخاذ القرار، انقر على مساعدتي في الاختيار. يعرض هذا الخيار مربّع حوار يعرض التوزيع التراكمي لمستوى واجهة برمجة التطبيقات الذي اخترته ويسمح لك بالاطّلاع على تأثير استخدام مستويات مختلفة من الحد الأدنى لواجهة برمجة التطبيقات.

   

   الشكل 3. شاشة مساعدة تعرض التوزيع التراكمي لمستويات مختلفة من واجهات برمجة التطبيقات.

6. تم إعداد مشروعك لاستخدام مكتبات AndroidX تلقائيًا، والتي تحلّ محلّ مكتبات Android Support. لاستخدام مكتبات الدعم القديمة بدلاً من ذلك، اختَر استخدام مكتبات android.support القديمة. ومع ذلك، لا يُنصح بذلك لأنّ مكتبات الدعم القديمة لم تعُد متوافقة. لمعرفة المزيد، راجع نظرة عامة على AndroidX.

7. عندما تكون مستعدًا لإنشاء مشروعك، انقر على إنهاء.

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

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

استيراد مشروع حالي

لاستيراد مشروع على جهاز المستخدم حالي إلى "استوديو Android"، اتّبِع الخطوات التالية:

1. انقر على ملف > جديد > استيراد مشروع.
2. في النافذة التي تظهر، انتقِل إلى الدليل الجذري للمشروع الذي تريد استيراده.
3. انقر على موافق.

يفتح "استوديو Android" المشروع في نافذة جديدة لبيئة التطوير المتكاملة (IDE) ويضع فهرسًا لمحتوياته.

إذا كنت تستورد مشروعًا من نظام التحكّم في الإصدارات، انقر على ملف > جديد > مشروع من نظام التحكّم في الإصدارات. لمزيد من المعلومات حول استيراد المشاريع من نظام التحكّم في الإصدارات، يُرجى الاطّلاع على معلومات IntelliJ حول نظام التحكّم في الإصدارات.

إنشاء تطبيقك وتشغيله

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

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إنشاء تطبيقك وتشغيله والأدلة التي تتناول التشغيل على Android Emulator وعلى أجهزة فعلية.