sbt定义子项目的标准方式是把子项目放在父项目的目录下,然后在父项目的Build.scala中定义子项目及其依赖关系。但这种方式要求把子项目放在父项目目录下这一点非常不爽,特别是如果某个子项目要在多个独立项目间共享时。这种方法这里就不说了,如果不想把子项目放在父项目目录下,sbt还提供了另外两种方法。
第一种方法称为项目引用。假如有一个commonsub子项目,放在/some/place/commonsub下,主项目放在/another/place/mainProject下,这两个目录完全不相关,那在主项目中就可以这样引用commonsub:
实现起来很简单,只是把Project换成了RootProject,如果你要引用的是commonsub下的一个子项目,如commonsub-sub,也就是子子项目,那把RootProject换成ProjectRef就行了,RootProject、ProjectRef甚至可以引用一个git仓库或一个已经打好包的jar,具体请参考[url=http://www.scala-sbt.org/release/docs/Dormant/Full-Configuration.html#project-relationships]sbt文档[/url]。需要注意的一点是,引用外部项目的时候,在主项目中,要设置好sbt.boot.directory这个环境变量,在你的sbt启动脚本中设置好就行了。
最后一种方式是把子项目打包发布,然后在主项目是加上对子项目的依赖,所以严格说起来,其实不是定义子项目,但是确实可以工作。sbt可以把项目打包发布到一个maven或ivy仓库,这个仓库可以是远程的,也可以是本地的。为了方便,假如要把commonsub发布到本地,那么在commonsub的项目定义中加上:
然后在sbt shell中执行publish命令,就可以把commonsub打包发布到指定的地方了,上面的代码中是设定发布到maven本地仓库,你也可以指定成任何其它的目录。然后要在主项目中增加对commonsub的依赖:
这种方式相对麻烦一些,另外还需要注意一点的是,两个项目要用相同的scala版本编译,因为不同的scala版本编译的结果可能是不兼容的。
不管哪种方式,都别忘记在项目更新时更新对子项目的引用,第二种方式中需要你自己checkout对应版本的源码,第三种方法需要你显式的定义依赖于哪个版本的子项目,比较而言,这种方式相对不容易遗忘些。
第一种方法称为项目引用。假如有一个commonsub子项目,放在/some/place/commonsub下,主项目放在/another/place/mainProject下,这两个目录完全不相关,那在主项目中就可以这样引用commonsub:
lazy val common = RootProject( file("/some/place/commonsub") )
……
val main = Project("main", file(".")) dependsOn(common)
实现起来很简单,只是把Project换成了RootProject,如果你要引用的是commonsub下的一个子项目,如commonsub-sub,也就是子子项目,那把RootProject换成ProjectRef就行了,RootProject、ProjectRef甚至可以引用一个git仓库或一个已经打好包的jar,具体请参考[url=http://www.scala-sbt.org/release/docs/Dormant/Full-Configuration.html#project-relationships]sbt文档[/url]。需要注意的一点是,引用外部项目的时候,在主项目中,要设置好sbt.boot.directory这个环境变量,在你的sbt启动脚本中设置好就行了。
最后一种方式是把子项目打包发布,然后在主项目是加上对子项目的依赖,所以严格说起来,其实不是定义子项目,但是确实可以工作。sbt可以把项目打包发布到一个maven或ivy仓库,这个仓库可以是远程的,也可以是本地的。为了方便,假如要把commonsub发布到本地,那么在commonsub的项目定义中加上:
publishTo := Some(Resolver.file("file", new File(Path.userHome.absolutePath+"/.m2/repository"))) //或者任何其它的地方
然后在sbt shell中执行publish命令,就可以把commonsub打包发布到指定的地方了,上面的代码中是设定发布到maven本地仓库,你也可以指定成任何其它的目录。然后要在主项目中增加对commonsub的依赖:
resolvers += "Local Maven Repository" at "file://"+Path.userHome.absolutePath+"/.m2/repository"
libraryDependencies += "com.yourCompany" % "commonsub" % "X.X.X"
这种方式相对麻烦一些,另外还需要注意一点的是,两个项目要用相同的scala版本编译,因为不同的scala版本编译的结果可能是不兼容的。
不管哪种方式,都别忘记在项目更新时更新对子项目的引用,第二种方式中需要你自己checkout对应版本的源码,第三种方法需要你显式的定义依赖于哪个版本的子项目,比较而言,这种方式相对不容易遗忘些。