پست‌های انتشارات Persian Flutter

راه‌اندازی Mirror برای Flutter/Dart Pub

سپهر تابعیان — Sat, 25 Apr 2026 05:50:36 +0330

مسئله چیست؟در فرآیند توسعه با Flutter و Dart، استفاده از پکیجها و بستهها اهمیت زیادی دارد. با این حال، در برخی مواقع ممکن است به دلیل مشکلات شبکه , پروکسی دسترسی به pub.dev (منبع اصلی پکیجها) با اختلال مواجه شود. این مشکلات میتواند ناشی از محدودیتهای اینترنتی، فایروالها یا حتی سرورهای غیرفعال باشد.قطعا با وجود ابزار های دور زدن فیلترینگ تجربه خطاهای ناموفق عدم دانلود پکیج های فلاتری را داشتید و حسابی کلافه شدید خواستید خودتون رو از بالا پرت کنید پایین.یک راه حل کاربردی و امتحان شده برای زمانی که نشت آی پی ایران دارید.اگر هنگام flutter pub get با خطاهایی مثل Authentication error (403) یا مشکلات شبکه روبهرو میشوید، استفاده از Mirror قابلاعتماد میتواند دریافت وابستگیها را پایدارتر کند.راهکار بهصورت خلاصهاستفاده از یک Mirror برای pub به ما این امکان را میدهد تا به جای مراجعه به pub.dev، از یک منبع محلی یا نزدیکتر استفاده کنیم. برای این کار تنها نیاز به یک سوییچ یکفرمانی داریم که به ما اجازه میدهد تا بهراحتی به Mirror متصل شویم.سوییچ سریع بین آینه و منبع رسمی را تنها با یک دستور خواهید داشت.macOS + zsh — پیکربندی دائمی با توضیحات مرحلهبهمرحله1) بررسی شل فعالدر macOS پیشفرض شل zsh است. برای اطمینان:echo $SHELLخروجی معمول: /bin/zsh2) پشتیبانگیری از تنظیمات فعلی شلقبل از هر تغییری از ~/.zshrc بکاپ بگیرید:cp ~/.zshrc ~/.zshrc.bak-$(date +%Y%m%d)3) باز کردن فایل تنظیمات ~/.zshrcبا ویرایشگر دلخواه باز کنید. مثلا با TextEdit:open -e ~/.zshrcیا اگر VS Code دارید:code ~/.zshrc4) افزودن Mirror + سوییچ سریعاین بلوک را عیناً به انتهای فایل اضافه کنید:# >>> PUB MIRROR SWITCH >>> export PUB_HOSTED_URL="https://pub.flutter-io.cn" export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn" alias pub-cn='export PUB_HOSTED_URL="https://pub.flutter-io.cn"; export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"; echo "Using mirror: $PUB_HOSTED_URL"' alias pub-dev='export PUB_HOSTED_URL="https://pub.dev"; export FLUTTER_STORAGE_BASE_URL="https://storage.googleapis.com"; echo "Using upstream: $PUB_HOSTED_URL"' # <<< PUB MIRROR SWITCH <<<توضیح خطوط:PUB_HOSTED_URL: مبدأ دریافت پکیجهای Dart/Flutter.FLUTTER_STORAGE_BASE_URL: مبدأ دریافت باینریها/آرتیفکتهای Flutter (مانند engine و SDK).pub-cn: در همان شل فعلی سوییچ به Mirror.pub-dev: در همان شل فعلی سوییچ به مبدأ رسمی.5) بارگذاری مجدد تنظیماتبرای اعمال فوری تغییرات:source ~/.zshrc6) راستیآزمایی مبدأهاecho $PUB_HOSTED_URL echo $FLUTTER_STORAGE_BASE_URLانتظار در حالت Mirror:https://pub.flutter-io.cnhttps://storage.flutter-io.cn7) استفادهٔ روزمرهاجرای عادی (پس از باز شدن شل جدید، Mirror پیشفرض است):flutter pub getسوییچ صریح به Mirror در همین ترمینال:pub-cn flutter pub getسوییچ به منبع رسمی در همین ترمینال:pub-dev flutter pub get8) نکات و رفع اشکال سریعاگر خطا ادامه داشت:flutter clean سپس flutter pub getسوییچ بین Mirror/رسمی: pub-cn یا pub-devبررسی دسترسی ها:curl -I https://pub.dev/api/packages/archive/advisories curl -I https://pub.flutter-io.cn/api/packages/archive/advisoriesاین تنظیمات تضمین «صفر خطا» نیست؛ آینهها ممکن است گهگاهی کند یا در دسترس نباشند.9) بازگردانی/حذف تغییرات(اختیاری)فایل ~/.zshrc را باز کرده و بلوک افزودهشده را پاک/کامنت کنید، سپس:source ~/.zshrcدر صورت نیاز میتوانید بکاپ را برگردانید:mv ~/.zshrc.bak-YYYYMMDD ~/.zshrc source ~/.zshrcWindows — پیکربندی دائمی + سوییچ سریعمیتوانید از PowerShell (توصیهشده) یا CMD استفاده کنید. در هر دو حالت، برای دائمیکردن، متغیرهای محیطی سطح کاربر را تنظیم میکنیم.گزینه PowerShell (پیشنهادی)1) تنظیم دائمی (User) به آینهPowerShell را بهصورت عادی باز کنید (بدون نیاز به ادمین برای سطح کاربر):setx PUB_HOSTED_URL "https://pub.flutter-io.cn" setx FLUTTER_STORAGE_BASE_URL "https://storage.flutter-io.cn"نکته: اثر setx در نشست فعلی دیده نمیشود؛ یک PowerShell جدید باز کنید. اگر میخواهید هماکنون هم اعمال شود:$env:PUB_HOSTED_URL = "https://pub.flutter-io.cn" $env:FLUTTER_STORAGE_BASE_URL = "https://storage.flutter-io.cn"2) افزودن توابع سوییچ سریع به پروفایل PowerShellساخت/باز کردن پروفایل:New-Item -Type File -Path $PROFILE -Force notepad $PROFILEاین توابع را در پروفایل بچسبانید تا هر بار با باز شدن PowerShell در دسترس باشند: function Use-PubMirror { $env:PUB_HOSTED_URL = "https://pub.flutter-io.cn" $env:FLUTTER_STORAGE_BASE_URL = "https://storage.flutter-io.cn" Write-Host "Using mirror: $env:PUB_HOSTED_URL" } function Use-PubUpstream { $env:PUB_HOSTED_URL = "https://pub.dev" $env:FLUTTER_STORAGE_BASE_URL = "https://storage.googleapis.com" Write-Host "Using upstream: $env:PUB_HOSTED_URL" } function Set-PubMirrorPermanent { setx PUB_HOSTED_URL "https://pub.flutter-io.cn" | Out-Null setx FLUTTER_STORAGE_BASE_URL "https://storage.flutter-io.cn" | Out-Null Write-Host "User env set to MIRROR. Open a new PowerShell." } function Set-PubUpstreamPermanent { setx PUB_HOSTED_URL "https://pub.dev" | Out-Null setx FLUTTER_STORAGE_BASE_URL "https://storage.googleapis.com" | Out-Null Write-Host "User env set to UPSTREAM. Open a new PowerShell." }بارگذاری مجدد پروفایل (یا باز کردن پنجره جدید):. $PROFILE3) راستیآزماییدر نشست فعلی:$env:PUB_HOSTED_URL $env:FLUTTER_STORAGE_BASE_URLمقدار دائمی (User):[Environment]::GetEnvironmentVariable("PUB_HOSTED_URL","User") [Environment]::GetEnvironmentVariable("FLUTTER_STORAGE_BASE_URL","User")4) استفادهٔ روزمرهflutter pub get # با مقادیر دائمی Use-PubMirror # سوییچ فوری به میرور در همین نشست Use-PubUpstream # سوییچ فوری به منبع رسمی5) بازگردانی/حذف مقادیر دائمی(اختیاری)[Environment]::SetEnvironmentVariable("PUB_HOSTED_URL", $null, "User") [Environment]::SetEnvironmentVariable("FLUTTER_STORAGE_BASE_URL", $null, "User")سپس یک PowerShell جدید باز کنید.گزینه Command Prompt (CMD)1) تنظیم دائمی (User) به Mirrorsetx PUB_HOSTED_URL "https://pub.flutter-io.cn" setx FLUTTER_STORAGE_BASE_URL "https://storage.flutter-io.cn"یک CMD جدید باز کنید تا اثر کند.2) تنظیم موقت در همان نشستset PUB_HOSTED_URL=https://pub.flutter-io.cn set FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn3) سوییچ سریع با فایلهای batch (اختیاری)یک فایل به نام pub-cn.cmd بسازید و محتوای زیر را در آن قرار دهید:@echo off set PUB_HOSTED_URL=https://pub.flutter-io.cn set FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn echo Using mirror: %PUB_HOSTED_URL%یک فایل به نام pub-dev.cmd بسازید:@echo off set PUB_HOSTED_URL=https://pub.dev set FLUTTER_STORAGE_BASE_URL=https://storage.googleapis.com echo Using upstream: %PUB_HOSTED_URL%اگر مسیر این فایلها در PATH باشد، میتوانید در همان CMD اجرا کنید:pub-cn flutter pub get pub-dev flutter pub get4) راستیآزماییecho %PUB_HOSTED_URL% echo %FLUTTER_STORAGE_BASE_URL%5) بازگردانی/حذف مقادیر دائمی(اختیاری)setx حذف مستقیم ندارد. از PowerShell استفاده کنید:[Environment]::SetEnvironmentVariable("PUB_HOSTED_URL", $null, "User") [Environment]::SetEnvironmentVariable("FLUTTER_STORAGE_BASE_URL", $null, "User")سپس یک CMD جدید باز کنید.خوشحالم که تا اینجا مقاله را خواندی و امیدوارم کاربردی بوده باشد.نکات مهماین روش پایداری را بهتر میکند، اما تضمین ۱۰۰٪ نیست. اگر آینهها کند شدند، به منبع رسمی برگردید.در CI/CD بهتر است متغیرها را بهطور صریح در محیط همان Job تنظیم کنید تا قابل تکرار باشد.پس از تغییر مقادیر دائمی با setx، همیشه ترمینال جدید باز کنید.اگر پشت پراکسی هستید، تنظیمات پراکسی سیستم/ترمینال را بررسی کنید.می دونید که با ❤️ کردن باعث انگیزه می شوید. منتظر کامنت های شما هستم.حتما تجربه های خودتون را در کامیونیتی فلاتر فارسی به اشتراک بگذارید.

آموزش کامل Drift در Flutter: از شروع تا مقابله با چالش‌ها

Saeed Ghafoori — Sat, 12 Oct 2024 11:19:10 +0330

معرفی کوتاه Drift به عنوان یک ORM قوی در Flutter.اهمیت مدیریت دیتابیسهای محلی در توسعه اپلیکیشنها.بیان مختصر اهداف مقاله و مزایای استفاده از Drift.فریمورک قدرتمند و متن باز گوگل به نام فلاتر و توسعه داده شده با زبان دارت ، به توسعه دهندگان این امکان را میدهد که با یک بار نوشتن کد، اپلیکیشن های زیبایی برای پلتفرم های مختلف مانند اندروید، iOS، وب و دسکتاپ ایجاد کنند. Drift چیست؟Drift یک ORM (Object-Relational Mapping) قدرتمند برای کار با پایگاه داده SQLite در اپلیکیشن های Flutter و Dart است. این کتابخانه به توسعه دهندگان اجازه میدهد تا با استفاده از کدهای Dart به سادگی کوئری های SQL را نوشته و مدیریت کنند، بدون نیاز به نوشتن مستقیم SQL. Drift امکاناتی همچون کوئری های قابل ترکیب، واکنش گرایی (Reactive) در دیتابیس، و تولید خودکار کدهای مرتبط با جداول را فراهم میکند. به طور خلاصه، Drift ارتباط بین اپلیکیشن و پایگاه داده را بسیار ساده و منعطف میسازد و امکان مدیریت دادهها در یک ساختار منظم و بهینه را فراهم میکند.یکی از مزایای کلیدی Drift، سازگاری با پلتفرم های مختلف است؛ از ویندوز و اندروید گرفته تا وب، این کتابخانه به توسعه دهندگان کمک میکند تا بدون نگرانی از جزئیات پیچیده هر پلتفرم، به راحتی دیتابیس خود را مدیریت کنند.برای شروع استفاده از Drift در پروژه Flutter، ابتدا باید این کتابخانه را نصب و پیکربندی کنید. Drift به راحتی با SQLite ادغام میشود و امکاناتی مانند کوئری نویسی ساده، مدیریت جداول و تعامل واکنشگرا با دیتابیس را فراهم می آورد. در این بخش، مراحل نصب و تنظیمات اولیه Drift را بررسی میکنیم.1. اضافه کردن کتابخانههای مورد نیازابتدا باید کتابخانه های Drift و SQLite را به فایل pubspec.yaml پروژه اضافه کنید. این کار را با قرار دادن خطوط زیر انجام دهید:dependencies: drift: ^2.20.2 drift_flutter: ^0.2.0 sqlite3_flutter_libs: ^0.7.0 dev_dependencies: drift_dev: ^2.20.2 build_runner: ^2.3.0drift: هسته اصلی Drift است که امکان نوشتن کوئریهای دیتابیس و مدیریت دادهها را فراهم میکند.drift_flutter: برای استفاده Drift در Flutter، به این پکیج نیاز داریم.sqlite3_flutter_libs: شامل باینری های SQLite برای استفاده در اندروید و iOS است.drift_dev و build_runner: این کتابخانه ها برای تولید خودکار کدهای مربوط به جداول و کوئریها استفاده میشوند.2. تنظیمات دیتابیسپس از نصب پکیجها، باید یک کلاس برای مدیریت اتصال به دیتابیس ایجاد کنید. این کلاس وظیفه باز کردن و مدیریت دیتابیس را بر عهده دارد.یک فایل Dart جدید به نام my_database.dart بسازید (نام اختیاری) و کد زیر را در آن وارد کنید:import 'dart:io'; import 'package:drift/drift.dart'; import 'package:drift/native.dart'; import 'package:path_provider/path_provider.dart'; import 'package:path/path.dart' as p; part 'my_database.g.dart'; این خط کد موقع وارد کردن با خطا هست که جلوتر حلش میکنیم @DriftDatabase( tables: [Master, Details], // جداول پایگاه داده ) class MyDatabase extends _$MyDatabase { MyDatabase() : super(_openConnection()); @override int get schemaVersion => 1; } LazyDatabase _openConnection() { return LazyDatabase(() async { final dbFolder = await getApplicationDocumentsDirectory(); final file = File(p.join(dbFolder.path, 'my_db.sqlite')); return NativeDatabase(file); }); }3. ساخت جداول دیتابیسدر Drift، جداول دیتابیس با استفاده از کلاسهای Dart تعریف میشوند. برای مثال، یک جدول به نام Master به شکل زیر تعریف میشود:class Master extends Table { IntColumn get id => integer().autoIncrement()(); TextColumn get title => text().withLength(min: 1, max: 50)(); IntColumn get processID => integer()(); }پس از تعریف جداول، با اجرای دستور زیر، کدهای مورد نیاز تولید میشوند ( بخصوص my_database.g.dart):flutter pub run build_runner build4. اجرای Driftپس از تنظیمات اولیه، دیتابیس شما آماده استفاده است. حال میتوانید از کوئریهای واکنشگرا و ساده Drif برای تعامل با داده ها در اپلیکیشن Flutter خود استفاده کنید.خب خب حالا بحث شیرین چالش و باگ هااستفاده از Drift در اپلیکیشنهای Flutter که برای پلتفرمهای مختلفی همچون وب، ویندوز، اندروید و iOS طراحی شدهاند، با چالشها و باگ هایی همراه است. یکی از مهمترین چالش ها، اجرای Drift در پلتفرم وب است، زیرا وب برخلاف پلتفرم های دیگر مانند اندروید یا ویندوز، از کتابخانه های محلی (native libraries) مانند dart:ffi برای دسترسی به SQLite پشتیبانی نمیکند. در ادامه به برخی از مهمترین چالش های استفاده از Drift در وب و مشکلات احتمالی آن میپردازیم:عدم پشتیبانی از dart:ffi در وبیکی از چالش های اساسی اجرای Drift در وب، عدم پشتیبانی مرورگرها از کتابخانه های مبتنی بر FFI (Foreign Function Interface) است. Drift از SQLite استفاده میکند که نیازمند تعامل مستقیم با سیستم عامل است، اما این امکان در وب وجود ندارد. به همین دلیل، برای اجرای Drift در وب، باید از drift/web(منسوخ شده) و IndexedDB به جای SQLite استفاده شود.راهحل: در هنگام پیکربندی Drift در اپلیکیشن وب، به جای استفاده از NativeDatabase، از WebDatabase استفاده میکنیم که به IndexedDB، یک دیتابیس داخلی در مرورگرها، متصل میشود:LazyDatabase _openConnection() { if (kIsWeb) { return LazyDatabase(() async { return WebDatabase('app_db'); }); } else { // استفاده از NativeDatabase برای پلتفرمهای موبایل و دسکتاپ final dbFolder = await getApplicationDocumentsDirectory(); final file = File(p.join(dbFolder.path, 'app_db.sqlite')); return NativeDatabase(file); } }محدودیتهای IndexedDBIndexedDB که Drift از آن در وب استفاده میکند، به عنوان یک دیتابیس مرورگر عمل میکند، اما دارای محدودیت هایی است:محدودیت حجم داده: در برخی مرورگرها (مانند Safari)، حجم دادههای ذخیره شده در IndexedDB محدود است و اگر برنامه شما حجم زیادی از داده ها را ذخیره کند، ممکن است به محدودیت برخورد کنید.سرعت پایین تر نسبت به SQLite: IndexedDB به طور کلی از لحاظ عملکرد، به ویژه در حجم بالای داده، کندتر از SQLite است. این میتواند در اپلیکیشنهایی که حجم زیادی از دادهها را پردازش میکنند، مشکل ساز شود.مشکلات همگام سازی داده بین پلتفرم هایکی دیگر از چالش ها در اجرای Drift در وب، همگامسازی داده ها بین پلتفرم های مختلف است. اگر اپلیکیشن شما در وب، موبایل و دسکتاپ اجرا شود، داده ها به طور پیشفرض در هر پلتفرم جداگانه ذخیره میشوند. این مسئله میتواند مشکل همگام سازی دادهها بین نسخه های مختلف اپلیکیشن را به همراه داشته باشد.راه حل احتمالی: استفاده از راهکارهایی مانند APIهای سمت سرور یا Firebase برای همگامسازی داده ها بین پلتفرم های مختلف میتواند این مشکل را حل کند.خطاهای سازگاری با مرورگرهای مختلفعملکرد Drift در وب ممکن است در برخی مرورگرها دچار مشکل شود. به عنوان مثال، نسخه های قدیمی مرورگرهایی مانند Safari یا Internet Explorer از IndexedDB به درستی پشتیبانی نمیکنند و ممکن است برنامه شما با خطا مواجه شود.راه حل: تست کامل برنامه در مرورگرهای مختلف و استفاده از polyfillها یا راهکارهای جایگزین برای رفع مشکلات سازگاری میتواند کمک کننده باشد.مدیریت ایمنی و امنیت دادههادر وب، امنیت و حریم خصوصی داده ها از اهمیت ویژهای برخوردار است. IndexedDB به صورت محلی در مرورگر کاربر ذخیره میشود و ممکن است داده های حساس اپلیکیشن شما در معرض خطر قرار بگیرد.راه حل: استفاده از رمزنگاری برای محافظت از داده های حساس و پیادهسازی مکانیسم های امنیتی سمت سرور برای مدیریت بهتر داده ها.محدودیت های مرورگر در توسعه وب اپلیکیشن هامرورگرها به دلیل محدودیت های ذاتی که دارند، امکان اجرای کدهای سنگین و عملیات پیچیده را به همان شکلی که در دسکتاپ یا موبایل وجود دارد، نمیدهند. این مسئله میتواند برای Drift، که با دیتابیس های حجیم سر و کار دارد، محدودیتهایی ایجاد کند._____________________________________________________________________________________________در کل، اگرچه Drift ابزار قدرتمندی برای مدیریت دیتابیسها است، اما در پلتفرم وب به دلیل محدودیتهای موجود باید با دقت و تغییراتی خاص مورد استفاده قرار گیرد.قربان شما ; سید سعید غفوری

مدیریت دکمه بک مرورگر در فلاتر با استفاده از GoRouter

اسماعیل احمدی پور — Fri, 02 Aug 2024 01:13:52 +0330

مدیریت دکمه بک مرورگر در فلاتر با استفاده از GoRouterدر انتخاب ابزار مدیریت روتینگ در فلاتر، گزینههای زیادی وجود دارد. اما زمانی که به محبوبترین پکیجها نگاه میکنیم، GoRouter به عنوان یکی از بهترینها شناخته میشود. با وجود مزایای بسیار، GoRouter نیز با چالشهایی مواجه است و یکی از مشکلات قابل توجه آن، مدیریت دکمه بک مرورگر است. در این مقاله، به بررسی این مشکل و ارائه راهحل آن خواهیم پرداخت.مشکل:در یک برنامه معمولی، ناوبری بین صفحات به صورت پیوسته و منظم است. این ساختار اطمینان میدهد که کاربران روند خاصی را دنبال کنند. اما استفاده از دکمه بک مرورگر میتواند این روند را مختل کرده و باعث شود که برنامه به صورت غیرمنتظرهای رفتار کند یا توالی ناوبری مورد نظر از بین برود.علاوه بر این، مدیریت این مسئله در چندین پلتفرم پیچیدگی دیگری را اضافه میکند. مهم است که کد به طور یکپارچه در تمام پلتفرمها، از جمله وب، بدون مشکل کار کند. هدف داشتن راهحلی است که نه تنها دکمه بک مرورگر را در وب مدیریت کند بلکه در سایر پلتفرمها نیز به درستی عمل کند.راهحل:گام 1: ایجاد یک فایل جاوا اسکریپت برای محدود کردن دکمه بک به صفحه اول PWAاولین قدم، ایجاد یک فایل جاوا اسکریپت است که عملکرد دکمه بک را به صفحه اول برنامه وب پیشرفته (PWA) محدود کند.نام فایل: clear_browser_history.jsfunction clearBrowserHistory(redirectUrl) { // جایگزین کردن وضعیت فعلی با وضعیت جدید history.replaceState(null, document.title, location.pathname); // پاک کردن تاریخچه جلو = function(event) { // هدایت به یک صفحه خاص .href = redirectUrl; }; }گام 2: درج فایل جاوا اسکریپت در HTMLدر مرحله بعد، باید این فایل جاوا اسکریپت را به فایل HTML خود اضافه کنید. خط کد زیر را درست بالای تگ اضافه کنید.