اگر توسعهدهنده Flutter باشید و در محیطهایی با محدودیت دسترسی به مخازن خارجی کار کنید، احتمالاً با این سناریو مواجه شدهاید:
ابتدا یک پکیج را به پروژه اضافه میکنید:
flutter pub add package_name
همه چیز بدون هیچ خطایی انجام میشود، اما هنگام اجرای پروژه:
flutter run
با خطاهایی مانند موارد زیر روبهرو میشوید:
Could not resolve all artifacts Could not find com.android.tools.build:gradle Could not resolve dependency
در نگاه اول تصور میکنیم نسخه Gradle، Android Gradle Plugin یا حتی Flutter با یکدیگر ناسازگار هستند؛ اما همیشه مشکل از نسخهها نیست.
flutter pub add و flutter runزمانی که دستور flutter pub add را اجرا میکنید، Flutter فقط وابستگی Dart را از مخزن دریافت کرده و فایل pubspec.yaml را بهروزرسانی میکند.
در این مرحله Gradle هنوز وارد فرآیند ساخت پروژه نشده است.
اما هنگام اجرای flutter run، Gradle شروع به ساخت پروژه اندروید میکند و تمام پلاگینهایی که به پروژه اضافه شدهاند نیز باید وابستگیهای Android خود را دریافت کنند.
در این مرحله است که بسیاری از مشکلات مربوط به Repositoryها خودشان را نشان میدهند.
بسیاری از توسعهدهندگان تصور میکنند تنظیم Repositoryها فقط در پروژه اصلی انجام میشود، در حالی که اکثر پلاگینهای Flutter نیز یک پروژه Android مستقل دارند.
برای مثال تقریباً تمام پلاگینها پوشهای مشابه زیر دارند:
package_name/ └── android/ ├── build.gradle ├── settings.gradle └── ...
این پروژه Android میتواند Repositoryهای مخصوص خودش را داشته باشد.
برای نمونه:
repositories { google() mavenCentral() }
یا در فایلهای جدیدتر:
pluginManagement { repositories { google() mavenCentral() } }
به همین دلیل حتی اگر پروژه اصلی شما از Mirror یا Repository دیگری استفاده کند، ممکن است یکی از وابستگیها همچنان تلاش کند فایلهای موردنیاز خود را مستقیماً از Google Maven یا Maven Central دریافت کند.
اگر دسترسی به این مخازن وجود نداشته باشد، فرآیند Build متوقف میشود.
همه پکیجها ساختار یکسانی ندارند.
برخی از آنها کاملاً از تنظیمات پروژه اصلی پیروی میکنند، اما برخی دیگر Repositoryها یا نسخههای Gradle موردنیاز خود را در فایلهای داخلی پلاگین تعریف کردهاند.
در نتیجه ممکن است:
دهها پکیج بدون مشکل کار کنند.
اما فقط یک پکیج باعث شکست کل فرآیند Build شود.
اگر پروژه اصلی بدون مشکل تنظیم شده باشد اما بعد از اضافه کردن یک پکیج خاص Build با خطا مواجه شود، بهتر است فایلهای Android همان پلاگین را بررسی کنید.
تمام پکیجهای Flutter بعد از دانلود در Pub Cache ذخیره میشوند.
در ویندوز معمولاً مسیر آنها به شکل زیر است:
C:\Users\<User>\AppData\Local\Pub\Cache\hosted\pub.dev
سپس وارد پوشه همان پکیج شوید و فایلهای Gradle موجود در پوشه android را بررسی کنید.
در بسیاری از مواقع مشاهده خواهید کرد که Repositoryهای جداگانهای در آن تعریف شدهاند.
اگر از Mirror برای دانلود وابستگیهای Gradle استفاده میکنید، تنها تنظیم کردن Repositoryها در پروژه اصلی کافی نیست.
تمام پروژههای Android موجود در وابستگیها نیز باید بتوانند از همان Mirror استفاده کنند.
در غیر این صورت، هنگام Build، هر پلاگین تلاش میکند وابستگیهای خود را از Repositoryهایی که داخل فایلهای خودش تعریف شدهاند دریافت کند و همین موضوع باعث بروز خطا خواهد شد.
به همین دلیل، هنگام مواجهه با خطاهای دانلود وابستگی، علاوه بر فایلهای Gradle پروژه اصلی، فایلهای Gradle موجود در خود وابستگیها را نیز بررسی کنید.
اگر با این وضعیت مواجه شدید که:
flutter pub add بدون خطا انجام میشود.
اما flutter run یا gradlew build با خطاهای مربوط به Gradle یا دانلود وابستگیها شکست میخورد.
قبل از تغییر نسخه Flutter، Gradle یا Android Studio، بررسی کنید که آیا خود وابستگی موردنظر دارای تنظیمات Gradle و Repository مستقل نیست.
در بسیاری از موارد، مشکل نه از Flutter است و نه از نسخه Gradle؛ بلکه از این موضوع ناشی میشود که یکی از وابستگیها همچنان از Repositoryهایی استفاده میکند که در محیط فعلی شما قابل دسترس نیستند.