Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

نصب باینری‌ها با استفاده از cargo install

دستور cargo install به شما این امکان را می‌دهد که crate‌های باینری را به صورت محلی نصب و استفاده کنید. این دستور به‌منظور جایگزینی بسته‌های سیستمی طراحی نشده است؛ بلکه یک راه آسان برای توسعه‌دهندگان Rust فراهم می‌کند تا ابزارهایی که دیگران در crates.io به اشتراک گذاشته‌اند را نصب کنند. توجه داشته باشید که فقط پکیج‌هایی را که دارای هدف باینری هستند می‌توانید نصب کنید. هدف باینری برنامه قابل‌اجرا است که در صورتی ایجاد می‌شود که crate شامل یک فایل src/main.rs یا فایل دیگری باشد که به عنوان باینری مشخص شده است. این در مقابل هدف کتابخانه‌ای قرار دارد که به تنهایی قابل اجرا نیست، اما برای استفاده در سایر برنامه‌ها مناسب است. معمولاً crate‌ها در فایل README اطلاعاتی در مورد اینکه آیا یک crate کتابخانه است، دارای هدف باینری است یا هر دو، ارائه می‌دهند.

تمام باینری‌هایی که با دستور cargo install نصب می‌شوند، در پوشه‌ی bin مسیر نصب ذخیره می‌شوند. اگر Rust را با استفاده از rustup.rs نصب کرده باشید و هیچ پیکربندی خاصی انجام نداده باشید، این دایرکتوری به صورت $HOME/.cargo/bin خواهد بود. اطمینان حاصل کنید که این دایرکتوری در متغیر محیطی $PATH شما قرار دارد تا بتوانید برنامه‌هایی را که با cargo install نصب کرده‌اید اجرا کنید.

برای مثال، در فصل 12 اشاره کردیم که یک پیاده‌سازی Rust از ابزار grep به نام ripgrep وجود دارد که برای جستجوی فایل‌ها استفاده می‌شود. برای نصب ripgrep می‌توانیم دستور زیر را اجرا کنیم:

$ cargo install ripgrep
    Updating crates.io index
  Downloaded ripgrep v14.1.1
  Downloaded 1 crate (213.6 KB) in 0.40s
  Installing ripgrep v14.1.1
--snip--
   Compiling grep v0.3.2
    Finished `release` profile [optimized + debuginfo] target(s) in 6.73s
  Installing ~/.cargo/bin/rg
   Installed package `ripgrep v14.1.1` (executable `rg`)

خط ماقبل آخر خروجی، محل و نام باینری نصب‌شده را نشان می‌دهد که در مورد ripgrep، نام آن rg است. تا زمانی که دایرکتوری نصب در متغیر محیطی $PATH شما قرار داشته باشد ــ همان‌طور که پیش‌تر ذکر شد ــ می‌توانید دستور rg --help را اجرا کرده و استفاده از یک ابزار جستجوی فایل سریع‌تر و Rust-محور را آغاز کنید!