Android Academy · درس

بنية المشروع وملف البيان

افهم تخطيط مشروع Android ودور build.gradle والموارد وملف AndroidManifest.xml الذي يعرّف تطبيقك لنظام التشغيل.

بنية المشروع وملف البيان درس مجاني في Android Academy على CoddyKit. هذا هو الدرس 1 من أصل 7. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Android Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Android Academy 7 دروس في المجموع.

مشروع Android الأول

عند إنشاء مشروع Android جديد في Android Studio، يُنشئ البرنامج بنية مجلدات محددة. ويُعد فهم هذه البنية الخطوة الأولى نحو تطوير Android بفعالية.

تملك كل تطبيقات Android التخطيط العام نفسه على المستوى الأعلى — فلنستكشفه.

البنية على المستوى الأعلى

يحتوي مشروع Android على وحدتين رئيسيتين:

app/ — وحدة تطبيقك (الشيفرة والموارد وملف البيان)
ملفات Gradle — إعدادات نظام البناء

ستقضي معظم وقتك داخل app/src/main/:

java/ (أو kotlin/) — ملفات مصدر Kotlin الخاصة بك
res/ — التخطيطات والصور والسلاسل النصية
AndroidManifest.xml — ملف إعدادات التطبيق

مجلد res/

يحتوي مجلد res/ على جميع الموارد غير البرمجية:

res/layout/ — تخطيطات الشاشات بصيغة XML
res/drawable/ — الصور والأيقونات
res/values/strings.xml — السلاسل النصية
res/values/colors.xml — تعريفات الألوان
res/mipmap/ — أيقونات تشغيل التطبيق

ينشئ Android فئة تُسمى R كي تتمكن من الإشارة إلى الموارد في الشيفرة.

AndroidManifest.xml

يُعد AndroidManifest.xml أهم ملف إعدادات. فهو يخبر Android بما يلي:

اسم حزمة التطبيق (المعرّف الفريد)
الأنشطة الموجودة
النشاط الذي يمثل شاشة التشغيل
الأذونات التي يحتاج إليها التطبيق (الكاميرا والإنترنت وغيرهما)
الحد الأدنى ومستويات Android API المستهدفة

بنية ملف البيان

يبدو AndroidManifest.xml الأدنى كما يلي:

<!-- AndroidManifest.xml -->
<manifest
    xmlns:android="http://schemas.android.com/apk/res/android">

    <uses-permission
        android:name="android.permission.INTERNET" />

    <application
        android:label="@string/app_name"
        android:icon="@mipmap/ic_launcher">

        <activity android:name=".MainActivity"
            android:exported="true">
            <intent-filter>
                <!-- This is the launch activity -->
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

    </application>
</manifest>

ملفات build.gradle

Gradle هو نظام البناء. يوجد ملفان من نوع build.gradle:

على مستوى المشروع — الإعدادات العامة وإعدادات المستودعات
على مستوى التطبيق (app/build.gradle) — تبعيات تطبيقك وإصدارات SDK والمكونات الإضافية

تضيف المكتبات هنا: implementation "com.google.code.gson:gson:2.10.1"

الحقول الرئيسية في app/build.gradle

أهم الحقول في app/build.gradle:

compileSdk — واجهة Android API التي يُبنى التطبيق مقابلها
minSdk — أقدم إصدار Android تدعمه
targetSdk — إصدار Android الذي اختبرت التطبيق مقابله
versionCode — عدد صحيح يزداد مع كل إصدار
versionName — إصدار مقروء بشريًا (مثل "1.2.0")

فئة R

ينشئ Android تلقائيًا فئة R تربط كل مورد بمعرّف صحيح:

R.layout.activity_main — تخطيط XML الخاص بك
R.id.tvTitle — عنصر عرض داخل تخطيط
R.string.app_name — مورد سلسلة نصية
R.drawable.ic_logo — صورة

بهذه الطريقة تتصل شيفرة Kotlin بموارد XML.

استخدام strings.xml للتوطين

ضع دائمًا النص الظاهر للمستخدم في res/values/strings.xml بدلًا من كتابته مباشرةً في الشيفرة. يتيح ذلك التوطين — إذ يختار Android تلقائيًا سلسلة اللغة المناسبة استنادًا إلى الإعدادات المحلية للجهاز.

مثال: أنشئ res/values-tr/strings.xml للترجمات التركية.

تحقق سريع

أين تصرّح عن النشاط الذي يظهر عند تشغيل التطبيق للمرة الأولى؟

مراجعة: بنية المشروع

أصبحت الآن تفهم بنية مشروع Android:

app/src/main/kotlin/ — شيفرتك
app/src/main/res/ — التخطيطات والصور والسلاسل النصية
AndroidManifest.xml — الأذونات والأنشطة وإعدادات التشغيل
build.gradle — التبعيات وإصدارات SDK
فئة R — تصل بين الشيفرة والموارد

التالي: جوهر كل شاشة Android — الأنشطة ودورة حياتها.

الأسئلة الشائعة

هل درس «بنية المشروع وملف البيان» مجاني؟

نعم — نص درس «بنية المشروع وملف البيان» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Android Academy، انتقل إلى CoddyKit PRO. تتضمن دورة Android Academy 7 دروس في المجموع.

ماذا ستتعلم في «بنية المشروع وملف البيان»؟

افهم تخطيط مشروع Android ودور build.gradle والموارد وملف AndroidManifest.xml الذي يعرّف تطبيقك لنظام التشغيل. تتمرن على Android Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ Android Academy؟

لا تُشترط خبرة سابقة. Android Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 1 من أصل 7.

كم من الوقت يستغرق درس «بنية المشروع وملف البيان»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس Android Academy هذا؟

نعم. كل درس في Android Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

← العودة إلى Android Academy