نظرة عامة على المشاريع

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

عند بدء مشروع جديد، ينشئ Android Studio البنية اللازمة لجميع ملفاتك ويجعلها مرئية في نافذة المشروع في Android Studio. لفتح النافذة، اختَر عرض. > نوافذ الأدوات > المشروع:

تقدم هذه الصفحة نظرة عامة على المكونات الرئيسية داخل مشروعك.

الوحدات

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

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

لإضافة وحدة جديدة إلى مشروعك، انقر على ملف > جديد > وحدة جديدة.

يوفر "استوديو Android" بضعة أنواع مختلفة من الوحدات:

وحدة تطبيق Android

توفّر حاوية لملف برمجة التطبيقات وملفّات الموارد والإعدادات على مستوى التطبيق، مثل ملف الإنشاء على مستوى الوحدة وملف بيان Android. فعندما تنشئ مشروعًا جديدًا، فستحمل وحدة التطبيق الافتراضية اسم "app".

عروض ترويجية في "استوديو Android" الأنواع التالية من وحدات التطبيق:

• الهاتف والجهاز اللوحي
• Automotive
• Wear OS
• التلفزيون
• منشئ الملف الشخصي الأساسي
• مقياس الأداء

توفر كل وحدة ملفات أساسية وبعض قوالب التعليمات البرمجية مناسبًا لنوع الجهاز أو التطبيق المعني

لمزيد من المعلومات حول إضافة وحدة، يمكنك الاطلاع على إضافة وحدة لجهاز جديد

وحدة الميزة

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

يوفّر Android Studio الأنواع التالية من وحدات الميزات:

• وحدة الميزات الديناميكية
• وحدة مكتبة الميزات الديناميكية الفورية

لمزيد من المعلومات، يمكنك الاطّلاع على عرض الميزات في 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 الأخرى.

يُشار أحيانًا إلى الوحدات باسم مشاريع فرعية، لأنّ IDE ‫Gradle يشير أيضًا إلى الوحدات باسم مشاريع.

عندما تنشئ وحدة مكتبة وتريد إضافتها كملحق إلى وحدة تطبيق Android، عليك الإفصاح عنها على النحو التالي:

رائعKotlin

dependencies {
    implementation project(':my-library-module')
}

dependencies {
    implementation(project(":my-library-module"))
}

ملفات المشروع

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

في ما يلي بعض الاختلافات الهيكلية بين عرض Android و البنية على القرص، وهي أنّ عرض Android:

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

داخل كل وحدة من وحدات تطبيق Android، يتم عرض الملفات في المجموعات التالية:

البيانات

يحتوي على ملف AndroidManifest.xml.

java

تحتوي على ملفات رمز المصدر بلغة Kotlin وJava، مفصولةً بأسماء الحزم، بما في ذلك رمز اختبار JUnit.

res

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

ملاحظة: أنواع الوحدات المختلفة لها هياكل مجموعات مختلفة. بالنسبة على سبيل المثال، تحتوي وحدة أصلية أيضًا على مجلد cpp/ داخل main مجموعة، ولا تحتوي مكتبة Kotlin أو Java على manifests أو res المجموعات.

عرض "المشروع"

للاطّلاع على بنية الملفات الفعلية للمشروع، بما في ذلك جميع الملفات المخفية من عرض Android، اختَر المشروع من القائمة في أعلى نافذة المشروع.

عند اختيار طريقة العرض المشروع، يمكنك الاطّلاع على المزيد من الملفات والدلائل، بما في ذلك ما يلي:

module-name/

build/

يحتوي على نتائج الإصدار.

libs/

تحتوي على مكتبات خاصة.

src/

تحتوي هذه العلامة على جميع ملفات الرموز وملفات الموارد الخاصة بالوحدة في ما يلي. الأدلة الفرعية:

androidTest/

تحتوي على رمز لاختبارات الأدوات التي يتم تشغيلها على جهاز Android. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الاختبار في Android Studio.

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/

يحتوي على رمز للاختبارات المحلية التي يتم تشغيلها على آلة Java الافتراضية للمضيف.

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 إلى طريقة عرض المشروع، اختَر المساعدة > تعديل السمات المخصّصة وأضِف studio.projectview=true.

إعدادات بنية المشروع

لتغيير إعدادات مختلفة لمشروعك على "استوديو Android"، افتح مربع حوار بنية المشروع بالنقر على ملف > بنية المشروع: وهي تحتوي على الأقسام التالية:

• المشروع: لضبط إصدار Gradle المكوّن الإضافي لنظام Gradle المتوافق مع Android واسم موقع المستودع.
• الموقع الجغرافي لحزمة SDK: لضبط الموقع الجغرافي لحزمة تطوير البرامج (JDK) وحزمة SDK لنظام التشغيل Android ومجموعة تطوير البرامج (NDK) لنظام التشغيل Android التي يستخدمها مشروعك.
• المتغيّرات: تتيح لك تعديل المتغيّرات التي يتم استخدامها في تصميمك. والنصوص البرمجية.
• الوحدات: تتيح لك تعديل إعدادات الإنشاء الخاصة بالوحدة، بما في ذلك الإصدار المستهدَف والحد الأدنى من إصدار حزمة SDK وتوقيع التطبيق والبرامج الاعتمادية للمكتبة. تنقسم صفحة إعدادات كل وحدة إلى علامات التبويب التالية:
  • السمات: تحدّد إصدارات حزمة SDK وأدوات الإنشاء التي يجب استخدامها لتجميع الوحدة.
  • توقيع: يحدد الشهادة التي سيتم استخدامها في توقيع .

• التبعيات: تعرض قائمة بالمكتبات والملفات والوحدات التي تعتمد عليها هذه الوحدة. يمكنك إضافة التبعيات وتعديلها وحذفها من هذه اللوحة. لمزيد من المعلومات عن التبعيات في الوحدات، يُرجى الاطّلاع على ضبط أنواع الإصدار.

  المعاينة: إذا كنت تستخدم كتالوج إصدار، يجب الانتباه إلى المشكلة التابعة التي تتم إضافتها من خلال مربع حوار هيكل المشروع تتم إضافتها إلى وحدة الوحدة ملف build.gradle، وليس الكتالوج لمعرفة المزيد من المعلومات عن كتالوجات إصدارات Gradle في Android Studio، يمكنك الاطلاع على ملاحظة حول إصدار المعاينة.

• خيارات الإصدار: تتيح لك ضبط أنواع مختلفة من النُسخ المخصّصة لمشروعك

  • النكهات: تتيح لك إنشاء نكهات متنوعة، حيث يمكنك تحدد كل صيغة مجموعة من إعدادات الضبط، مثل الحد الأدنى من الوحدة وإصدار حزمة تطوير البرامج (SDK) المستهدفة، رمز الإصدار اسم الإصدار.

    على سبيل المثال، يمكنك تحديد إصدار له الحد الأدنى من إصدار حزمة تطوير البرامج (SDK) هو 21 وإصدار حزمة تطوير البرامج (SDK) المستهدَف هو 29، وإصدار آخر له الحد الأدنى من إصدار حزمة تطوير البرامج (SDK) هو 24 وإصدار حزمة تطوير البرامج (SDK) المستهدَف هو 33.

  • أنواع الإصدارات: تتيح لك إنشاء إعدادات الإصدارات وتعديلها، كما هو موضّح في ضبط أنواع الإصدارات. بشكلٍ تلقائي، تحتوي كل وحدة على نوعَي الإصدار تصحيح الأخطاء و الإصدار، ويمكنك تحديد المزيد حسب الحاجة.