إعداد المكوّن الإضافي لمكتبة 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 ومرتبطة بشكل وثيق بنظام العرض في 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
• المكوّن الإضافي لنظام Gradle المتوافق مع Kotlin (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. تحديد الاعتماديات

تتمثّل إحدى المهام الشائعة في تعريف التبعيات لمجموعات المصادر الخاصة بنظام 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")
}

3- تفعيل "موارد 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

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

من التغييرات المهمة في المكوّن الإضافي الجديد أنّه يتم إيقاف الاختبارات على مستوى الجهاز (التي تتضمّن أدوات) وعلى مستوى المضيف (الوحدة) في 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

5. تفعيل تجميع مصدر 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"
    }
  }
}

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

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

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

// build.gradle.kts

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

// build.gradle.kts

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

7. اختيار صيغ تبعيات مكتبة 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"))
      }
    }
  }
}

8. التبعيات في إنشاء المعاينة

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

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

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

9. ضبط إصدار 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"
    }
}

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

إذا كانت مكتبة 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")
  }
}

11. نشر مكتبتك على 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