sbt/Getting-Started-Running

sbtの実行

https://github.com/harrah/xsbt/wiki/Getting-Started-Runningの翻訳(2011/10/26時点)

ここでは、プロジェクトをセットアップした後のsbtの使い方をみていく。 sbtをインストールして、Hello, Worldか何かのプロジェクトを作成済であることが前提だ。

対話モード

プロジェクトディレクトリの中で引数無しでsbtを起動する

$ sbt

コマンド引数なしで起動すると対話モードになる。 対話モードではコマンドプロンプトが使える(しかもタブ補完と履歴付き!)

例えば、プロンプトでcompileとタイプする

> compile

もう一度コンパイルしたいときは、上矢印を押してEnterを押せばいい。

君のプログラムを起動したい場合はrunだ。

対話モードを終了させたいときは、exitとタイプするか、あるいはCtrl+D(Unixの場合)、あるいはCtrl+Z(Windowsの場合)。

バッチモード

sbtをバッチモードで起動することもできる。 これには、空白で区切られたsbtのアクションを引数として与えればいい。

引数をとるsbtコマンドに対しては、コマンドと引数をクォートで囲む。こんなふうに

$ sbt clean compile "test-only TestA TestB"

この例では、test-onlyにTestAとTestBという引数が与えられる。 そして、示された順(clean, compile, test-only)にアクションが実行される。

継続的なビルドとテスト

edit-compile-testサイクルを素早くするには、君がソースファイルを保存した途端に自動的にコンパイルされるといいよね。

ソースファイルを変更しすると同時にアクションを実行するには、そのアクションの前に~を指定する。例えば、対話モードで以下のようにしてみよう

> ~ compile

変更監視モードを抜けるにはEnterを押すこと。これは対話モードでもバッチモードでも使える。

詳細は「Triggered Execution」を参照のこと

共通アクション

以下は代表的なsbtコマンドだ。完全なリストは「Command Line Reference」を見て欲しい

タブ補完

対話モードではタブ補完ができる。プロンプトが空の状態でもできるよ。 一度押せば代表的なものが示され、複数押せばより詳細なものが示される。

履歴コマンド

対話モードでは履歴を記憶してる。たとえいったんsbtをexitして再起動してもだ。 最も簡単な履歴アクセス方としては、上矢印キーだが、以下のコマンドもある。

次は.sbtビルド定義

last edited 2011-10-29 07:51:44 by ysugimura