شارك المقالة
تشغيل Flutter على الويب وتشخيص البناء وCORS

تشغيل Flutter على الويب وتشخيص البناء وCORS

تشغيل Flutter على الويب بأوامر SDK المدعومة، وفصل أخطاء renderer عن CORS والموارد والمسارات عند النشر.

تشغيل Flutter على الويب بأوامر SDK المدعومة، وفصل أخطاء renderer عن CORS والموارد والمسارات عند النشر.

استخدم أوامر الإصدار المثبت

ابدأ بـflutter devices ثم flutter run -d chrome للتطوير وflutter build web للنشر. خيار –web-renderer html في الأدلة القديمة لا يصلح افتراضًا لكل SDK حديث؛ راجع flutter run –help والخيارات الحالية. اختيار renderer لا يمنح التطبيق تجاوز CORS ولا يغير قواعد خادم API.

اختبار النشر يختلف عن التشغيل المحلي

ملفات build/web تحتاج استضافة HTTP أو HTTPS مناسبة ومسار base href مطابقًا لمكان النشر. اختبر فتح route مباشرة وإعادة تحميلها، وموقع assets والروابط المطلقة. لا تستخدم dart:io أو plugin بلا تنفيذ ويب في المسار نفسه. إذا فشل API افحص حالة HTTP وCORS وHTTPS من الخادم، ولا تعالج الخطأ بتعطيل أمان متصفح المستخدم.

تجهيز الهدف للتطوير

تأكد أن نسخة Flutter تدعم هدف الويب وأن المتصفح يظهر في flutter devices، ثم جرب مشروعًا صغيرًا بالأمر الافتراضي. خطأ في مشروع قديم لا يعني أن كل إعدادات renderer يجب تغييرها؛ قد تأتي المشكلة من plugin أو استيراد dart:io أو ملف أصل غير معرف. اقرأ أول رسالة compile أو console وحدد الطبقة قبل تطبيق خيار من دليل أقدم. احتفظ بإصدار SDK وملف القفل لتعيد التجربة نفسها.

الاستضافة والمسارات

بعد flutter build web انشر المخرجات كوحدة واحدة على خادم يرسل أنواع محتوى صحيحة للملفات، واختبر base href إن كان التطبيق تحت مسار فرعي. عند استخدام routing يحتاج الخادم سياسة مناسبة لطلبات الصفحات التي ليست ملفات فعلية، وإلا قد تعمل الصفحة الرئيسية ويعيد تحديث رابط داخلي 404. لا تستبدل كل 404 بالصفحة الرئيسية على مستوى موقع WordPress كله من أجل تطبيق فرعي؛ خصص قواعد المسار الخاص به.

الشبكة وCORS

إذا أرسل المتصفح طلبًا لخادم آخر فإن السماح بالوصول يقرره الخادم وسياسة CORS، وليس عنصر Flutter الذي يعرض النتيجة. راجع أصل الطلب وطرق HTTP والـheaders والمصادقة وpreflight إن وجد، وراجع mixed content عندما تكون الصفحة HTTPS والخدمة HTTP. لا تطلب من المستخدم تعطيل حماية المتصفح، ولا تضع مفتاحًا خاصًا لخادم في JavaScript لتجاوز خطأ مصادقة. اعرض حالة فشل قابلة للفهم وأبق تفاصيل التشخيص غير الحساسة للتطوير.

اختبار الإصدار المنشور

تجربة debug المحلية ليست بديلًا لفتح مخرجات release من عنوان الاستضافة الفعلي. جرب متصفحًا مدعومًا وشاشة ضيقة وroute مباشرة وملف صورة وطلب شبكة ومؤشر تحميل، ثم حدّث نسخة التطبيق واختبر ما إذا ظهرت موارد قديمة بسبب الكاش. ضع سياسة نشر متسقة للملفات وراجع إعدادات الاستضافة بدل مسح بيانات المتصفح لكل المستخدمين. إذا كانت الميزة تعتمد plugin أصليًا فاختر تنفيذ ويب أو بديلًا واضحًا، ولا تعد أن أمر تشغيل واحدًا سيحل اختلاف قدرات المنصات.

صفحة تحميل وموارد الإصدار

افحص عنوان الصفحة وأيقونتها وملفات الخطوط والصور في البناء المنشور، وتأكد أن خادمك لا يرسل HTML بدل ملف JavaScript بسبب قاعدة إعادة كتابة واسعة. راجع نوع المحتوى وحالة كل طلب فاشل قبل تعديل Dart. عند نشر إصدار جديد احتفظ بتطابق ملفات bootstrap والموارد ولا تنقل جزءًا فقط من build/web ثم تختبر في متصفح يحمل كاش نسخة سابقة. إذا احتجت تطبيقًا ضمن موقع قائم فاجعل قواعد المسار والتخزين المؤقت خاصة به كي لا تؤثر في صفحات الموقع الأخرى أو روابطها الأساسية.

مراجعة أخيرة للتطبيق

لا ترفع مفاتيح خدمة خاصة ضمن build/web؛ كل ملف عميل منشور يمكن للمستخدم تنزيله أو فحصه من المتصفح.

مثال الشفرة بعد المراجعة

اقرأ التعليقات ومتطلبات الإعداد قبل النقل إلى مشروعك. أمثلة الواجهات ذات main مستقلة، أما العقود والمقاطع الأصلية وملفات الإعداد فموضح نطاقها داخل المثال.

flutter --version
flutter devices
flutter run -d chrome
flutter build web
# Serve the resulting build/web directory through an HTTP(S) host.
# For a subdirectory deployment, configure its base href explicitly.
# Do not disable browser security to solve an API CORS error.

مرجع للتنفيذ

راجع التوثيق الخاص بهذا الموضوع وطابق إعداداته مع إصدار أدوات مشروعك. اختبر السلوك المستهدف وحالة الفشل قبل إدماج المثال في تطبيق منشور.

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع