نصب

اولین قدم نصب Rust است. ما برای دانلود Rust از rustup استفاده می‌کنیم که یک ابزار خط فرمان برای مدیریت نسخه‌های مختلف زبان و ابزار آن است. برای اینکار به اتصال اینترنت نیاز دارید.

نکته: اگر به دلایلی ترجیح می‌دهید از rustup استفاده نکنید لطفا صفحه نصب را برای گزینه‌های دیگر ببینید.

با این راهنما آخرین نسخه پایدار کامپایلر Rust را نصب می‌کنید. پایداری Rust تضمین می‌کند که تمام مثال‌های کتاب توسط نسخه‌های جدیدتر کامپایلر نیز کامپایل بشوند. البته چون Rust معمولا خطا‌ها و پیام‌های کامپایلر را بهبود می‌بخشد خروجی ممکن است کمی بین نسخه‌ها فرق داشته باشد. به عبارت دیگر هر نسخه پایدار جدید‌تر از این راهنما باید مطابق کتاب کار کند.

نمایش دستورات خط فرمان

در این فصل و در طی کتاب دستوراتی که باید در خط فرمان(ترمینال) وارد شوند را معرفی می‌کنیم. این دستورات در اول خط با علامت $ شروع می‌شوند. لازم نیست این علامت را اول دستور وارد کنید؛ این علامت فقط نشان‌دهنده شروع دستور است. خطوطی که با $ شروع نشوند معمولا خروجی دستور قبلی هستند. علاوه بر این دستورات مربوط به PowerShell نیز با علامت < شروع می‌شوند.

نصب rustup روی لینوکس یا مک

اگر از لینوکس یا مک استفاده می‌کنید، یک ترمینال باز کنید و دستور زیر را وارد کنید:

$ curl https://sh.rustup.rs -sSf | sh

این دستور اسکریپت نصب rustup را دانلود کرده و آنرا اجرا می‌کند. که در نهایت موجب نصب آخرین نسخه پایدار Rust می‌شود. ممکن است در طی این فرایند رمزعبور شما درخواست شود. اگر فرایند نصب موفقیت‌آمیز باشد پیام زیر را خواهید دید:

Rust is installed now. Great!

در صورت تمایل می‌توانید اسکریپت را دانلود و محتویاتش را قبل از اجرا بررسی نمایید.

اسکریپت نصب در ورود بعدی بصورت خودکار Rust را به متغیر PATH سیستم شما اضافه می‌کند. اگر می‌خواهید بدون راه‌اندازی مجدد ترمینال از Rust استفاده کنید این دستور را در خط فرمان برای اضافه کردن دستی به PATH وارد نمایید:

$ source $HOME/.cargo/env

یا این خط را به فایل ~/.bash_profile خودتان اضافه کنید.

$ export PATH="$HOME/.cargo/bin:$PATH"

علاوه بر این نیاز به یک لینکر هم دارید که به احتمال قوی روی سیستم نصب باشد. اما اگر طی کامپایل کردن برنامه‌ها پیام خطایی شامل Linker نمایش داده شد مشخص است که هیچ لینکری روی سیستم شما نصب نشده. پس نیاز دارید به صورت دستی نصب کنید. کامپایلر‌های C معمولاً با خود لینکر نیز نصب می‌کنند. مستندات پلتفرم خودتان را برای نحوه نصب یک کامپایلر C مطالعه کنید. همچنین برخی بسته‌های Rust به کد C نیاز دارند و نصب کامپایلر C برای استفاده از آنها ضروری است پس نصب آن ایده خوبی است.

نصب rustup روی ویندوز

در ویندوز به https://www.rust-lang.org/tools/install مراجعه کرده و دستورالعمل آنرا برای نصب Rust دنبال کنید. در طی روند نصب پیامی دریافت خواهید کرد که به C++ build tools for Visual Studio 2013 یا نسخه جدیدتر آن نیز احتیاج دارید. راحت‌ترین راه برای نصب آنها اینجا Build Tools for Visual Studio 2019 می‌باشد. این ابزار در بخش Other Tools and Frameworks قابل دریافت هستند.

ادامه این کتاب از دستوراتی که هم در cmd.exe و هم در PowerShell کار می‌کند استفاده می‌کند. اگر تفاوت خاصی باشد حتما ذکر خواهد شد.

بروزرسانی و حذف

بعد از نصب Rust با rustup، بروزرسانی به آخرین نسخه بسیار آسان است. کافیست از پوسته خود دستور زیر را اجرا کنید:

$ rustup update

برای حذف Rust و rustup، این دستور را از پوسته اجرا کنید:

$ rustup self uninstall

عیب‌یابی

برای بررسی درستی نصب Rust دستور زیر را وارد کنید:

$ rustc --version

بعد از اجرا باید شماره نسخه، هش کامیت، و تاریخ کامیت برای آخرین نسخه پایدار را به فرمت زیر ببینید:

rustc x.y.z (abcabcabc yyyy-mm-dd)

اگر این اطلاعات را می‌بینید، نصب Rust با موفقیت انجام شده است! اگر این اطلاعات را نمی‌بینید و روی ویندوز هستید چک کنید که Rust روی متغیر سیستمی %PATH% شما باشد. اگر همه چیز درست است اما Rust همچنان کار نمی‌کند می‌توانید از چند منبع کمک بگیرید. آسان‌ترین راه برای کمک گرفتن کانال #beginners در دیسکورد رسمی Rust می‌باشد. آنجا می‌توانید با Rustaceans (اسم بامزه‌ای که ما خودمان را صدا می‌زنیم) های دیگر که می‌توانند به شما کمک کنند گفتگو کنید. منابع خوب دیگر میتوانند انجمن کاربران و Stack Overflow باشند.

مستندات محلی

با نصب Rust یک کپی از مستندات بصورت محلی(در کامپیوتر شما) نصب می‌شود و می‌توانید بصورت آفلاین در مرورگرتان به آن‌ها دسترسی داشته باشید.

اگر تابع یا نوعی در کتابخانه استاندارد ارائه می‌شود و در مورد طرز استفاده از آن یا کاری که انجام می‌دهد مطمئن نیستید از مستندات API برای یادگیری در مورد آن استفاده کنید.