-
Notifications
You must be signed in to change notification settings - Fork 0
v1_CN_Git
如何选择SRS的稳定版本?如何更新代码?
很多人希望缩减仓库大小,很多doc和3rdparty中的第三方代码压缩包。我在这里集中说明一次,为何需要把doc收集那么全?这个不言自明,srs中23%的代码都是注释,注释会说明是哪个文档的哪一页,难道还需要再下载一次这个文档吗?为何需要把依赖的第三方代码放进来,譬如ffmpeg和nignx还有openssl?谁会无聊到再执行几个命令去下载?
为何不做这些改变?这些是次要复杂度,仓库多大对于代码质量没有任何影响。而且更重要的是,国内很多git镜像站点,SRS是同步更新的,阿里云提供服务的oschina,我git clone一次是40秒左右。难道一定得是3秒clone下来才叫做满意吗?不要纠缠这个问题了。
如何使用国内镜像站点clone,然后把服务器设置为github上?这样和直接从github上clone一模一样了。执行下面的命令就可以了:
git clone https://git.oschina.net/winlinvip/srs.oschina.git && cd srs.oschina &&
git remote set-url origin https://github.com/winlinvip/simple-rtmp-server.git
其他国内镜像参考:https://github.com/winlinvip/simple-rtmp-server/tree/develop#mirrors
有些功能只有SRS2.0有,SRS1.0没有,请注意看wiki是v1还是v2的。
如果是1.0的功能,更新代码后要改变到1.0分支:
git pull && git checkout 1.0release
如果是2.0的功能,更新代码后要改变到2.0分支:
git pull && git checkout 2.0release
如果是3.0的功能,更新代码后要改变到3.0分支(没有单独的3.0release分支就是develop):
git pull && git checkout develop
注意:master是作为稳定版本分支。
稳定的SRS版本会新建branch,譬如1.0release。1.0release是1.0的release,有最新的bug fix。
Master分支是主要的release,目前就是1.0。对比1.0release分支,master分支bug fix频率低,每隔1-2个月会集中merge 1.0release的bug fix到master。
develop是开发版,目前是2.0。
所以稳定度master >= 1.0release >> develop.
注意:中国国内访问github慢,可以使用oschina或csdn镜像,参考下面的其他镜像。
你可以从github获取SRS的代码,需要先安装git(如何安装git可以百度下)。
安装好git后,执行以下命令获取SRS最新代码:
git clone https://github.com/winlinvip/simple-rtmp-server
其他镜像git地址: https://github.com/winlinvip/simple-rtmp-server/tree/1.0release#mirrors
SRS包含的软件很多,不需要额外下载其他的包就可以编译。所以第一次从github上下载后,不需要每次都git clone,用以下命令即可更新:
git pull
另外,不需要删除objs后编译srs,只需要make就可以编译。若make出错,则执行configure之后再make,可能有配置项更新。
fork之后,可以在github上点击pull request和主分支保持同步。
下面以和angularjs同步为例,我fork了angularjs,然后一个月之后和主分支同步。
step 1:点击pull request
step 2: 切换为同步模式
默认是将你的修改同步给作者,也就是作者在左边,你的修改在右边。
点击switching the base
会将你放在左边,作者放在右边,同步总是从右边同步到左边。
step 3: 提交同步请求
点击Create pull request
按钮,开始将作者的修改同步到你的github分支。
注意:点击一次后开始发起请求,有时候请求完了也没有响应,再点一次Create pull request
按钮就好了。
step 4: 创建请求
输入信息,点击Create pull request
按钮。
step 5: 创建请求成功
可以看到成功创建了同步请求,提交到自己的分支的pull request中了。
拖动滚动条到页面最后,开始合并请求,即和作者同步。
step 6: 合并修改
点击按钮合并请求。
step 7: 确认合并
step 8: 同步成功
然后在自己的虚拟机上git pull
就可以将自己的github的项目同步到虚拟机。
如果本地有修改,譬如改了SRS的代码,那么git pull会提示无法更新。这时候可以撤销所有本地的修改,然后更新:
git reset --hard
git pull
注意,这个会导致所有的修改都丢弃,只适用于不需要保留修改代码的情况。如果你需要提交代码,请参考git详细的用法。
一个仓库(project/repository)可以有多个branch,每个commit都可以作为tag(里程碑,一般release分支有)。
SRS使用的branch策略稍微不一样,SRS不会同时开发多个版本,所以没有feature分支;也没有hotfix分支,直接在对应的release分支hotfix后打tag。
SRS只有master,develop和release分支;master是主要的稳定版本分支,release是各个稳定版本的分支,develop是开发版分支。
譬如,develop开发分支在准备Release1.0时,打出Release1.0分支,冻结功能,测试并发布。Release发布后,merge到master作为主要版本发布。
参考:http://nvie.com/posts/a-successful-git-branching-model/
参考:http://blog.csdn.net/sabalol/article/details/7049851
撤销上次commit(还没有push到服务器时,只是commit到本地git):
git reset --soft HEAD~1
执行完后git status
可以看到有修改的文件,就回退到了git commit
之前的状态了。
若已经push到了服务器,就没法撤销commit了,只能撤销本地的commit。
git提供了一个方案,再次提交一次commit正好和上次commit相反,这样的效果也是撤销了:
git revert HEAD~1
执行完后git status
可以看到有新的修改,用来覆盖上次的commit。
Winlin 2014.3