ผู้จัดการการพึ่งพาสำหรับภาษา Crystal
แอปพลิเคชันและไลบรารีของ 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
โปรดดู SPEC สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับรูปแบบ 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
)
ลิเบียมล
บน 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 ของคุณ
แพทย์แอสซิอิด็อกเตอร์
จำเป็นสำหรับการสร้าง manpages
ขอแนะนำอย่างยิ่งให้ใช้ make
สำหรับการสร้างชิ้นส่วนและพัฒนามัน Makefile
มีสูตรสำหรับการรวบรวมและการทดสอบ การสร้าง make
ยังช่วยให้แน่ใจว่ามีการติดตั้ง molinillo
การพึ่งพาแหล่งที่มา คุณไม่จำเป็นต้องดูแลเรื่องนี้ด้วยตัวเอง
เรียกใช้ make bin/shards
เพื่อสร้างไบนารี
release=1
สำหรับรุ่น release (ใช้การปรับให้เหมาะสม)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
พื้นที่เก็บข้อมูลนี้มีการกำหนดค่าสำหรับ devenv.sh ซึ่งทำให้ง่ายต่อการติดตั้งสภาพแวดล้อมที่ทำซ้ำได้ด้วยเครื่องมือที่จำเป็นทั้งหมดสำหรับการสร้างและการทดสอบ
devenv shell
เพื่อรับเชลล์ที่มีสภาพแวดล้อมการพัฒนา มีตะขอสำหรับการเปิดใช้งานกระสุนอัตโนมัติรวมอยู่ด้วย หากคุณติดตั้ง direnv
ไว้ สภาพแวดล้อม devenv จะโหลดโดยอัตโนมัติเมื่อเข้าสู่โฟลเดอร์ repo
ได้รับอนุญาตภายใต้ Apache License เวอร์ชัน 2.0 ดูใบอนุญาตสำหรับรายละเอียด