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

Instalowanie binariów za pomocą cargo install

Polecenie cargo install pozwala instalować i używać lokalnie binarne pakiety. Nie ma ono na celu zastąpienia pakietów systemowych; ma być wygodnym sposobem dla programistów Rust na instalowanie narzędzi, które inni udostępnili na crates.io. Zauważ, że możesz instalować tylko pakiety, które mają binarne cele. Cel binarny to uruchamialny program, który jest tworzony, jeśli pakiet ma plik src/main.rs lub inny plik określony jako binarny, w przeciwieństwie do celu bibliotecznego, który nie jest uruchamialny sam w sobie, ale nadaje się do włączenia do innych programów. Zazwyczaj pakiety mają w pliku README informacje o tym, czy dany pakiet jest biblioteką, ma cel binarny, czy jedno i drugie.

Wszystkie pliki binarne zainstalowane za pomocą cargo install są przechowywane w folderze bin katalogu instalacyjnego. Jeśli zainstalowałeś Rust za pomocą rustup.rs i nie masz żadnych niestandardowych konfiguracji, ten katalog będzie $HOME/.cargo/bin. Upewnij się, że ten katalog znajduje się w Twojej zmiennej $PATH, aby móc uruchamiać programy zainstalowane za pomocą cargo install.

Na przykład, w Rozdziale 12 wspomnieliśmy, że istnieje implementacja narzędzia grep w Rust o nazwie ripgrep do przeszukiwania plików. Aby zainstalować ripgrep, możemy uruchomić następujące polecenie:

$ cargo install ripgrep
    Aktualizowanie indeksu crates.io
  Pobrano ripgrep v14.1.1
  Pobrano 1 pakiet (213.6 KB) w 0.40s
  Instalowanie ripgrep v14.1.1
--snip--
   Kompilowanie grep v0.3.2
    Zakończono `release` profil [optimized + debuginfo] cel(e) w 6.73s
  Instalowanie ~/.cargo/bin/rg
   Zainstalowano pakiet `ripgrep v14.1.1` (wykonywalny `rg`)

Druga od końca linia wyjścia pokazuje lokalizację i nazwę zainstalowanego pliku binarnego, którym w przypadku ripgrep jest rg. Dopóki katalog instalacyjny znajduje się w Twoim $PATH, jak wspomniano wcześniej, możesz uruchomić rg --help i zacząć używać szybszego, bardziej „rusty” narzędzia do przeszukiwania plików!