转——SVN使用教程——很全

概要

 概述

    SAE自2011-7-10日起，将全面支持SVN代码部署，用户不仅可以通过任何SVN客户端部署代码，而且SAE现有的代码部署方式也已经对接应用的SVN仓库，即使不使用SVN客户端部署代码，也保证了代码版本。

    如：通过桌面SDK或在线SDK代码编辑器(http://sdk.tools.sinaapp.com)等方式对代码的修改、部署等操作也会像svn commit一样，产生一个新版本。通过SVN客户端svn update可以获取最近的更新，也可以通过svn客户端回滚代码。

 与标准SVN的区别

    为了保持与SAE兼容，使用svn方式部署代码到SAE有如下限制：

    1. 文件名或目录名不允许含有以下字符：",*,?,<,>,|，另外文件或文件名的开始与结束也不允许有空格。

    2. 上传单个文件大小不超过20M

    3. 单个目录下的文 件个数不能超过2000个

    4. 每个应用代码总大小不超过100M

    5. 单个版本代码总大小不超过50M

    6. appname目录下只允许存在10个以内的版本，并且版本号必须为正整数。（也就是说appname下面只允许出现10个以内的正整数目录名，不允许有非目录的存在）

 代码部署原理 

 相关资源

Windows SVN

 使用TortoiseSVN客户端

    在Windows下推荐使用乌龟(Tortoise)SVN客户端。 TortoiseSVN 是 Subversion 版本控制系统的一个免费开源客户端，可以超越时间的管理文件和目录。文件保存在中央版本库（即SAE中央SVN仓库），除了能记住文件和目录的每次修改以 外，版本库非常像普通的文件服务器。你可以将文件恢复到过去的版本，并且可以通过检查历史知道数据做了哪些修改，谁做的修改。这就是为什么许多人将 Subversion 和版本控制系统看作一种“时间机器”。

  下载安装

    TortoiseSVN下载：http://dl.pconline.com.cn/download/53122.html

    又不是在linux下，安装就不多说了 :)

    下面详细介绍使用TortoiseSVN向SAE部署代码。

  创建本地工作目录

    第一步，如图1，创建一个新文件夹作为本地工作目录(Working directory)，可以使用应用名为文件夹名。如，为我的应用devcenter创建本地工作目录。

    第二步，从SAE的SVN仓库检出(checkout)一个应用的全部版本代码，如图2，右键-->点击“SVN Checkout”

    在弹出页面中填写仓库路径即可，这里是：https://svn.sinaapp.com/devcenter/，其它默认参数即可，如图3：

    Reversion处，“HEAD revision”是指最新版，也可以指定Revision为任意一个版本。

    点击“OK”，出现下载界面，如图4：

    如果一切顺利，devcenter应用所有版本代码将会全部出现在刚刚创建的devcenter文件夹下，如图5：

  修改代码

    在本地使用你喜欢的编辑器，编辑任意文件，保存后该文件图标将会出现红色感叹号，如图6所示：

    看，刚刚修改过的index.php变色了。下面需要提交(commit)最近的更新。在index.php文件上击右键，出现菜单 ，选择“SVN commit”，如图7：

    然后填写关于本次更新的日志（log message），这是必填项，否则commit会失败。如图8：

    当您看到如图9所示，表明刚才的修改已经成功提交，并且前该devcenter项目的SVN版本号加1，变成30.

  新增文件/文件夹

    在 SVN工作目录下，对于文件修改，完成后只需要commit就ok了，但对于新增文件，或者从其它目录复制进来的文件或文件夹，需要在commit之前需 要做一步add操作，即将文件或文件夹添加到svn工作目录中来，否则SVN客户端不认它。具体操作很简单，如图10:

    然后再如图7所示，右键commit即可。

    更多Tortoise SVN使用帮助，请参阅：http://www.subversion.org.cn/tsvndoc/

 Notepad++集成svn插件

    Notepad++ 是一款Windows环境下很受欢迎的免费开源的代码编辑器，有很丰富的第三方插件。

    下面介绍Notepad++的svn插件的安装及使用。

    如图12，点击Plugin --> Plugin Manager --> Show Plugin Manager

    打开后，在“Available”页找到“Subversion”，然后点击“Install”，如图13所示：

    安装成功后会在Plugins菜单下出现"Subversion"子菜单。

    打开之前checkout下来的任一文件，如devcenter/1/index.php，编辑完成后，点击Plugins --> Subversion --> Commit File(或使用快捷键Ctrl+Alt+A)

    出现熟悉的一页，如图14所示：

    对，这就是乌龟SVN的Commit页面，输入Log Message，点击“OK”即可提交。

 使用UltraEdit Studio部署

    UltraEdit Studio(注意不是UltraEdit，UltraEdit不能与SVN整合)配置稍微复杂些。

    第一步，SVN仓库账号设置，如图15所示：

    然后填写仓库信息，如图16所示：

    完成后，创建Project，如图17所示：

    填写project名b.prj后，出现如图18所示"Project Settings"，点击“Add Folder”，出现“NewFolder”，将"Group"前的勾去掉，然后点击“Browse”，在“Browse for Folder”页找到之前checkout出现的本地工作目录。

    点击“OK”后出现提示，如图19所示：

    表明UEStudio自动识别出了选择的代码目录是一个SVN工作目录，并询问是否整合，点击“Yes”，出现如图20所示：

    大功告成，"Close"之后即可以编辑代码，并随时commit修改。如图21所示：

 使用EditPlus部署

    EditPlus依赖于Tortoise SVN(TSVN)，必须先安装。

    使用最简单，见图22所示：

    当编辑SVN工作目录里的文件时，File --> TSVN即出现相应可操作的菜单。

Linux/Mac SVN

 仓库地址

    https://svn.sinaapp.com/appname/

    为了传输安全，SAE要求统一使用https方式部署代码；

 创建仓库

登陆SAE在线管理平台(http://sae.sina.com.cn)，创建应用，成功后您即可以检出该应用代码。

例如，您刚刚创建了应用newapp，在本地执行：

svn checkout https://svn.sinaapp.com/newapp

      第一次checkout时需要验证，用户名/密码为您的SAE安全邮箱和安全密码(非微博登陆账号密码)。

 创建版本

      假如，为newapp应用创建版本1

      目前提供两种方式：

  使用svn客户端