مُصرّف Kotlin

يأتي Elide مع Kotlin 2.5.0-Beta1. يُبلغ التوزيع المخصّص لبيئة التشغيل فقط أن kotlinc يحتاج إلى التوزيع الكامل.

تصريف الملفات المصدرية

// Hello.kt
fun main() = println("Hello!")

elide kotlinc -- -d out Hello.kt
elide java -- -cp out HelloKt

تأتي خيارات kotlinc بعد --، وخيارات Elide قبلها. يسرد elide kotlinc --help خيارات Elide، ويسرد elide kotlinc -- -help خيارات kotlinc.

لا يضيف elide java مكتبة Kotlin القياسية، لذا تفشل هناك الشيفرة التي تستدعيها (listOf و joinToString):

fun main() = println(listOf("Hello", "Kotlin").joinToString(" "))

خيارات Elide

ملفات JAR للواجهة الثنائية

elide kotlinc --abi-only -- -d header.jar src/**/*.kt

يحتوي ملف JAR على التواقيع العامة والمحمية، و @Metadata، وأجسام inline المؤثرة في الواجهة الثنائية، وقيم const، وعلامات الوسائط الافتراضية. تعطي الواجهة الثنائية التي لم تتغير ملف JAR مطابقًا بايتًا ببايت، فتبقى الوحدات المعتمدة عليه في الذاكرة المؤقتة عند تعديل الأجسام.

يتخطى ELIDE_KOTLINC_ABI_STRIP=1 توليد شيفرة الأجسام. اتركه دون ضبط عندما تتضمن الواجهة الثنائية تصريحات تولّدها الإضافات، مثل $serializer في kotlinx.serialization. يقبله العمّال لكل طلب على حدة.

بناء المشاريع

يُصرّف elide build مجموعات مصادر Kotlin التي يعثر عليها وفق الاصطلاح أو المُعلنة في elide.pkl.

kotlin {
  apiLevel = "auto"
  languageLevel = "auto"
  compilerOptions {
    allWarningsAsErrors = true
    optIn { "kotlin.time.ExperimentalTime" }
    freeCompilerArgs { "-Xcontext-parameters" }
  }
}

تكتب كل عملية تصريف وسائطها في kotlinc.args بجوار ناتجها.

الإضافات والميزات

kotlin {
  features {
    metro = false
  }
  plugins {
    ["org.jetbrains.kotlinx.serialization"] {
      ["mode"] = "json"
    }
  }
}

dependencies {
  maven {
    kotlinPlugins { "com.example:my-compiler-plugin:1.0.0" }
  }
}

• يصبح كل إدخال في plugins على الصورة -P plugin:<id>:<key>=<value>، مرتّبًا حسب المعرّف ثم المفتاح.
• توضع إضافات الجهات الخارجية في الفئة kotlinPlugins وتحتاج إلى ManagedKotlinToolchain أو CustomKotlinToolchain. يُصدر المُصرّف المدمج التحذير Custom Kotlin compiler plugins are not supported when using the embedded compiler, plugins will not be applied ويُصرّف من دونها.
• تُتخطى الإضافة المدمجة غير الموجودة في التوزيع مع خياراتها، ويصدر تحذير.
• لا تُضاف مكتبات Kotlin الضمنية إلا إلى جذور التبعيات التي تحتوي على مصادر Kotlin. يُسقط reflection = false مكتبة kotlin-reflect، ويُسقط compilerOptions.noStdlib = true هذه المكتبة والمكتبة القياسية معًا. تبقى التبعيات المُعلنة.
• يكشف project("core").friend() تصريحات internal الخاصة بمشروع شقيق؛ راجع مساحات العمل.
• ترى مجموعة المصادر تصريحات internal في المجموعات التي تعتمد عليها داخل المشروع نفسه: كل مجموعة مذكورة في dependsOn الخاص بها (و main لمجموعة اختبار لا تذكره)، إضافة إلى المجموعات التي تعتمد عليها تلك.

اختيار سلسلة الأدوات

import "elide:Kotlin.pkl" as Kotlin

kotlin {
  toolchain = "embedded"                                       // the default
  // toolchain = new Kotlin.ManagedKotlinToolchain { version = "2.4.0" }
  // toolchain = new Kotlin.CustomKotlinToolchain { path = "/opt/kotlinc" }
}

تنطبق سلسلة الأدوات على بناء المشاريع؛ أما elide kotlinc فيستخدم دائمًا المُصرّف المضمّن.

لا يدعم Elide أداتي KAPT و KSP. يجب أن تحصل شيفرة Kotlin التي تستخدم أنواع Java مُولَّدة عليها من مجموعة مصادر أو مشروع سابق في سلسلة البناء.

أمثلة

• المجموعات في Kotlin
• الاختبارات في Kotlin

ابدأ من قالب:

elide init --template ktjvm       # Kotlin app with a test