SVN QuickStart (TSVN)

Author:	Beijing Qun Hui Information Technology Co., Ltd.
Url:	http://www.ossxp.com/
Version:	0.1-35
Date:	2011-07-05 10:51:59
Copyright information:

Directory

• 1 Installing TORTOISESVN
• 2 Using the required knowledge
• 3 Use of TSVN
  • 3.1 Browsing the remote repository
  • 3.2 Checking out a remote repository to a workspace
  • 3.3 File Submissions
  • 3.4 Submit Log
  • 3.5 Undelete Files

SVN has a lot of content, even though its concise manual is hard to concentrate on a single page, but it may be possible to use an oversized piece of paper. Here's a quick guide to TORTOISESVN under the Windows platform, and more about SVN, see the SVN training handout at the elite and the SVN official documentation below.

• Svnbook (Version Control with Subversion)

  Http://svnbook.red-bean.com/nightly/en/index.html

• TSVN Manual

  Http://tortoisesvn.net/docs/release/TortoiseSVN_zh_CN/index.html

1 Installing TORTOISESVN

TORTOISESVN abbreviated as TSVN, is a widely used subversion (SVN) client on the Windows platform. The software is identified by a small turtle (tortoise), which can download the latest version of TSVN software from the TSVN official website.

1. Download and install TSVN.

   The TSVN installation package has 32-bit and 64-bit two versions, before downloading the installation, confirm your version of Windows (note that it is not Windows XP and Windows 7 versions, but whether the supported CPU instruction architecture is 32-bit or 64-bit), and if you are unsure, try the 32-bit version first.

2. Download and install the Chinese language pack.

   The same Chinese language pack also has 32-bit and 64-bit points, according to the version of your operating system to choose.

3. Install the TSVN first, install the Chinese language pack, and then set the TSVN to set the default language to Chinese.

   The Setup method is as follows:

   • Right-click in the explorer and pop-up menu See Figure 1.

     Figure 1: Resource Manager Right-click popup menu

   • Set the language to Chinese. See Figure 2.

     Figure 2: Setting TSVN language

2 Using the required knowledge

TSVN is an application that is integrated with Windows Explorer, which can be called from the Explorer, Windows File Open dialog box, or even the desktop, by right-clicking and invoking the appropriate function from the popup's right-click menu.

Before using TSVN, you need to confirm from the administrator:

1. What is the address of the SVN repository? Example: Https://svn.ossxp.com/svn/demo
2. Your user name and password.

3 Use of TSVN 3.1 browse remote repository

The SVN repository of the project may contain very many files, and the development lines, branches, and milestones exist as separate directories, so it is not a good idea to check out the repository from the root of the project. You can take advantage of TSVN's remote repository browsing feature to see what the repository has and then check out as needed.

1. In Explorer, in the right-click menu, select "Repository Browser", as shown in 3.

   Figure 3: The Repository browser is selected in the right-click menu

2. In the Popup URL address entry box, enter the repository address, as shown in 4.

   Figure 4: Input repository URL address

3. Because you are connecting to the SVN repository of the HTTPS protocol, you will be asked to accept the HTTPS Web site certificate. The selection is always accepted, then any subsequent access to any repository on that server will no longer pop up like the Certificate confirmation dialog box. As shown in 5.

   Figure 5:https Website Certificate Confirmation

4. In the authentication dialog box that appears, enter the username and password of the SVN server login. As shown in 6.

   Figure 6: Enter user name and password

5. Displays the directory tree for the remote repository. As you can see from Figure 7, the repository has three top-level directories: Trunk (main directory), branches (the root of the branch), tags (the root directory of the Save milestone).

   Figure 7: Enter user name and password

6. You can open a file view directly from the repository browser, or do something else, see Figure 8.

   Figure 8: Opening a file directly from the Repository browser

3.2 Checking out a remote repository to a workspace

Although you can view the files in the remote repository directly from the Repository browser, you can even delete the files from the remote repository, but if you want to modify the files in the repository and update the modified files to the remote repository, you first need to use the SVN checkout command.

The checkout action is to check out the directory of the remote repository to a local directory. The target directory (local directory) for this checkout action is called the local workspace directory.

1. Select "SVN Checkout" in the Explorer's right-click menu, or select the directory you want to check out through the Repository browser, with the right mouse button, 9.

   Figure 9: Right-click menu in the Repository browser

2. The Check Out dialog box pops up, confirming that the repository URL and destination directory are filled in correctly (that is, labeled "Check Out to Directory"). 10.

   Figure 10: Check Out Dialog box

3. Once the checkout is started, the entire process of checking out is displayed. The rate of checkout varies depending on the network bandwidth and the amount of data downloaded. 11.

   Figure 11: Checkout Process

4. After checking out, the icon for files and directories in the workspace directory is superimposed on the TSVN identity, which makes it easy to identify which files have been altered, which files are added locally and not added to the repository.

   Figure 12 also shows a hidden directory ". SVN", which has this ". SVN" directory in every subdirectory of the workspace, and be careful not to change the contents of that directory, let alone delete it.

   Figure 12: Local Workspace after checkout

5. Figure 13 shows the changes to the file and directory icons after the workspace file has been modified.

   Figure 13: Changes to the icon after workspace file changes

3.3 File Submissions

After the file has been modified, added and deleted in the workspace, if you want to update the changes to the remote server, you need to perform a commit operation.

1. Select the commit action from the right-click menu, as shown in 14.

   Figure 14: The Commit in the right-click menu

2. By default only modifications or other files that have been TSVN identified are submitted. As shown in 15, locally added and deleted files are not committed by default because they are not already identified.

   Figure 15: Submit dialog box

3. Select the locally deleted file, which is marked as deleted by the right-click menu, as shown in 16.

   Figure 16: Mark a locally deleted file for deletion.

4. Select the locally added file, which is marked as new by the right-click menu, as shown in 17.

   Figure 17: Mark the locally added file as new.

5. Do not forget to write the submission instructions, as shown in 18.

   Submission instructions can: Why to modify these files, why to change, and solve the problem, if possible to the corresponding bug number also written.

   Note that because the submission itself automatically records who, at what time, which files were modified, it is not necessary to place such information in the submission instructions, so as not to cause unnecessary duplication.

   Figure 18: Write the submission instructions, click the Submit button

3.4 Submit Log

In the submission log, you can see the previous commit records, including the latest submissions, and click "Show Log" in the context menu.

Figure 19: Commit Log

3.5 Undelete Files

Files that are checked into the repository are permanently logged, even if the user deletes the file on the client and commits it, but only removes the file from the latest version of the repository submission, but the file still exists in the history submission. SVN provides the ability to recover deleted files, and the TSVN operation is very simple.

1. In the workspace, go to the Browse submit log interface, find the deletion file submission, right click on the deleted file pop-up menu has "undo this version made changes" one, 20.

   Figure 20: The interface from the workspace to the Browse submission log

2. When you click "Revert changes made in this version", Tsvn pops up the confirmation dialog box, shown in 21.

   Figure 21: Dialog box confirming file recovery

3. Shows the process of undelete, as shown in 22.

   Figure 22: Anti-delete process display

4. After the above operation, the deleted files have been retrieved and re-appeared in the workspace. Figure 23 shows the icon of the recovered file superimposed with a plus sign.

   Figure 23: Once deleted files are retrieved

5. The final step of the undelete is to commit the file and submit the undelete to the server so that the file's undelete is truly complete.

   Figure 24: Submit Complete File Undelete

SVN QuickStart (TSVN)