cargo

貨物

Cargo は Rust プロジェクトの依存関係をダウンロードし、プロジェクトをコンパイルします。

Cargo の使用を開始するには、The Cargo Book で詳細をご覧ください。

Cargo 自体の開発を開始するには、Cargo Contributor Guide を読んでください。

Rust を通じて配布された Cargo バイナリは、より広範なエコシステムで使用できるように Cargo チームによって保守されています。このクレートの他のすべての用途 (バイナリまたはライブラリとして) については、これは Cargo チームによって保守されており、主に Cargo による使用を目的としており、外部使用を目的としていません (推移的な依存関係としての使用を除く)。このクレートは API に大きな変更を加える可能性があります。

コードステータス

コードドキュメント: https://doc.rust-lang.org/nightly/nightly-rustc/cargo/

ソースからコンパイルする

要件

Cargo を構築するには、次のツールとパッケージが必要です。

• cargoとrustc

• プラットフォーム用の AC コンパイラ

• git (このリポジトリのクローンを作成するため)

その他の要件:

以下は、プラットフォームとニーズに基づいてオプションです。

• pkg-config — これは、 libsslヘッダー/ライブラリなどのシステム パッケージを見つけるのに役立ちます。これは、ベンダーの OpenSSL の使用や Windows など、すべての場合に必要なわけではありません。

• OpenSSL — Unix 系システムで、 vendored-openssl Cargo 機能が使用されていない場合にのみ必要です。

  これには開発ヘッダーが必要です。これは、Ubuntu のlibssl-devパッケージ、apk または yum を使用したopenssl-devel 、または macOS の Homebrew のopensslパッケージから取得できます。

  vendored-openssl Cargo 機能を使用する場合、OpenSSL の静的コピーは、システム OpenSSL を使用する代わりにソースから構築されます。これには、 perlやmakeなどの追加ツールが必要になる場合があります。

  macOS では、Homebrew、MacPorts、または pkgsrc からの共通のインストール ディレクトリがチェックされます。それ以外の場合は、 pkg-configに戻ります。

  Windows では、システムが提供する Schannel が代わりに使用されます。

  LibreSSL もサポートされています。

オプションのシステム ライブラリ:

ビルドでは、次のライブラリのベンダー バージョンが自動的に使用されます。ただし、それらがシステムによって提供され、 pkg-configで見つかる場合は、代わりにシステム ライブラリが使用されます。

• libcurl — ネットワーク転送に使用されます。

• libgit2 — git の依存関係を取得するために使用されます。

• libssh2 — git リポジトリへの SSH アクセスに使用されます。

• libz (別名 zlib) — データ圧縮に使用されます。

ベンダーのバージョンは Cargo で動作することがテストされているため、使用することをお勧めします。

コンパイル中

まず、このリポジトリをチェックアウトしてください。

git clone https://github.com/rust-lang/cargo.git
cd cargo

cargoすでにインストールされている場合は、次のコマンドを実行するだけです。

cargo build --release

Cargo への新しいサブコマンドの追加

Cargo は、Cargo 自体を変更することなく、新しいサブコマンドで拡張できるように設計されています。詳細と、コミュニティによって開発された既知のサブコマンドのリストについては、Wiki ページを参照してください。

リリース

Cargo のリリースは Rust のリリースと同時に行われます。高レベルのリリース ノートは、Rust のリリース ノートの一部として入手できます。詳細なリリース ノートは、このリポジトリの CHANGELOG.md で入手できます。

問題の報告

バグが見つかりましたか?それについてぜひ知りたいです!

すべての問題は GitHub 問題トラッカーで報告してください。

貢献する

Cargo への貢献の詳細については、 「Cargo Contributor Guide」を参照してください。

ライセンス

Cargo は主に、MIT ライセンスと Apache ライセンス (バージョン 2.0) の両方の条件に基づいて配布されます。

詳細については、LICENSE-APACHE および LICENSE-MIT を参照してください。

サードパーティ製ソフトウェア

この製品には、OpenSSL ツールキット (https://www.openssl.org/) で使用するために OpenSSL プロジェクトによって開発されたソフトウェアが含まれています。

バイナリ形式では、この製品には、GNU General Public License バージョン 2 の条件に基づいてライセンス供与されるソフトウェアが含まれていますが、リンクの例外はあり、上流のリポジトリから入手できます。

詳細については、「ライセンス-サードパーティ」を参照してください。