أساسيات أندرويد بجافا

إعداد Android Studio وإنشاء مشروع

18 دقيقة الدرس 2 من 12

إعداد Android Studio وإنشاء مشروع

Android Studio هو بيئة التطوير المتكاملة الرسمية لتطوير تطبيقات Android، وهي مبنية على IntelliJ IDEA وتُصانها Google. تأتي مُدمجةً مع SDK Manager وAVD Manager (محاكي Android)، ونظام بناء Gradle، ومحرر تخطيط مرئي. الإعداد الصحيح من المرة الأولى يوفّر ساعات من تصحيح مشاكل البيئة لاحقًا.

متطلبات النظام

قبل التنزيل، تأكّد من أنّ جهازك يستوفي الحد الأدنى من المتطلبات. اعتبارًا من Android Studio Hedgehog (2023.1) وما بعده:

نظام التشغيل: Windows 10/11 (64-bit)، أو macOS 12 (Monterey) فما فوق، أو Linux مع glibc 2.31 فما فوق.
الذاكرة العشوائية: 8 جيجابايت كحد أدنى؛ 16 جيجابايت موصى به بشدة عند تشغيل المحاكي مع بيئة التطوير معًا.
مساحة القرص: 8 جيجابايت مساحة حرة (بيئة التطوير + SDK) بالإضافة إلى 4–8 جيجابايت لكل صورة نظام للمحاكي.
المعالج: Intel/AMD x86_64 أو Apple Silicon (سلسلة M). يجب تفعيل المحاكاة الافتراضية للعتاد لتشغيل المحاكي — على Windows يعني ذلك Intel HAXM أو Windows Hypervisor Platform (WHPX)؛ وعلى Linux يعني KVM.

Java مُدمج في البيئة. يأتي Android Studio مرفقًا بإصداره الخاص من JDK (حاليًا JDK 17). لا تحتاج إلى تثبيت JDK منفصل لبناء تطبيقات Android، وإن كنت تستطيع توجيه بيئة التطوير إلى JDK نظام عبر File → Project Structure → SDK Location → Gradle JDK عند الحاجة.

التثبيت

نزّل المثبّت من developer.android.com/studio وشغّله. سيرشدك معالج التشغيل الأول عبر الخطوات التالية:

اختيار سمة واجهة المستخدم (Darcula أو Light).
تنزيل Android SDK لأحدث إصدار مستقر من المنصة (حاليًا API 34 / Android 14). يُثبَّت SDK في ~/Android/Sdk على Linux/macOS أو C:\Users\<اسمك>\AppData\Local\Android\Sdk على Windows.
تنزيل Android Virtual Device افتراضي (Pixel 8 Pro، API 34) وتثبيت المحاكي.
اختياريًا: تثبيت Intel HAXM (على Windows/Linux Intel) لتسريع المحاكاة بالعتاد.

بعد الإعداد، افتح SDK Manager عبر Tools → SDK Manager وتأكّد من وجود المكوّنات التالية:

Android SDK Platform (أحدث إصدار مستقر — API 34 أو أحدث).
Android SDK Build-Tools (إصدار مطابق).
Android Emulator.
Android SDK Platform-Tools (يحتوي على adb).

إنشاء أول مشروع Android (بلغة Java)

من شاشة الترحيب انقر New Project. ستظهر لك معرض قوالب. في هذا البرنامج التعليمي اختر دائمًا Empty Views Activity — فهو يمنحك Activity واحدة وملف تخطيط XML وحد أدنى من الكود التلقائي. تجنّب "Empty Activity" التي قد تُعيَّن افتراضيًا على Compose؛ "Views Activity" يؤكّد استخدام نظام العروض التقليدي المستند إلى XML.

أكمل حقول حوار المشروع الجديد:

Name: مثلًا HelloAndroid. استخدم PascalCase.
Package name: معرّف بنمط النطاق العكسي، مثلًا com.yourname.helloandroid. يصبح هذا المعرّف الفريد لتطبيقك على متجر Play وعلى الجهاز. اجعله بأحرف صغيرة دون شُرَط.
Save location: مسار لا يحتوي على مسافات أو أحرف غير ASCII لضمان أفضل توافق.
Language: Java — تأكّد من اختيار Java وليس Kotlin.
Minimum SDK: API 26 (Android 8.0 Oreo) خيار معقول كحد أدنى — يغطّي ~95% من الأجهزة النشطة مع منحك إمكانية الوصول إلى واجهات برمجية حديثة.

انقر Finish. سيقوم Gradle بالمزامنة (تنزيل التبعيات) لمدة 1–3 دقائق في التشغيل الأول.

تحلّ بالصبر في أول مزامنة. يُنزّل Gradle مكوّن Android Gradle Plugin ومكتبة Kotlin stdlib (حتى في مشاريع Java، يستخدم نظام البناء Kotlin DSL بشكل افتراضي في الإصدارات الأحدث)، إضافةً إلى التبعيات التي أعلنتَها. اتصال إنترنت سريع ضروري؛ بعد أول مزامنة تُخزَّن الملفات في ~/.gradle/caches وتستغرق المزامنات اللاحقة ثوانٍ فقط.

ما الذي ولّده Android Studio

بعد المزامنة ستشاهد شجرة المشروع في Android view (القائمة المنسدلة في أعلى لوحة Project). المكوّنات الرئيسية التي تمّ توليدها لك:

app/src/main/java/com/yourname/helloandroid/MainActivity.java — فئة Activity التي تُمثّل نقطة الدخول.
app/src/main/res/layout/activity_main.xml — ملف XML الخاص بالتخطيط الذي تُحمّله MainActivity.
app/src/main/AndroidManifest.xml — بيان التطبيق (يُناقَش في الدرس 6).
app/build.gradle — سكريبت بناء Gradle على مستوى الوحدة (التبعيات، compileSdk، minSdk، إلخ).
build.gradle (مستوى المشروع) — إعلانات المكوّنات والمستودعات المشتركة بين جميع الوحدات.
gradle/libs.versions.toml — كتالوج الإصدارات (تستخدمه المشاريع الأحدث لمركزة إصدارات التبعيات).

هذا هو ملف MainActivity.java الذي تمّ توليده:

package com.yourname.helloandroid;

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }
}

تُوسّع الفئة AppCompatActivity (من مكتبة AndroidX AppCompat) بدلًا من فئة Activity المجرّدة. يمنحك هذا دعمًا للشريط العلوي متوافقًا مع الإصدارات القديمة وأدوات مساعدة أخرى. onCreate هو أول استدعاء في دورة الحياة — سندرس دورة الحياة الكاملة في الدرس 4. setContentView(R.layout.activity_main) تُحمّل ملف XML الخاص بالتخطيط وتجعله المحتوى المرئي للنافذة.

التشغيل على محاكٍ

افتح AVD Manager عبر Tools → Device Manager، اختر جهاز Pixel الذي تمّ إنشاؤه مسبقًا، وانقر مثلث التشغيل الأخضر لتشغيله. بعد تشغيل المحاكي اضغط زر Run الأخضر (أو Shift+F10). سيقوم Android Studio بترجمة تطبيقك وتعبئته كـ APK وتثبيته على المحاكي عبر adb وتشغيل MainActivity. يجب أن ترى "Hello World!" على الشاشة.

أداء المحاكي على Windows. إذا كان المحاكي بطيئًا جدًا، تحقّق من تفعيل المحاكاة الافتراضية للعتاد في إعدادات BIOS/UEFI لجهازك، ومن تثبيت HAXM أو WHPX. على الأجهزة التي لا تدعم المحاكاة الافتراضية للعتاد (بعض أجهزة لابتوب الشركات ذات BIOS المقفول)، استخدم جهاز Android حقيقي متصلًا عبر USB بدلًا من ذلك — يكتشفه Android Studio تلقائيًا بعد تفعيل USB Debugging في خيارات المطوّر بالجهاز.

التشغيل على جهاز حقيقي

على جهاز Android، انتقل إلى الإعدادات → حول الهاتف وانقر رقم الإصدار سبع مرات لفتح خيارات المطوّر.
انتقل إلى الإعدادات → خيارات المطوّر وفعّل USB Debugging.
اتصل بالهاتف عبر USB وقبَل مربّع الحوار "Allow USB Debugging" على الجهاز.
سيُدرج Android Studio جهازك في قائمة الهدف المنسدلة. اختره وانقر Run.

فهم نظام البناء (Gradle)

تُبنى تطبيقات Android بواسطة Gradle وليس بواسطة Android Studio مباشرةً — فبيئة التطوير مجرّد منسّق. هذا مهمّ لأنّك تستطيع بناء نفس المشروع من سطر الأوامر:

# في مجلد المشروع الجذر:
./gradlew assembleDebug          # بناء APK للتصحيح
./gradlew installDebug           # بناء + تثبيت على جهاز/محاكٍ متصل
./gradlew test                   # تشغيل اختبارات الوحدة

ملف app/build.gradle على مستوى الوحدة هو المكان الذي ستقضي فيه معظم وقتك. افهم أقسامه الرئيسية:

plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'   // موجود حتى في مشاريع Java في القوالب الأحدث
}

android {
    namespace 'com.yourname.helloandroid'
    compileSdk 34

    defaultConfig {
        applicationId "com.yourname.helloandroid"
        minSdk 26
        targetSdk 34
        versionCode 1
        versionName "1.0"
    }

    buildTypes {
        release {
            minifyEnabled false       // اضبطه true + فعّل ProGuard للإصدارات الحقيقية
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_17
        targetCompatibility JavaVersion.VERSION_17
    }
}

dependencies {
    implementation 'androidx.appcompat:appcompat:1.7.0'
    implementation 'com.google.android.material:material:1.12.0'
    implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
    testImplementation 'junit:junit:4.13.2'
    androidTestImplementation 'androidx.test.ext:junit:1.2.1'
}

مصطلحات أساسية: compileSdk هو مستوى API الذي تُترجَم الكود ضدّه (يحدّد الواجهات البرمجية التي يراها المترجم)؛ minSdk هو أدنى إصدار يُثبَّت عليه تطبيقك؛ targetSdk يُعلم Android بأيّ نموذج سلوك للإصدار يتوقّعه تطبيقك أثناء التشغيل.

الخلاصة

لديك الآن Android Studio مُثبَّتًا وSDK مُهيَّأً وتطبيق "Hello World" قابل للتشغيل. أنشأ معالج المشروع أول Activity لك وملف تخطيط XML وبيانًا وسكريبت بناء Gradle. في الدرس القادم سنجول عبر كل مجلد وملف في شجرة المشروع حتى تفهم أين تنتمي الأشياء تمامًا قبل أن تبدأ كتابة كود حقيقي.