3.2 KiB
3.2 KiB
راهنمای تنظیم Flutter Mirror برای دسترسی بهتر به پکیج‌ها
مشکل
در برخی مناطق، دسترسی مستقیم به pub.dev ممکن است محدود یا کند باشد.
راه‌حل
استفاده از mirror سایت‌های چینی برای دسترسی بهتر به پکیج‌های Flutter.
تنظیم سریع
1. اجرای اسکریپت خودکار
cd /home/babak/hesabix
./setup_flutter_mirror.sh
2. تنظیم دستی
export PUB_HOSTED_URL="https://pub.flutter-io.cn"
export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"
Mirror سایت‌های پشتیبانی شده
1. China Flutter User Group
- URL:
https://pub.flutter-io.cn - Storage:
https://storage.flutter-io.cn - پشتیبانی: Issue Tracker
2. Shanghai Jiao Tong University
- URL:
https://mirror.sjtu.edu.cn/dart-pub - Storage:
https://mirror.sjtu.edu.cn
3. Tsinghua University TUNA
- URL:
https://mirrors.tuna.tsinghua.edu.cn/dart-pub - Storage:
https://mirrors.tuna.tsinghua.edu.cn/flutter
تنظیم دائمی
برای Bash/Zsh:
echo 'export PUB_HOSTED_URL="https://pub.flutter-io.cn"' >> ~/.bashrc
echo 'export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"' >> ~/.bashrc
source ~/.bashrc
برای Windows PowerShell:
$env:PUB_HOSTED_URL="https://pub.flutter-io.cn"
$env:FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"
تست تنظیمات
1. بررسی متغیرهای محیطی
echo $PUB_HOSTED_URL
echo $FLUTTER_STORAGE_BASE_URL
2. تست دسترسی به پکیج‌ها
cd hesabixUI/hesabix_ui
flutter pub get
3. تست نصب پکیج جدید
flutter pub add package_name
بازگشت به تنظیمات پیش‌فرض
حذف متغیرهای محیطی
unset PUB_HOSTED_URL
unset FLUTTER_STORAGE_BASE_URL
یا تنظیم به pub.dev اصلی
export PUB_HOSTED_URL="https://pub.dev"
export FLUTTER_STORAGE_BASE_URL="https://storage.googleapis.com"
مزایای استفاده از Mirror
- سرعت بالاتر: دانلود سریع‌تر پکیج‌ها
- دسترسی بهتر: حل مشکل محدودیت‌های جغرافیایی
- پایداری: کاهش احتمال قطع ارتباط
- سازگاری: کاملاً سازگار با Flutter اصلی
نکات مهم
- Mirror سایت‌ها توسط جامعه Flutter چین پشتیبانی می‌شوند
- همیشه از mirror های معتبر استفاده کنید
- در صورت بروز مشکل، به Issue Tracker مربوطه مراجعه کنید
- تنظیمات فقط برای session فعلی اعمال می‌شود مگر اینکه دائمی شوند