Maven Repository

راه‌اندازی مخزن Maven در پروژه‌های Gradle

Maven Repository

در صورتی که از فایل build.gradle استفاده می‌کنید:

Groovy (build.gradle)
buildscript {
  repositories {
    maven { url 'https://maven.myket.ir' }
  }
}
allprojects {
  repositories {
    maven { url 'https://maven.myket.ir' }
  }
}

در صورتی که از settings.gradle استفاده می‌کنید:

Kotlin DSL (settings.gradle)
pluginManagement {
  repositories {
    maven { url = uri("https://maven.myket.ir/") }
  }
}
dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    maven { url = uri("https://maven.myket.ir/") }
  }
}

🔄 بروزرسانی خودکار کتابخانه‌ها

مخزن Maven مایکت به‌صورت مداوم با مخازن رسمی همگام‌سازی می‌شود تا جدیدترین نسخهٔ کتابخانه‌ها در دسترس شما قرار بگیرد.

📦

کتابخانه موجود است

مستقیم و با سرعت بالا از داخل ایران دانلود می‌شود

🌐

کتابخانه جدید است

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

🔒 بررسی صحت فایل‌ها با Checksum

برای اطمینان از اینکه کتابخانهٔ دانلود شده دقیقاً همان نسخهٔ اصلی و بدون تغییر است، می‌توانید مقدار Checksum فایل را با مقدار منتشرشده توسط مخزن رسمی مقایسه کنید.

مثال Checksum رسمی:

URL
https://repo1.maven.org/maven2/com/squareup/okhttp3/okhttp/4.12.0/okhttp-4.12.0.jar.sha1

از آنجا که Maven مایکت فایل‌ها را بدون تغییر و به‌صورت Cache از مخازن رسمی نگهداری می‌کند، Checksum فایل دریافتی از مایکت باید دقیقاً با مقدار رسمی یکسان باشد.

📚 مخازن رسمی پشتیبانی شده

سرویس Maven مایکت به‌عنوان یک پروکسی هوشمند، درخواست‌ها را به مخازن رسمی هدایت می‌کند و کتابخانه‌ها را بدون تغییر دریافت و کش می‌کند.

در حال حاضر، این سرویس از مخازن رسمی زیر پشتیبانی می‌کند:

💡

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

❓ سوالات متداول

۱. سرویس Maven مایکت چیست؟
سرویس Maven مایکت یک مخزن (Repository) عمومی برای کتابخانه‌ها و dependencyهای اندروید است که دسترسی سریع، پایدار و بدون محدودیت تحریمی را برای توسعه‌دهندگان داخل ایران فراهم می‌کند.
۲. چرا باید از Maven مایکت استفاده کنم؟
بسیاری از مخازن رسمی به‌دلیل تحریم یا محدودیت شبکه از داخل ایران کند یا غیرقابل دسترس هستند. مایکت این مشکل را با ارائهٔ یک مسیر پایدار و سریع برای دریافت کتابخانه‌ها حل می‌کند.
۳. آیا استفاده از این سرویس رایگان است؟
بله، استفاده از Maven مایکت برای توسعه‌دهندگان رایگان است.
۴. چگونه مطمئن شوم فایل دریافتی همان نسخهٔ اصلی است؟
می‌توانید مقدار Checksum (SHA1 یا SHA256) فایل را محاسبه و با مقدار منتشرشده توسط مخزن رسمی مقایسه کنید. اگر مقادیر یکسان باشند، فایل دقیقاً همان نسخهٔ اصلی است.
۵. اگر یک نسخه از کتابخانه در مخزن موجود نباشد چه می‌شود؟
در اولین درخواست فایل از مخزن رسمی دریافت می‌شود. به شما تحویل داده می‌شود و در مخزن مایکت ذخیره (Cache) می‌شود. از دفعات بعد، همان نسخه با سرعت بالا از داخل ایران ارائه خواهد شد.
۶. آیا نسخه‌های جدید کتابخانه‌ها به‌صورت خودکار اضافه می‌شوند؟
بله. با انتشار نسخه‌های جدید در مخازن رسمی، این نسخه‌ها در اولین درخواست یا طی همگام‌سازی در مخزن مایکت در دسترس قرار می‌گیرند.
۷. آیا این سرویس فقط برای اندروید است؟
تمرکز اصلی Maven مایکت بر کتابخانه‌های مورد استفاده در توسعهٔ اندروید است، اما بسیاری از dependencyهای Java/Kotlin نیز از طریق این مخزن قابل دریافت هستند.
۸. آیا استفاده از این سرویس Build پروژه را تغییر می‌دهد؟
خیر. تنها با اضافه کردن آدرس مخزن به Gradle، پروژهٔ شما بدون تغییر در کدها یا dependencyها قابل Build خواهد بود.
۹. آیا استفاده از Maven مایکت امن است؟
بله. فایل‌ها از منابع رسمی دریافت می‌شوند. Checksum آن‌ها قابل بررسی و تطبیق است.
۱۰. آیا می‌توانم از این سرویس در CI/CD استفاده کنم؟
بله. Maven مایکت برای Build Serverها و CI/CD بسیار مناسب است، زیرا وابستگی به دسترسی خارجی را کاهش می‌دهد و سرعت Build را افزایش می‌دهد، همچنین پایداری دانلود dependencyها را بالا می‌برد.
۱۱. چگونه می‌توانم استفاده از Maven مایکت را شروع کنم؟

کافی است مخزن را به فایل build.gradle اضافه کنید:

Groovy
repositories {
  maven { url 'https://maven.myket.ir' }
}
۱۲. اگر مشکلی در دریافت کتابخانه‌ها داشتم چه کار کنم؟
  • اتصال اینترنت و تنظیمات Proxy را بررسی کنید.
  • از درستی آدرس مخزن در Gradle مطمئن شوید.
  • در صورت تداوم مشکل، با تیم پشتیبانی مایکت تماس بگیرید.
۱۳. آیا این سرویس صرفا برای توسعه‌دهندگان مایکت قابل استفاده است؟
خیر، دسترسی به این سرویس برای همه‌ی توسعه‌دهندگان باز است و محدودیتی برای استفاده وجود ندارد.
۱۴. آیا این سرویس در زمان‌هایی که اختلال اینترنت بین‌الملل در کشور وجود دارد، همچنان کار می‌کند؟
بله، به دلیل اینکه این سرویس فایل‌های دانلود شده را کش می‌کند، همچنان می‌توان به نسخه‌های کش شده دسترسی داشت. در نظر داشته باشید، در صورتی که اختلال اینترنت بین‌الملل در دیتاسنترهای مایکت وجود داشته باشد، امکان دریافت کتابخانه‌های جدید وجود نخواهد داشت.