أهلاً بالجميع، إذا وصلت إلى هذا القسم، فمن المرجح أنك أكملت الدروس السابقة. إن لم تكن قد فعلت ذلك، فارجع أولاً لقراءة دليلنا السابق: البدء مع NativePHP – تثبيت Laravel – FoxDevelop. سنقوم الآن بشرح خطوات بناء أول مشروع لنا.
سنبدأ من الصفر ونقوم بإعداد مشروع جديد تمامًا:
أنشئ مجلدًا فارغًا على جهاز الكمبيوتر لحفظ ملفات المشروع، مثال: D:\phpproject
افتح موجه الأوامر CMD في هذا المسار بسرعة: اكتب cmd مباشرة في شريط العناوين الخاص بالمجلد ثم اضغط على مفتاح Enter، وسوف تفتح نافذة الأوامر وتنتقل إلى المسار تلقائيًا.
قم بتشغيل الأوامر المدرجة أدناه:
composer create-project --prefer-dist nativephp/mobile-starter my-app
cd my-app
php artisan native:jumpملاحظة سريعة لاستكشاف الأخطاء وإصلاحها (تخط هذا القسم إذا كنت تستخدم إصدار PHP 8.3)
composer create-project --prefer-dist nativephp/mobile-starter my-app
Creating a "nativephp/mobile-starter" project at "./my-app"
Installing nativephp/mobile-starter (1.0.4)
- Downloading nativephp/mobile-starter (1.0.4)
- Installing nativephp/mobile-starter (1.0.4): Extracting archive
Created project in D:\phpproject\my-app
> @php -r "file_exists('.env') || copy('.env.example', '.env');"
Loading composer repositories with package information
Updating dependencies
Your requirements could not be resolved to an installable set of packages.
Problem 1
- Root composer.json requires nativephp/mobile ^3.0 -> satisfiable by nativephp/mobile[3.0.0, ..., 3.3.5].
- nativephp/mobile[3.0.0, ..., 3.3.5] require php ^8.3 -> your php version (8.2.31) does not satisfy that requirement.Code language: JavaScript (javascript)يحدث هذا الخطأ لأن إصدار PHP المحلي لديك هو 8.2، ويلزم الترقية إلى PHP 8.3 لمتابعة العمل.
https://windows.php.net/download#php-8.3
انتقل إلى هذه الصفحة لتنزيل PHP 8.3. يمكن لمستخدمي نظام Windows 64 بت تنزيل الحزمة الموجودة أدناه مباشرة:
https://downloads.php.net/~windows/releases/archives/php-8.3.31-nts-Win32-vs16-x64.zip
بعد انتهاء التنزيل، قم باستخراج جميع الملفات داخل المسار D:\php8.3. يمكنك اختيار مسار مجلد آخر، ولكن احرص على استخدام الأحرف الإنجليزية فقط.
بعد الانتهاء من الاستخراج، أعد تسمية ملف الإعدادات:
قم بتغيير اسم php.ini-development إلى php.ini
افتح ملف php.ini وقم بإلغاء التعليق عن الأسطر عن طريق حذف الفاصلة المنقوطة الموجودة في بداية كل سطر؛
احذف علامات التعليق (الفواصل المنقوطة) لجميع العناصر المذكورة هنا (خطوة ضرورية للغاية):
extension_dir = "ext"
extension=curl
extension=gd
extension=mbstring
extension=mysqli
extension=pdo_mysql
extension=zip
extension=openssl
extension=fileinfo
extension=sqlite3
extension=pdo_sqliteCode language: JavaScript (javascript)قم بتحديث متغيرات البيئة في النظام، واستبدل المسار القديم D:\php8.2 بـ D:\php8.3.
تحقق من تثبيت PHP باستخدام الأمر php -v. إذا كان الإصدار صحيحًا، فتابع إعداد المشروع.
متابعة إنشاء مشروع NativePHP للهواتف المحمولة
قم الآن بتشغيل أوامر التثبيت مرة أخرى:
composer create-project --prefer-dist nativephp/mobile-starter my-app
cd my-appعند نجاح التثبيت بشكل كامل، لن تظهر أي رسائل خطأ باللون الأحمر في نافذة الأوامر.
لإجراء الاختبار على هاتف فعلي، قم أولاً بتوصيل الجهاز بالكمبيوتر عبر منفذ USB، ثم قم بتفعيل خيارات المطور وتصحيح أخطاء USB على الهاتف.
استخدم الأمر التالي لإجراء الاختبار بسرعة على الجهاز الفعلي (تشغيل سريع على الجهاز الفعلي: قم بتثبيت تطبيق Jump على هاتفك، ثم امسح رمز الاستجابة السريعة للاتصال وإجراء التصحيح دون الحاجة لترجمة ملف APK بالكامل):
php artisan native:jumpCode language: CSS (css)إذا لم يكن لديك جهاز محمول فعلي، استخدم الأمر البديل أدناه للاختبار على المحاكي:
php artisan native:serve : للمعاينة على سطح المكتب أو الاختبار على المحاكي (سيفتح نافذة تطبيق منفصلة على جهاز الكمبيوتر)
عند عمل جميع الوظائف بشكل سليم، سترى ناتج مشابه لما يلي بعد تشغيل الأمر php artisan native:jump
php artisan native:jump
خادم NativePHP Jump
خادم Laravel ……………………………………………………………………. http://127.0.0.1:8000
تهيئة Laravel ………………………………………………………………… اكتملت خلال 0.42 ثانية (استجابة HTTP 200)
افتح الرابط http://127.0.0.1:8000 في المتصفح لعرض محتوى التطبيق قيد التشغيل.
