This repository has been archived by the owner on Mar 14, 2019. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 218
scrach
zhongl edited this page Jun 20, 2012
·
21 revisions
- Foke我的源码库
- Fork 成功后, 从自己的库中克隆都本地(注意替换
$yourname
),git clone https://github.com/$yourname/HouseMD.git housemd
-
src
源代码目录(含单元测试代码) -
acceptance-test
验收测试代码目录 -
bin
安装和运行脚本目录 -
project
SBT
构建脚本和插件配置目录 -
sbt
SBT
启动脚本
执行./sbt
, 进入SBT命令行.
注意, 第一次执行
./sbt
, 此脚本会自动下载SBT
, 并启动它. 此后有一段较长时间的初始化, 以及下载依赖包的过程, 期间可能会因为GFW
原因导致一些依赖无法下载, 请在sbt
脚本文件中配置HTTP代理.
下面的命令全部是在进入SBT
命令行之后执行的:
> compile
编译源码
> test
执行测试用例
> assembly
打包
HouseMD
使用主要编程语言是Scala和Java, 下面是常用IDE
准备说明, 若你喜欢的工具不在此列, 我表示很遗憾, 请咨询Google: scala $your_favorite_ide_or_editor
IntelliJ IDEA (推荐首选)
-
下载
IDEA
的社区版(免费) - 启动
IDEA
, 选择菜单File
->Settings
->Plugins
中搜索并安装Scala
插件 - 在
SBT
的命令行下, 执行gen-idea
, 便会生成IDEA
的项目文件 - 在
IDEA
中, 选择菜单File
->Open Project
打开项目, 马上开始为HouseMD
贡献你的智慧吧:)
- 不多废话, 请参考官方文档安装配置
- 在
SBT
的命令行下, 执行eclipse
, 便会生成Eclipse
的项目文件 - 在
Eclipse
中打开项目, 马上开始为HouseMD
贡献你的智慧吧:)
注意, 有可能打开项目后你发现
.java
的文件会有编译错误提示, 也许Scala-IDE
目前对Scala project
中混合有.java
文件的支持不是很好, 这个是可以忽略的, 因为只需要用SBT
进行编译构建就可以了.
如果你知道怎么解决请邮件告诉我, 谢谢
原则上, 只要是对HouseMD
有帮助的都可以, 例如但不限于:
- 解决已有的Issue
- 提交新的Issue, 功能特性, 改进, 缺陷都可以
- 新增或修订Wiki页
- 分享
HouseMD
的使用和开发经验技巧, 记得邮件告诉我链接, 我会放到Wiki Home让更多人知道
提交你的贡献之前, 请做到下面几点小小的要求:
- 请确保你的贡献有相应的Issue, 这样方便大家了解贡献的上下文背景, 甚至一同参与讨论
- 提交中必须含有相应的单元测试代码, 单元测试代码应能清晰的说明且验证你提供了哪些特性上的变化
- 强烈建议参考
HouseMD
已有的测试用例, 采用FunSpec
风格能够更容易的清晰表达其意图.
- 提交之前, 请确保单元测试全部通过
在你的代码提交到你的github上(获取源代码时Fork产生的库)后, 请点击Pull Request
向我发起请求, 并在提交的表单中清晰描述你的提交目的和变化要点, Github会自动邮件通知我, 随后我会第一时间处理. 更多操作帮助请见Using Pull Request.
没有比新增一些更酷的指令, 更让人兴奋的啦~
请参考代码:
请参考代码:
有疑问请提交Issue, 我们一起来讨论:)