《TortoiseSVN使用手册.doc》由会员分享，可在线阅读，更多相关《TortoiseSVN使用手册.doc（48页珍藏版）》请在三一办公上搜索。
1、技术白皮书HAND Enterprise Solutions Company Ltd. Author:Creation Date:November 29, 2005Last Updated:一月 1, 0001Document Ref:TWP Version:DRAFT 1A Copy Number_Document ControlChange Record4DateAuthorVersionChange Reference22-Sep-06Siomon LiuDraft 1aNo Previous DocumentReviewersNamePositionDistributionCopy N
2、o.NameLocation1234Note To Holders:If you receive an electronic copy of this document and print it out, please write your name on the equivalent of the cover page, for document control purposes.If you receive a hard copy of this document, please write your name on the front cover, for document contro
3、l purposes.ContentsDocument Control112337101313161819202021222729323233344142431.使用 TortoiseSVN图1：在版本控制下的目录菜单所有TortoiseSVN命令都集成在Windows的资源管理器的菜单中。当你在一个文件或文件夹单击鼠标右键时，大多数命令都会直接显示出来。哪些菜单显示出来，依赖于文件或文件夹是否处于版本控制之下。在工作副本目录中，当你用鼠标右键拖拽文件或文件夹到一个新目录，或者把没有在版本控制下的文件或文件夹拖拽到版本控制下的目录中，就会显示另外一些命令在右键菜单中。2.认证假如你试图访问一个
4、有密码保护的仓库，一个认证对话框会跳出来。图2：认证对话框输入你的用户名和密码。那个复选框可以让TortoiseSVN保存认证信息在Subversion的默认目录中：$APPDATASubversionauth。如果你想让Subversion和TortoiseSVN忘记你的认证信息，你必须删除相关的文件。重要信息：在Windows2000及其以上的系统中，认证信息被加密保存在注册表中。要删除认证信息，请选择settings对话框，并且点击Clear Auth Cache按钮。提示：如果你是使用WindowsNT域的认证方式，那么在输入用户名时要包括域名，比如：MYDOMAIN/johnd。3.
5、导入数据到仓库Importing Data Into A Repository3.1.仓库规划Repository Layout在将数据导入到仓库之前，你必须先想好如何组织存放你的数据。如果你使用一种我们推荐的规划方式，你将在以后的使用中感觉到很舒服。我们这里有很多种标准的推荐仓库组织形式。大多数人会创建一个trunk目录来存放开发的“主线”，一个branches目录来存放支线副本，另外还有一个tags目录来存放标签副本。假如一个仓库只保存一个项目，经常会创建这样的几个顶级目录：/trunk/branches/tags如果一个仓库存放多个项目，经常会像下面这样根据分支来规划：/trunk/pa
6、int/trunk/calc/branches/paint/branches/calc/tags/paint/tags/calc.或者根据项目分成多个目录：/paint/trunk/paint/branches/paint/tags/calc/trunk/calc/branches/calc/tags如果多个项目之间的关系不是很紧密，并且他们都是被单独取出的，那根据项目来规划会比较有意义些。For related projects where you may want to check out all projects in one go, or where the projects are
7、all tied together in a single distribution package, it is often better to index by branch. This way you have only one trunk to checkout, and the relationships between the sub-projects is more easily visible.对那些相关的项目（），最好根据分支来组织规划。这样的话，你就只有一个trunk需要checkout，而且子项目间的关系会更明显。你如果采用/trunk /tags /branches并列
8、于根目录的方式，那你必须为每个branch和tag复制整个trunk，也就是说这种结构显得更机动些。对不相干的项目来说，你可以使用多个不同的仓库。当你提交一个改动，版本号会是整个仓库的版本号，而不是项目的版本号。2个不相干的项目共享一个仓库会在版本号方面导致极大的不方便。Subversion和TortoiseSVN的项目看起来好像在同一个地址，但事实上他们在完全不同的仓库中研发着，并且在版本号方面完全的不相干。当然，你可以不管上面提到的这些形式。你可以随意发挥以满足你或者你的团队的需要。记住不管你怎么选择，那都不会是一个永久的形式，你可以在任何时候重新组织你的仓库。因为branches和tag
9、s都是很普通的目录，只要你愿意，TortoiseSVN可以随时移动它们，或改名。从一种形式转换到另一种形式仅仅需要在服务器端做一些文件或目录移动操作；如果你不喜欢你仓库的某种组织形式，尽管大胆的操作那些目录。到这里，如果你还没有在你的仓库中创建一个基本的目录架构，接下来你应该这么做：1. 在你的硬盘中创建一个空目录。2. 在这个目录中创建一个你中意的目录组织形式。注意现在不要放任何文件进去。3. 接下来把这个结构导入仓库。在新建的那个目录上单击鼠标右键，选择Import。这样，就把你刚才创建的临时目录导入到仓库的根目录了，并创建了仓库的基本架构。注意：你导入的这个目录的目录名是不应该出现在仓库
10、中的，应该只有目录中的内容会出现。比如，创建下面的目录结构：C:TempNewtrunkC:TempNewbranchesC:TempNewtags将C:TempNew 导入到仓库的根目录，那么根目录看起来应该是这样的：/trunk/branches/tags另外你也可以使用仓库浏览器（repository browser）直接在仓库中创建新目录。3.2. Import在把你的项目导入到仓库之前，下面的工作必须做好： 1. 把项目中不需要的文件删除。（临时文件、编译器创建的文件，比如*.obj、2进制文件等。）2. 把目录和子目录中的所有文件整理一遍。虽然你可以在导入之后再来进行重命名或删除等
11、操作，但是还是推荐你在导入之前把你的项目整理好。现在，在资源管理器（windows explorer）中选择项目的根目录，单击鼠标右键，选择Import命令，跳出一个对话框：在这个对话框中你需要填写你要将项目导入仓库的URL地址。那个Important Message是用来记录日志信息的。重要信息：和exclude pattern匹配的文件或文件夹不会被导入。当你按下OK按钮，TortoiseSVN就开始把整个目录树包括所有文件导入到仓库了。和前面讲到的一样，这个目录的名字不会出现在仓库中，只有目录中的内容会出现。现在，你的这个项目就处于版本控制之下了。请注意，你刚才导入的这个目录（在你本地硬
12、盘上的这个）并没有处于版本控制下！要获取一份处于版本控制之下的工作副本，你需要对刚导入的版本做一次取出（Checkout）操作。3.3. Special Files有时候你需要版本控制一个存储着用户个性信息的文件。也就是说这个文件每个开发者或用户都会去修改以适应他本地的设置。但每个用户在进行提交（commit）操作时都会把这个文件的修改提交给仓库，这就使得版本控制这样一个文件很困难。在这种境况下，建议使用模版文件。你可以创建一个包含开发人员需要的所有数据的文件，把它添加到版本控制之下，然后让开发人员取出这份文件。接下来，每个开发人员就可以给这个文件做个备份，然后给他改个名字。这样操作之后，不管
13、怎么修改这个备份都不再是什么问题了。 As an example, you can have a look at TortoiseSVNs build script. It calls a file named TortoiseVars.bat which doesnt exist in the repository. Only the file TortoiseVars.tmpl. TortoiseVars.tmpl is the template file which every developer has to create a copy from and rename that fil
14、e to TortoiseVars.bat. Inside that file, we added comments so that the users will see which lines they have to edit and change according to their local setup to get it working. So as not to disturb the users, we also added the file TortoiseVars.bat to the ignore list of its parent folder, i.e. weve
15、set the Subversion property svn:ignored to include that filename. That way it wont show up as unversioned on every commit. 3.4. Referenced ProjectsSometimes it is useful to construct a working copy that is made out of a number of different checkouts. For example, you may want different subdirectorie
16、s to come from different locations in a repository, or perhaps from different repositories altogether. If you want every user to have the same layout, you can define the svn:externals properties. Lets say you check out a working copy of /project1 to D:devproject1. Select the folder D:devproject1, ri
17、ght click and choose properties from the context menu. The Properties Dialog comes up. Then go to the Subversion tab. There, you can set properties. Select the svn:externals property from the combobox and write in the edit box the repository url in the format name url. For example subversion Now cli
18、ck Set and commit your changes. If a user updates their working copy the external project is checked out, too. If you need more information how TortoiseSVN handles Properties read Section 4.9, “Get/Set Information About Files/Directories”. 4.取出工作副本Checking Out A Working Copy为了获取一个工作副本，你必须从仓库中做一次取出（c
19、heckout）操作。在资源管理器中选择一个你想要存放工作副本的目录。单击鼠标右键跳出菜单，选择命令Checkout，再跳出一个窗口：如果你输入一个不存在的目录名，那这个目录会自动创建。重要信息你只能取出到一个空目录。假如你想要取出到先前导入的原始目录，Subversion会抛出一个错误。你必须取出到另外的一个目录或者先把原始目录删掉。强烈建议您仅取出trunk部分。假如你坚持要取出父目录，那你有可能就会把你的硬盘塞满，因为你将得到整个仓库的数据（包括项目的每一个branch和tag）。 导出Exporting有时候你也许需要一份没有那些.svn目录的工作副本，比如要建一个源代码zip压缩包。
20、TortoiseSVN提供一个导出命令 Export，可以免除我们自己动手来操作（做一个副本，然后手动删除所有.svn目录）。如果你在工作副本中执行这个命令，你可以选择一个目录用来存放没有.svn目录的干净工作副本。同样，你也可以指定是导出所有文件还是那些被版本控制的文件。 导出的另一种方法是，用鼠标右键拖拽一个工作目录到其他地方，然后选择Subversion export here 或者 Subversion export all here。5.获取状态信息Getting Status Information当你在你的工作副本中工作的时候，你经常会需要知道哪些文件被修改过，哪些被增加，哪些被
21、重命名，或者哪些文件是其他人修改和提交的。5.1.覆盖图标Icon Overlays- 图4.5 覆盖图标在从仓库中取出工作副本之后，你会发现资源管理器中文件的图标发生了变化。 这就是TortoiseSVN受欢迎的一个原因。TortoiseSVN为每个文件图标在原来的基础上增加了一个叫做覆盖图标的东东。覆盖图标根据Subversion状态的不同而显示不同的图标。绿色图标表示这是一个最新取出的工作副本，他的Subversion状态是normal。当你开始编辑一个文件，这个文件的状态就会变成modified，图标也会变成红色圆圈带一个感叹号。这样你就可以轻易的知道自从上次更新以来都有修改过哪些文件
22、，需要提交哪些文件。这个黄色三角符号带感叹号，表示在一次update中产生了一个冲突（conflict）。蓝色加号意味着这个文件或文件夹已经被计划加入到版本控制之下。红叉叉表示相应文件或文件夹被计划删除（deleted），或者表示文件缺失。文件夹也有这样的覆盖图标显示。默认情况下只会显示文件夹自己的状态。但你也可以在Settings（4.21节，“TortoiseSVN的Settings”）中做一些设置，让文件夹的图标递归显示。但这会导致覆盖图标显示缓慢，因此在不太好的机器上或工作副本太大我们都不推荐这样。在这样设置之后，每个文件夹都会显示为他下面所有文件的状态，优先显示顺序为confilct
23、modifiednormal。这样你就可以轻松的看到一个文件夹是否有冲突或者修改过了。Slow Overlays You may notice that if you enable the recursive overlay for folders that the explorer slows down remarkably when browsing working copies. This depends on how big your working copy is and how much RAM Windows can use for file index caching. Usu
24、ally its only very slow the first time you browse such a directory - if you browse the same directory later again its much faster. If you want to disable the recursive overlays for some folders but not for all then you can do that by creating a file called _tsvnexcluderecursive inside that folder. T
25、his will disable the recursive overlays for that folder, but not for the files or folders inside it. You can also disable the overlays completely for a folder by creating a file called _tsvnexcludethis inside that folder. Again, this disables the overlays only for that folder, not the folders inside
26、 it. You can define specific paths to be excluded from showing overlays on the settings page (Section 4.21.2, “The Settings Dialog, Look and Feel Tab”). 和TortoiseCVS（CVS客户端）不一样，没有被版本控制的文件是没有覆盖图标的。所以这样做，是因为覆盖图标的数量是有限的，我们应该节约点使用：）5.2.资源管理器中TortoiseSVN的专栏和覆盖图标一样有用（或更有用）的信息可以显示在浏览器详细资料视图方式时的附加栏中。Simply
27、right click on one of the headings of a column, choose More. from the context menu displayed. A dialog will appear where you can specify the columns and their order, which is displayed in the Detailed View. Scroll down until the entries starting with SVN come into view. Check the ones you would like
28、 to have displayed and close the dialog by pressing OK. The columns will be appended to the right of those currently displayed. You can reorder them by drag and drop, or resize them, so that they fit your needs. 技巧TipIf you want the current layout to be displayed in all your working copies, you may
29、want to make this the default view. 5.3.仓库状态Status Of The Repository图4.6.检查修改Check for Modifications清楚地知道自己修改了哪些文件以及别人修改提交了哪些文件是很有用的。这就是命令Check For Modifications用的着的地方了。这个对话框显示出你的工作副本中修改过的每一个文件，没有在版本控制下的文件也会被显示出来。点击Check Repository按钮，可以检查仓库中的改动。在做update之前，你可以这么做一下，来检查是否有冲突的可能。在其中选择文件或文件夹单击鼠标右键，在菜单中我
30、们可以选择查看文件的差别，或者把本地的修改取消。TortoiseSVN会从仓库中自动下载最新的版本来进行比较。5.4. Viewing Diffs我们经常会想要在文件里面查看哪些地方修改了。你可以先选择已经修改的文件，单击鼠标右键，选择TortoiseSVN的命令Diff。然后会打开一个比较查看器，它会对本地的文件和仓库中最新版本的内容进行详细的对比。 技巧Tip不在工作目录中，或者你有多个版本的文件在一起的时候，你也可以使用比较功能：在资源管理器中选中你要进行比较的两个文件（使用Ctrl键和鼠标），然后选择TortoiseSVN的菜单命令Diff。最后被点选的文件（焦点所在的那个，也就被虚线
31、矩形框住的那个）将被认为是被修改过的那个。6. 更新工作副本Update Your Working Copy With Changes From Others图 4.7. 已完成更新的对话框有时候你想要把别人做的修改融合到自己的本地副本当中。这个把改动从服务器拿到本地的过程就是我们已经知道的updating。Updating操作可以针对一个文件，或几个被选择的文件，或某个目录中的所有文件。选择你想要进行update操作的文件和（或）文件夹，单击鼠标右键，在菜单中选择Update。这时会跳出一个窗口显示正在update的进程。别人做的修改会合并到你的文件中，而你所做的修改会被保留。Update操
32、作对仓库是不会产生任何影响的。 进程对话框用不同颜色的文字来表示不同的update动作。蓝色加入到你的工作副本中的新条目。 深红从你的副本中删除的条目。绿色成功将改动合并到本地的条目。亮红合并改动到本地，但是有冲突需要解决。黑色所有其它的。如果你在更新中产生了冲突（当你和别人同时修改了同一个文件的同一行并且改动的不同会发生这种情况），对话框中会用红色文字显示出冲突。双击对应的行就可以启动外挂程序来解决冲突。TortoiseSVN 同时也允许你更新工作副本到一个特定的版本，并不仅仅是最新的版本。这个命令就是Update to Revision，他会跳出一个对话框来让你输入你需要的版本。小心Cau
33、tion If you update a file or folder to a specific revision, you will get out of date error messages when you try to commit them! If you want to undo changes to a file and start afresh from an earlier revision, you must either use the Revert changes from this revision command from the log dialog or t
34、he Merge. menu command.命令Update to Revision.可以让你的工作回复到以前的版本。比如说你的工作副本现在的版本是100，但你想要看看版本为50的时候是什么样子，那就可以简单的将版本更新到50即可。一般来说，更新一个单独的文件到以前的版本并不太好，因为这会导致你的工作副本处于一个不一致的状态。假如你更新的文件改过名字，有可能你只是发现那个文件消失了，因为在以前的那个版本，根本不存在那个名字的文件。如果你只是需要某个文件的老版本副本，最好在日志对话框中使用Save revision to.命令来搞定。警告Warning If you updated your
35、working copy to an earlier revision, you must not make changes to the files! You will get out of date errors if you try to commit those changes. If you want to revert some changes in your working copy, then use the repository browser and save the file in question over the file in your working copy.
36、Or you can use the log dialog and use the command Revert changes in this revision. This will undo only those changes made in the selected revision. Changes made after that revision will be retained. For reverting multiple revisions, you should use the merge command, where you can specify the range o
37、f revisions you want to undo.多个文件或文件夹Multiple Files/Folders If you select multiple files and folders in the explorer and then select Update, all of those files/folders are updated one by one. TortoiseSVN makes sure that all files/folders which are from the same repository are updated to the exact sa
38、me revision! Even if between those updates another commit occurred.本地文件已存在Local File Already Exists Sometimes when you try to update, the update fails with a message to say that there is already a local file of the same name. This typically happens when Subversion tries to checkout a newly versioned
39、 file, and finds that an unversioned file of the same name already exists in your working folder. Subversion will never overwrite an unversioned file - it might contain something you are working on, which coincidentally has the same filename as another developer has used for his newly committed file
40、.If you get this error message, the solution is simply to rename the local unversioned file. After completing the update, you can check whether the renamed file is still needed.If you keep getting error messages, use Check for modifications instead to list all the problem files. That way you can dea
41、l with them all at once. 7. 解决冲突Resolving Conflicts有时候，你从仓库更新文件时会发生一些冲突。当两个或更多开发人员对同一个文件的某几行做了修改，就会产生冲突。因为Subversion对你的项目一无所知，他会把冲突留给开发人员来解决。只要冲突产生了，你就应该打开有问题的文件，然后找到以“”开头的那几行，有冲突的区域会被下面这样标示： revision另外，对每一个有冲突的文件，Subversion都会在你的目录中放三个另外的文件：filename.ext.mine这个文件是更新工作副本之前，冲突文件在你的工作副本中原来的样子。其中没有任何冲突标记
42、。filename.ext.rOLDREV这个文件是版本号为OLDREV时的文件。也就是你做修改之前最后一次取出的文件。filename.ext.rNEWREV这是你更新时Subversion客户端从服务器收到的最新版本的文件。他是仓库的最新版本。你可以在菜单中选择Edit Conflict来打开一个合并工具或冲突编辑器，或者用其他编辑器来解决这个冲突。你必须决定这些代码到底该是什么样子，做一些必要的修改，然后保存文件。然后选择菜单中的Resolved命令执行，接着提交修改到仓库。请注意，命令Resolved并没有真正的解决冲突，它只不过是把filename.ext.mine 和 filena
43、me.ext.r*删除，并允许你提交修改而已。8. 把你的修改发送到仓库Sending Your Changes To The Repository发送你对工作副本的修改就是提交修改。在提交之前，你应该确认你的工作副本是最新的。你可以直接作一次Update操作，或者先Check for Modifications看看在本地或在服务器上哪些文件修改过。如果你的副本是最新的，并且没有冲突，你就可以提交你的修改了。选中你想要提交的任意文件或文件夹，然后选择在菜单中选择Commit。图 4.8. 提交对话框提交对话框会显示每一个有修改的文件，包括新增的，删除的，还有没有版本控制的。如果你不想提交某个有
44、修改的文件，只要不勾选那个文件就好了。如果你要提交某个没有做版本控制的文件，只要勾选它就可以提交了。Commit files or folders? When you commit files, the commit dialog shows only the files you have selected. When you commit a folder the commit dialog will select the changed files automatically. If you forget about a new file you created, committing t
45、he folder will find it anyway. Committing a folder does not mean that every file gets marked as changed; It just makes your life easier by doing more work for you.Many unversioned files in the commit dialog If you think that the TSVN commit dialog shows you too many unversioned (e.g. compiler generated or editor backup) files, there are several ways to handle this. You can: add the file (or a wildcard extension) to the list of files to exclude on the settings page. This will affect every working copy you have. add the file to the svn:ignore list using th
