نسخه فلاتر 3.47 منتشر شده است و آپدیتهای جذاب جدیدی را به همراه دارد. امروز، انتشار نسخه 1.0 پکیجهای مستقل material_ui و cupertino_ui معرفی میشود. این یک نقطه عطف بزرگ است که سیستمهای طراحی را از هسته اصلی SDK جدا میکند.
همچنین در این نسخه، عملکرد و ابزارهای فلاتر در سراسر پلتفرمها بهبود یافته است. این آپدیت، موتور رندر Impeller را بهطور پیشفرض به دسکتاپ میآورد، پایپلاینها را برای iOS، macOS و Xcode 27 آماده میکند و ویژگی Flutter Widget Previews را به نسخه پایدار (Stable) ارتقا میدهد.
برای شروع کار، کافی است دستور flutter upgrade را در ترمینال اجرا کنید، یا ادامه این مقاله را بخوانید تا با تغییرات مهم این نسخه بیشتر آشنا شوید.
انتخاب مسیر رابط کاربری دلخواه شما
اولین قدم به سمت یک معماری جداگانه (Decoupled) در فلاتر برداشته شده است: طراحیهای متریال (Material) و کاپوئیتینو (Cupertino) اکنون بهعنوان پکیجهای مستقل در دسترس هستند!
یکی از بزرگترین نقاط قوت فلاتر، توانایی آن در رندر کردن بینقص ویجتهای Material و Cupertino است. با این حال، از آنجا که این کتابخانههای طراحی از نظر تاریخی مستقیماً درون هسته اصلی SDK قرار داشتند، روند توسعه آنها را کُند میکرد و مشارکت در آنها یا بهروز نگه داشتنشان را دشوار میساخت.
اگرچه در این نسخه کتابخانههای اصلی SDK همچنان شامل این موارد هستند، اکنون میتوانید از پکیجهای مستقل material_ui و cupertino_ui استفاده کنید که رسماً به نسخه 1.0 در pub.dev رسیدهاند.
جدا کردن نقشهراه طراحیها (Opt-in)
با انتخاب سیستمهای طراحی جداگانه، کنترل کامل نقشهراه طراحی در دست شما قرار میگیرد. از آنجا که material_ui و cupertino_ui اکنون در pub.dev قرار دارند، میتوانند رفع باگها و کامپوننتهای جدید را در برنامههای هفتگی مستقل از انتشارهای فصلی Flutter SDK منتشر کنند.
آموزش استفاده از کلاود کد در برنامه نویسی موبایل
جدا کردن سیستمهای طراحی مزایای زیر را به همراه دارد:
- امکان استفاده از جدیدترین سبکهای ویجت Cupertino و Material بدون نیاز به ارتقای کامل نسخه Flutter SDK.
- اعمال سریعتر و مکررتر مشارکتها و آپدیتها.
- فراهم کردن زمینه برای یک کاتالوگ ویجتهای هسته فلاتر با سبک خنثی (Style-neutral) که ساخت سیستمهای طراحی سفارشی را در آینده آسانتر میکند.
نحوه مهاجرت به پکیجهای جدید
برای مهاجرت پروژه به پکیجهای مستقل جدید، دستور زیر را اجرا کنید:
dart fix --apply --code=migrate_design_widgets
این ابزار بهطور خودکار importهای شما را از package:flutter/material.dart و package:flutter/cupertino.dart به پکیجهای مستقل جدید بهروزرسانی میکند.
نکته: اگر ابزار مهاجرت در بهروزرسانی pubspec.yaml با مشکل مواجه شد (یک باگ شناختهشده در روزهای اولیه)، میتوانید با اجرای دستی flutter pub add material_ui (و cupertino_ui در صورت استفاده) مشکل را برطرف کرده و سپس دوباره دستور dart fix --apply را اجرا کنید.
کتابخانههای طراحی اصلی درون هسته SDK، برای منسوخ شدن رسمی در انتشار نسخه پایدار پاییز (نوامبر) برنامهریزی شدهاند. اگر در حال مهاجرت یک پکیج در اکوسیستم هستید، این انتقال به پکیجهای مستقل را بهعنوان یک آپدیت اصلی (Major Release) در نظر بگیرید.
تسهیل فرایند مهاجرت
برای تسهیل این انتقال و پر کردن شکاف اکوسیستم، پکیجهای material_ui و cupertino_ui دارای ابزارهای مهاجرت هستند. کلاس MaterialUiCompatibilityBridge به اپلیکیشن اجازه میدهد تا بلافاصله به پکیجهای مستقل مهاجرت کند، حتی اگر برخی از وابستگیهای پکیج شما هنوز از importهای قدیمی هسته SDK استفاده کنند.
به عنوان مثال، میتوانید اپلیکیشن خود را درون این پل سازگار قرار دهید:
import 'package:material_ui/material_ui.dart';
void main() {
runApp(const MyApp());
}
class MyApp extends StatelessWidget {
const MyApp({super.key});
@override
Widget build(BuildContext context) {
return MaterialApp(
theme: ThemeData(
colorScheme: ColorScheme.fromSeed(seedColor: const Color(0xFF6750A4)),
),
builder: (BuildContext context, Widget? child) {
return MaterialUiCompatibilityBridge(child: child!);
},
home: const HomeScreen(),
);
}
}
جداسازی محلیسازیها (Localizations)

به عنوان بخشی از این انتقال، پکیج flutter_localizations نیز جدا شده است. delegateهای محلیسازی و رشتههای ترجمهشده برای ویجتهای Material و Cupertino اکنون به ترتیب در package:material_ui و package:cupertino_ui قرار دارند.
کد قدیمی (Before):
import 'package:flutter_localizations/flutter_localizations.dart';
import 'package:flutter/material.dart';
// ...
localizationsDelegates: const <LocalizationsDelegate<dynamic>>[
GlobalCupertinoLocalizations.delegate,
GlobalMaterialLocalizations.delegate,
GlobalWidgetsLocalizations.delegate,
],
کد جدید (After):
import 'package:material_ui/material_ui.dart';
// ...
localizationsDelegates: GlobalMaterialLocalizations.delegates,
تنظیم localizationsDelegates روی GlobalMaterialLocalizations.delegates اکنون شامل delegateهای Cupertino و Widgets نیز میشود و تنظیمات شما را سادهتر میکند.
باز شدن مسیر برای مشارکتهای جامعه کاربری
با توقف موقت مشارکتها در کتابخانههای Material و Cupertino در ماه آپریل، یک مهاجرت بدون اصطکاک تضمین شده است. کتابخانههایی که اکنون در material_ui و cupertino_ui منتظر شما هستند، همان کتابخانههایی هستند که پیشتر از آنها استفاده میکردید.
اکنون که آماده رفع این توقف هستیم، میتوانید منتظر رفع باگها و امکانات بیشتری بهطور منظم در پکیجهای جدید باشید. انتشارها در حال حاضر بهصورت هفتگی برنامهریزی شدهاند و این پکیجها رسماً برای مشارکتهای جامعه کاربری باز میشوند.
آمادگی برای موج بعدی آپدیتهای اپل
با توجه به انتشار Xcode 27، iOS 27 و macOS 27 در این پاییز، تمرکز زیادی روی اطمینان از آمادگی فلاتر برای این آپدیتها صورت گرفته است. برای اطمینان از اینکه کاربران در روز اول با مشکلاتی مواجه نمیشوند، توصیه میشود اپلیکیشنهای خود را همین حالا در برابر نسخههای بتای اپل تست کنید.
الزام چرخه حیات UIScene
iOS 27 SDK اکنون چرخه حیات UIScene را برای تمام اپلیکیشنهای مبتنی بر UIKit الزامی میکند. اپلیکیشنهایی که با Xcode 27 ساخته میشوند و از UIScene استفاده نمیکنند، در زمان استارتاپ با شکست مواجه میشوند.
برای بیشتر اپلیکیشنها، Flutter CLI این مهاجرت را بهطور خودکار در زمان build انجام میدهد.
با این حال، اگر کدهای نیتیو سفارشی در AppDelegate خود دارید یا از پلاگینهایی استفاده میکنید که هنوز به چرخه حیات قدیمی برنامه وابستهاند، مهاجرت دستی لازم است. در این موارد، باید راهنمای UIScene/Delegate Adoption را دنبال کنید.
حذف تدریجی پشتیبانی از مکبوکهای اینتلی
هماهنگ با انتقال اپل به Apple Silicon، فلاتر پشتیبانی از مکهای مبتنی بر Intel را کاهش میدهد. اجرای تستهای خودکار روی سختافزار Intel غیرفعال شده است و Flutter CLI اکنون هنگام ساخت روی میزبانهای Intel یا هدفگیری معماری دوگانه، هشدارهایی را چاپ میکند. این هشدارها در نسخههای آینده تبدیل به خطا (Error) خواهند شد.
شما میتوانید با اجرای دستور flutter config --enable-macos-arm64-only بلافاصله ساخت اپلیکیشنهای macOS فقط با معماری ARM64 را فعال کنید.
پیشرفت Swift Package Manager
جامعه کاربری پیشرفت شگفتانگیزی در انتقال به Swift Package Manager داشته است، بهطوری که اکنون ۹۲ مورد از ۱۰۰ پلاگین برتر iOS مهاجرت کردهاند. اگر پیشتر Swift Package Manager را خاموش کردهاید، میتوانید با اجرای flutter config --enable-swift-package-manager دوباره آن را امتحان کنید.
از آنجا که CocoaPods اکنون در حالت نگهداری (Maintenance mode) قرار دارد، پلاگینهایی که به SwiftPM مهاجرت نکنند در نهایت کار کردن خود را متوقف میکنند. پلاگینهای مهاجرتنکرده همچنین امتیاز کمتری در pub.dev دریافت میکنند.
تنظیم مسیر به سمت پیشفرض بودن Wasm در وب
تلاشهای فعالی برای فعالکردن پیشفرض WebAssembly (Wasm) برای اپلیکیشنهای وب فلاتر در جریان است تا عملکردی شبیه به نیتیو در مرورگر ارائه شود.
اگر هنوز اپلیکیشنهای وب خود را با Wasm تست نکردهاید، میتوانید با اضافه کردن فلگ --wasm به دستور ساخت نسخه نهایی (Release)، آن را فعال کنید:
flutter build web --release --wasm
در آمادهسازی برای این انتقال، به خاطر داشته باشید که Wasm نیازمند مهاجرت پایگاه کد شما به پکیج جدید JS interop (package:web) است، زیرا کتابخانه قدیمی dart:html پشتیبانی نمیشود. ارتقای وابستگیهای پکیج پروژه اغلب این مشکلاتInterop قدیمی را بهطور خودکار حل میکند.
برای کمک به مقیاسپذیری اپلیکیشنهای بزرگتر وب، این نسخه همچنین از بارگذاری معوق (Deferred loading) روی Wasm بهصورت آزمایشی پشتیبانی میکند. این قابلیت که با یک فلگ در کانال main در دسترس است، به شما امکان میدهد اپلیکیشن Wasm خود را به ماژولهای کوچکتر و با بارگذاری تنبل (Lazy-loaded) تقسیم کنید:
flutter build web --release --wasm --enable-wasm-deferred-loading
رسیدن گرافیک مدرن به دسکتاپ با Impeller
تعهدی برای تبدیل پلتفرمهای دسکتاپ به اهداف درجهیک برای گرافیک با عملکرد بالا وجود دارد. در فلاتر 3.47، Impeller به موتور رندر پیشفرض برای macOS، Windows و Linux تبدیل میشود.
Impeller موتور رندر نسل بعدی فلاتر است که از پایه برای جایگزینی Skia ساخته شده است. با هدفگیری APIهای مدرن سختافزاری (مانند Metal در macOS و Vulkan در Windows و Linux)، Impeller مجموعه ثابتی از شیدرها را در زمان build کامپایل میکند به جای اینکه آنها را در زمان اجرا (Runtime) کامپایل کند. این کار لرزشهای کوتاه که به آن jank میگویند را در اولین پخش یک انیمیشن از بین میبرد و انتقالهای نرم و یکدستی را از همان فریم اول ارائه میدهد.
اگر نیاز به غیرفعال کردن موقت Impeller دارید، این مراحل را دنبال کنید:
- macOS: مقدار
FLTEnableImpellerرا درInfo.plistروی false قرار دهید. - Windows: عبارت
project.set_impeller_switch(flutter::ImpellerSwitch::Disabled)را درmain.cppاضافه کنید. - Linux: تابع
fl_dart_project_set_enable_impeller(project, FALSE)را درmy_application.ccفراخوانی کنید.
این گزینههای جایگزین (Fallback) در نسخههای آینده حذف خواهند شد. همچنین، ویژگی Wide Gamut Color اکنون بهطور پیشفرض در macOS فعال است و رنگهای غنی، زنده و دقیقی را روی سختافزارهای پشتیبانیشنده ارائه میدهد.
پیشرفت آزمایشی پنجرههای چندگانه (Multi-window)

لینوکس و ویندوز اکنون از پنجرههای popup پشتیبانی میکنند که به شما امکان ساخت منوهای کانتکست نیتیو و پالتهای ابزار را میدهد.
همچنین اکنون میتوانید با استفاده از windowHandle در کنترلرهای خاص پلتفرم، یک اشارهگر مستقیم به پنجره نیتیو زیرین (HWND، NSWindow یا GtkWindow) دریافت کنید. این امر دسترسی به امکانات پیشرفته نیتیو مانند پنلهای قابل اتصال (Dockable panes) در ویندوز را فراهم میکند.
همچنین چندین باگ مربوط به تمرکز پنجره برطرف شد. در ویندوز، فعال کردن یک پنجره دیگر باعث جلو کشیده شدن پنجرههای پسزمینه نمیشود و در لینوکس، ساخت پنجرههای چندگانه اکنون بهطور صریح قبل از دریافت اولین فریم از compositor انجام میشود که هشدارهای رندر اولیه را برطرف میکند.
یک API جدید برای اندازهدهی خودکار پنجرهها بر اساس محتوای آنها نیز اضافه شده است.
پشتیبانی از Flavors در دسکتاپ
ویندوز و لینوکس اکنون از Flutter Flavors پشتیبانی میکنند. به عنوان مثال، فایل pubspec.yaml شما میتواند از assetهای متفاوتی برای flavorهای مختلف استفاده کند. با استفاده از فلگ --flavor میتوانید flavor مورد نظر خود را مشخص کنید.
متنهای واضحتر در دسکتاپ
صفحهنمایشهای دسکتاپ اغلب چگالی پیکسلی کمتری نسبت به نمایشگرهای موبایل دارند اما توانایی پردازش گرافیکی بیشتری دارند. برای ارائه متنهای واضحتر و منحنیهای وکتوری تمیزتر، موتور فلاتر که از Impeller استفاده میکند، اکنون از رندرینگ SDF (Signed Distance Function) در macOS، Linux و Windows بهره میبرد.
پیشنمایشهای پایدار و آپدیتهای GenUI
پایداری Widget Previews
ویژگی Flutter Widget Preview اکنون پایدار (Stable) است. این ویژگی به شما اجازه میدهد بدون نیاز به build و اجرای کل اپلیکیشن، کامپوننتهای UI را بهطور فوری رندر، بررسی و تغییر دهید.
در این نسخه پایدار میتوانید انتظار موارد زیر را داشته باشید:
- زمان استارتاپ سریعتر به لطف کش پروژه محلی در پوشه
.widget_preview/. - تستهای منعطفتر با API انتزاعی
PreviewThemeData. - همگامسازی خودکار assetهای وب هنگام پیشنمایش ویجتهای وب.
- پیشرفتهای مداوم در GenUI برای پاسخ به نیازهای توسعهدهندگان.
بهبود تجربه پلتفرم
این بخش به بهبودهای هدفمندی میپردازد که توسط جامعه کاربری و تیم فلاتر برای ارتقای تجربه توسعهدهنده و کاربر در تمام پلتفرمها ارائه شده است.
اندروید
در اندروید، مشکل کیبورد مجازی که در آن کلیدهای اصلاحی (مانند Shift) گیر میکردند، برطرف شد. کلیدهای فیزیکی برای ورودیهای کیبورد مجازی نادیده گرفته میشوند تا تعاملات کیبورد تمیز بمانند.
ماتریس وابستگیهای اندروید: برای اطمینان از buildهای پایدار، فلاتر 3.47 با نسخههای زیر تست و تایید شده است:
- Java: 17
- Kotlin Gradle Plugin (KGP): 2.4.0
- Android Gradle Plugin (AGP): 9.1.0
- Gradle: 9.3.1
iOS و macOS
برای توسعهدهندگان iOS، فرایند امضای کد (Code signing) اکنون شفافتر است و هنگام انتخاب گواهی، Team ID و Team Name نمایش داده میشود. همچنین پیامهای خطای پروفایلهای provisioning هنگام شکست امضا واضحتر شدهاند.
دسکتاپ
رفع مشکل موقعیت caret در ترکیب متن کرهای در ویندوز. پلاگینهای ویندوز اکنون میتوانند وظایف سنگین را از thread پلتفرم خارج کنند. در لینوکس، چرخش قلم و گزارش فشار استایلوس پشتیبانی میشود.
گرافیک و موتور رندرینگ
در موتور رندرینگ، شیدرهای فرگمنت که OpenGLES را هدف قرار میدهند، دیگر نیازی به چرخش مختصات شرطی هنگام خواندن تکسچرها ندارند.
بهبود فریمورک (Framework Polish)
خود فریمورک نیز روانتر شده است و بهبودها در بخشهای کلیدی زیر تقسیم شدهاند:
- دسترسیپذیری و معناشناسی: تنظیمات کنتراست بالا و وارونگی رنگ در اندروید بهطور خودکار شناسایی میشوند.
- متن و انتخاب: دستگیرههای انتخاب متن در موبایل هنگام اسکرول جزئی پایدار میمانند. باگهای کرش در
SelectableRegionبرطرف شده و نمایش دستگیرهها در نزدیکی بالای صفحه اصلاح شده است. - ژستها و اسکرول: انتشار بهتر ژستها برای ویوهای نیتیو iOS. اسکرول خودکار اکنون از
ScrollPhysicsفعال احترام میگذارد. - بهبود ویجتهای اصلی: حفظ رنگ اصلی در
ImageIconباuseOriginalColors: true، تعیین رفتار clip درAnimatedCrossFadeو ردیابی خطاهای ImageStream.
زیربناها آماده است. تنها چیزی که باقی مانده این است که این ارتقاها را به سیستم محلی خود بیاورید:
flutter upgrade
دیدگاهها (0)
دیدگاه خود را بنویسید