أداة ⁦JAR⁩

يُضمّن ⁦Elide⁩ أداة ⁦JAR⁩ مُترجَمة مُسبقاً — نفس تنفيذ أداة ⁦jar⁩ في ⁦JDK⁩، لكنها مُترجَمة مسبقاً باستخدام ⁦GraalVM AOT⁩. هذا يُزيل تكلفة تشغيل ⁦JVM⁩ كلياً، مما يجعل تجميع ملفات ⁦JAR⁩ شبه فوري حتى في سكريبتات الأتمتة وبيئات ⁦CI⁩ حيث تكون تكلفة البدء الباردة لـ ⁦JVM⁩ هي المسيطرة عادةً. وتُكشف بطريقتين:

1. بديل مباشر — ⁦elide jar -- [OPTION...]⁩ يمرر الوسائط مباشرةً إلى الأداة المدمجة دون أي تكلفة لتشغيل ⁦JVM⁩.
2. تكامل نظام البناء — ⁦elide build⁩ يُجمّع ملفات ⁦JAR⁩ تلقائياً بناءً على تعريفات المخرجات في ⁦elide.pkl⁩.

اختصار ثالث — ⁦elide javac --jar⁩ — يُترجم كود ⁦Java⁩ ويُعبّئه في ملف ⁦JAR⁩ في خطوة واحدة.

---

الاستخدام المباشر

⁦elide jar⁩ يكشف تنفيذ ⁦sun.tools.jar.JarToolProvider⁩ المدمج — مُترجَماً بشكل أصلي، فيبدأ فورياً دون الحاجة إلى ⁦JVM⁩. جميع الوسائط بعد ⁦--⁩ تُمرَّر إلى الأداة الأساسية بالشكل الحرفي، مما يمنحك توافقاً كاملاً مع استدعاءات ⁦jar⁩ الحالية بجزء بسيط من وقت البدء.

elide jar -- [OPTION...] [ [--release VERSION] [-C dir] files] ...

العمليات الرئيسية

المُعدِّلات الشائعة

أمثلة

إنشاء أرشيف من ملفي فئة:

 elide jar -- --create --file ./classes.jar ./Foo.class ./Bar.class

إنشاء أرشيف من مجلد مع ملف بيان مخصص:

 elide jar -- --create --file ./classes.jar --manifest ./mymanifest -C ./foo/ .

إنشاء ملف ⁦JAR⁩ وحداتي قابل للتنفيذ:

 elide jar -- --create --file ./app.jar --main-class com.example.Main --module-version 1.0 \
 -C ./build/classes .

تحديث ملف ⁦JAR⁩ غير وحداتي إلى وحداتي:

 elide jar -- --update --file ./app.jar --main-class com.example.Main --module-version 1.0 \
 -C ./build/classes module-info.class

إنشاء ملف ⁦JAR⁩ متعدد الإصدارات:

 elide jar -- --create --file ./mr.jar -C ./foo classes --release 9 -C ./foo9 classes

عرض محتويات ملف ⁦JAR⁩:

 elide jar -- --list --file ./app.jar

استخراج ملف ⁦JAR⁩ إلى مجلد:

 elide jar -- --extract --file ./app.jar --dir ./extracted

---

التكامل مع نظام البناء

عند استخدام ⁦elide build⁩ مع ملف مشروع ⁦elide.pkl⁩، يتم التعامل مع تعبئة ملفات ⁦JAR⁩ تلقائياً من خلال رسم بياني لمهام البناء. ثلاثة أنواع من المخرجات مدعومة: ملفات ⁦JAR⁩ للفئات، وملفات ⁦JAR⁩ للمصادر، وملفات ⁦JAR⁩ للوثائق.

الإعلان عن المخرجات

تُعرَّف المخرجات تحت تعيين ⁦artifacts⁩ في ⁦elide.pkl⁩. استورد ⁦elide:Jvm.pkl⁩ للوصول إلى أنواع ⁦JAR⁩:

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

name = "my-library"

sources {
  ["main"] = new Src.SourceSetSpec {
    paths {
      "src/main/java<<>>*.java"
    }
  }
}

artifacts {
  ["app"] = new Jvm.Jar {
    name = "my-library"
    sources { "main" }
  }
  ["sources"] = new Jvm.SourceJar {
    from { "main" }
  }
  ["docs"] = new Jvm.JavadocJar {
    from { "main" }
  }
}

ملف ⁦JAR⁩ للفئات ⁦(Jvm.Jar)⁩

يُعبّئ ملفات ⁦.class⁩ المُترجَمة من مهام الترجمة السابقة، إلى جانب أي موارد مُعلَن عنها، في ملف ⁦JAR⁩ واحد. يُنشأ ملف البيان تلقائياً ويتضمن ⁦Manifest-Version⁩ و⁦Created-By⁩ و⁦Implementation-Title⁩ و⁦Implementation-Version⁩ و⁦Main-Class⁩ (إذا كانت نقطة الدخول محددة).

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

artifacts {
  ["app"] = new Jvm.Jar {
    name = "my-library"
    sources { "main" }
    manifest {
      ["Implementation-Vendor"] = "Acme Corp"
      ["Bundle-SymbolicName"] = "com.example.my-library"
    }
  }
}

artifacts {
  ["app"] = new Jvm.Jar {
    name = "my-app"
    sources { "main" }
    resources {
      ["/config/defaults.properties"] = "src/main/resources/defaults.properties"
    }
  }
}

ملف ⁦JAR⁩ للمصادر ⁦(Jvm.SourceJar)⁩

يُعبّئ ملفات المصادر من مجموعات المصادر المُعلَن عنها في ملف ⁦JAR⁩ بمُصنِّف ⁦-sources⁩. يُستخدم عادةً لدعم بيئات التطوير المتكاملة ونشر ⁦Maven⁩.

artifacts {
  ["sources"] = new Jvm.SourceJar {
    from { "main" }
    excludes { "**/*.generated.java" }
  }
}

ملف ⁦JAR⁩ للوثائق ⁦(Jvm.JavadocJar)⁩

يُشغّل أداة ⁦javadoc⁩ على ملفات مصادر ⁦Java⁩ ويُعبّئ وثائق ⁦HTML⁩ الناتجة في ملف ⁦JAR⁩ بمُصنِّف ⁦-javadoc⁩.

artifacts {
  ["docs"] = new Jvm.JavadocJar {
    from { "main" }
    windowTitle = "My Library API"
    links {
      "https:<<>>
    }
    excludes { "com.example.internal" }
  }
}

---

الترجمة والتعبئة في خطوة واحدة

تقبل ⁦elide javac⁩ علامة ⁦--jar⁩ التي تُترجم مصادر ⁦Java⁩ وتُعبّئ الفئات المُترجَمة فوراً في ملف ⁦JAR⁩، دون الحاجة إلى استدعاء ⁦elide jar⁩ منفصل.

 elide javac --jar < output.jar> [--manifest < manifest-file>] -- <source files...>

يذهب مخرج الترجمة إلى ⁦target/⁩ في مجلد العمل الحالي، ثم يُجمَّع ملف ⁦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