مشاريع ⁦Elide⁩

يستطيع ⁦Elide⁩ إنشاء وإدارة المشاريع الأصلية لـ ⁦Elide⁩ من خلال سلسلة أدوات المشروع.

يتكون مشروع ⁦Elide⁩ من:

1. بيان المشروع - ⁦elide.pkl⁩ هو بيان قوي قابل للتكوين يعتمد على ⁦Pkl⁩.
2. مجلد العمل - ⁦.dev⁩ يعمل كمجلد داخلي يستخدمه ⁦Elide⁩ لتخزين المخرجات والحالات الوسيطة لمهام البناء.
3. ملف القفل - ⁦.dev/elide.build.bin⁩ و ⁦.dev/elide.lock.v2.bin⁩ هما ملفان ثنائيان للقراءة فقط تستخدمهما أدوات ⁦Elide⁩. بشكل عام، لا ينبغي للمستخدمين تعديلهما.

واجهة سطر الأوامر للمشروع

هناك ثلاثة أوامر في واجهة سطر الأوامر يمكن أن تعتمد على مشروع ⁦Elide⁩ للعمل، ويمكنها الوصول إليه بطريقتين:

1. التمرير المباشر - بتمرير ⁦--project PATH⁩ يمكنك تحديد البيان الذي سيتم تحميله لهذا الأمر.
2. الاكتشاف التلقائي - إذا لم يتم توفير مسار، سيحاول الأمر العثور على بيان المشروع في المجلد الحالي.

لذلك فإن الاستدعاء البسيط لـ

 elide build

سيحاول البحث عن البيان في المجلد المحلي، بينما

 elide build -p PATH

سيحاول جلب البيان من المسار.

بناء مشروع

⁦elide build⁩ هو الطريقة الرئيسية لبناء المشاريع. يُنشئ رسماً بيانياً للمهام بناءً على تكوين البيان.

يمكن عرض القائمة الكاملة للمهام التي يُنشئها أمر ⁦build⁩ من بيان المشروع.

 elide build --inspect

لتشغيل مهمة محددة،

 elide build TASK

على سبيل المثال،

 elide build :compile-java-main

بيان مشروع ⁦Elide⁩

⁦elide.pkl⁩ هو بيان يعتمد على ⁦Pkl⁩ يسمح بتكوين واسع لمشروع ⁦Elide⁩.

يمتلك بيان المشروع بنية منظمة ومرنة في الوقت ذاته.

# Importing project schema
amends "elide:project.pkl"

# Importing configuration-specific schema
import "elide:Sources.pkl" as Src

# Project metadata
name = "project"
version = "1.0.0"
description = "example project"

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

بيانات المشروع الوصفية

المصادر

لكي يقوم مشروع ⁦Elide⁩ بالبناء، يجب تحديد المصادر في البيان. القالب العام لتصريح المصادر هو

import "elide:Sources.pkl" as Src
sources {
  ["main"] = new Src.SourceSetSpec {
    paths {
      "src/main/java<<>>*.java"
    }
  }
}

يتيح لك الاستيراد استخدام مخطط المصادر ويساعد ⁦Elide⁩ على تحليل قسم المصادر في البيان.

تُصرَّح المصادر نفسها بواسطة ⁦paths⁩، وهي قائمة من المسارات المطابقة بالأنماط.

نقطة الدخول

يتيح تحديد نقطة الدخول لـ ⁦Elide⁩ اكتشاف البرامج النصية للتشغيل تلقائياً.

entrypoint {
  "some.entry"
}

لذلك إذا لم يُحدَّد برنامج نصي أثناء ⁦elide run⁩، سيحاول ⁦Elide⁩ جلب مسار ملف نقطة الدخول من البيان.

البرامج النصية

البرامج النصية هي أزواج مفتاح-قيمة، مُصمَّمة للعمل بشكل مشابه لبرامج ⁦package.json⁩ الخاصة بـ ⁦Node⁩.

إذا تلقى ⁦elide run⁩ وسيطاً غير خيار يتطابق مع اسم برنامج نصي، يُنفَّذ البرنامج النصي بدلاً من تفسير المعامل كمسار.

على سبيل المثال، إذا حددت في البرنامج النصي

scripts {
  ["help"] = "elide --help"
}

سينتج ⁦elide run help⁩ مخرجات مشابهة لـ ⁦elide --help⁩.

التبعيات

يأتي ⁦Elide⁩ مع مدير تبعيات مدمج.

هناك طريقتان لتصريح تبعية ⁦Maven⁩

import "elide:Jvm.pkl" as Jvm

dependencies {
  maven {
    packages {
      "com.google.guava:guava:33.4.8-jre",
      new Jvm.MavenPackageSpec {
        group = "com.google.guava"
        name = "guava"
        version = "33.4.8-jre"
      }
    }
  }
}

تُثبَّت تبعيات ⁦Maven⁩ في مستودع ⁦Maven⁩ المحلي وتُربَط بمشروعك من خلال ملف ⁦.dev⁩.

import "elide:Jvm.pkl" as Jvm

dependencies {
  maven {
    repositories {
      ["central"] = new Jvm.MavenRepositorySpec {
        name = "Maven Central"
        description = "The central Maven repository"
        url = "https:<<>>
      }
      ["google"] = "https://maven.google.com"
    }
  }
}

أو تحديد مستودع محلي والاتصال بـ ⁦Maven Central⁩

dependencies {
  maven {
    localRepository = ".m2/repository"
  }
}

⁦JVM⁩

يمتلك ⁦Elide⁩ آلية تسمح بمستوى عالٍ من التكوين لكيفية تفاعل ⁦Elide⁩ مع ⁦JVM⁩.

لبدء تكوين ⁦JVM⁩، يجب استيراد المخطط الخاص بـ ⁦JVM⁩.

import "elide:Jvm.pkl" as Jvm
jvm {
  # your configuration here
}

على المستوى العالي، يمكنك تحديد أي ⁦JVM⁩ تريد أن يستهدفها ⁦Elide⁩ وتحديد نقطة دخول لـ ⁦JVM⁩.

jvm {
  main = "test.class"
  target = "latest"
  javaHome = "home"
}

⁦Kotlin⁩

يتيح ⁦Elide⁩ تكوين سلوك ⁦Kotlin⁩.

kotlin {
  # your configuration here
}

plugins {
  ["plugin"] = {
    ["setting"] = "value",
  }
}

⁦JavaScript⁩

يتيح ⁦Elide⁩ تكوين مستوى ⁦ECMA⁩ لـ ⁦JavaScript⁩ في المشروع.

javascript {
  ecma = "latest"
}

⁦Native Image⁩

يتيح ⁦Elide⁩ تكوين المُجمّع الأصلي على مستوى المشروع.

لبدء تكوين المُجمّع الأصلي، يجب استيراد مخطط محدد.

import "elide:NativeImage.pkl" as NativeImage

nativeImage {
  # your configuration here
}

المحرك

هذا التكوين مسؤول عن تكوين محرك التنفيذ الذي يستخدمه ⁦Elide⁩ عند تشغيل مشروع.

engine {
  # your configuration here
}

التطوير

تكوينات التطوير تسمح لـ ⁦Elide⁩ بالاندماج الكامل في عملية تطوير المشروع.

لبدء تكوين إعدادات التطوير، يجب استيراد مخطط محدد.

import "elide:Dev.pkl" as Dev

dev {
  # dev configuration here
}

resources {
      new Dev.McpResource {
        # some resource config
      }
    }

سلسلة الأدوات

تتيح إعدادات سلسلة الأدوات تكوين إصدار محرك ⁦Elide⁩ المُستخدَم.

toolchain {
  engines {
    ["elide"] = ">1.0.0"
  }
}

المخرجات

يمكن لـ ⁦Elide⁩ إنتاج مجموعة متنوعة من المخرجات التي يمكن وضعها في مشروعك. تُصرَّح هذه كأزواج مفتاح-قيمة داخل تكوين ⁦artifact⁩.

artifacts {
  ["some-artifact"] = {
    # some artifact
  }
}

import "elide:Jvm.pkl" as Jvm

artifacts {
  ["some-jar"] = new Jvm.Jar {
    # some config here
  }
}

الويب

import "elide:Web.pkl" as Web

web {
  css {
    targets {
        new Web.CssTarget {
          # some config
        }
    }
  }
}

ملف قفل ⁦Elide⁩

يحتوي ملف قفل ⁦Elide⁩ على معلومات حول بيانات المشروع الوصفية بالإضافة إلى رسم بياني للتبعيات المحلولة. يسمح ببناء أسرع عبر ⁦elide build⁩ حيث سيتم تخطي قائمة التبعيات غير المُعدَّلة واستخدام الرسم البياني المحلول للتبعيات.