null.md

راهنمای جامع Gradle و Glide برای توسعه‌دهندگان

این راهنما توضیح می‌دهد که Gradle و Glide چه هستند و چگونه با هم کار می‌کنند تا قابلیت‌های قدرتمندی مثل بارگذاری عکس‌های متحرک را به پروژه اندروید شما اضافه کنند.

---

بخش اول: Gradle چیست؟ (مدیر پروژه شما 🧑‍💼)

Gradle سیستم ساخت (Build System) رسمی و اتوماتیک برای پروژه‌های اندروید است. آن را به عنوان مدیر پروژه هوشمند خود در نظر بگیرید که وظایف تکراری و پیچیده را برای شما انجام می‌دهد.

کارهایی که Gradle انجام می‌دهد:

1. کامپایل کد: کدهای کاتلین یا جاوا شما را به کدی که دستگاه اندروید می‌فهمد تبدیل می‌کند.
2. مدیریت منابع: تمام فایل‌های پروژه شما (عکس‌ها، فونت‌ها، لایه‌ها) را بسته‌بندی می‌کند.
3. ساخت فایل نهایی (APK/AAB): تمام بخش‌های پروژه را در یک فایل قابل نصب جمع‌آوری می‌کند.
4. مهم‌ترین وظیفه (برای این بحث): مدیریت وابستگی‌ها (Dependency Management).

مدیریت وابستگی‌ها چیست؟

در گذشته، اگر می‌خواستید از کد یک نفر دیگر (یک کتابخانه) استفاده کنید، باید فایل آن (مثلاً یک فایل .jar) را به صورت دستی دانلود کرده و به پروژه اضافه می‌کردید. این روش مشکلات زیادی داشت.

Gradle این فرآیند را کاملاً خودکار می‌کند. شما دیگر فایلی را دستی دانلود نمی‌کنید. به جای آن، فقط نام و نسخه کتابخانه مورد نیازتان را در یک فایل متنی به نام build.gradle.kts به Gradle اعلام می‌کنید.

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

---

بخش دوم: Glide چیست؟ (متخصص بارگذاری تصویر 🖼️)

Glide یک کتابخانه یا وابستگی (Dependency) شخص ثالث است. این کتابخانه به طور پیش‌فرض در اندروید وجود ندارد و ما باید آن را به پروژه خود اضافه کنیم (با استفاده از Gradle).

چرا به Glide نیاز داریم؟ بارگذاری عکس در اپلیکیشن‌ها، مخصوصاً از اینترنت، پیچیده‌تر از آن چیزی است که به نظر می‌رسد. Glide این کار پیچیده را به بهترین شکل ممکن انجام می‌دهد و مزایای زیر را دارد:

• مدیریت حافظه (Caching): عکس‌هایی که یک بار دانلود شده‌اند را در حافظه گوشی ذخیره می‌کند تا دفعه بعد با سرعت بسیار بالا نمایش داده شوند.
• پشتیبانی از فرمت‌های مختلف: به راحتی عکس‌های متحرک (GIF) را نمایش می‌دهد.
• بهینه‌سازی: به صورت خودکار اندازه عکس‌ها را متناسب با جایی که قرار است نمایش داده شوند تغییر می‌دهد تا حافظه کمتری مصرف شود.
• سادگی استفاده: با یک خط کد می‌توانید یک عکس را از اینترنت یا منابع داخلی پروژه بارگذاری کنید.

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

---

بخش سوم: این دو چگونه با هم کار می‌کنند؟ (گردش کار ⚙️)

گردش کار بسیار ساده است:

1. اعلام نیاز (Declaration): شما به عنوان توسعه‌دهنده، در فایل build.gradle.kts اعلام می‌کنید که به کتابخانه Glide نیاز دارید.

   dependencies {
       // ...
       implementation("com.github.bumptech.glide:glide:4.16.0")
   }

2. همگام‌سازی (Sync): با کلیک روی دکمه Sync Now در اندروید استودیو، به Gradle دستور می‌دهید لیست نیازمندی‌ها را بررسی کند.
3. انجام وظیفه توسط Gradle:
   • Gradle به اینترنت متصل می‌شود.
   • کتابخانه Glide با نسخه 4.16.0 را در مخازن آنلاین پیدا می‌کند.
   • آن را دانلود کرده و در سیستم شما ذخیره می‌کند.
   • آن را به پروژه شما متصل می‌کند تا کدهای شما بتوانند به آن دسترسی داشته باشند.
4. استفاده (Usage): حالا که Gradle کار خود را انجام داده، شما می‌توانید در فایل MainActivity.kt خود به سادگی از کلاس Glide استفاده کنید، انگار که همیشه بخشی از پروژه شما بوده است.