تحریم شکن برای Gradle

محدودیت دسترسی به Gradle می‌تواند فرایند توسعه، دریافت وابستگی‌ها یا استفاده از ابزارهای مرتبط را مختل کند. در این راهنما تنظیم شکن، دامنه‌های لازم و روش آزمایش تحریم شکن برای Gradle را با نمونه عملی توضیح می‌دهیم.

اگر هنگام اجرای پروژه‌های Java، Kotlin یا Android با خطاهای Gradle مواجه می‌شوید، ممکن است مشکل به دریافت وابستگی‌ها از مخزن‌های آنلاین مربوط باشد. خطاهایی مانند Could not resolve dependencies، پیام UnknownHostException یا متوقف شدن Gradle Sync می‌توانند دلایل متفاوتی داشته باشند؛ از اختلال شبکه و DNS گرفته تا تنظیمات مخزن‌ها، نسخه‌های ناسازگار و مشکلات گواهی امنیتی.

Gradle یکی از ابزارهای اصلی ساخت و مدیریت وابستگی در پروژه‌های نرم‌افزاری است. این ابزار برای دریافت کتابخانه‌ها و پلاگین‌های موردنیاز، به مخزن‌هایی مانند Maven Central و Gradle Plugin Portal متصل می‌شود. اگر ارتباط با یکی از این مخزن‌ها برقرار نشود، ممکن است فرایند ساخت پروژه کامل نشود.

Gradle چیست و چرا دسترسی به مخزن‌های آن اهمیت دارد؟

Gradle یک ابزار اتوماسیون ساخت نرم‌افزار است که برای مدیریت فرایندهایی مانند دریافت وابستگی‌ها، کامپایل کد، اجرای آزمون‌ها و آماده‌سازی خروجی پروژه استفاده می‌شود. این ابزار در پروژه‌های Java و Kotlin و همچنین بسیاری از پروژه‌های اندرویدی کاربرد دارد.

فرض کنید در یک پروژه اندرویدی از کتابخانه‌ای برای ارسال درخواست‌های شبکه یا مدیریت رابط کاربری استفاده می‌کنید. برای اینکه پروژه بتواند از آن کتابخانه استفاده کند، باید وابستگی موردنظر در فایل‌های تنظیمات معرفی شود و Gradle بتواند فایل‌های لازم را دریافت کند.

برای مثال، وابستگی‌های پروژه ممکن است در فایلی مانند build.gradle یا build.gradle.kts تعریف شوند. همچنین تنظیمات مربوط به مخزن‌های دریافت پلاگین و کتابخانه‌ها معمولاً در فایل‌هایی مانند settings.gradle یا settings.gradle.kts قرار می‌گیرند.

وقتی پروژه را در Android Studio باز می‌کنید یا دستور ساخت آن را اجرا می‌کنید، Gradle ممکن است برای دریافت اطلاعات نسخه‌ها و فایل‌های موردنیاز به اینترنت متصل شود. اگر این ارتباط با مشکل مواجه شود، فرایند Sync یا Build ممکن است متوقف شود.

به همین دلیل، اگر خطای Gradle در مرحله دریافت وابستگی‌ها رخ می‌دهد، بررسی وضعیت اتصال به مخزن‌های مربوطه یکی از مراحل اولیه عیب‌یابی است.

تحریم شکن برای Gradle چه کاربردی دارد؟

اگر دسترسی به مخزن‌های موردنیاز Gradle از شبکه شما با مشکل روبه‌رو شده باشد، بررسی تنظیمات DNS می‌تواند یکی از راه‌های عیب‌یابی باشد. DNS وظیفه دارد نام دامنه‌هایی مانند repo.maven.apache.org را به آدرس IP متناظر تبدیل کند. اگر این فرایند با اختلال مواجه شود، ابزار Gradle ممکن است نتواند به مقصد موردنظر متصل شود.

شکن یک سرویس DNS است که می‌توانید تنظیمات آن را روی رایانه یا شبکه خود آزمایش کنید. با این حال، باید در نظر داشته باشید که DNS شکن جایگزین VPN یا یک پراکسی عمومی نیست و تمام ترافیک اینترنت را از یک تونل عبور نمی‌دهد. بنابراین، اگر خطای Gradle ناشی از گواهی TLS، تنظیمات پراکسی، فایروال، ناسازگاری نسخه‌ها یا اختلال سرور باشد، تغییر DNS به‌تنهایی مشکل را برطرف نمی‌کند.

پیش از تغییر تنظیمات، مشخص کنید مشکل شما در کدام مرحله رخ می‌دهد:

هنگام باز کردن پروژه در Android Studio و اجرای Gradle Sync.
هنگام دانلود پلاگین‌های Gradle.
هنگام دریافت کتابخانه‌های Java یا Kotlin.
هنگام اجرای دستور gradle build یا ./gradlew build.
هنگام دریافت وابستگی‌ها از Maven Central یا یک مخزن سفارشی.
هنگام دریافت فایل‌های Gradle Wrapper برای اجرای پروژه.

تشخیص مرحله خطا کمک می‌کند بدانید کدام مخزن یا بخش از فرایند ساخت نیاز به بررسی دارد.

خرید طرح‌های شکن حرفه‌ای

آدرس DNS شکن برای Gradle

برای آزمایش سرویس شکن، می‌توانید از DNSهای زیر استفاده کنید.

نوع سرویس	DNS اول	DNS دوم
شکن رایگان	`178.22.122.100`	`185.51.200.2`
شکن حرفه‌ای	`178.22.122.101`	`185.51.200.1`

DNS مناسب را در تنظیمات شبکه دستگاه خود وارد کنید. اگر از نسخه حرفه‌ای استفاده می‌کنید، شرایط فعال‌سازی سرویس و تنظیمات مربوط به IP را مطابق راهنمای رسمی پنل بررسی کنید. برای مشاهده اطلاعات پلن‌ها نیز می‌توانید به صفحه طرح‌های شکن مراجعه کنید.

توجه: تنظیم DNS به‌تنهایی دسترسی موفق به تمام مخزن‌های Gradle را تضمین نمی‌کند. پس از اعمال تنظیمات، اتصال را آزمایش کنید و اگر خطا باقی ماند، متن کامل پیام Gradle را بررسی کنید.

چگونه از شکن برای رفع مشکل دسترسی به Gradle استفاده کنیم؟

مرحله اول: تنظیم DNS در سیستم‌عامل

ابتدا DNS شکن را روی همان رایانه‌ای تنظیم کنید که Gradle یا Android Studio روی آن اجرا می‌شود. تغییر DNS روی گوشی یا دستگاه دیگری، لزوماً اتصال Gradle در رایانه را تغییر نمی‌دهد.

برای مشاهده روش تنظیم DNS در سیستم‌عامل‌های مختلف، می‌توانید از راهنماهای زیر استفاده کنید:

اگر از مودم یا روتر استفاده می‌کنید و می‌خواهید تنظیمات DNS را در سطح شبکه بررسی کنید، راهنمای تحریم شکن برای مودم و روتر را ببینید. برای اینترنت مبتنی بر مودم TD-LTE نیز می‌توانید از راهنمای تحریم شکن برای مودم TD-LTE استفاده کنید.

مرحله دوم: بررسی دسترسی به مخزن‌های Gradle

Gradle ممکن است برای دریافت وابستگی‌ها یا پلاگین‌ها به چند مخزن مختلف متصل شود. بنابراین، باز شدن یک سایت در مرورگر به این معنی نیست که تمام مخزن‌های موردنیاز پروژه نیز در دسترس هستند.

مهم‌ترین مخزن‌هایی که در پروژه‌های Gradle با آن‌ها مواجه می‌شوید عبارت‌اند از:

Maven Central: یکی از مخزن‌های اصلی کتابخانه‌های Java و سایر وابستگی‌های سازگار با Maven.
Gradle Plugin Portal: مخزن متداول برای دریافت پلاگین‌های Gradle.
Google Maven Repository: مخزنی که در بسیاری از پروژه‌های Android برای دریافت وابستگی‌های مرتبط با ابزارها و کتابخانه‌های گوگل استفاده می‌شود.
مخزن‌های سفارشی: مخزن‌های عمومی یا خصوصی که تیم توسعه در تنظیمات پروژه معرفی کرده است.

وجود این مخزن‌ها در یک پروژه به معنی استفاده قطعی از همه آن‌ها نیست. فهرست مخزن‌های موردنیاز را باید از فایل‌های تنظیمات همان پروژه بررسی کنید.

مرحله سوم: اجرای دوباره Gradle Sync یا Build

پس از تغییر تنظیمات DNS، پروژه را دوباره همگام‌سازی کنید. در Android Studio می‌توانید از گزینه Gradle Sync استفاده کنید. اگر از ترمینال استفاده می‌کنید، در پوشه اصلی پروژه دستور مناسب را اجرا کنید.

در ویندوز:

gradlew.bat build

در macOS یا لینوکس:

./gradlew build

این دستورها در پروژه‌هایی کاربرد دارند که فایل Gradle Wrapper در آن‌ها وجود دارد. استفاده از Wrapper معمولاً کمک می‌کند پروژه با نسخه Gradle تعیین‌شده برای همان پروژه اجرا شود.

اگر هدف شما فقط بررسی دریافت وابستگی‌هاست، می‌توانید از دستور متناسب با ساختار پروژه استفاده کنید؛ برای مثال:

./gradlew dependencies

توجه داشته باشید که این دستور گزارش وابستگی‌ها را تولید می‌کند و بسته به تنظیمات پروژه ممکن است همه وابستگی‌ها را دانلود نکند. در صورت مشاهده خطا، پیام کامل را ذخیره کنید تا بتوانید علت را دقیق‌تر بررسی کنید.

رفع خطاهای رایج Gradle هنگام اتصال به اینترنت

خطاهای Gradle همیشه به DNS مربوط نیستند. پیام خطا و مرحله‌ای که فرایند ساخت در آن متوقف می‌شود، سرنخ مهمی برای انتخاب راهکار است.

خطا یا نشانه	علت احتمالی	راهکار پیشنهادی
`UnknownHostException`	نام میزبان شناسایی نشده یا تنظیمات DNS با مشکل مواجه است.	DNS، اتصال اینترنت و نام دامنه مخزن را بررسی کنید.
`Could not resolve all files for configuration`	یک یا چند وابستگی پروژه قابل دریافت یا حل نیستند.	مخزن مربوطه، نسخه وابستگی‌ها و متن خطای اصلی را بررسی کنید.
`Could not GET`	درخواست دریافت فایل از سرور با موفقیت انجام نشده است.	آدرس مخزن، اتصال HTTPS، پراکسی و وضعیت سرور را بررسی کنید.
`Read timed out`	سرور در بازه زمانی تعیین‌شده پاسخ نداده است.	اتصال شبکه، محدودیت‌های فایروال و وضعیت مخزن را بررسی کنید.
`PKIX path building failed`	Java نتوانسته زنجیره گواهی امنیتی را تأیید کند.	ساعت سیستم، گواهی‌های مورداعتماد Java و تنظیمات بازرسی HTTPS را بررسی کنید.
`Plugin ... was not found`	پلاگین در مخزن‌های تعریف‌شده پیدا نشده یا قابل دریافت نیست.	بخش `pluginManagement`، مخزن‌های پلاگین و نسخه درخواستی را بررسی کنید.
`Could not find ...`	مختصات یا نسخه وابستگی در مخزن‌های قابل دسترس پیدا نشده است.	نام، گروه، نسخه و مخزن تعریف‌شده برای وابستگی را بررسی کنید.
`Could not download gradle-...-bin.zip`	دانلود فایل Gradle Wrapper با مشکل مواجه شده است.	آدرس `distributionUrl`، اتصال شبکه و دسترسی به فایل را بررسی کنید.
`JAVA_HOME is set to an invalid directory`	مسیر JDK اشتباه است یا به یک پوشه معتبر اشاره نمی‌کند.	مسیر نصب JDK و مقدار متغیر محیطی `JAVA_HOME` را بررسی کنید.
`Permission denied`	مجوز اجرای فایل یا دسترسی به مسیر موردنظر کافی نیست.	مجوزهای فایل‌ها و پوشه‌های پروژه و مسیر نصب را بررسی کنید.

نکته: برای رفع خطاهای Gradle، ابتدا اولین خطای اصلی در خروجی Build را پیدا کنید؛ پیام‌های بعدی ممکن است فقط نتیجه همان مشکل باشند. اگر خطا مربوط به دانلود وابستگی‌هاست، دسترسی به مخزن و تنظیمات شبکه را بررسی کنید.

رفع خطای UnknownHostException

خطای UnknownHostException معمولاً نشان می‌دهد برنامه نتوانسته نام میزبان موردنظر را به آدرس شبکه تبدیل کند. این خطا می‌تواند به تنظیمات DNS، نام دامنه اشتباه یا شرایط شبکه مربوط باشد.

برای بررسی اولیه، در ویندوز Command Prompt را باز کنید و دامنه موردنیاز را آزمایش کنید. برای مثال:

nslookup repo.maven.apache.org

در macOS و لینوکس نیز می‌توانید همین دستور را در ترمینال اجرا کنید:

nslookup repo.maven.apache.org

اگر پروژه در گزارش خطا به مخزن دیگری اشاره می‌کند، همان دامنه را بررسی کنید. دریافت پاسخ DNS فقط نشان می‌دهد نام دامنه به آدرس مربوطه تبدیل شده است؛ این نتیجه به‌تنهایی موفقیت اتصال HTTPS یا دانلود فایل را تأیید نمی‌کند.

رفع خطای Could not resolve dependencies

پیام Could not resolve dependencies یک خطای کلی است و لزوماً به معنی مسدود بودن مخزن نیست. ممکن است Gradle نتواند به مخزن وصل شود، نسخه درخواستی موجود نباشد یا وابستگی موردنظر از مخزن دیگری دریافت شود.

برای تشخیص علت:

چند خط قبل و بعد از پیام اصلی را بررسی کنید.
نام وابستگی و نسخه‌ای را که دریافت نشده پیدا کنید.
نام مخزن یا URL نمایش‌داده‌شده در گزارش را یادداشت کنید.
بررسی کنید خطا برای تمام وابستگی‌ها رخ می‌دهد یا فقط یک مورد.
در صورت نیاز، تنظیمات repositories و pluginManagement را بررسی کنید.

اگر نام دامنه در پیام خطا وجود دارد، می‌توانید آن را جداگانه از نظر DNS آزمایش کنید. اگر دامنه به‌درستی resolve می‌شود، باید سراغ بررسی اتصال HTTPS، دسترسی مخزن و تنظیمات پروژه بروید.

رفع خطای PKIX و گواهی SSL

خطاهایی مانند PKIX path building failed معمولاً به اعتبارسنجی گواهی امنیتی در محیط Java مربوط‌اند. این خطا با مشکل DNS یکسان نیست.

در این وضعیت، نسخه و مسیر JDK مورد استفاده Gradle، تاریخ و ساعت سیستم و گواهی‌های امنیتی را بررسی کنید. اگر در شبکه سازمانی از پراکسی یا سامانه بازرسی HTTPS استفاده می‌شود، ممکن است تنظیمات گواهی نیز نیاز به بررسی داشته باشند.

برای رفع خطا، اعتبارسنجی گواهی‌ها را غیرفعال نکنید و از تنظیمات ناامن برای نادیده گرفتن خطاهای TLS استفاده نکنید. چنین تغییراتی می‌توانند امنیت دریافت کتابخانه‌ها و پلاگین‌ها را کاهش دهند.

رفع خطای Plugin not found

پلاگین‌های Gradle ممکن است از مخزن‌هایی متفاوت با مخزن وابستگی‌های عادی پروژه دریافت شوند. به همین دلیل، اگر خطا مربوط به پیدا نشدن پلاگین است، فقط بخش repositories در فایل build.gradle را بررسی نکنید.

در پروژه‌های جدیدتر، تنظیمات مربوط به مخزن پلاگین‌ها ممکن است در فایل settings.gradle یا settings.gradle.kts و داخل بخش pluginManagement قرار داشته باشد. نام پلاگین، نسخه و مخزن‌هایی را که در این بخش تعریف شده‌اند بررسی کنید.

اگر مخزن درست تعریف شده ولی دریافت پلاگین به دلیل اختلال شبکه انجام نمی‌شود، وضعیت اتصال به همان مخزن را آزمایش کنید. در مقابل، اگر نام یا نسخه پلاگین اشتباه باشد، تغییر DNS مشکل را حل نخواهد کرد.

تفاوت تنظیم DNS با تنظیم پراکسی در Gradle

یکی از نکات مهم در عیب‌یابی Gradle، تفاوت DNS و پراکسی است. این دو تنظیم کار یکسانی انجام نمی‌دهند.

DNS نام دامنه را به آدرس IP تبدیل می‌کند؛ اما پراکسی واسطه‌ای برای عبور درخواست‌های شبکه است. Gradle امکان تنظیم پراکسی را از طریق ویژگی‌های سیستمی JVM و فایل gradle.properties فراهم می‌کند. <Cite refs={[“turn612926search0”]}/>

اگر شبکه شما به پراکسی نیاز دارد، باید تنظیمات صحیح آن را از مدیر شبکه یا ارائه‌دهنده سرویس دریافت کنید. از وارد کردن آدرس یا پورت حدسی خودداری کنید.

نمونه زیر فقط شکل کلی تنظیم یک پراکسی را نشان می‌دهد و تا زمانی که اطلاعات واقعی پراکسی را ندارید، نباید آن را عیناً در پروژه قرار دهید:

systemProp.https.proxyHost=proxy.example.com
systemProp.https.proxyPort=8080

در این نمونه، proxy.example.com و پورت 8080 مقادیر نمونه هستند، نه آدرس پراکسی سرویس شکن. این مثال برای توضیح روش تنظیم پراکسی Gradle است و نباید به‌عنوان تنظیم پیشنهادی DNS شکن در نظر گرفته شود.

اگر از DNS شکن استفاده می‌کنید و شبکه شما به پراکسی جداگانه نیاز ندارد، صرفاً برای رفع خطای Gradle تنظیمات پراکسی جدید و نامعتبر اضافه نکنید. ابتدا متن خطا را بررسی کنید تا مشخص شود مشکل واقعاً به پراکسی مربوط است یا خیر.

آیا تغییر DNS مشکل Gradle Sync در Android Studio را حل می‌کند؟

در بعضی شرایط، مشکل Gradle Sync به ارتباط با مخزن‌های آنلاین مربوط است و بررسی DNS می‌تواند به تشخیص یا رفع آن کمک کند. اما Gradle Sync ممکن است به دلایل دیگری نیز شکست بخورد.

برای مثال، نسخه Gradle ممکن است با نسخه پلاگین Android Gradle سازگار نباشد، JDK مورد استفاده درست تنظیم نشده باشد یا فایل‌های تنظیمات پروژه اشتباه باشند. همچنین امکان دارد یک وابستگی در مخزن موردنظر وجود نداشته باشد.

برای بررسی مشکل، ابتدا پیام کامل Gradle Sync را باز کنید. اگر خطا به نام میزبان، timeout یا دریافت فایل از یک URL اشاره می‌کند، اتصال شبکه را بررسی کنید. اگر پیام به نسخه‌ها، پلاگین یا تنظیمات ساخت اشاره دارد، بررسی فایل‌های پروژه در اولویت قرار می‌گیرد.

اگر پروژه از فایل Wrapper استفاده می‌کند، فایل gradle/wrapper/gradle-wrapper.properties را نیز بررسی کنید. مقدار distributionUrl در این فایل مشخص می‌کند Gradle Wrapper فایل توزیع Gradle را از کجا دریافت کند. اگر خطا دقیقاً هنگام دریافت این فایل رخ می‌دهد، مسئله ممکن است با دریافت کتابخانه‌های پروژه متفاوت باشد.

راهنمای Gradle برای ویندوز، مک و لینوکس

روش تنظیم DNS در هر سیستم‌عامل متفاوت است، اما منطق عیب‌یابی Gradle در همه آن‌ها مشابه است: ابتدا اتصال شبکه را بررسی کنید، سپس نام دامنه مخزن را آزمایش کنید و در نهایت خطای ابزار ساخت را بخوانید.

اگر روی ویندوز توسعه می‌دهید، می‌توانید از راهنمای تحریم شکن برای ویندوز استفاده کنید. برای سیستم‌های ویندوز 10 و 11 نیز راهنماهای ویندوز 10 و ویندوز 11 در دسترس‌اند.

در macOS، تنظیمات DNS را مطابق راهنمای تحریم شکن برای مک بررسی کنید. کاربران لینوکس نیز می‌توانند از راهنمای تحریم شکن برای لینوکس کمک بگیرند.

اگر پروژه را روی یک سرور ویندوزی اجرا می‌کنید، راهنمای تحریم شکن برای ویندوز سرور می‌تواند برای تنظیمات شبکه سیستم‌عامل مفید باشد. با این حال، تنظیم DNS سرور و تنظیمات اختصاصی Gradle دو موضوع جداگانه‌اند و باید هر کدام متناسب با نوع خطا بررسی شوند.

صفحات مرتبط با ابزارهای برنامه‌نویسی

اگر علاوه بر Gradle از ابزارها و مخزن‌های دیگری استفاده می‌کنید، می‌توانید راهنمای اختصاصی هر سرویس را نیز بررسی کنید:

تحریم شکن برای GitHub؛ برای بررسی مشکلات دسترسی به مخزن‌های کد و پروژه‌های میزبانی‌شده در GitHub.
تحریم شکن برای npm؛ برای مشکلات مربوط به دریافت پکیج‌های JavaScript.
تحریم شکن برای PyPI؛ برای بررسی مشکلات دسترسی به مخزن پکیج‌های Python.
تحریم شکن برای pub.dev؛ برای مشکلات دریافت پکیج‌های Dart و Flutter.
تحریم شکن برای Docker؛ برای بررسی مشکلات دسترسی به سرویس‌ها و مخزن‌های مرتبط با Docker.

این صفحات موضوعات متفاوتی دارند. برای مثال، خطای دریافت پکیج از Maven Central با خطای دریافت یک تصویر از Docker یا پکیج از npm یکسان نیست؛ بنابراین، بهتر است برای هر سرویس از راهنمای تخصصی خودش استفاده کنید.

سؤالات متداول درباره تحریم شکن برای Gradle

چرا اینترنت دارم اما Gradle نمی‌تواند کتابخانه‌ها را دانلود کند؟

برقرار بودن اینترنت به معنی دسترسی موفق به تمام مخزن‌های Gradle نیست. ممکن است DNS یک دامنه را resolve نکند، اتصال به سرور timeout شود یا گواهی امنیتی قابل تأیید نباشد. همچنین ممکن است نسخه وابستگی در مخزن تعریف‌شده وجود نداشته باشد. متن کامل خطا را بررسی کنید تا مشخص شود مشکل از شبکه است یا تنظیمات پروژه.

آیا برای Gradle باید DNS را داخل Android Studio تنظیم کنم؟

در حالت معمول، DNS از تنظیمات شبکه سیستم‌عامل یا شبکه‌ای که رایانه به آن متصل است دریافت می‌شود. بنابراین، ابتدا تنظیمات DNS همان دستگاه را بررسی کنید. تنظیمات پراکسی Android Studio یا JVM موضوع جداگانه‌ای است و تنها زمانی باید بررسی شود که شواهد خطا به پراکسی یا تنظیمات محیط اجرا اشاره داشته باشند.

چرا سایت Maven Central باز می‌شود اما Gradle همچنان خطا می‌دهد؟

باز شدن صفحه اصلی یک مخزن در مرورگر تضمین نمی‌کند که تمام درخواست‌های موردنیاز Gradle موفق باشند. ممکن است خطا مربوط به URL دیگری، دریافت یک فایل مشخص، اعتبارسنجی TLS یا نسخه وابستگی باشد. URL و نام مخزنی را که در گزارش خطا آمده است بررسی کنید.

آیا برای دانلود پلاگین‌های Gradle باید مخزن جداگانه‌ای تعریف شود؟

در بسیاری از پروژه‌ها، مخزن‌های پلاگین از طریق بخش pluginManagement تعریف می‌شوند و با مخزن‌های وابستگی‌های معمولی پروژه تفاوت دارند. اگر خطای Plugin not found دریافت می‌کنید، فایل settings.gradle یا settings.gradle.kts را بررسی کنید و مطمئن شوید نام، نسخه و مخزن پلاگین درست تعریف شده‌اند.

چرا Gradle Wrapper دانلود نمی‌شود؟

Gradle Wrapper برای اجرای نسخه تعیین‌شده Gradle ممکن است نیاز داشته باشد فایل توزیع را دریافت کند. اگر این فایل دانلود نمی‌شود، مقدار distributionUrl در فایل gradle-wrapper.properties و متن خطا را بررسی کنید. این مشکل ممکن است به آدرس نامعتبر، اختلال شبکه یا عدم دسترسی به سرور مربوط باشد و لزوماً به وابستگی‌های خود پروژه ارتباط ندارد.

آیا تغییر DNS خطای ناسازگاری نسخه Gradle و Android Gradle Plugin را حل می‌کند؟

خیر، اگر مشکل واقعاً ناشی از ناسازگاری نسخه‌ها باشد، تغییر DNS راهکار مستقیمی نیست. نسخه Gradle، نسخه Android Gradle Plugin و نسخه JDK موردنیاز پروژه را بررسی کنید. اگر در کنار ناسازگاری نسخه‌ها خطای دانلود نیز وجود دارد، هر مشکل را جداگانه عیب‌یابی کنید.

آیا DNS شکن جایگزین پراکسی Gradle است؟

خیر. DNS وظیفه تبدیل نام دامنه به آدرس IP را بر عهده دارد، اما پراکسی واسطه عبور درخواست‌های شبکه است. Gradle تنظیمات پراکسی مخصوص خود را نیز پشتیبانی می‌کند. اگر شبکه شما به پراکسی نیاز دارد، باید تنظیمات معتبر آن را دریافت کنید؛ آدرس‌های نمونه را به‌عنوان پراکسی واقعی وارد نکنید.

اگر Gradle فقط در شبکه شرکت یا دانشگاه خطا می‌دهد، چه کاری انجام دهم؟

ممکن است شبکه موردنظر از فایروال، پراکسی یا سیاست‌های دسترسی خاصی استفاده کند. ابتدا دامنه و URL درج‌شده در خطا را مشخص کنید و سپس تنظیمات شبکه را با مسئول مربوطه بررسی کنید. تغییر DNS به‌تنهایی ممکن است برای حل محدودیت‌های اعمال‌شده در سطح شبکه کافی نباشد.

جمع‌بندی

اگر هنگام اجرای پروژه‌های Java، Kotlin یا Android با خطاهای Gradle مواجه می‌شوید، ابتدا بررسی کنید مشکل به دریافت وابستگی‌ها، دانلود پلاگین‌ها یا دریافت فایل Gradle Wrapper مربوط است. سپس نام مخزن و متن کامل خطا را بررسی کنید و در صورت مشاهده نشانه‌های مرتبط با DNS، تنظیمات شبکه را آزمایش کنید.

شکن می‌تواند یکی از گزینه‌های بررسی مشکلات احتمالی DNS باشد، اما رفع تمام خطاهای Gradle را تضمین نمی‌کند. خطاهای مربوط به پراکسی، TLS، تنظیمات مخزن، نسخه وابستگی‌ها و JDK ممکن است به راهکارهای جداگانه نیاز داشته باشند. تشخیص درست نوع خطا، از تغییرات غیرضروری در تنظیمات پروژه جلوگیری می‌کند.