شروع

انتشار برچسب خورده یا شبانه؟

Zig هنوز به نسخه 1.0 نرسیده است و چرخه انتشار فعلی با نسخه های جدید LLVM، که 6 ماهه هستند، گره خورده است. از نظر عملی، انتشارات Zig تمایل زیادی به هم دارند و در نهایت با توجه به سرعت توسعه فعلی، قدیمی می شوند.

بهتر است Zig را با استفاده از نسخه برچسب دار ارزیابی کنید، اما اگر می خواهید غواصی عمیق تری داشته باشید، ما شما را تشویق می کنیم تا به یک بیلد شبانه ارتقا دهید، عمدتا به این ترتیب دریافت کمک برای شما آسان تر خواهد بود: اکثر انجمن ها و سایت ها دوست دارند zig.guide به دلایلی که در بالا ذکر شد شاخه اصلی را دنبال کنید.

خبر خوب این است که بسیار آسان است که از یک نسخه Zig به نسخه دیگر بروید، یا حتی چندین نسخه به طور همزمان در سیستم موجود باشد: نسخه های Zig آرچیو های مستقل هستند که می توانند در هر نقطه از سیستم شما قرار گیرند.

نصب Zig

دانلود مستقیم

این ساده ترین راه برای به رسیدن به Zig است: یک بسته Zig را برای پلتفرم خود از صفحه بارگیری کنید. آن را در یک پوشه استخراج کرده و به PATH خود اضافه کنید تا بتوانید از هر مکانی zig را فرابخوانید.

راه اندازی PATH در ویندوز

برای راه اندازی مسیر خود در ویندوز یکی از قطعات کد زیر را در Powershell اجرا کنید (نیاز به Run As Administrator).

انتخاب کنید که آیا می خواهید این تغییر را در سطح سیستم اعمال کنید یا فقط برای کاربر شما، و مطمئن شوید که قطعه را به محلی که کپی Zig شما در آن قرار دارد تغییر دهید. “؛” قبل از “C:” اشتباه تایپی نیست.

کل سیستم (admin Powershell):

[Environment]::SetEnvironmentVariable(
   "Path",
   [Environment]::GetEnvironmentVariable("Path", "Machine") + ";C:\your-path\zig-windows-x86_64-your-version",
   "Machine"
)

فقط کاربر (Powershell):

[Environment]::SetEnvironmentVariable(
   "Path",
   [Environment]::GetEnvironmentVariable("Path", "User") + ";C:\your-path\zig-windows-x86_64-your-version",
   "User"
)

پس از اتمام کار، Powershell خود را مجدداً راه اندازی کنید.

راه اندازی PATH در Linux, macOS و BSD

مکان باینری zig خود را به متغیر PATH خود اضافه کنید.

این کار عموماً با افزودن یک خط export به اسکریپت راه اندازی shell شما انجام می شود (.profile, .zshrc, …)

export PATH=$PATH:~/path/to/zig

پس از اتمام کار، فایل راه اندازی خود را source کنید یا shell خود را مجدداً راه اندازی کنید.

پکیج منیجر ها

ویندوز

Zig در Chocolatey قابل دسترس است.

choco install zig

مک

Homebrew
آخرین انتشار برچسب دار:

brew install zig

MacPorts

port install zig

لینوکس

Zig همچنین در بسیاری از پکیج منیجر ها برای لینوکس وجود دارد. اینجا شما می توانید یک لیست به روز شده پیدا کنید، اما به خاطر داشته باشید که برخی از بسته ها ممکن است نسخه های قدیمی Zig را به همراه داشته باشند.

ساخت از سورس

اینجا می توانید اطلاعات بیشتری در مورد نحوه ایجاد Zig از منبع برای Linux،macOS و Windows پیدا کنید.

ابزار های توصیه شده

برجسته کننده ها و LSP

همه ویرایشگرهای اصلی متن از Zig پشتیبانی برجسته نحوی دارند. برخی آن را در خود دارند و برخی دیگر نیاز به نصب افزونه دارند.

اگر به ادغام عمیق تر بین Zig و ویرایشگر خود علاقه دارید اینجا را ببینید zigtools/zls.

اگر به چیزهای دیگر علاقه مند هستید، قسمت ابزارها را بررسی کنید.

اجرای سلام دنیا!

اگر مراحل نصب را به درستی انجام داده اید، اکنون باید بتوانید کامپایلر Zig را از shell خود فراخوانی کنید. بیایید این را با ایجاد اولین برنامه Zig خود آزمایش کنیم!

به فهرست پروژه های خود بروید و این دستور را اجرا کنید:

mkdir hello-world
cd hello-world
zig init-exe

خروجی باید این باشد:

info: Created build.zig
info: Created src/main.zig
info: Next, try `zig build --help` or `zig build run`

اجرای zig build run سپس باید فایل اجرایی را کامپایل کرده و اجرا کند و در نهایت منجر به:

info: All your codebase are belong to us.

تبریک می گویم، شما یک Zig نصب دارید!

مراحل بعدی

سایر منابع موجود در قسمت یادگیری را بررسی کنید, مطمئن شوید که از مستندات نسخه خود استفاده میکنید (توجه داشته باشید: انتشار های شبانه باید از مستندات master استفاده کنند) و در نظر داشته باشید که zig.guide را هم بخوانید.

Zig یک پروژه جوان است و متأسفانه ما هنوز توانایی تولید مستندات گسترده و مطالب آموزشی برای همه چیز را نداریم, پس بهتر است عضو یکی از انجمن های موجود شوید برای دریافت کمک هنگام گیر افتادن، و همچنین بررسی ابتکاراتی مانند Zig SHOWTIME را بررسی کنید.

در نهایت، اگر از Zig لذت می برید و می خواهید به سرعت بخشیدن به توسعه کمک کنید، کمک مالی به Zig Software Foundation را فراموش نکنید .