إعداد المكوّن الإضافي لمكتبة Android Gradle في KMP

المكوّن الإضافي com.android.kotlin.multiplatform.library لنظام Gradle هو الأداة المتاحة رسميًا لإضافة هدف Android إلى وحدة مكتبة في Kotlin Multiplatform (KMP). ويسهّل هذا النظام عملية ضبط إعدادات المشاريع، ويحسِّن أداء الإصدار، ويتيح إمكانية دمج أفضل مع "استوديو Android".

يعتمد استخدام المكوّن الإضافي com.android.library لتطوير KMP على واجهات برمجة تطبيقات مكوّن إضافي لنظام Gradle المتوافق مع Android التي تم إيقافها نهائيًا وتتطلّب الموافقة في الإصدار 9.0 والإصدارات الأحدث من مكوّن إضافي لنظام Gradle المتوافق مع Android (الربع الرابع من عام 2025). ومن المتوقّع إزالة واجهات برمجة التطبيقات هذه في الإصدار 10.0 من مكوّن إضافي لنظام Gradle المتوافق مع Android (النصف الثاني من عام 2026).

لتطبيق هذا المكوّن الإضافي، يُرجى الرجوع إلى قسم تطبيق المكوّن الإضافي Android-KMP. إذا كنت بحاجة إلى نقل البيانات من واجهات برمجة التطبيقات القديمة، يُرجى الاطّلاع على دليل نقل البيانات.

للحصول على مساعدة بشأن نقل البيانات إلى الإصدار 9.0 أو الإصدارات الأحدث من "المكوّن الإضافي لنظام Android Gradle"، يمكنك استخدام مهارة الوكيل التي أنشأتها JetBrains لتطبيقات KMP. لمزيد من المعلومات حول استخدام المهارات في استوديو Android، يُرجى الاطّلاع على توسيع "وضع الوكيل" باستخدام المهارات. يُرجى العِلم أنّ نتائج الذكاء الاصطناعي ليست قابلة للتوقّع بشكل كامل.

الميزات والاختلافات الرئيسية

تم تصميم المكوّن الإضافي Android-KMP خصيصًا لمشاريع KMP، ويختلف عن المكوّن الإضافي com.android.library العادي في عدة جوانب رئيسية:

• بنية الإصدار الفردي: تستخدم الإضافة إصدارًا واحدًا، ما يؤدي إلى إزالة التوافق مع نكهات المنتجات وأنواع الإصدارات، ما يسهّل عملية الإعداد ويحسّن أداء الإصدار.

• محسَّن لـ KMP: تم تصميم المكوّن الإضافي لمكتبات KMP، مع التركيز على رموز Kotlin البرمجية المشترَكة وإمكانية التشغيل التفاعلي، مع إغفال إمكانية استخدام الإصدارات الأصلية الخاصة بنظام Android وAIDL وRenderScript.

• الاختبارات غير مفعَّلة تلقائيًا: يتم إيقاف كل من اختبارات الوحدات والاختبارات على الأجهزة (الاختبارات الآلية) تلقائيًا لتحسين سرعة الإنشاء. ويمكنك تفعيلها إذا لزم الأمر.

• لا توجد إضافة Android من المستوى الأعلى: تتم معالجة الإعدادات باستخدام حظر android ضمن لغة DSL الخاصة بمنصة KMP في Gradle، ما يحافظ على بنية متسقة لمشاريع KMP. ما مِن حظر على مستوى android.

• تفعيل تجميع Java: يتم إيقاف تجميع Java تلقائيًا. استخدِم withJava() في حظر android لتفعيله. يؤدي ذلك إلى تحسين أوقات الإنشاء عندما لا يكون تجميع Java ضروريًا.

مزايا إضافة Android-KMP

يوفّر المكوّن الإضافي Android-KMP المزايا التالية لمشاريع KMP:

• تحسين أداء عملية الإنشاء وثباتها: تم تصميم هذه الميزة لتحسين سرعة الإنشاء وتعزيز الثبات في مشاريع KMP، كما أنّ تركيزها على سير عمل KMP يساهم في جعل عملية الإنشاء أكثر فعالية وموثوقية.

• تكامل محسّن مع بيئة التطوير المتكاملة (IDE): يوفّر هذا التكامل إمكانات أفضل لإكمال الرموز البرمجية والتنقّل وتصحيح الأخطاء وتحسين تجربة المطوّرين بشكل عام عند استخدام مكتبات KMP على Android.

• تبسيط عملية إعداد المشاريع: يسهّل المكوّن الإضافي عملية إعداد مشاريع KMP من خلال إزالة التعقيدات الخاصة بنظام Android، مثل تنويعات التصميم، ما يؤدي إلى إنشاء ملفات تصميم أكثر وضوحًا وأسهل صيانة. في السابق، كان استخدام المكوّن الإضافي com.android.library في مشاريع KMP يؤدي إلى إنشاء أسماء غير واضحة لمجموعات رموز المصدر، مثل androidAndroidTest. كان نمط التسمية هذا أقل وضوحًا للمطوّرين الذين يعرفون بنى مشاريع KMP العادية.

حلول بديلة للميزات غير المتوافقة

عند مقارنة عملية دمج KMP مع المكوّن الإضافي com.android.library، نجد أنّ بعض الميزات غير متوفّرة في المكوّن الإضافي com.android.kotlin.multiplatform.library. في ما يلي الحلول البديلة للميزات غير المتوافقة:

• تنويعات التصميم

  لا تتوافق هذه الميزة مع أنواع الإصدارات وصيغ المنتجات، لأنّ المكوّن الإضافي الجديد يستخدم بنية تنويعة واحدة، ما يسهّل عملية الضبط ويحسّن أداء عملية الإنشاء.

  إذا كنت بحاجة إلى صيغ إصدار، ننصحك بإنشاء وحدة مكتبة Android مستقلة باستخدام إضافة com.android.library، وإعداد أنواع الإصدارات وصيغ المنتجات داخل هذه الوحدة، ثم استخدامها كعنصر تابع للمشروع العادي من مجموعة رموز المصدر androidMain في مكتبة Kotlin Multiplatform. لمزيد من التفاصيل، يُرجى الاطّلاع على إنشاء مكتبة Android وإعداد تنويعات الإصدارات.

• ربط البيانات وربط العرض

  وهي ميزات خاصة بإطار عمل واجهة المستخدم في Android ومرتبطة بشكل وثيق بنظام View في Android وتنسيقات XML. باستخدام المكوّن الإضافي الجديد لمكتبة Android-KMP، ننصحك بالتعامل مع واجهة المستخدم باستخدام إطار عمل متعدد المنصات، مثل Compose Multiplatform. يُعدّ ربط البيانات وربط العرض من تفاصيل التنفيذ الخاصة بتطبيق Android نهائي، وليس مكتبة قابلة للمشاركة.

• إتاحة الإصدارات الأصلية

  يركّز المكوّن الإضافي الجديد على إنشاء ملف AAR عادي لنظام التشغيل Android. تتولّى أهداف KMP الأصلية (مثل androidNativeArm64 وandroidNativeX86) وإمكانات التوافق مع لغة C عملية دمج الرمز البرمجي الأصلي في Kotlin Multiplatform مباشرةً. إذا كنت بحاجة إلى تضمين رمز C/C++ أصلي، عليك تعريفه كجزء من مجموعة رموز المصدر المشتركة أو الأصلية وضبط إمكانية التشغيل التفاعلي لـ C ضمن الحظر kotlin، بدلاً من استخدام آلية externalNativeBuild الخاصة بنظام Android.

  بدلاً من ذلك، إذا كنت بحاجة إلى دعم الإصدار الأصلي من خلال externalNativeBuild، ننصحك بإنشاء وحدة com.android.library مستقلة ومنفصلة يمكنك من خلالها دمج الرمز البرمجي الأصلي واستخدام هذه المكتبة المستقلة من مجموعة المصادر androidMain لمشروع مكتبة Kotlin Multiplatform. لمزيد من التفاصيل، يُرجى الاطّلاع على إنشاء مكتبة Android وإضافة رمز C وC++ إلى مشروعك.

• BuildConfig class

  تكون ميزة BuildConfig مفيدة جدًا في البيئات المتعددة المتغيرات. بما أنّ المكوّن الإضافي الجديد لمكتبة Kotlin Multiplatform لا يعتمد على صيغة معيّنة ولا يتيح استخدام أنواع الإصدارات ونكهات المنتجات، لم يتم تنفيذ هذه الميزة. ننصحك كبديل باستخدام المكوّن الإضافي BuildKonfig أو حلول مشابهة من المنتدى لإنشاء بيانات وصفية لجميع الاستهدافات.

المتطلبات الأساسية

لاستخدام المكوّن الإضافي com.android.kotlin.multiplatform.library، يجب ضبط مشروعك على الحد الأدنى من الإصدارات التالية أو الإصدارات الأحدث:

• المكوّن الإضافي لنظام Gradle المتوافق مع Android (AGP): الإصدار 8.10.0
• إضافة Kotlin Gradle (KGP): الإصدار 2.0.0

تطبيق المكوّن الإضافي Android-KMP على وحدة حالية

لتطبيق المكوّن الإضافي Android-KMP على وحدة مكتبة KMP حالية، اتّبِع الخطوات التالية:

1. حدِّد المكوّنات الإضافية في كتالوج الإصدارات. افتح ملف TOML الخاص بكتالوج الإصدارات (عادةً gradle/libs.versions.toml) وأضِف قسم تعريفات المكوّنات الإضافية:

   # To check the version number of the latest Kotlin release, go to
   # https://kotlinlang.org/docs/releases.html
   
   [versions]
   androidGradlePlugin = "9.2.0"
   kotlin = "KOTLIN_VERSION"
   
   [plugins]
   kotlin-multiplatform = { id = "org.jetbrains.kotlin.multiplatform", version.ref = "kotlin" }
   android-kotlin-multiplatform-library = { id = "com.android.kotlin.multiplatform.library", version.ref = "androidGradlePlugin" }
   

2. تطبيق بيان المكوّن الإضافي في ملف الإصدار الجذر افتح ملف build.gradle.kts الموجود في الدليل الجذر لمشروعك. أضِف أسماء المكوّنات الإضافية البديلة إلى الحظر plugins باستخدام apply false. ويتيح ذلك استخدام أسماء مستعارة للمكوّن الإضافي في جميع المشاريع الفرعية بدون تطبيق منطق المكوّن الإضافي على المشروع الرئيسي نفسه.

   Kotlin

   // Root build.gradle.kts file
   
   plugins {
      alias(libs.plugins.kotlin.multiplatform) apply false
   
      // Add the following
      alias(libs.plugins.android.kotlin.multiplatform.library) apply false
   }

   أنيق

   // Root build.gradle file
   
   plugins {
      alias(libs.plugins.kotlin.multiplatform) apply false
   
      // Add the following
      alias(libs.plugins.android.kotlin.multiplatform.library) apply false
   }

3. طبِّق المكوّن الإضافي في ملف إنشاء وحدة مكتبة KMP. افتح ملف build.gradle.kts في وحدة مكتبة KMP وطبِّق المكوّن الإضافي في أعلى الملف ضمن الحزمة plugins:

   Kotlin

   // Module-specific build.gradle.kts file
   
   plugins {
      alias(libs.plugins.kotlin.multiplatform)
   
      // Add the following
      alias(libs.plugins.android.kotlin.multiplatform.library)
   }

   أنيق

   // Module-specific build.gradle file
   
   plugins {
      alias(libs.plugins.kotlin.multiplatform)
   
      // Add the following
      alias(libs.plugins.android.kotlin.multiplatform.library)
   }

4. ضبط هدف KMP لنظام التشغيل Android اضبط إعدادات حزمة Kotlin Multiplatform (kotlin) لتحديد هدف Android. ضِمن كتلة kotlin، حدِّد هدف Android باستخدام android:

   Kotlin

   kotlin {
      android {
          namespace = "com.example.kmpfirstlib"
          compileSdk = 33
          minSdk = 24
   
          withJava() // enable java compilation support
          withHostTestBuilder {}.configure {}
          withDeviceTestBuilder {
              sourceSetTreeName = "test"
          }
   
          compilerOptions.configure {
              jvmTarget.set(
                  org.jetbrains.kotlin.gradle.dsl.JvmTarget.JVM_1_8
              )
          }
      }
   
      sourceSets {
          androidMain {
              dependencies {
                  // Add Android-specific dependencies here
              }
          }
          getByName("androidHostTest") {
              dependencies {
              }
          }
   
          getByName("androidDeviceTest") {
              dependencies {
              }
          }
      }
      // ... other targets (JVM, iOS, etc.) ...
   }

   أنيق

   kotlin {
      android {
          namespace = "com.example.kmpfirstlib"
          compileSdk = 33
          minSdk = 24
   
          withJava() // enable java compilation support
          withHostTestBuilder {}.configure {}
          withDeviceTestBuilder {
              it.sourceSetTreeName = "test"
          }
   
          compilerOptions.options.jvmTarget.set(
              org.jetbrains.kotlin.gradle.dsl.JvmTarget.JVM_1_8
          )
      }
   
      sourceSets {
          androidMain {
              dependencies {
              }
          }
          androidHostTest {
              dependencies {
              }
          }
          androidDeviceTest {
              dependencies {
              }
          }
      }
      // ... other targets (JVM, iOS, etc.) ...
   }

5. تطبيق التغييرات بعد تطبيق المكوّن الإضافي وضبط kotlin الحظر، عليك مزامنة مشروع Gradle لتطبيق التغييرات.

نقل البيانات من المكوّن الإضافي القديم

يساعدك هذا الدليل في نقل البيانات من المكوّن الإضافي القديم com.android.library إلى المكوّن الإضافي com.android.kotlin.multiplatform.library.

1. نقل المستندات المصدر

كانت الإضافة القديمة تتيح لك استخدام مجموعات المصادر src/main وsrc/test وsrc/androidTest، بالإضافة إلى src/androidMain وsrc/androidHostTest وsrc/androidDeviceTest. أما الإضافة الجديدة، فتستخدم فقط أدلة المصادر الأخيرة، لذا عليك نقل المصادر من src/main إلى src/androidMain ومن src/test إلى src/androidHostTest ومن src/androidTest إلى src/androidDeviceTest.

2. ضبط أدلة المصادر والموارد المخصّصة

إذا كانت لديك ملفات مصدر أو موارد في أدلة غير عادية، سبق لك ضبطها باستخدام الحظر sourceSets. باستخدام المكوّن الإضافي الجديد، استخدِم الإضافة androidComponents لإضافة أدلة مصدر ثابتة إلى صيغة التطبيق.

يُرجى العِلم أنّه باستخدام المكوّن الإضافي الجديد، تضيف الطريقة addStaticSourceDirectory الدليل إلى القائمة الحالية لأدلة المصادر، بينما تستبدل الطريقة setSrcDirs القائمة باستخدام المكوّن الإضافي القديم، وتضيف الطريقة srcDir إلى القائمة.

// build.gradle.kts

androidComponents {
    onVariants { variant ->
        // Add a directory for Kotlin sources
        variant.sources.kotlin?.addStaticSourceDirectory("other/kotlin")

        // Add a directory for Android assets
        variant.sources.assets?.addStaticSourceDirectory("other/assets")
    }
}

// build.gradle.kts

android {
    sourceSets {
        getByName("main") {
            // Replaces the directory for Kotlin sources.
            kotlin.setSrcDirs(listOf("other/kotlin"))

            // Appends a directory for assets.
            assets.srcDir("other/assets")
        }
    }
}

3- تحديد الاعتماديات

من المهام الشائعة تحديد التبعيات لمجموعات المصادر الخاصة بنظام Android. ويتطلّب المكوّن الإضافي الجديد وضع هذه التبعيات بشكل صريح ضمن الحظر sourceSets، على عكس الحظر العام dependencies المستخدَم سابقًا.

// build.gradle.kts

kotlin {
    android {}
    //... other targets

    sourceSets {
        commonMain.dependencies {
            implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.8.0")
        }

        // Dependencies are now scoped to the specific Android source set
        androidMain.dependencies {
            implementation("androidx.appcompat:appcompat:1.7.0")
            implementation("com.google.android.material:material:1.11.0")
        }
    }
}

// build.gradle.kts

kotlin {
    android {
        compilations.getByName("deviceTest") {
            kotlinOptions.languageVersion = "2.0"
        }
    }
}

// build.gradle.kts

kotlin {
  androidTarget()
  //... other targets
}

// Dependencies for all source sets were often mixed in one block
dependencies {
  // Common dependencies
  commonMainImplementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.8.0")

  // Android-specific dependencies
  implementation("androidx.appcompat:appcompat:1.7.0")
  implementation("com.google.android.material:material:1.11.0")
}

4. تفعيل موارد Android

لا يتم تفعيل دعم موارد Android (مجلدات res) تلقائيًا باستخدام المكوّن الإضافي الجديد لتحسين أداء الإصدار، بل يجب الموافقة على استخدامها. ويساعد هذا التغيير في ضمان عدم تحمّل المشاريع التي لا تتطلّب موارد خاصة بنظام Android عبء الإصدار المرتبط بها.

// build.gradle.kts

kotlin {
  android {
    // ...
    // Enable Android resource processing
    androidResources {
      enable = true
    }
  }
}

// Project Structure
// └── src
//     └── androidMain
//         └── res
//             ├── values
//             │   └── strings.xml
//             └── drawable
//                 └── icon.xml

// build.gradle.kts

android {
    namespace = "com.example.library"
    compileSdk = 34
    // No extra configuration was needed to enable resources.
}

// Project Structure
// └── src
//     └── main
//         └── res
//             ├── values
//             │   └── strings.xml
//             └── drawable
//                 └── icon.xml

5. ضبط اختبارات المضيف والجهاز

يؤدي المكوّن الإضافي الجديد تلقائيًا إلى إيقاف الاختبارات على الجهاز (الاختبارات المزوّدة بأدوات) والاختبارات على المضيف (اختبارات الوحدات) في Android. يجب الموافقة بشكل صريح على إنشاء مجموعات ومَراجع اختبارية، بينما كانت الإضافة القديمة تنشئها تلقائيًا.

يساعد نموذج التفعيل هذا في التأكّد من أنّ مشروعك يظل بسيطًا ولا يتضمّن سوى منطق الإنشاء ومجموعات المصادر التي تستخدمها بشكل نشط.

// build.gradle.kts

kotlin {
  android {
    // ...

    // Opt-in to enable and configure host-side (unit) tests
    withHostTest {
      isIncludeAndroidResources = true
    }

    // Opt-in to enable and configure device-side (instrumented) tests
    withDeviceTest {
      instrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
      execution = "HOST"
    }
  }
}

// Project Structure (After Opt-in)
// └── src
//     ├── androidHostTest
//     └── androidDeviceTest

// build.gradle.kts

android {
  defaultConfig {
    // Runner was configured in defaultConfig
    testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
  }

  testOptions {
    // Configure unit tests (for the 'test' source set)
    unitTests.isIncludeAndroidResources = true

    // Configure device tests (for the 'androidTest' source set)
    execution = "HOST"
  }
}

// Project Structure (Defaults)
// └── src
//     ├── test
//     └── androidTest

6. تفعيل تجميع مصدر Java

إذا كانت مكتبة KMP تحتاج إلى تجميع مصادر Java لاستهداف Android، يجب تفعيل هذه الوظيفة بشكل صريح باستخدام المكوّن الإضافي الجديد. يُرجى العِلم أنّ هذا الإعداد يتيح تجميع ملفات Java الموجودة مباشرةً في مشروعك، وليس التجميع لملفات التبعية. تتغيّر أيضًا طريقة ضبط إصدار JVM المستهدف لمترجمَي Java وKotlin.

// build.gradle.kts

kotlin {
  android {
    //  Opt-in to enable Java source compilation
    withJava()
    // Configure the JVM target for both Kotlin and Java sources
    compilerOptions {
      jvmTarget.set(org.jetbrains.kotlin.gradle.dsl.JvmTarget.JVM_1_8)
    }
  }
  // ...
}

// Project Structure:
// └── src
//     └── androidMain
//         ├── kotlin
//         │   └── com/example/MyKotlinClass.kt
//         └── java
//             └── com.example/MyJavaClass.java

// build.gradle.kts

android {
  // ...
  compileOptions {
    sourceCompatibility = JavaVersion.VERSION_1_8
    targetCompatibility = JavaVersion.VERSION_1_8
  }
}

kotlin {
  androidTarget {
    compilations.all {
      kotlinOptions.jvmTarget = "1.8"
    }
  }
}

7. التفاعل مع تصاميم متنوعة باستخدام androidComponents

لا يزال بإمكانك استخدام الإضافة androidComponents للتفاعل مع عناصر الإصدار آليًا. ومع أنّ معظم واجهة برمجة التطبيقات Variant لم تتغيّر، إلا أنّ واجهة AndroidKotlinMultiplatformVariant الجديدة أكثر محدودية لأنّ المكوّن الإضافي ينتج صيغة واحدة فقط.

وبالتالي، لم تعُد الخصائص المرتبطة بأنواع الإصدارات وصيغ المنتجات متوفّرة في عنصر المتغير.

// build.gradle.kts

androidComponents {
  onVariants { variant ->
      val artifacts = variant.artifacts
  }
}

// build.gradle.kts

androidComponents {
  onVariants(selector().withBuildType("release")) { variant ->
    // ...
  }
}

8. اختيار صيغ تبعيات مكتبة Android

تنتج مكتبة KMP صيغة واحدة لنظام Android، ولكن قد تعتمد على مكتبة Android عادية (com.android.library) تتضمّن صيغًا متعددة (مثل free/paid صيغ المنتجات). ويُعدّ التحكّم في طريقة اختيار مشروعك لصيغة من هذه الاعتمادية من المتطلبات الشائعة.

// build.gradle.kts
kotlin {
  android {
    localDependencySelection {
      // For dependencies with multiple build types, select 'debug' first, and 'release' in case 'debug' is missing
      selectBuildTypeFrom.set(listOf("debug", "release"))

      // For dependencies with a 'type' flavor dimension...
      productFlavorDimension("type") {
        // ...select the 'typeone' flavor.
        selectFrom.set(listOf("typeone"))
      }
    }
  }
}

9. إضافة تبعيات معاينة Compose

عادةً، نريد أن تكون نطاقات المكتبات محدّدة في بيئة التطوير المحلية لمنع تسريب الأدوات الداخلية إلى العنصر النهائي المنشور. ويصبح ذلك تحديًا مع المكوّن الإضافي المتوافق مع Android الجديد في KMP لأنّه يزيل بنية نوع التصميم المستخدَمة لفصل اعتماديات التطوير عن رمز الإصدار.

// build.gradle.kts
dependencies {
  "androidRuntimeClasspath"(libs.androidx.compose.ui.tooling)
}

// build.gradle.kts
dependencies {
  debugImplementation(libs.androidx.compose.ui.tooling)
}

10. ضبط إصدار JVM المستهدف لمنصة Android في KMP

يضبط المكوّن الإضافي المتوافق مع Android في KMP إصدار JVM المستهدف باستخدام android.compilerOptions.jvmTarget، وينطبق ذلك على كل من Java وKotlin، ما يؤدي إلى تبسيط عملية الإعداد مقارنةً بكتل compileOptions وkotlinOptions المنفصلة في مشاريع Android البحتة.

// build.gradle.kts
kotlin {
    jvmToolchain(21)
}

// build.gradle.kts
kotlin {
    android {
        compilerOptions {
            jvmTarget.set(JvmTarget.JVM_11)
        }
    }
}

// build.gradle.kts
kotlin {
    android {
        compilations.all {
            compileTaskProvider.configure {
                compilerOptions.jvmTarget.set(JvmTarget.JVM_11)
            }
        }
    }
}

// build.gradle.kts
kotlin {
    jvmToolchain(21)
}

// build.gradle.kts
android {
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_11
        targetCompatibility = JavaVersion.VERSION_11
    }

    kotlinOptions {
        jvmTarget = "11"
    }
}

11. نشر قواعد الاحتفاظ بالبيانات الخاصة بالمستهلكين

إذا كانت مكتبة KMP بحاجة إلى إرسال قواعد الاحتفاظ بالمستهلكين (مثل قواعد ProGuard الخاصة بـ R8) إلى مستهلكيها، عليك تفعيل النشر بشكل صريح باستخدام المكوّن الإضافي الجديد. في السابق، كانت قواعد الاحتفاظ بالبيانات الخاصة بالمستهلك تُنشَر تلقائيًا في حال تحديدها.

// build.gradle.kts
kotlin {
  android {
    optimization {
      consumerKeepRules.apply {
        publish = true
        file("consumer-proguard-rules.pro")
      }
    }
  }
}

// build.gradle.kts
android {
  defaultConfig {
    consumerProguardFiles("consumer-proguard-rules.pro")
  }
}

12. نشر مكتبتك على Maven

إذا كنت تخطّط لنشر مكتبة KMP على Maven ليتم استخدامها في مشاريع أخرى، تختلف العملية حسب ما إذا كنت تستخدم المكوّن الإضافي الجديد Android-KMP أو المكوّن الإضافي القديم.

مرجع واجهة برمجة التطبيقات الخاصة بالمكوّن الإضافي

يحتوي المكوّن الإضافي الجديد على مساحة واجهة برمجة تطبيقات مختلفة عن com.android.library. للحصول على معلومات تفصيلية حول لغة DSL والواجهات الجديدة، يُرجى الاطّلاع على مراجع واجهة برمجة التطبيقات:

• KotlinMultiplatformAndroidLibraryExtension
• KotlinMultiplatformAndroidLibraryTarget
• KotlinMultiplatformAndroidDeviceTest
• KotlinMultiplatformAndroidHostTest
• KotlinMultiplatformAndroidVariant

المشاكل المعروفة في المكوّن الإضافي لمكتبة Android-KMP

في ما يلي المشاكل المعروفة التي قد تحدث عند تطبيق الإضافة الجديدة com.android.kotlin.multiplatform.library:

• يتعذّر عرض معاينة الإنشاء عند استخدام المكوّن الإضافي الجديد android-KMP

  • تم إصلاح المشكلة في Android Studio Otter 2 Feature Drop | 2025.2.2 Canary 3 وAndroid Gradle Plugin 9.0.0-alpha13

• NullPointerException في معاينات Compose Multiplatform باستخدام المكوّن الإضافي com.android.kotlin.multiplatform.library

  • تم إصلاح المشكلة في Android Studio Otter 2 Feature Drop | 2025.2.2 Canary 3 وAndroid Gradle Plugin 9.0.0-alpha13

• يخزِّن KMP عملية تحديد تبعية التجميع الشائعة في ذاكرة التخزين المؤقت للإعدادات ما يؤدي إلى حدوث خطأ عند إلغاء التسلسل (نظام التشغيل Android فقط)

  • تم حلّ المشكلة في Kotlin Gradle Plugin 2.3.0-Beta2

• إتاحة sourceSetTree المزوَّد بأدوات لاستهداف androidLibrary

  • تم إصلاح المشكلة في Android Studio Otter 2 Feature Drop | 2025.2.2 Canary 3 وAndroid Gradle Plugin 9.0.0-alpha13