0
0

چه زمانی با مشکل gradle در اندروید استودیو مواجه می شویم؟ + روش حل مشکل

39 بازدید
رفع مشکل gradle در اندروید استودیو

چه زمانی با مشکل gradle در اندروید استودیو مواجه می شویم؟

در این مقاله قصد داریم به مشکل gradle در اندروید استودیو به‌صورت تخصصی و همچنین راه‌حل آن بپردازیم.

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

منظور از این چالش‌ها، همان خطاها و ارورهایی هستند که در حین کار با آن‌ها مواجه می‌شویم.

یکی از رایج‌ترین آن‌ها خطای همگام‌سازی یا مشکل gradle است.

همان‌طور که گفته شد، متوجه شدیم که این مشکل در اندروید استودیو جزو مشکلاتی است که تقریباً همه با آن حداقل یک بار مواجه می‌شوند.

ما در این مقاله قصد داریم شما را ابتدا با چیستی و دلایل پیشامد این خطا آشنا کنیم.

پس از آن که ماهیت آن را خوب متوجه شدید، به روش‌های مختلف برای حل مشکل خواهیم پرداخت.

 

Gradle چیست؟

 

Gradle به‌خودی‌خود یک نوع ابزار است که برای اتوماسیون ساخت استفاده می‌شود. این ابزار در زبان‌های JVM مانند جاوا، Groovy یا Scala کاربرد دارد.

شاید این نکته برایتان جالب باشد که بدانید در واقع Gradle یک سیستم مبتنی بر پلاگین است و از آن می‌توان برای اجرای Tasks بهره برد.

Gradle در اصل می‌تواند کارهایی مانند اجرای آزمایش‌های مختلف، کامپایل کردن jar ها، ایجاد داکیومنت‌های مختلف و این‌گونه موارد را انجام دهد.

build system یا سیستم ساخت برای اندروید هم به طور مشابه، سورس کد را اتوماسیون و کامپایل می‌کند.

پس از آن هم جهت بسته‌بندی برای استقرار و توزیع یا ایجاد APK مورداستفاده قرار می‌گیرد.

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

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

البته این در حالی است که از قسمت‌های مشترک خودش در اپلیکیشن و برنامه شما مجدداً استفاده خواهد کرد.

پلاگین اندروید مخصوص آن نیز با جعبه ابزار build کار می‌کند. این به آن خاطر است که فرایندها و یک سری تنظیمات قابل‌تغییری را ارائه دهد که مخصوص build باشد و همچنین بتوان با آن برنامه‌های اندروید را تست و آزمایش کرد.

 

مواردی که باعث خطای Gradle می‌شوند

 

چه چیزی باعث پیام خطای Gradle Project Sync Failed در اندروید استودیو می‌شود؟

در ابتدا و در مقدمه این مقاله گفته شد که به دلایل مختلفی ممکن است که پروژه شما در نهایت کامپایل نشود و به مشکل gradle در اندروید استودیو بر بخورید.

در این بخش قصد داریم برخی از دلایلی که باعث ایجاد این مشکل می‌شوند را بررسی کنیم.

طبیعی است که ممکن است برخی از این موارد، دلیل اصلی مشکل gradle شما نباشند اما بد نیست که همه آن‌ها را بدانید.

 

1) اتصال بد اینترنت

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

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

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

 

2) مشکلات کامپایلر Gradle

در برخی از موارد نیز دیده شده است که بخش کامپایلر Gradle دچار مشکل و خطا شده است و برای رفع خطای gradle باید به سراغ آن قسمت کار بروید.

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

 

3) حافظه پنهان یا cache بد در اندروید استودیو

اگر نمی‌دانستید، بدانید که اندروید استودیو برای آنکه درست کار کند از حافظه نهان یا cache استفاده می‌کند.

این مورد در موارد متعددی دیده شده که خراب شود و در چندین ماژول (از جمله Gradle) مشکلاتی ایجاد کند. 

برای حل این مشکل باید cache اندروید استودیو را پاک یا clean و پروژه را rebuild کنید .

برای این منظور به منوی tools در اندروید استودیو مراجعه کنید و گزینه های clean و  rebuild project را به ترتیب بزنید . 

 


4) مشکل فایل‌های ازدست‌رفته در اندروید استودیو

فایل‌های ازدست‌رفته (Missing files)

یک مورد دیگر که ممکن است موجب ایجاد مشکل gradle در اندروید استودیو شود، خطا و مشکل فایل‌های ازدست‌رفته است.

یعنی اینکه در فرایند اجرای Gradle باید فایل‌هایی وجود داشته باشند که دیگر نیستند.

شناسایی و نصب مجدد آن‌ها مشکل را فوراً حل می‌کند.

همیشه سعی کنید اندروید استودیو را بروز کنید و تا جای ممکن به فایل های سیستمی آن دست نزنید . 

 

5) سرورهای پراکسی

باوجوداینکه سرورهای پراکسی به طور فزاینده‌ای محبوب هستند، در مواردی مشاهده شده که Gradle به‌درستی روی آن‌ها همگام‌سازی نمی‌شود.

غیرفعال‌کردن سرور پروکسی هم ممکن است مشکل را حل کند.

به‌طورکلی قبل از این که از هر راهی سعی کنید مشکل gradle در اندروید استودیو را حل کنید، حتماً یک نسخه پشتیبان از پروژه خودتان داشته باشید.

فایل آن را حتماً ذخیره کرده و در صورت لزوم در جای دیگری کپی کنید.

قبل از هر کاری این نکته ضروری است که حتماً باید به‌عنوان administrator وارد سیستم خودتان شوید تا دسترسی نامحدود داشته باشید.

 

Gradle دقیقاً چه چیزی است

 

راه حل های رایج رفع مشکل gradle در اندروید استودیو

 

راه‌حل 1: بررسی اتصال به اینترنت

همان‌طور که گفته شد و توضیح دادیم Gradle به یک اتصال قوی به اینترنت نیاز دارد.

این مسئله هم به آن خاطر است که یکی از کارهای اصلی آن دانلود تمام نسخه‌های موردنیاز برای اجرای پروژه از اینترنت است که در رایانه شما وجود ندارد.

پس حتماً باید داشتن و متصل بودن به اینترنت قوی را چک کنید. این الزامی است.

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

هنگامی که کاملاً مطمئن شدید مشکل gradle در اندروید استودیو به‌خاطر این مورد نیست، می‌توانید به سراغ راه‌حل‌های بعدی بروید.

 

راه‌حل 2: غیرفعال‌کردن پروکسی سرور

یکی دیگر از راه‌حل‌های مشکل gradle در اندروید استودیو همین مورد است.

کاربرد اصلی سرورهای پروکسی این است که دسترسی به اینترنت را برای تمام کاربران بهتر می‌کند و پهنای باند را افزایش می‌دهد.

همچنین این سرورهای پروکسی به طور معمول روزبه‌روز رایج‌تر می‌شوند.

بااین‌حال، سرورهای پروکسی محدودیت‌های خودشان را دارند.

یکی از مشکلاتی که پروکسی سرور موجب ایجاد آن می‌شود این است که ماژول‌های همگام‌سازی درست کار نمی‌کنند که همین گریبان‌گیر Gradle نیز می‌شود.

برای آن که پروکسی سرور خود را غیرفعال کنید باید مراحل زیر را پشت سر بگذارید:

 

  1. ابتدا Windows + R را فشار دهید، “cpl” را در کادر باز شده تایپ کنید و دکمه Enter را فشار دهید.
  2. حالا باید Internet Properties در جلوی شما باز شده باشد. روی تب Connections بروید و سپس روی تنظیمات LAN کلیک کنید.
  3. حال اگر از یک سرور پراکسی استفاده می‌کنید، فیلد با جزئیات داخل بررسی می‌شود. در صورت فعال‌بودن، تیک هر سرور پروکسی را بردارید. حالا اندروید استودیو را ری استارت کنید و بررسی کنید که آیا مشکل حل شده است یا خیر.

 

راه‌حل 3: نصب مجدد فایل‌ها و اجزای گمشده

قبل از آن که به سراغ روش‌های فنی‌تر برای حل مشکل gradle در اندروید استودیو بروید، باید مورد Missing Components را بررسی کنید.

آیا برای اجرا کردن Gradle ماژول‌های دیگری لازم نیست که در سیستم شما وجود داشته باشد؟

Gradle به‌خودی‌خود مستقل نیست و برای عملکرد مناسب به خدمات و اجزای دیگری نیز نیاز دارد.

پس از حالا به بعد هروقت که قصد همگام‌سازی Gradle را داشتید و به یک باره با متن پیام ارور مواجه شدید، این مورد را حتماً بررسی کنید که آیا پیوندی در زیر مشکل آن با عنوان Install missing platform(s) و پروژه همگام‌سازی وجود دارد یا خیر.

با مشاهده چنین چیزی برای حل آن می‌توانید روی آن لینک کلیک کنید و اندروید استودیو به‌صورت خودکار تمام اجزای موردنیاز را دانلود می‌کند.

اکنون پروژه خود را همگام‌سازی (sync)کنید و ببینید آیا این مورد مشکل را حل کرده یا خیر.

البته توجه داشته باشید دانلود این موارد با سرعت اینترنت شما و استفاده از شکن رابطه مستقیم دارد . 

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

در این صورت باید از Restoro Repair استفاده کنید.

Restoro Repair توانایی آن را دارد که فایل‌های خراب و فایل‌های ازدست‌رفته را با فایل‌های سالم مجدداً جایگزین کند.

این راه در اکثر موارد کار می‌کند؛ البته در جایی که مشکل به دلیل خرابی سیستم باشد.

 

توزیع محلی Gradle در اندروید استودیو

 

راه‌حل 4: استفاده از توزیع محلی Gradle

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

در موارد بسیار زیاد مشاهده شده است که سیستم distribution آنلاین با مشکل مواجه شده و باعث آن شده که همگام‌سازی Gradle ناموفق بماند.

راه‌حل دیگر برای حل مشکل gradle در اندروید استودیو دانلود دستی distribution  مخصوص Gradle و استفاده از آن است.

برای این کار باید مراحل زیر را دنبال کنید:

  1. قبل از هر چیز نصب آخرین نسخه Gradle از وب‌سایت رسمی Gradle Release باید انجام شود.
  2. بعد از آن که دانلود کامل شد، آن را ذخیره کرده و در یک پوشه همه چیز را استخراج (extract) کنید.
  3. بعد از اینکه همه این کارها را انجام دادید، اندروید استودیو را باز کرده و این مراحل را دنبال کنید:
    File > Settings > Build, Execution, Deployment > Gradle .
  4. در نهایت هم بر روی گزینه Local Gradle Distribution بزنید و آن را انتخاب کنید. همچنین هنگامی که در بخش خانه Gradle هستید، مسیری که فایل‌ها در آن استخراج شده‌اند را برایش انتخاب کنید.

توجه: اگر از offline work در تنظیمات Global Gradle خود استفاده می‌کنید، تیک آن گزینه حتماً را بردارید.

اکنون می‌توانید پروژه خود را بسازید و بررسی کنید که آیا هنوز هم Gradle دچار خطا می‌شود یا به‌درستی همگام‌سازی خواهد شد.

تمام این مراحل را برای هر پروژه جدیدی که می‌خواهید استارت بزنید، می‌توانید باز دوباره تکرار کنید.



راه‌حل 5: فعال‌کردن GPU Debugger

استفاده و فعال‌سازی GPU Debugger یکی دیگر از راه‌حل‌های مشکل gradle در اندروید استودیو است.

با GPU Debugger شما خواهید توانست برنامه‌های OpenGL ES را باگ زدایی و تجزیه‌وتحلیل کنید.

این کامپوننت چندین عملکرد مختلف دارد که به شما اجازه و امکان بررسی GPU را نیز می‌دهد.

علاوه بر این با آن متوجه می‌شوید که چه چیزی باعث نتیجه رندر شده است.

در برخی از نمونه‌های ساخت Gradle، مشاهده شده که این قابلیت در بعضی از سیستم‌ها غیرفعال است.

با دنبال‌کردن مراحل زیر ماژول‌ها را مجبور به رفرش و نصب این کامپوننت خواهید کرد:

 

  1. روی Tools کلیک و سپس مسیر Android > SDK Manager را طی کنید.
  2. حال باید بر روی تب SDK Tools کلیک کنید و سپس تیک گزینه Android SDK Build-Tools را بردارید. پس از حدود 5 ثانیه انتظار، دوباره آن را فعال کنید.
  3. حالا باید کمی صبر کنید تا لیست به‌روز شود و موارد لازم در آن پر شوند.
  4. هنگامی که این کار کامل شد و موارد جدید پر شدند، به لیست نگاه کنید و گزینه GPU Debugging Tools را علامت بزنید.
  5. پس از آن که این کار را انجام دادید، روی گزینه OK کلیک کنید.

اکنون این ابزارها در برنامه اندروید استودیو شما دانلود می‌شوند و دیگر باید مشکل gradle در اندروید استودیو حل شده باشد و قادر خواهید بود Gradle را بدون مشکل همگام‌سازی کنید.

 

راه‌حل 6: رفرش کردن کش

هر اپلیکیشن و برنامه، از جمله خود مایکروسافت ویندوز، یک حافظه نهان یا کش دارد.

این کش کاربردش در آنجاست تا برنامه‌های مختلف بدون هیچ مشکلی اجرا شوند.

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

در موارد بسیار متعددی مشاهده شده که اگر این حافظه نهان دچار مشکل شود بر روی روند ساخت gradle هم تأثیر می‌گذارد و آن را متوقف خواهد کرد.

در این راه‌حل، ابتدا کل کش را Refresh خواهیم کرد و پس از حذف فایل‌های Gradle موجود، اندروید استودیو را مجدداً راه‌اندازی می‌کنیم تا ببینیم که مشکل gradle در اندروید استودیو حل شده است یا خیر.

 

مشکل gradle در اندروید استودیو

 

جمع‌بندی و کلام آخر

در این مقاله به بررسی روش های رایج حل مشکل gradle در اندروید استودیو پرداختیم.

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

به‌طورکلی دنیای برنامه‌نویسی اندروید پر است از مواجه شدن با مشکلات و ارورهای مختلف.

برای دانستن راه‌حل هرکدام بعد از مواجه شدن با آن‌ها، باید خود مشکل را به‌خوبی بشناسید.

آیا این مطلب را می پسندید؟
اشتراک گذاری:
زهرا فریدونی
علاقه‌مند و فعال در زمینه برنامه نویسی سمت وب و همچنین مدرس وب و برنامه نویسی اندروید هستم. از زمان دانشجویی برنامه نویسی کار میکردم . اما از سال ۹۴ به صورت تخصصی تر به برنامه نویسی روی آوردم و از سال ۹۶ شروع به تدریس برنامه نویسی وب و اندروید کردم. https://novindevelopers.com/about/

نظرات

0 نظر در مورد چه زمانی با مشکل gradle در اندروید استودیو مواجه می شویم؟ + روش حل مشکل

دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد.

هیچ دیدگاهی نوشته نشده است.