欢迎来到队式16的开发仓库

2014-9-26 接口再次更新，请大家查看 logic_api.md 和 platform_api.md

本仓库目前包括了逻辑组，平台组和界面组。

目前入驻的有：

逻辑组：郭一隆 (@Nuullll), 孙胜扬 (@ssydasheng), 杨幻睿 (@yanghr), 王殷豪 (@YacratesWyh)

平台组：李思涵 (@ThomasLee969), 刘家硕 (@Liudada), 阮磊 (@tristoner-RL)

界面组：李文硕 (@Gaffey)，林梓楠 (@fjxmlzn)

图例：

紧急的任务

一般的任务

关系不大的任务

• 跑通游戏

• 编写对逻辑组代码的测试模块 (阮磊)
• 完成 Battle 及其子类框架的编写 (刘家硕)
• 完成 AIProxy 与选手程序的通信 (李思涵 @ 刘家硕)
• 编写对平台组代码的测试模块 (李思涵 @ 刘家硕)
• 完成能黑箱运行的对战程序

• 赶紧和逻辑组商量好，给他们各种提建议
• 完成界面设计
• 搞定接口
• 完成主界面、地图编辑器、回放器的编写

• 确定 平台/界面 接口
• 更新了单位介绍
• 确定 逻辑/平台 接口
• 提供 Markdown/LaTex 格式的选手文档

Git教程 by 廖雪峰

Git简明指南 by rogerdudler（据说是雨泽学长推荐）

然后去学习一下一种正确的分支姿势，这次的开发的分支策略就是基于这个的。 真的很重要！！！

请大家 不要 使用中文文件名或目录名 = =

请大家 不要 直接对 master 分支进行修改，而是将 develop 分支作为主要开发分支。（为了保险起见我还是把 master 设为protected了…Orz）

请大家 不要commit写到一半的代码，对每次commit 附上清晰简明的概要，并且 在本地测试没有问题之后再push

请大家在merge时 使用 --no-ff 参数，以保持branch层次的清晰

鉴于惨痛的经验…为了保持分支图的清晰，如果在push时发现远程仓库下的对应分支已被修改，并且预期不会有太多的conflict， 请不要直接使用 git pull， 而是使用 git pull --rebase，以避免不必要的merge

下面是个人摸索出的，比较科学的工作流程……

$ git clone http://git.eesast.com/ThomasLee/teamstyle16.git  # 克隆仓库到当前目录下
$ cd teamstyle16  # 进入本地仓库文件夹
$ git status  # 确认下处在 develop 分支

如果还想要仓库内的其他分支（如 master）

$ git checkout -b master origin/master  # 创建本地分支，并跟踪远程分支
$ git pull  # 更新本地分支到最新状态

$ git checkout develop  # 来到 develop 分支
$ git pull  # 获取最新的工作进度
$ git checkout -b some_work  # 分支出 some_work 分支，并转到该分支

如果是需要多人合作的分支，则可能需要 push 到远程库

$ git push -u origin some_work  # 推至远程，同时设置为跟踪该远程分支

加入了新文件 some_new_file

$ git add some_new_file

修改了一系列已经添加的文件，一同提交

$ git commit -a

develop 分支上出现了比较重要的更新，需要立即合并到当前分支

$ git checkout develop  # 来到 develop 分支
$ git pull  # 获取最新的工作进度
$ git checkout some_work  # 来到工作分支下
$ git merge --no-ff develop  # 将最新更新与自己已有工作进度合并

$ git checkout develop  # 来到 develop 分支
$ git pull  # 确保 develop 分支与远程同步
$ git merge --no-ff some_work  # 将工作成果合并进 develop 分支
$ git push  # 将合并后的 develop 分支推至远程仓库

如果很不幸，有人在 merge 的时间里更新了 develop 分支导致 push 失败， 请在 pull 时带上 --rebase，以保持分支图的清晰

$ git pull --rebase  # 将本次修改放在此修改之后
$ git push  # 推回远程仓库

最后别忘了删除 some_work 分支

$ git branch -d some_work  # 删除 some_work 分支

如果之前将该分支推至远程库，则还要从远程库删除

$ git push origin :some_work  # 将一空分支 push 到远程库的该分支，即删除

大家注意，所有操作都保持了 develop 分支 在本地与远程的同步

这里的思路是 本地的 develop 分支是远程 develop 分支的直接体现

所有本地 develop 分支上的改变，都应对应着远程 develop 分支上的改变

故在 develop 分支可能发生冲突时，请使用 git pull --rebase （如果不确定，一直用它就好了…）

其他类似的分支同理……

推荐SourcetTree

不过建议大家主要用这类工具看看分支树和修改历史，或者便捷地 commit……当然，如果你 清楚地 知道自己在做什么的话，用它而抛弃命令行也不是什么大事 = =

大家加油~🙏