Scala sbt

目次

FrontPage
・Windows11
・Chromebook
・Random
・機械学習
・さくらVPS
・Fedora13
・SuSe10
・Docker
・Ansible
・Java
・Scala
・Python
・Ruby
・Lisp
・Computer
・GIS
・HTML
・Culture
・Link

訪問者

total: 10001
today: 7
yesterday: 7
now: 6

更新

最新の10件

人気の10件

MenuBar

sbt †

• Scala プログラムのビルドツール
• http://www.scala-sbt.org/index.html

sbtプロジェクトの作成 †

• 前提
  • Scala Install で Scala/Sbt をインストール
  • Scala Netbeans 8 で Scala plugin をインストール
• 新規プロジェクトの作成で Scala を選べば sbt プロジェクトが作られる
  

sbtプロジェクトのディレクトリ構造 †

• ソースコードの配置場所は Maven に準ずる

  src/main/java	ソースコード
  src/main/scala	ソースコード
  src/main/resources	設定ファイルやアイコン画像など
  src/test/java	テストコード
  src/test/scala	テストコード
  src/test/resources	テストデータなど

• 設定ファイルは project/ に配置

  Build.scala	ビルドスクリプト(旧式の記述方法) → 削除する
  build.sbt.template	ビルドスクリプト(現行の記述方法) → build.sbt にリネームする
  build.properties	sbt の バージョン指定
  plugins.sbt	sbt の plugin 指定

build.properties †

• sbt のバージョンを指定する

  https://github.com/kagyuu/ScalaSbtExam/blob/master/project/build.properties

  sbt.version=0.13.5
  

plugins.sbt †

• sbt のpluginを指定する

  https://github.com/kagyuu/ScalaSbtExam/blob/master/project/plugins.sbt

  addSbtPlugin("org.netbeans.nbsbt" % "nbsbt-plugin" % "1.1.4")
  
  addSbtPlugin("com.typesafe.sbt" % "sbt-scalariform" % "1.3.0")
  
  

  指定方法は

  addSbtPlugin( "${groupId}" % "${artifactId}" % "${version}")

• 公式ドキュメントでは、plugin ごとに sbt ファイルを作る用に書いてあったけど、Netbeans の Scala-plugin は plugins.sbt にまとめる主義らしい
• 主要な plugin → http://www.scala-sbt.org/0.13/docs/Community-Plugins.html

build.sbt †

https://github.com/kagyuu/ScalaSbtExam/blob/master/project/build.sbt

import scalariform.formatter.preferences._

lazy val root = (project in file(".")).
  settings(commonSettings: _*).
  settings(
    name := "SampleProject",
    libraryDependencies ++= Seq()
  )

lazy val commonSettings = Seq(
  organization := "your.organization",
  version := "0.1.0",
  // build.sbt supports 2.10.x only due to scalariform version. Use Build.scala for 2.11.x
  scalaVersion := "2.10.4",
  scalacOptions ++= Seq("-unchecked", "-deprecation"),
  javacOptions ++= Seq("-source", "1.6", "-target", "1.6"),
  resolvers ++= Seq(
    "Sonatype OSS Releases" at "https://oss.sonatype.org/content/repositories/releases",
    "Sonatype OSS Snapshots" at "https://oss.sonatype.org/content/repositories/snapshots",
    "Typesafe Releases" at "http://repo.typesafe.com/typesafe/releases/"
  )
)


// scalariform code format settings
scalariformSettings // enable scalariformSettings

ScalariformKeys.preferences := ScalariformKeys.preferences.value
  .setPreference(RewriteArrowSymbols, false)
  .setPreference(AlignParameters, true)
  .setPreference(AlignSingleLineCaseStatements, true)
  .setPreference(DoubleIndentClassDeclaration, true)
  .setPreference(IndentSpaces, 2)

• Project Settings
  • sbt.Project オブジェクトに key:value の形で設定を追加しているだけ
  • 設定項目は http://www.scala-sbt.org/0.13/api/index.html#sbt.Keys$
  • 主な設定項目

    option	type	explanation
    organization	String	gropuId
    name	String	artifactId
    version	String	version
    scalaVersion	String	scala version
    scalaOptions	Seq[String]	scala compiler options
    javaOptions	Seq[String]	java compiler options
    resolvers	Seq[Resolver]	Maven repository. (${name} at ${url})
    libraryDependencies	Seq[ModuleID]	required library. (${groupId}" % "${artifactId}" % "${version}")
    publishTo	SettingKey?[Option[Resolver]]	publish jar to the Maven repository. cf. http://www.scala-sbt.org/release/docs/Publishing.html
    mainClass	String	project main class

  • libraryDependencies で指定するライブラリに scala のバージョンを入れる
    

    scalaVersion := "2.10.4"

    のとき

    "org.scala-tools" %% "scala-stm" % "0.3"

    は、

    "org.scala-tools" % "scala-stm_2.10.4" % "0.3"

    と同じ
  • ローカルにおいた jar を参照したい

    lib/

    に jar ファイルを置けば、sbt がビルド時に参照してくれる
  • 演算子

    key := value	key に value を設定する
    key += value	key に value を追加する
    key ++= Seq(value1, value2, value3, ...)	key に value1, value2, value3 を追加する

• Plugin
  • plugins.sbt で取得した plugin に対して設定を行う。sbt.Project と同様に key:value 形式のオブジェクトを作る
  • scalariformSettings は、compile 時にソースコードの生計を行う plugin
    • https://github.com/sbt/sbt-scalariform
    • https://github.com/scala-ide/scalariform

マルチプロジェクト †

lazy val commonSettings = Seq(
  organization := "com.example",
  version := "0.1.0",
  scalaVersion := "2.11.7"
  )

lazy val root = (project in file(".")).
  aggregate(util, core)

lazy val core = (project in file("core")).
  settings(commonSettings: _*).
  settings(
  // other settings
  name := "SampleCore",
  )

lazy val util = (project in file("util")).
  settings(commonSettings: _*).
  settings(
  // other settings
  name := "SampleUtil",
  ).
  dependsOn(core)

• ディレクトリごとに sbt.Project オブジェクトを作る
• root プロジェクトが util, core を aggreaget しているので、root で sbt が動くと core と util がビルドされる
• util.dependsOn(core) で、util プロジェクトは core プロジェクトの成果物に依存させる
• 共通的な設定は commonSettings に定義 (Netbeasn で生成された単一プロジェクトの sbt にcommonsSettings があったけど、マルチプロジェクトに行きやすくするためだったのね

sbt コマンド †

• http://www.scala-sbt.org/0.13/docs/Command-Line-Reference.html

  clean	target/ を削除
  publishLocal	ローカルのIvyレポジトリに、作成した資産を配布
  publish	リモートのレポジトリに、作成した資産を配布 cf.Mavenレポジトリへの配布
  udpate	依存ライブラリを更新
  compile	src/main/scala、src/main/java 配下のソースコードをコンパイルする
  console	コンパイル済み資産を Classpath に加えて sbt コンソールを起動。終了 Ctrl+D(Unix) Ctrl+Z(Windows)
  package	src/main/scala、src/main/java、src/main/resources → jar
  packageDoc	src/main/scala → doc jar
  packageSrc	src/main/scala → src jar
  run <argument>*	プロジェクトのメインクラスを実行する cf.メインクラスの指定
  runMain <main-class> <argument>*	プロジェクト内の任意のメインクラスを実行する
  test	テストを実行する

2016-07 時点での留意点 †

• sbt 1.3 は scala 2.10 ビルドされている
• scalaVersion := "2.10.4" とする必要がある
  • 2.11 だとビルドできない
  • とくに、auto plugin が初期化でコケる

Scala