تنزيل shards - تنزيل كود مصدر shards

shards

شفرة المصدر الأخرى

v0.18.0

تنزيل

شظايا

مدير التبعية للغة الكريستال.

الاستخدام

من المتوقع أن تحتوي تطبيقات ومكتبات Crystal على ملف shard.yml في جذرها يبدو كالتالي:

 name : shards
version : 0.1.0

dependencies :
  openssl :
    github : datanoise/openssl.cr
    branch : master

development_dependencies :
  minitest :
    git : https://github.com/ysbaddaden/minitest.cr.git
    version : ~> 0.3.1

license : MIT

عند تثبيت المكتبات من مستودعات Git، من المتوقع أن يحتوي المستودع على علامات إصدار تتبع تنسيقًا يشبه semver، مسبوقة بالحرف v . أمثلة: v1.2.3 أو v2.0.0-rc1 أو v2017.04.1 .

الرجاء مراجعة المواصفات للحصول على مزيد من التفاصيل حول تنسيق shard.yml .

ثَبَّتَ

عادةً ما يتم توزيع Shards مع Crystal نفسها (مثل حزم Homebrew وDebian). وبدلاً من ذلك، قد تكون حزمة shards متاحة لنظامك.

يمكنك تنزيل ملف tarball مصدر من نفس الصفحة (أو استنساخ المستودع) ثم تشغيل make release=1 ونسخ bin/shards إلى PATH الخاص بك. على سبيل المثال /usr/local/bin .

أنت الآن جاهز لإنشاء shard.yml لمشاريعك (راجع التفاصيل في SPEC). يمكنك كتابة shards init للحصول على مثال لملف shard.yml الذي تم إنشاؤه لمشروعك.

قم بتشغيل shards install لتثبيت تبعياتك، مما سيؤدي إلى قفل تبعياتك في ملف shard.lock . يجب عليك التحقق من كل من shard.yml و shard.lock في التحكم في الإصدار، لذلك سيؤدي shards install الإضافية دائمًا إلى تثبيت الإصدارات المقفلة، مما يحقق عمليات تثبيت قابلة للتكرار عبر أجهزة الكمبيوتر.

قم بتشغيل shards --help لسرد الأوامر الأخرى مع خياراتها.

قرصنة سعيدة!

المطورين

متطلبات

هذه المتطلبات ضرورية فقط لتجميع Shards.

كريستال
يرجى الرجوع إلى https://crystal-lang.org/install/ للحصول على إرشادات حول نظام التشغيل الخاص بك.
molinillo
يجب أن تكون قطعة molinillo في المسار البلوري. إنه متاح على https://github.com/crystal-lang/crystal-molinillo يمكنك تثبيته إما باستخدام ثنائي shards الموجود مسبقًا ( shards install قيد التشغيل) أو فقط قم بمراجعة المستودع على lib/crystal-molinillo ( make lib ).
libyaml
في نظام Debian/Ubuntu Linux، يمكنك تثبيت الحزمة libyaml-dev .
في نظام التشغيل Mac OS X، يمكنك تثبيته باستخدام homebrew مع brew install libyaml ثم تأكد من وجود /usr/local/lib في متغير البيئة LIBRARY_PATH الخاص بك (على سبيل المثال: export LIBRARY_PATH="/usr/local/lib:$LIBRARY_PATH" ). يرجى ضبط المسار حسب تثبيت Homebrew الخاص بك.
asciidoctor
مطلوب لبناء صفحات مان.

ابدء

يوصى بشدة باستخدام make لبناء القطع وتطويرها. يحتوي Makefile على وصفات للتجميع والاختبار. يضمن البناء باستخدام make أيضًا تثبيت molinillo تبعية المصدر. لا تحتاج إلى الاهتمام بهذا بنفسك.

قم بتشغيل make bin/shards لبناء الملف الثنائي.

release=1 لبناء الإصدار (ينطبق التحسينات)
static=1 للربط الثابت (يعمل فقط مع musl-libc)
debug=1 للحصول على معلومات التصحيح الرمزية الكاملة

قم بتشغيل make install لتثبيت الملف الثنائي. يمكن تعديل المسار المستهدف باستخدام PREFIX (الافتراضي: PREFIX=/usr/bin ).

قم بتشغيل make test لتشغيل مجموعات الاختبار:

make test_unit يقوم بتشغيل اختبارات الوحدة ( ./spec/unit )
يقوم make test_integration بتشغيل اختبارات التكامل ( ./spec/integration ) على bin/shards

قم بتشغيل make docs لإنشاء صفحات manpages.