مستودع أحادي مع Kotlin: تنظيم الكود عمليًا

مستودع واحد مع Kotlin: تنظيم الكود عمليًا

في تطوير البرمجيات الحديثة، يظهر بشكل متزايد الاختيار بين المستودع الواحد (monorepo) والمستودعات المتعددة (multirepo). بالنسبة للمشاريع التي تستخدم Kotlin، خاصة تلك التي تستخدم Kotlin Multiplatform أو بنية الخدمات المصغرة، يصبح المستودع الواحد أداة قوية. في هذه المقالة، سنشرح كيفية تنظيم الكود بشكل صحيح في مستودع واحد باستخدام Kotlin، وسنستعرض أمثلة عملية وأفضل الممارسات التي ستساعدك على تجنب الأخطاء النموذجية.

ما هو المستودع الواحد ولماذا هو ضروري في Kotlin؟

المستودع الواحد هو نهج يتم فيه تخزين جميع أكواد المشروع (أو عدة مشاريع مرتبطة) في مستودع واحد. في سياق Kotlin، يمكن أن يشمل ذلك:

• المكتبات المشتركة — الأدوات المساعدة، نماذج البيانات، DTO.
• وحدات التطبيقات — الواجهة الخلفية (Ktor, Spring)، الواجهة الأمامية (Kotlin/JS)، تطبيقات الهواتف المحمولة (Kotlin Multiplatform).
• النصوص البرمجية والتكوينات — CI/CD، Dockerfile، نصوص Gradle.

المزايا الرئيسية للمستودع الواحد لمشاريع Kotlin:

• إصدار موحد للتبعيات — جميع الوحدات تستخدم إصدارًا واحدًا من Kotlin والمكتبات، مما يقلل من خطر التعارضات.
• إعادة هيكلة مبسطة — تغيير API في وحدة واحدة يظهر فورًا في جميع الوحدات التابعة.
• إعداد CI/CD أسهل — خط أنابيب واحد لجميع المكونات.
• الشفافية — قاعدة الكود بأكملها متاحة في مكان واحد.

ومع ذلك، هناك عيوب: قد ينمو حجم المستودع، ويزداد وقت الاستنساخ. لكن بالنسبة للمشاريع المتوسطة والكبيرة على Kotlin، غالبًا ما يكون المستودع الواحد هو الحل الأمثل.

هيكل المستودع الواحد: نموذج عملي

التنظيم الصحيح للمجلدات هو أساس النجاح. دعنا نستعرض هيكلًا نموذجيًا لمشروع Kotlin باستخدام Gradle:

my-kotlin-monorepo/├── build.gradle.kts          # سكريبت البناء الجذري├── settings.gradle.kts       # إعداد الوحدات├── gradle.properties         # معلمات Gradle العامة├── gradle/│   └── libs.versions.toml    # كتالوج الإصدارات (موصى به)├── modules/│   ├── common/               # الأدوات والنماذج المشتركة│   │   ├── build.gradle.kts│   │   └── src/│   ├── backend/              # خدمة الواجهة الخلفية على Ktor│   │   ├── build.gradle.kts│   │   └── src/│   ├── android-app/          # تطبيق Android│   │   ├── build.gradle.kts│   │   └── src/│   └── web-client/           # عميل Kotlin/JS│       ├── build.gradle.kts│       └── src/├── scripts/                  # النصوص البرمجية المساعدة│   └── deploy.sh└── docs/                     # التوثيق    └── architecture.md

ملف settings.gradle.kts يقوم بتوصيل الوحدات:

rootProject.name = "my-kotlin-monorepo"

include(":modules:common")include(":modules:backend")include(":modules:android-app")include(":modules:web-client")

في build.gradle.kts الجذري، يمكن تعيين الإضافات والتبعيات العامة:

plugins {    kotlin("jvm") version "1.9.22" apply false    kotlin("multiplatform") version "1.9.22" apply false    id("com.android.application") version "8.2.0" apply false}

إدارة التبعيات: كتالوج الإصدارات والإضافات التقليدية

في المستودع الواحد، من المهم جدًا تجنب تكرار إصدارات التبعيات. لهذا، يستخدمون في Kotlin كتالوج الإصدارات (ملف libs.versions.toml).

مثال gradle/libs.versions.toml:

[versions]kotlin = "1.9.22"ktor = "2.3.7"coroutines = "1.8.0"

[libraries]kotlin-stdlib = { module = "org.jetbrains.kotlin:kotlin-stdlib", version.ref = "kotlin" }ktor-server-core = { module = "io.k