يتضمن المشروع في "استوديو Android" كل ما يحدد لأحد التطبيقات، بدءًا من رمز المصدر والأصول إلى اختبار الرمز وإنشاء الإعدادات.
عند بدء مشروع جديد، ينشئ "استوديو Android" لجميع ملفاتك وجعلها مرئية في نافذة المشروع في "استوديو Android" لفتح النافذة، اختَر عرض. > نوافذ الأدوات > المشروع:
تقدم هذه الصفحة نظرة عامة على المكونات الرئيسية داخل مشروعك.
الوحدات
الوحدة هي مجموعة من ملفات المصدر وإعدادات الإنشاء التي تتيح لك تقسيم مشروعك إلى وحدات منفصلة من الوظائف. على وحدة أو أكثر، ويمكن أن تستخدم وحدة واحدة وحدة أخرى والتبعية. ويمكنك إنشاء كل وحدة واختبارها وتصحيح الأخطاء فيها بشكل مستقل.
يمكن الاستفادة من الوحدات الإضافية عند إنشاء مكتبات الرموز البرمجية داخل مشروعك الخاص أو عندما تريد إنشاء مجموعات مختلفة من التعليمات البرمجية والموارد أنواع الأجهزة المختلفة، مثل الهواتف والأجهزة القابلة للارتداء، مع الاحتفاظ بجميع الملفات ضمن نفس المشروع ومشاركة بعض التعليمات البرمجية.
لإضافة وحدة جديدة إلى مشروعك، انقر على ملف. > جديد > وحدة جديدة:
يوفر "استوديو Android" بضعة أنواع مختلفة من الوحدات:
- وحدة تطبيق Android
- يوفر حاوية لتطبيقك.
ورمز المصدر وملفات الموارد والإعدادات على مستوى التطبيق، مثل
ملف إنشاء على مستوى الوحدة وملف بيان Android. فعندما
تنشئ مشروعًا جديدًا، فستحمل وحدة التطبيق الافتراضية اسم "app".
عروض ترويجية في "استوديو Android" الأنواع التالية من وحدات التطبيق:
- الهاتف الجهاز اللوحي
- Automotive
- Wear OS
- التلفزيون
- منشئ الملف الشخصي الأساسي
- مقياس الأداء
توفر كل وحدة ملفات أساسية وبعض قوالب التعليمات البرمجية مناسبًا لنوع الجهاز أو التطبيق المعني
لمزيد من المعلومات حول إضافة وحدة، يمكنك الاطلاع على إضافة وحدة لجهاز جديد
- وحدة الميزات
-
يمثّل هذا القسم ميزة مُقسَّمة إلى وحدات من تطبيقك للاستفادة من Play.
عرض الميزات: على سبيل المثال، يمكنك من خلال وحدات الميزات تزويد المستخدمين
بميزات معينة في تطبيقك عند الطلب أو كتجارب فورية من خلال
تطبيقات Google Play الفورية:
يوفّر "استوديو Android" الأنواع التالية من وحدات الميزات:
- وحدة الميزات الديناميكية
- وحدة مكتبة الميزات الديناميكية الفورية
لمزيد من المعلومات، يمكنك الاطّلاع على عرض الميزات في Play:
- وحدة المكتبة
- يوفر حاوية للرمز القابل لإعادة الاستخدام، والذي
يمكنها استخدامها كتبعية في وحدات التطبيق الأخرى أو استيرادها إلى
مماثلة. من الناحية الهيكلية، تكون وحدة المكتبة هي نفسها الوحدة النمطية في التطبيق، ولكن عند إنشائها،
ينشئ ملف أرشيف للرموز بدلاً من حِزمة APK، لذلك لا يمكن تثبيته على
أحد الأجهزة.
في النافذة إنشاء وحدة جديدة، يعرض "استوديو Android" الأنواع التالية من وحدات المكتبة:
- مكتبة Android: تتضمن كل أنواع الملفات المتوافقة في مشروع Android باستثناء رمز C++ الأصلي، بما في ذلك رمز المصدر Java وKotlin، والموارد وملفات البيان. نتيجة الإصدار هي ملف أرشيف Android (AAR) يمكنك إضافته تبعية لوحدات تطبيق Android.
- مكتبة Android الأصلية: تشتمل على جميع أنواع الملفات المتوافقة. في مشروع Android، على غرار مكتبة Android. ومع ذلك، يمكن لـ "مكتبات Android المحلية" أيضًا يمكن أن يحتوي على رمز مصدر C++ أصلي. وتكون نتيجة الإصدار هي ملف أرشيف Android (AAR) يمكنك إضافتها كتبعية لوحدات تطبيق Android
- مكتبة Java أو Kotlin: تحتوي على ملفات مصدر بلغة Kotlin أو Java فقط. وتكون نتيجة الإصدار هي ملف أرشيف Java (JAR) يمكنك إضافته تبعية لوحدات تطبيق Android أو لمشاريع Kotlin أو Java الأخرى.
يُشار أحيانًا إلى الوحدات باسم المشاريع الفرعية، لأنه تشير Gradle أيضًا إلى الوحدات كمشروعات.
عندما تنشئ وحدة مكتبة وتريد إضافتها كملحق إلى وحدة تطبيق Android، عليك الإفصاح عنها على النحو التالي:
Groovy
dependencies { implementation project(':my-library-module') }
Kotlin
dependencies { implementation(project(":my-library-module")) }
ملفات المشروع
![](https://developer.android.com/static/images/tools/projectview-p1.png?authuser=9&hl=ar)
يعرض "استوديو Android" تلقائيًا ملفات مشروعك في Android. لا يعكس هذا العرض التسلسل الهرمي للملفات الفعلية على القرص. بدلاً من ذلك، يتم تنظيمها حسب والوحدات وأنواع الملفات لتبسيط التنقل بين ملفات المصدر الرئيسية لمشروعك، مما يؤدي إلى ملفات أو أدلة معينة لا يشيع استخدامها.
بعض الاختلافات الهيكلية بين عرض Android الهيكلية على القرص والتي يتم عرضها في طريقة عرض Android:
- يعرض كل ملفات الإعداد المتعلقة بالإصدارات في مستوى أعلى Gradle Script.
- تعرض جميع ملفات البيان لكل وحدة في المجموعة على مستوى الوحدة عند تحتوي على ملفات بيان مختلفة لنكهات المنتجات وأنواع الإصدارات المختلفة.
- عرض جميع ملفات الموارد البديلة في مجموعة واحدة بدلاً من وضعها في مجلدات منفصلة لكل مؤهل مورد. على سبيل المثال، قد تكون جميع الكثافة تكون إصدارات رمز مشغّل التطبيقات مرئية جنبًا إلى جنب.
داخل كل وحدة من وحدات تطبيق Android، يتم عرض الملفات في المجموعات التالية:
- البيانات
- تحتوي على الملف
AndroidManifest.xml
. - JavaScript
- تحتوي على ملفات رمز المصدر بلغة Kotlin وJava، مفصولةً بأسماء الحزم، بما في ذلك رمز اختبار JUnit.
- الدقة
- تحتوي على كل الموارد غير البرمجية، مثل سلاسل واجهة المستخدم صور نقطية، مقسمة إلى أدلة فرعية مقابلة. لمزيد من المعلومات حول أنواع الموارد المحتملة، راجع نظرة عامة على موارد التطبيقات.
عرض المشروع
![](https://developer.android.com/static/images/tools/projectview-p2.png?authuser=9&hl=ar)
لرؤية القيمة بنية ملفات المشروع، بما في ذلك جميع الملفات المخفية من عرض Android، حدد مشروع من القائمة في الجزء العلوي من نافذة المشروع.
عند تحديد طريقة عرض المشروع، يمكنك الاطلاع على الكثير من الملفات. والأدلة، بما في ذلك ما يلي:
module-name/
-
build/
- يحتوي على نتائج الإصدار.
libs/
- تحتوي على مكتبات خاصة.
src/
- تحتوي هذه العلامة على جميع ملفات الرموز وملفات الموارد الخاصة بالوحدة في ما يلي.
الأدلة الفرعية:
androidTest/
- تحتوي على رمز لاختبارات الأدوات التي يتم تشغيلها على جهاز Android. لمزيد من المعلومات، يُرجى مراجعة الاختبار في "استوديو Android"
cpp/
- يحتوي على رمز C أو C++ أصلي باستخدام واجهة Java الأصلية (JNI). لمزيد من المعلومات، يُرجى مراجعة مستندات Android NDK.
main/
- تحتوي على "الرئيسة" ملفات مجموعة المصدر: رمز Android وموارده
مشترَكة بين جميع صيغ الإصدار (ملفات لخيارات الإصدار الأخرى
موجودة في الأدلة التابعة، مثل
src/debug/
نوع إصدار تصحيح الأخطاء):AndroidManifest.xml
- يصف هذا النموذج طبيعة التطبيق وكل مكوّن من مكوناته. لمزيد من المعلومات، يُرجى الاطّلاع على بيان التطبيق نظرة عامة.
java/
- يحتوي على مصدر رمز بلغة Kotlin أو Java أو كليهما إذا كان التطبيق يتضمّن كلاً من Kotlin وJava رمز المصدر.
kotlin/
- يحتوي على مصادر رموز Kotlin فقط.
res/
- يحتوي على موارد التطبيقات، مثل الملفات القابلة للرسم وملفات سلاسل واجهة المستخدم. لمزيد من المعلومات، المعلومات، فراجع نظرة عامة على موارد التطبيق.
assets/
- تحتوي على ملفات ليتم تجميعها في ملف APK كما هي. على سبيل المثال:
فهذا مكان جيد للزخارف وبيانات الألعاب. يمكنك
التنقل في هذا الدليل بنفس الطريقة مثل نظام الملفات النموذجي، باستخدام
معرفات الموارد المنتظمة (URI) وقراءة الملفات كتدفق لوحدات البايت باستخدام
AssetManager
test/
- تحتوي على رمز للاختبارات المحلية التي يتم إجراؤها على مضيف الحِزمة JVM.
build.gradle
أوbuild.gradle.kts
(وحدة)- يحدّد ذلك إعدادات التصميم الخاصة بالوحدة.
build.gradle
هو اسم الملف الصحيح إذا كنت تستخدم Groovy كلغة نص الإصدار، وهذاbuild.gradle.kts
إذا كنت تستخدم نص Kotlin.
build.gradle
أوbuild.gradle.kts
(المشروع)- يحدّد ذلك إعدادات تصميمك التي تنطبق على جميع الوحدات.
build.gradle
هو اسم الملف الصحيح إذا كنت تستخدم Groovy كلغة نص الإصدار، وهذاbuild.gradle.kts
إذا كنت تستخدم نص Kotlin. يعد هذا الملف جزءًا لا يتجزأ من المشروع، لذا حافظ عليه في التحكم في النسخة السابقة مع جميع رموز المصدر الأخرى.للحصول على معلومات عن ملفات الإصدار الأخرى، يُرجى الاطّلاع على اضبط الإصدار.
إعدادات بنية المشروع
لتغيير إعدادات مختلفة لمشروعك على "استوديو Android"، افتح مربع حوار بنية المشروع بالنقر على ملف > بنية المشروع: وهي تحتوي على الأقسام التالية:
- المشروع: لضبط إصدار Gradle المكوّن الإضافي لنظام Gradle المتوافق مع Android واسم موقع المستودع.
- موقع حزمة SDK: لضبط موقع حزمة تطوير البرامج (SDK) لنظام التشغيل JDK أو حزمة تطوير البرامج (SDK) لنظام التشغيل Android وAndroid NDK التي يستخدمها مشروعك.
- المتغيّرات: تتيح لك تعديل المتغيّرات التي يتم استخدامها في تصميمك. والنصوص البرمجية.
-
الوحدات: تتيح لك تعديل التصميم الخاص بالوحدات.
من الإعدادات، بما في ذلك حزمة SDK المستهدفة والحد الأدنى وتوقيع التطبيق
وتبعيات المكتبة. تنقسم صفحة إعدادات كل وحدة إلى علامات التبويب التالية:
- الخصائص: تحدِّد إصدارات حزمة SDK والإصدارات والأدوات التي يمكنك استخدامها لتجميع الوحدة.
- توقيع: يحدد الشهادة التي سيتم استخدامها في توقيع .
-
التبعيات: يسرد المكتبة والملف والوحدة والتبعيات لهذه الوحدة. يمكنك إضافة التبعيات وتعديلها وحذفها. من هذا الجزء. لمزيد من المعلومات حول تبعيات الوحدة، راجع ضبط صيغ الإصدار
-
إعداد خيارات المنتج: يتيح لك هذا الخيار إعداد نكهات مختلفة وأنواع التصاميم. لمشروعك.
-
النكهات: تتيح لك إنشاء نكهات متنوعة، حيث يمكنك تحدد كل صيغة مجموعة من إعدادات الضبط، مثل الحد الأدنى من الوحدة وإصدار حزمة تطوير البرامج (SDK) المستهدفة، رمز الإصدار اسم الإصدار.
على سبيل المثال، يمكنك تحديد نكهة واحدة لها لا تقل هذه الحزمة عن 21 وحزمة SDK مستهدَفة قيمتها 29، فضلاً عن صيغة أخرى إصدار 24 من حزمة SDK كحدّ أدنى و33 حزمة SDK مستهدَفة
- أنواع الإصدارات: تتيح لك إنشاء إصدارات وتعديلها. الإعدادات، كما هو موضَّح في مقالة ضبط صيغ الإصدار. بشكل افتراضي، تحتوي كل وحدة على تصحيح الأخطاء الإصدار، ويمكنك تحديد المزيد حسب الحاجة.
-