كيفية إنشاء أول تطبيق باستخدام Xamarin.Android خطوة بخطوة

 

مقدمة

إذا كنت مطور C# وترغب في دخول عالم تطوير تطبيقات Android دون تعلم لغة Java أو Kotlin، فإن Xamarin.Android يعد خيارًا قويًا وعمليًا. فهو يسمح لك بإنشاء تطبيقات أندرويد باستخدام لغة C# وبيئة Visual Studio، مع إمكانية الوصول الكامل إلى واجهات برمجة Android الأصلية.

في هذا الدليل العملي سنشرح بالتفصيل كيفية إنشاء أول تطبيق Android باستخدام Xamarin.Android، بدءًا من تثبيت الأدوات وحتى تشغيل التطبيق على المحاكي أو الهاتف الحقيقي.

---

ما هو Xamarin.Android؟

Xamarin.Android هو إطار عمل يسمح ببناء تطبيقات Android أصلية باستخدام لغة C# و .NET.
وهو جزء من منصة .NET التي تدعم تطوير تطبيقات متعددة المنصات.

أهم مميزاته:

• استخدام لغة C# بدل Java

• إمكانية مشاركة الكود مع مشاريع أخرى

• دعم كامل لمكتبات Android الأصلية

• تطوير داخل Visual Studio

---

المتطلبات الأساسية

قبل البدء، تأكد من توفر ما يلي:

1. جهاز كمبيوتر يعمل بنظام Windows

2. تثبيت Visual Studio 2022 أو أحدث

3. اختيار Workload:

   • Mobile development with .NET

4. تثبيت Android SDK عبر Visual Studio

---

الخطوة الأولى: إنشاء مشروع جديد

1. افتح Visual Studio

2. اضغط على "Create a new project"

3. اختر:

   Android App (Xamarin)
   

4. اضغط Next

5. اكتب اسم المشروع (مثلاً: FirstApp)

6. اختر مكان الحفظ

7. اضغط Create

اختر قالب:

Blank App

ثم اضغط Create.

---

التعرف على هيكل المشروع

بعد إنشاء المشروع، ستلاحظ عدة ملفات مهمة:

MainActivity.cs

وهو الملف الرئيسي الذي يبدأ منه التطبيق.

Resources/layout/Main.axml

ملف واجهة المستخدم.

AndroidManifest.xml

يحتوي على إعدادات التطبيق الأساسية مثل:

• اسم التطبيق

• الأذونات

• إصدار النظام

---

الخطوة الثانية: تصميم واجهة بسيطة

افتح الملف:

Resources/layout/Main.axml

واستبدل المحتوى بالتالي:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:padding="20dp"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <EditText
        android:id="@+id/nameInput"
        android:hint="اكتب اسمك هنا"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />

    <Button
        android:id="@+id/btnClick"
        android:text="اضغط هنا"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:marginTop="20dp"/>

    <TextView
        android:id="@+id/resultText"
        android:text=""
        android:textSize="18sp"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:marginTop="20dp"/>

</LinearLayout>

هذه الواجهة تحتوي على:

• مربع إدخال نص

• زر

• نص لعرض النتيجة

---

الخطوة الثالثة: كتابة كود C#

افتح ملف:

MainActivity.cs

وأضف الكود التالي داخل OnCreate:

protected override void OnCreate(Bundle savedInstanceState)
{
    base.OnCreate(savedInstanceState);
    SetContentView(Resource.Layout.Main);

    var nameInput = FindViewById<EditText>(Resource.Id.nameInput);
    var button = FindViewById<Button>(Resource.Id.btnClick);
    var resultText = FindViewById<TextView>(Resource.Id.resultText);

    button.Click += (sender, e) =>
    {
        string name = nameInput.Text;
        resultText.Text = "مرحباً " + name;
    };
}

هذا الكود يقوم بالتالي:

• يأخذ النص الذي يدخله المستخدم

• عند الضغط على الزر

• يعرض رسالة ترحيب داخل TextView

---

الخطوة الرابعة: تشغيل التطبيق

لديك خياران:

1. تشغيل على محاكي (Emulator)

• من أعلى Visual Studio

• اختر جهاز محاكي

• اضغط Run

2. تشغيل على هاتف حقيقي

• فعّل وضع المطور في الهاتف

• فعّل USB Debugging

• وصل الهاتف بالكمبيوتر

• اختر الجهاز من القائمة

• اضغط Run

---

فهم دورة حياة Activity

من المهم فهم أن Android يعتمد على مفهوم Activity.

أهم المراحل:

• OnCreate → عند إنشاء الشاشة

• OnStart → عند ظهورها

• OnResume → عند التفاعل معها

• OnPause → عند مغادرتها مؤقتًا

• OnDestroy → عند إغلاقها

فهم هذه الدورة يساعدك لاحقًا في إدارة البيانات والموارد بكفاءة.

---

أفضل ممارسات عند بناء أول تطبيق

1. ابدأ بمشروع بسيط

2. نظم الكود ولا تضع كل شيء داخل Activity

3. استخدم أسماء واضحة للعناصر

4. افصل منطق العمل عن واجهة المستخدم

5. اختبر التطبيق على أكثر من جهاز

---

الأخطاء الشائعة للمبتدئين

• نسيان استدعاء SetContentView

• خطأ في معرف العنصر داخل XML

• NullReferenceException عند عدم إيجاد العنصر

• عدم تحديث SDK

إذا ظهر خطأ، اقرأ رسالة الخطأ جيدًا فهي غالبًا تشير إلى السبب مباشرة.

---

تطوير التطبيق لاحقًا

بعد إنشاء تطبيقك الأول، يمكنك تطويره بإضافة:

• قاعدة بيانات SQLite

• ربط API

• Firebase

• تسجيل دخول

• إشعارات

• تصميم احترافي باستخدام Material Design

---

الفرق بين Xamarin.Android و .NET MAUI

Xamarin.Android:

• مخصص لنظام Android فقط

• تحكم كامل في كل تفاصيل النظام

.NET MAUI:

• متعدد المنصات

• كود واحد يعمل على Android و iOS و Windows

إذا كنت تريد تطبيق Android مخصص بالكامل، فـ Xamarin.Android خيار قوي.