Getting Started on RapidFTR (Chinese)

什么是RapidFTR?

RapidFTR是thoughtworks P3下面的一个项目。在紧急情况下，无论是自然灾害还是武力冲突，骚动导致孩子和他们的照顾者分开。使孩子容易受到暴力 经济和性剥夺和贩卖。现在使用的方式是用纸来纪录孩子的信息这样是很低效的。由于这样，很多珍贵的时间被浪费。

RapidFTR是一个多功能的开源手机应用和数据存储系统，旨在通过帮助人道主义工作人员来收集，整理和分享由于紧急情况无人照管的孩子信息。通过这个系统他们可以和他们的家人团聚。RapidFTR是专门为了加快寻找孩子的家人。

RapidFTR是一个开源软件，全是由志愿者完成的, 由联合国紧急情况儿童保护团队支持，已经收到从人道主义创新基金和联合国供应基金会的支持。

RapidFTR是一个个很有意义的项目，可以帮助更多的人。比如说现在中国四川雅安地震，这样的软件就可以做很有意义的事情。希望更多的人可以加入这个项目，献出自己的一份力。项目是基于ruby on rails，数据库采用couchdb。对于ruby和ruby on rails的入门推荐一个很好的入门视频网站 http://railsforzombies.org/

为什么选择 Rapidftr?

• 这个一个公益项目，很有价值
• 无论你是在工作还是学习，这是一个很好的学习机会，体验什么叫极限编程，什么叫TDD(test driver development)。而且可以跟各种外国人进行沟通。
• 在你完成story的过程中，你从现在的代码中可以学到很多东西。
• ruby on rails 真的很有诱惑力，如果你曾经开发过web应用程序，你将会发现ruby on rails让一切变的简单。

建立项目开发环境

Ruby on Rails + Android Mobile.

https://github.com/rapidftr/RapidFTR/wiki/Install-and-run-RapidFTR-on-OSX

这个是在mac os 上关于如何安装配置环境的。这个开发环境可能并不像java，c＋＋那样一下就可以装好，请大家多一些耐心。我完全不懂命令行，也是装的焦头烂额。但是我最终学会了如何去解决问题，在安装的过程中。还有就是每次如果出错之后建议把错误拿到google上去搜索，一般可以找到结论。

关于集成开发环境问题，因为代码太多个人建议可以装一个集成开发环境rubymine用来查看代码。

开发阶段

首先需要在mingle上注册一个帐号，记得选择RapidFTR。 https://minglehosting.thoughtworks.com/rapidftr/users/registration/new 。如下链接是rapidftr开发者页面，https://minglehosting.thoughtworks.com/rapidftr/projects，

采用mingle来管理整个项目。mingle是thoughtworks开发的管理story的一个工具。在极限编程中story＝task。你可以在mingle中找你想要完成的story。比如 Ready for Dev表示已经准备好进行开发，还没有人选。 IN Dev正在开发中。我们可以通过鼠标点击进入story的详细信息页面，如果想选某个Ready for Dev，assigned to 那里输入你注册的用户名，然后项目就会移入 In Dev。不同颜色的story代表不同的story类型，如红色代表bug，页面侧面有说明。

在你进行story之前，需要使用git来管理你的项目。git可以纪录你所做的改变。同时需要注册一个github帐号，通过如下链接进行配置，配置完之后就不用每次push都要输入密码了https://help.github.com/articles/set-up-git。

注意这个链接里面有这么一句需要特别注意：

    sudo mv git-credential-osxkeychain `dirname \`which git\``

   # Move the helper to the path where git is installed

我当时用的 which git命令，显示的是git装在哪里。usr\bin\git

然后做了一件很悲剧的事情，

   sudo mv git-credential-osxkeychain usr\bin\git

这个命令覆盖了我之前的git，我的git就这样没了。正确的命令应该是sudo mv git-credential-osxkeychain usr\bin 放在和git一个文件夹里面就可以了。

关于public和private key的生成可以参考如下页面:https://help.github.com/articles/generating-ssh-keys。

页面生成之后就可以不用每次push都要输入密码了。

这个链接是教大家如何在github上对一个项目作出贡献的实际步骤，https://help.github.com/articles/fork-a-repo

关于terminal建议大家安装iTerm2,这个软件可以有一些颜色的设置，这样比如git diff这样的命令看起来会稍微好一些。

  git status可以用来查看项目的当前状态

  git diff是用来查看你的代码和你从github下载的有那些改变，＋号表示增加的，－表示删除的。

  git add  "file_name"  把你对这个文件的改变存在本地库里

  git add  .  把所有改变纪录在本地库里（注意add和. ）之间有个空格 

  git commit －m "the message you want to deliver" 把之前add的东西提交到github。

一般调用git commit的时候会自动调用git pull。对你目前的本地库进行一下更新也就是merge。很有可能别人对代码的改变会和你的代码产生影响。一般使用git pull --rebase人工进行merge。

一切完成之后就可以进行正式的开发了，你可以选择自己感兴趣的story。完成。记得每次准备push代码之前跑一遍所有的测试，保证程序的正确性。

你也可以考虑加入我们的IRC group同我们进行交谈。 可以使用客户端collaquy/ pidgin。或者使用网页版，网页地址是irc.freenode.net 加入频道#rapidftr。