تخيل أنك تجهز ورشتك الخاصة قبل البدء في مشروع يدوي؛ هكذا تمامًا تبدو خطوتك الأولى في عالم تطوير تطبيقات الهواتف. كل ما تحتاجه هو محرر نصوص، وأدوات تشغيل، وهاتف أو محاكي لترى النتيجة. وفي غضون دقائق معدودة، ستشاهد شاشة تطبيقك تتغير أمام عينيك مع كل سطر تكتبه—وهنا تحديدًا تبدأ متعة التعلم الحقيقية.
أهداف هذا الدرس
مع نهاية هذا الدرس، ستتمكن من:
- استيعاب الدور الذي تلعبه بيئة التطوير الأساسية في React Native.
- التمييز بين Expo و React Native CLI لاختيار المسار الأنسب لمشروعك.
- تثبيت الأدوات الضرورية والتأكد من جاهزيتها للعمل بكفاءة.
- إنشاء تطبيقك الأول وتجربته على هاتف حقيقي أو جهاز افتراضي.
- استكشاف الهيكل الداخلي للمشروع والتعديل على واجهته الأولى.
- التعامل بذكاء مع الأخطاء الشائعة وتجاوزها قبل أن تعطل تقدمك.
ما الذي نحتاجه لبناء تطبيق React Native؟
يتيح لك إطار عمل React Native كتابة واجهات التطبيق بلغة JavaScript أو TypeScript، ثم يتكفل هو بتحويلها إلى مكونات أصلية تعمل بسلاسة على نظامي Android وiOS. ولأن الغاية هي بناء تطبيق فعلي وليس مجرد صفحة ويب، لن يكفيك كتابة الكود فقط؛ بل ستحتاج إلى بيئة عمل متكاملة قادرة على تجميع المشروع واختباره في بث مباشر.
تدور عملية التطوير اليومية في دورة عمل منظمة:
- تكتب كود الواجهة وعناصرها داخل محرر الأكواد.
- يتولى خادم التطوير قراءة الملفات وتجهيزها لحظة بلحظة.
- يرتبط تطبيق Expo Go أو أداة البناء بهاتفك أو المحاكي.
- تظهر التعديلات على الشاشة فورًا، لتعاين النتيجة تمامًا كما سيراها المستخدم النهائي.
سنركز في هذا الدرس على مسار Expo؛ لأنه يمهد الطريق للمبتدئين ويغنيك في البداية عن تعقيدات ضبط إعدادات نظام التشغيل. وفي الوقت نفسه، سنوضح دور React Native CLI والمتى يصبح الانتقال إليه ضرورة.
اختيار مسار العمل: Expo أم React Native CLI؟
متى نختار Expo؟
توفر منصة Expo بيئة متكاملة تمنحك مشروعًا جاهزًا للتطوير فورًا، مع تطبيق Expo Go لتشغيل التجربة على هاتفك، إضافة إلى خدمات سحابية تسهل البناء والنشر لاحقًا. إنها الخيار المثالي إذا كنت تخطو خطواتك الأولى، أو تبني تطبيقًا يعتمد على الميزات القياسية مثل الكاميرا، والتنبيهات، والتخزين المحلي.
الميزة الكبرى هنا هي أنك لن تحتاج لتثبيت برامج ثقيلة مثل Android Studio أو Xcode لمجرد رؤية تطبيقك يعمل. يكفيك تثبيت Node.js، ثم إطلاق المشروع وتجربته مباشرة على هاتفك الشخصي.
متى ننتقل إلى React Native CLI؟
يتغير المشهد إذا أردت بناء برمجيات خاصة تتطلب كتابة كود بلغة Kotlin أو Swift، أو احتجت إلى التحكم الكامل في ملفات النظام الأصلية لـ Android وiOS. هنا يصبح React Native CLI الخيار الأنسب. يمنحك هذا المسار حرية مطلقة، لكنه يفرض عليك في المقابل ضبط أدوات بناء متعددة وإدارتها بنفسك.
لا تشغل بالك بهذا القرار في يومك الأول. ابدأ مع Expo لتستوعب كيفية بناء الشاشات وإدارة البيانات، وعندما تظهر حاجة تقنية تتجاوز إمكانياته، يمكنك الانتقال إلى CLI بسهولة. فتعلم التطوير لا يعني تحميل كل الأدوات دفعة واحدة، بل استدعاء الأداة المناسبة في وقتها.
الأدوات الأساسية
1. Node.js وnpm
تمثل Node.js المحرك الذي يشغل كود JavaScript خارج المتصفح، بينما تعمل npm كمدير للحزم يتيح لك تثبيت المكتبات وتحديثها. تعتمد كافة مشاريع React Native على Node لتشغيل خوادم التطوير وأوامر البناء.
احرص على تحميل نسخة الدعم طويل الأجل (LTS) من الموقع الرسمي لـ Node.js لمعاملاتها المستقرة. وبعد اكتمال التثبيت، افتح موجه الأوامر (Terminal) واكتب الأمرين التاليين للتأكد من جاهزيتهما:
node -vللتحقق من رقم إصدار Node.js.npm -vللتحقق من رقم إصدار npm.
ظهور أرقام الإصدارات يعني أن كل شيء يعمل بسلاسة. وإذا اقترح النظام تحديث مدير الحزم، يمكنك إجراء التحديث للعمل مع أحدث التحسينات.
2. محرر Visual Studio Code
يتميز محرر Visual Studio Code بكونه مجانيًا، وسريعًا، ومتوافقًا مع أدوات تطوير الهواتف. أضف ملحق React Native من متجر الإضافات لتسهيل قراءة الكود، واستعن بملحقات تنسيق الأكواد التلقائية للحفاظ على نظافة ملفاتك.
احرص دائمًا على فتح مجلد المشروع الرئيسي مباشرة داخل المحرر؛ فهذا يضمن عمل ميزات الإكمال التلقائي واكتشاف الأخطاء بدقة. وتجنب فتح مجلد node_modules كمسار رئيسي، فهو مجرد مستودع للمكتبات المحملة وليس المكان الذي تكتب فيه كودك.
3. نظام حفظ النسخ Git
يعمل نظام Git بمثابة ذاكرة للمشروع؛ يحفظ سجل التعديلات ويسمح لك بالعودة إلى أي نقطة زمنية متى ما حدث خطأ غير متوقع. تبرز أهميته حتى أثناء التعلم، لا سيما بعد إضافة ميزة جديدة أو إعادة هيكلة الكود.
بعد تثبيت Git، يمكنك بدء تتبع المشروع عبر تنفيذ الأوامر التالية داخل مجلد التطبيق:
git initلإنشاء مستودع محلي جديد.git add .لتجهيز التغييرات الحالية للحفظ.
ثم اكتب أمر الحفظ مع رسالة توضيحية تعبر عن الخطوة التي أنجزتها، مثل: git commit -m "إضافة الشاشة الرئيسية". هذه العادة البسيطة ستوفر عليك ساعات من البحث عندما تحاول معرفة أسباب خطأ ظهر فجأة.
4. الهاتف أو المحاكي
يمكنك معاينة التطبيق عبر هاتف حقيقي، أو استخدام محاكي افتراضي على جهازك. يُفضل استخدام الهاتف الفعلي في البداية؛ لأنه يعطيك انطباعًا واقعيًا عن أحجام العناصر وسرعة الاستجابة وسلاسة اللمس.
يتطلب تشغيل المحاكي الافتراضي لنظام Android تثبيت برنامج Android Studio وإعداد الأجهزة الافتراضية، في حين يحتاج محاكي iOS Simulator إلى جهاز Mac ووجود بيئة Xcode. لذا، إذا كنت تعمل على نظام Windows، فإن تشغيل Expo Go على هاتفك الذكي هو المسار الأسرع والأكثر فاعلية.
إنشاء مشروع React Native الأول
افتح موجه الأوامر داخل مجلد عملك المعتاد (مع تجنب مجلدات النظام المحمية)، واختر اسمًا للمشروع يتكون من حروف إنجليزية وأرقام دون مساحات، ثم نفذ الأمر:
npx create-expo-app@latest my-first-app
قد يتطلب التنزيل دقائق معدودة لبناء المجلدات وتنزيل المكتبات. فور انتهاء العملية، انتقل إلى مجلد المشروع:
cd my-first-app
ثم ابدأ تشغيل خادم التطوير:
npm start
ستظهر لك لوحة أدوات التطوير داخل النافذة مرفقة برمز استجابة سريعة (QR Code). هذه اللوحة هي الجسر الذي يربط بين كودك على الحاسوب والتطبيق على الهاتف.
تشغيل التطبيق على الهاتف
التشغيل عبر Expo Go
- حمل تطبيق Expo Go من متجر التطبيقات الخاص بهاتفك.
- تأكد من اتصال الحاسوب والهاتف بنفس شبكة Wi-Fi.
- افتح تطبيق Expo Go وافحص رمز QR الظاهر على شاشة الحاسوب.
- انتظر لحظات حتى تكتمل عملية التجميع، ثم تفاعل مع الواجهة الظاهرة على هاتفك.
لن تحتاج لتسجيل حسابات مطورين رسمية في هذه المرحلة. لكن إذا تعثر اتصال الهاتف بالحاسوب بسبب إعدادات جدار الحماية أو اختلاط الشبكات، شغّل المشروع بوضع النفق:
npx expo start --tunnel
نشئ هذا الأمر نقطة وصول عبر الإنترنت تتجاوز عوائق الشبكات المحلية، مما يضمن وصول التحديثات إلى هاتفك بسهولة.
التشغيل على محاكي Android
شغّل جهازك الافتراضي من داخل Android Studio، وبعد أن يكتمل إقلاع النظام الافتراضي، نفذ الأمر التالي في موجه الأوامر لديك:
npx expo start --android
سيقوم الخادم برصد المحاكي وتثبيت التطبيق عليه تلقائيًا. وإذا تعذر التعرف على الجهاز، تأكد من تفعيل خيارات المحاكاة الافتراضية (Virtualization) من إعدادات BIOS في جهازك.
التشغيل على محاكي iOS Simulator
يتطلب هذا الخيار العمل على نظام macOS. افتح تطبيق Xcode لتأكيد تثبيت المكونات البرمجية، ثم شغّل المحاكي المفضل لديك، ونفذ الأمر:
npx expo start --ios
تذكر أن محاكي iOS لا يعمل على أنظمة Windows أو Linux بسبب قيود التطوير الخاصة بشركة Apple.
فهم هيكل المشروع
ملفات المدخل الأساسية
تعتمد المشاريع الحديثة على نظام Expo Router، حيث تجد مجلدًا باسم app يحتوي على شاشات التطبيق. أما في القوالب التقليدية، فستجد ملفًا رئيسيًا باسم App.js أو App.tsx بكونه نقطة الانطلاق التي يرسم التطبيق واجهته الأولى منها.
افتح هذا الملف، وغير النص الموجود داخل وسم الرسالة الترحيبية، ثم احفظ التغييرات. ستلاحظ أن الشاشة على هاتفك تحدثت في التو واللحظة دون الحاجة لإعادة تشغيل المشروع.
ملف package.json
يمثل هذا الملف الهوية البرمجية لمشروعك؛ فهو يحتوي على الاسم، والإصدار، وأوامر التشغيل، وقائمة المكتبات الخارجية. وعندما ترغب في إضافة مكتبة جديدة، استخدم الأمر المخصص من Expo:
npx expo install اسم-الحزمة
يضمن لك هذا الأمر اختيار نسخة من المكتبة تتوافق تمامًا مع إصدار Expo الذي تعمل عليه، مما يجنبك التعارضات البرمجية المفاجئة.
ملف app.json
يختص هذا الملف بضبط الإعدادات العامة للتطبيق؛ مثل الاسم الذي يظهر تحت الأيقونة على شاشة الهاتف، والصورة الترحيبية (Splash Screen)، واتجاه الشاشة، والأذونات التي يطلبها التطبيق عند التشغيل.
- أساسيات React Native: إعداد البيئة والأدوات (أنت هنا)
- مكونات واجهة المستخدم الأساسية في React Native
- التنقل بين الشاشات وإدارة الحالة
- بناء واجهات تفاعلية باستخدام المكونات المتطورة
- الاتصال بالواجهة الخلفية واستهلاك APIs
- النشر والتوزيع على متاجر التطبيقات