تجميع JAR

ينشئ Elide ملفات JAR ويقرؤها مباشرة باستخدام elide jar، ويبنيها كمُخرَجات للمشروع.

الإنشاء والسرد والاستخراج

تأتي خيارات jar بعد --:

elide jar -- --create --file app.jar -C out .                              # create
elide jar -- --list --file app.jar                                         # list
elide jar -- --extract --file app.jar --dir extracted                      # extract
elide jar -- --create --file app.jar --main-class com.example.Main -C out . # executable JAR
elide jar -- -help

التصريف وإنشاء ملف JAR

elide javac --jar target/app.jar -- src/Main.java src/Util.java
elide javac --jar target/app.jar --manifest src/MANIFEST.MF -- src/Main.java

مُخرَجات المشروع

amends "elide:project.pkl"
import "elide:Jvm.pkl" as Jvm

artifacts {
  ["app"] = new Jvm.Jar {
    name = "app"
    options {
      entrypoint = "com.example.Main"
    }
  }
}

يكتب elide build في .dev/artifacts/jar/<name>/. يحتوي ملف JAR على أصناف وموارد كل مجموعات المصادر غير الاختبارية.

Jvm.Jar

artifacts {
  ["app"] = new Jvm.Jar {
    sources { "main" }
    excludes {
      "com.example.internal"   // a package and its subpackages
      "**/*.proto"             // a path glob
    }
    manifest {
      ["Implementation-Vendor"] = "Example"
    }
    resources {
      "LICENSE.txt"
      new { from = "config"; into = "META-INF/config" }
    }
  }
}

ملفات JAR للمصادر و Javadoc

artifacts {
  ["sources"] = new Jvm.SourceJar {
    classifier = "sources"
    excludes { "**/internal/**" }
  }
  ["javadoc"] = new Jvm.JavadocJar {
    windowTitle = "Example API"
    links { "https://docs.oracle.com/en/java/javase/25/docs/api/" }
    groups {
      ["Core"] { "com.example.core" }
    }
  }
}

تُوثَّق المصادر التي تتضمن Kotlin باستخدام Dokka بدلًا من javadoc، بما في ذلك شيفرة Java المجاورة لها؛ أما generator = "javadoc" فيوثّق ملفات Java فقط. يعمل Dokka في عملية JVM منفصلة. يحلّ Elide ملفات JAR الخاصة به من Maven في أول مرة يُبنى فيها ملف JAR لتوثيق Kotlin، ويخزّنها مؤقتًا في مستودع Maven المحلي، لذا يحتاج ذلك البناء الأول إلى اتصال بالشبكة. وفي كل بناء، يجلب Dokka أيضًا قوائم الحزم خلف روابطه إلى JDK والمكتبة القياسية و links؛ ويتخطى --offline عمليات البحث هذه. يقرأ Dokka كلًّا من sources و links و excludes (تُستبعد الحزمة المستثناة وحزمها الفرعية)؛ أما groups والعناوين فتنطبق على javadoc فقط، ويُصدر Elide تحذيرًا عند ضبط العناوين لـ Dokka.

توزيعات تطبيقات قابلة للتشغيل

يمثّل Jvm.JvmApplication شجرة قابلة للتشغيل، مثل إضافة application في ⁦Gradle:⁩ ملفات JAR اللازمة للتشغيل في lib/، وسكربتات التشغيل في bin/، وأرشيفات اختيارية.

artifacts {
  ["dist"] = new Jvm.JvmApplication {
    from { "app" }
    entrypoint = "com.example.Main"
    defaultJvmArgs { "-Xmx512m" }
    contents {
      new { from = "config"; into = "etc" }
    }
    options {
      archives { "zip"; "tar" }
    }
  }
}

• يُطلق elide run الشجرة المثبّتة بخيارات JVM الموجودة في السكربتات.
• تقرأ السكربتات أيضًا JAVA_OPTS و <NAME>_OPTS (sample-app → SAMPLE_APP_OPTS).
• يتتبّع سكربت POSIX الروابط الرمزية التي تشير إليه؛ وعلى Windows، شغّل السكربت مباشرة أو عبر PATH.
• يجب أن تكون قيم name و version (عند الأرشفة) وكل into أسماء ملفات صالحة على كل المنصات: دون / أو \ أو :*?"<>| أو محارف تحكّم أو نقطة أو مسافة في النهاية، ودون أسماء أجهزة Windows مثل NUL. تُفشل الأسماء غير الصالحة البناء قبل أن يكتب أي شيء.

يستخدم أعضاء مساحة العمل Jvm.Jar من مشروع شقيق عبر project("core")؛ راجع مساحات العمل.