يساعدك Santulator على تشغيل رسم Secret Santa الخاص بك بكل بساطة ومرونة. يمكنك إدخال أسماء الأشخاص المشاركين في السحب وسيقوم النظام بشكل عشوائي باختيار من سيقدم الهدايا لمن. إذا كنت تريد تجنب التقسيمات بالتأكيد، على سبيل المثال لضمان عدم حصول الأشخاص على شركائهم في السحب، فيمكنك إضافة الاستثناءات. عند إجراء السحب، سيتم إنشاء ملف PDF لكل شخص لإخباره بمن سيشتري الهدية له. إذا كنت تريد تجنب رؤية جميع النتائج عن طريق الخطأ، فيمكنك إضافة كلمة مرور سرية إلى ملفات PDF التي تم إنشاؤها.
Santulator متاح مجانًا من صفحة التنزيل لموقع المشروع. يمكنك العثور على برنامج تعليمي كامل يشرح كيفية استخدام النظام على صفحة المساعدة.
ستحتاج إلى JDK 17. الإصدار المستخدم لإنشاء إصدارات Santulator هو OpenJDK 17 مع Hotspot، من Adoptium.
بعد تثبيت JDK، يمكنك استنساخ هذا المستودع وتشغيل ما يلي لبدء تشغيل Santulator:
./gradlew :gui:run
يمكنك بناء النظام بأكمله باستخدام الأمر التالي:
./gradlew clean build
افتراضيًا، يتم تشغيل اختبار واجهة المستخدم الرسومية كجزء من بناء Gradle القياسي، في وضع بدون رأس. إذا كنت ترغب في تشغيل اختبار واجهة المستخدم الرسومية في وضع غير مقطوع الرأس حتى تتمكن من رؤية ما يحدث، فاستخدم الأمر التالي:
./gradlew :gui:test --tests io.github.santulator.gui.main.GuiTest --rerun-tasks -PnoHeadless
في المقالة تطبيقات Java القابلة للتثبيت مع jpackage، يمكنك القراءة عن كيفية إنشاء الحزم القابلة للتثبيت لأنظمة التشغيل Mac وWindows وLinux وكيف يمكنك القيام بذلك في مشروعك الخاص. تسمح هذه المثبتات المستقلة للمستخدمين بإعداد Santulator على أجهزة الكمبيوتر الخاصة بهم دون الحاجة إلى تثبيت Java أولاً.
يمكنك أيضًا العثور على إرشادات كاملة خطوة بخطوة لإنشاء حزمة Santulator القابلة للتثبيت في PACKAGING.md.
في مدونة King Tech، يمكنك قراءة المزيد عن المشروع في Open Source & Secret Santa with Santulator. تتضمن المقالة معلومات حول كيفية استخدام JavaFX CSS لمنح Santulator نظام ألوان احتفالي.