Simple Build Tool(SBT)

※sbtは0.7と0.10以降とで非常に大きな変更がある。 書籍や様々なウェブサイトで0.7の機能が紹介されているが、現在(2011/10)のsbtとは大きく異なる。

何をするものか

MavenやIvy+Antのような位置づけのもの。依存解決からビルド・配布物の作成までをやってくれる。 内部ではIvyが使用されており、ローカルキャッシュもIvyと共用される。

メリット

すべてをScalaで記述できること、これが最も大きい。 おかしなxmlとそれを拡張するためのJavaコードという組み合わせは不要で、antに例えればbuild.xmlとタスクを統一的にScalaで記述できる。

デメリット

情報が少ない。マニュアル（英語）は、かなりの分量が用意されており、比較的親切な方なのだが、それだけでは全く使いものにはならない。 キー（antでいえばタスク？）それぞれのマニュアルが無いため、使い方を知るには相当苦労する。 しかも、作者はソースコードに全くコメントをつけていないため、scaladocを見たところであまり参考にはならない。

キーを組み合わせて新しいことをやろうとしたり、新たなタスクやプラグイン（タスクの一種）を作成するには多大な努力が必要になる（と思われる）。

学習のしかた

マニュアルを全文読んでも概念的な事柄がわかるだけで、実用にはほど遠いと思われる。 sbt本体のソースコードもほぼ意味不明。 おそらくは、サードパーティ製プラグインのソースコードを読むのが一番の近道ではないかと思われる。 やりたいことと、その実現方法がわかる。

参考サイト

• 本家

• 本家ドキュメント

• 本家プラグインリスト

• 非公式 sbt 0.10 ガイド v2.0

• Keys.scala

ドキュメント翻訳

Getting Started

• ようこそ

• セットアップ

• Hello, World

• ディレクトリ構造

• sbtの実行

• .sbtの定義

• スコープ

• Settingについてもっと

• ライブラリ依存性

• .scalaビルド定義

• プラグインの使用

• マルチプロジェクト

• カスタム設定とタスク

• サマリ

Detailed Topics

• Artifacts what to publish
• Best Practices

• クラスパス

• Command Line Reference
• Compiler Plugins
• Console Project
• Cross Build
• Forking

• グローバル設定

• Inspecting Settings
• Java Sources

• ランチャ

• Library Management
• Local Scala
• Mapping Files
• Migrating to 0.10+
• Parsing Input
• Paths
• Process
• Publishing
• Resolvers
• Running Project Code
• Scripts
• Setup Notes

• タスク

• TaskInputs

• Testing
• Triggered Execution
• Update Report

インストール

0.10以降は、従来のgooglecodeからgihubにウェブサイトが変更されている。https://github.com/harrah/xsbt/wiki/Setup

ダウンロードは、http://typesafe.artifactoryonline.com/typesafe/ivy-releases/org.scala-tools.sbt/sbt-launch/の中の最新のものにすればよい。

ダウンロードしたjarファイルは$SCALA_HOME/libやプロジェクトのlibディレクトリ、あるいはその他クラスパスの通ったところには置いてはいけないという。

次にDOS窓でsbtコマンドが使えるように、sbt.batを作成し、これをPATHの通ったところにおくか、PATHを通す。

java -Xmx512M -jar "(sbt-launch.jarをおいたパス)\sbt-launch.jar" %*

初回にsbtコマンドを実行すると、scala環境を勝手にダウンロードしてくるので、終了するまで待つ必要がある。

チュートリアル

• ステップバイステップ

IDE用プラグイン

• sbt/Eclipse

• sbt/IntelliJ（sbt0.7に基づいている）

機能拡張プラグイン

• sbt-assembly