شارك المقالة
تحديد حجم نافذة Flutter Desktop باستخدام desktop_window

تحديد حجم نافذة Flutter Desktop باستخدام desktop_window

شرح تحديد حجم نافذة Flutter Desktop وحدودها الدنيا والعليا باستخدام desktop_window، مع مثال مكتمل وتخطيط متجاوب وحل أخطاء الإضافات.

لتحديد حجم نافذة تطبيق Flutter على سطح المكتب، يمكنك استخدام desktop_window لضبط الحجم الابتدائي والحد الأدنى والأقصى. أما تغيير توزيع المحتوى داخل النافذة فيتم بأدوات التخطيط مثل LayoutBuilder. المثال التالي يوضح الفرق ويشغّل التطبيق فعلًا، بدل الاكتفاء باستدعاء يحدد الحد الأدنى دون runApp.

الحجم الابتدائي ليس الحد الأدنى

setWindowSize يطلب حجم النافذة الحالي، بينما setMinWindowSize يمنع التصغير تحت حد معين، وsetMaxWindowSize يحدد السقف. استدعاء الحد الأدنى لا يعني أن النافذة ستفتح بالحجم نفسه ولا يمنع تكبيرها. حدد كل قيمة وفق حاجتك، ولا تجعل الحد الأدنى أكبر من الأقصى أو من مساحة عرض المستخدم المتاحة.

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

تثبيت desktop_window ومتطلبات المثال

flutter pub add desktop_window:0.4.4

راجعت desktop_window 0.4.4، ويتطلب بحسب pubspec الخاص به Flutter 3.41 أو أحدث وDart 3.11 أو أحدث. الاختبار المحلي استخدم Flutter 3.44.6 وDart 3.12.2. افحص بيئة مشروعك قبل تغيير القيد، ثم أعد تشغيل التطبيق بالكامل بعد إضافة المكتبة لأنها تتضمن تكاملًا أصليًا.

لا تخلط توثيق desktop_window مع window_manager؛ فهما حزمتان مختلفتان بواجهات ومتطلبات مختلفة. عند المراجعة كان window_manager 0.6.0 يتطلب Flutter 3.47 وDart 3.13 مع تغيير في واجهته، ولذلك نقل استدعاءات إصدار قديم إليه بلا قراءة دليل الترقية قد لا يعمل. لا تحتاج إلى تثبيت الحزمتين لتنفيذ المثال الحالي.

مثال كامل لتطبيق الحدود بعد الإطار الأول

احفظ واجهة DesktopDemo الموجودة في درس تشغيل Flutter Desktop في lib/main.dart، واحفظ الملف التالي باسم lib/window_main.dart. يستورد المثال الواجهة المشتركة بدل نسخها؛ شغله باستخدام flutter run -d macos -t lib/window_main.dart على Mac، مع استبدال اسم الجهاز للأنظمة الأخرى.

يهيئ main ربط Flutter، ثم يشغل الواجهة. بعد الإطار الأول يطبق الحدود على منصة سطح مكتب مدعومة فقط. معالجة PlatformException وMissingPluginException تبين فشل الإعداد أثناء التطوير، ولا تعني أن النافذة حصلت على الحجم المطلوب إذا رفض النظام العملية. افحص النتيجة الفعلية على نظامك.

import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:desktop_window/desktop_window.dart';
import 'main.dart' show DesktopDemo;

bool supportsDesktopWindow(TargetPlatform platform) => switch (platform) {
  TargetPlatform.windows || TargetPlatform.macOS || TargetPlatform.linux => true,
  _ => false,
};

Future<void> configureDesktopWindow() async {
  await DesktopWindow.setMinWindowSize(const Size(640, 480));
  await DesktopWindow.setMaxWindowSize(const Size(1600, 1000));
  await DesktopWindow.setWindowSize(const Size(1000, 700));
}

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(const DesktopDemo());
  if (!kIsWeb && supportsDesktopWindow(defaultTargetPlatform)) {
    WidgetsBinding.instance.addPostFrameCallback((_) async {
      try {
        await configureDesktopWindow();
      } on PlatformException catch (error) {
        debugPrint('Window configuration failed: ${error.code}');
      } on MissingPluginException {
        debugPrint('Restart the desktop app after adding the plugin.');
      }
    });
  }
}

تغيير الحجم لاحقًا وإزالة الحد الأقصى

await DesktopWindow.setWindowSize(const Size(900, 650));
await DesktopWindow.resetMaxWindowSize();

يمكن استدعاء تغيير الحجم من تفاعل داخل واجهة سطح المكتب، بعد استيراد الحزمة والتحقق من المنصة. resetMaxWindowSize يزيل القيد الأعلى الذي فرضته الحزمة؛ لا تحذف الحد الأدنى إذا كانت الواجهة تعتمد عليه. كما لا تعيد تطبيق الحجم الافتراضي عند كل build، لأن ذلك قد يقاوم محاولات المستخدم تعديل النافذة.

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

ماذا عن الويب والهاتف؟

هذه الإضافة مخصصة للنوافذ الأصلية على Windows وmacOS وLinux. نافذة المتصفح ليست النافذة الأصلية التي تديرها الحزمة، ولذلك يمنع المثال استدعاءها في الويب أو الهاتف. على هذه المنصات غيّر التخطيط داخل القيود المتاحة بدل محاولة فرض أبعاد نافذة سطح مكتب.

إذا بقي المحتوى مقصوصًا بعد ضبط الحجم، راجع قيود الصفوف والأعمدة والعناصر ذات العرض الثابت. استخدم Expanded وFlexible والتمرير حيث يناسب المحتوى، واجعل نقاط التحول مرتبطة بعرض المساحة الفعلية. تغيير النافذة وحده لا يصلح RenderFlex overflow داخل تصميم ضيق.

قائمة اختبار قبل اعتماد المثال

جرب الفتح بالحجم الابتدائي، ثم التصغير إلى الحد الأدنى والتكبير إلى الحد الأقصى. تأكد من إمكانية الوصول إلى أزرار الإغلاق والعودة والحفظ ومن عدم حجبها على شاشة صغيرة. اختبر أيضًا التشغيل البارد بعد إضافة Plugin، لأن hot reload لا يعيد بناء التكامل الأصلي.

اجتاز الكود تحليل Flutter واختبارات مع قناة منصة محاكاة تتحقق من ترتيب استدعاءات الحدين ثم الحجم الابتدائي. هذه الاختبارات لا تثبت تطبيق القيود بواسطة كل مدير نوافذ فعلي؛ يلزم اختبار النسخة الأصلية على الأنظمة التي ستوزع لها التطبيق.

للحصول على ملف main.dart الذي يحتوي DesktopDemo، راجع تشغيل Flutter على سطح المكتب: Windows وmacOS وLinux ثم شغّل نقطة window_main.dart بدل نقطة التشغيل الافتراضية.

المصادر والمراجع

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

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