TortoiseSVN chạy trên Windows Vista hoặc cao hơn và có sẵn cho cả 32-bit và 64-bit. Cài đặt cho Windows 64-bit cũng bao gồm các phần mở rộng 32-bit. Điều đó có nghĩa là bạn không cần phải cài đặt phiên bản 32-bit riêng biệt để có được menu ngữ cảnh TortoiseSVN và lớp phủ trong các ứng dụng 32-bit.

Hỗ trợ cho Windows 98, Windows ME và Windows NT4 đã bị bỏ trong phiên bản 1.2.0, và Windows 2000 và XP SP2 hỗ trợ đã bị bỏ trong 1.7.0. Hỗ trợ cho Windows XP SP3 đã bị bỏ trong phiên bản 1.9.0. Bạn vẫn có thể tải về và cài đặt phiên bản cũ nếu bạn cần chúng.

TortoiseSVN đi kèm với một bộ cài đặt dễ sử dụng. Kích đúp vào tập tin cài đặt và làm theo hướng dẫn. Bộ cài đặt sẽ lo liệu phần còn lại. Đừng quên khởi động lại sau khi cài đặt.

Gói ngôn ngữ được dịch giao diện người dùng TortoiseSVN ra nhiều ngôn ngữ khác nhau. Hãy kiểm tra Phụ lục G, Các gói ngôn ngữ và bộ kiểm tra chính tả để biết thêm thông tin về việc làm thế nào để cài đặt.

If you encounter any problems during or after installing TortoiseSVN please refer to our online FAQ at https://tortoisesvn.net/faq.html.

Đối với một dự án thực tế, bạn sẽ có một kho lưu trữ một nơi nào đó an toàn và một máy chủ Subversion để kiểm soát nó. Theo mục đích của hướng dẫn này chúng tôi sẽ sử dụng tính năng kho lưu trữ Subversion địa phương cho phép truy cập trực tiếp vào một kho lưu trữ được tạo ra trên ổ cứng của bạn mà không cần một máy chủ nào.

Đầu tiên tạo ra một thư mục trống trên máy tính của bạn. Nó có thể đi bất cứ nơi nào, nhưng trong hướng dẫn này chúng tôi sẽ gọi nó là C:\svn_repos . Bây giờ kích chuột phải vào thư mục mới và từ trình đơn ngữ cảnh chọn TortoiseSVN → Tạo Kho Lưu Trữ ở đây ... . Kho lưu trữ này sau đó được tạo ra bên trong thư mục, sẵn sàng cho bạn sử dụng. Chúng tôi cũng sẽ tạo ra các trúc thư mục mặc định nội bộ bằng cách nhấn vào nút Tạo cấu trúc thư mục .

Bây giờ chúng ta có một kho lưu trữ, nhưng nó là hoàn toàn trống rỗng vào lúc này. Hãy giả sử tôi có một tập hợp các tập tin trong C:\Projects\Widget1 mà tôi muốn thêm vào. Định hướng đến thư mục Widget1 trong Explorer và phải nhấp chuột vào nó. Bây giờ chọn TortoiseSVN → Nhập khẩu ... mà đem lên một hộp thoại

Hình 1.2. Hộp thoại nhập khẩu

Một kho lưu trữ Subversion được gọi bằng URL, cho phép chúng ta xác định một kho lưu trữ bất cứ nơi nào trên Internet. Trong trường hợp này chúng ta cần chỉ đến kho lưu trữ địa phương của chúng ta có URL file:///C:/svn_repos/trunk , và chúng ta thêm tên dự án của chúng ta Widget1 . Lưu ý rằng có 3 dấu gạch chéo sau file: và đó là dấu gạch chéo phía trước được sử dụng xuyên suốt.

Các tính năng quan trọng khác của hộp thoại này là Nhập khẩu tin nhắn hộp cho phép bạn nhập một thông báo mô tả những gì bạn đang làm. Khi bạn đến để xem xét thông qua lịch sử dự án của bạn, các thông báo cam kết là một tài liệu hướng dẫn có giá trị về những thay đổi đã được thực hiện và lý do tại sao. Trong trường hợp này, chúng ta có thể nói một cái gì đó đơn giản như “ Nhập khẩu các dự án Widget1 ” . Click vào OK và thư mục được bổ sung vào kho lưu trữ của bạn.

Now that we have a project in our repository, we need to create a working copy to use for day-to-day work. Note that the act of importing a folder does not automatically turn that folder into a working copy. The Subversion term for creating a fresh working copy is Checkout. We are going to checkout the Widget1 folder of our repository into a development folder on the PC called C:\Projects\Widget1-Dev. Create that folder, then right click on it and select TortoiseSVN → Checkout.... Then enter the URL to checkout, in this case file:///c:/svn_repos/trunk/Widget1 and click on OK. Our development folder is then populated with files from the repository.

Bạn sẽ thấy rằng sự xuất hiện của thư mục này là khác nhau từ thư mục ban đầu của chúng tôi. Tập tin đều có một dấu kiểm màu xanh lá cây ở góc dưới cùng bên trái. Đây là những biểu tượng tình trạng TortoiseSVN chỉ xuất hiện trong một bản sao làm việc. Nhà nước màu xanh lá cây chỉ ra rằng tập tin là không thay đổi so với phiên bản trong kho.

Time to get to work. In the Widget1-Dev folder we start editing files - let's say we make changes to Widget1.c and ReadMe.txt. Notice that the icon overlays on these files have now changed to red, indicating that changes have been made locally.

Tuy nhiên, các thay đổi là những gì? Nhấp chuột phải vào một trong các tập tin thay đổi và chọn TortoiseSVN → Khác . Công cụ so sánh tập tin của TortoiseSVN bắt đầu , hiển thị cho bạn chính xác những dòng đã thay đổi.

Hình 1.3. Trình xem khác biệt của tâp tin

OK, vì chúng ta rất vui với những thay đổi, chúng ta hãy cập nhật các kho lưu trữ. Hành động này được gọi là Cam kết các thay đổi. Nhấp chuột phải vào Widget1-dev thư mục và chọn TortoiseSVN → Cam kết . Hộp thoại cam kết liệt kê các tập tin thay đổi, mỗi một hộp kiểm. Bạn có thể muốn chọn chỉ là một tập hợp con của các tập tin, nhưng trong trường hợp này chúng tôi sẽ cam kết những thay đổi đến cả hai tập tin. Nhập một thông điệp để mô tả tất cả những gì thay đổi và bấm vào OK . Các hộp thoại tiến triển sẽ hiển thị các tập tin được tải lên kho lưu trữ và bạn đã làm xong.

Khi dự án phát triển, bạn sẽ cần thêm tập tin mới - chúng ta hãy nói rằng bạn thêm một số tính năng mới trong Extras.c và thêm một tài liệu tham khảo hiện có Makefile . Nhấp chuột phải vào thư mục và TortoiseSVN → Thêm . Hộp thoại Thêm bây giờ cho bạn thấy tất cả các tập tin không phiên bản và bạn có thể chọn những người cái mà bạn muốn thêm vào. Một cách khác để thêm các tập tin sẽ là kích chuột phải vào tập tin và chọn TortoiseSVN → Thêm .

Bây giờ khi bạn thực hiện cam kết các thư mục, tập tin mới xuất hiện là Thêm và các tập tin hiện có như Thay đổi . Lưu ý rằng bạn có thể nhấn đôi vào tập tin sửa đổi để kiểm tra chính xác những thay đổi đã được thực hiện.

One of the most useful features of TortoiseSVN is the Log dialog. This shows you a list of all the commits you made to a file or folder, and shows those detailed commit messages that you entered (you did enter a commit message as suggested? If not, now you see why this is important).

Hình 1.4. Hộp thoại Tường Trình

OK, so I cheated a little here and used a screenshot from the TortoiseSVN repository.

Các cửa sổ đầu cho thấy một danh sách các sửa đổi cam kết cùng với sự bắt đầu của thông báo cam kết. Nếu bạn chọn một trong những sửa đổi, cửa sổ giữa sẽ hiển thị các thông báo tường trình đầy đủ cho sửa đổi đó và khung bên dưới sẽ hiển thị một danh sách các tập tin và thư mục được thay đổi.

Mỗi khung có một menu ngữ cảnh cung cấp cho bạn cách nhiều hơn nữa bằng cách sử dụng các thông tin. Trong khung dưới cùng, bạn có thể nhấp đúp chuột vào một tập tin để xem chính xác những thay đổi đã được thực hiện trong bản chỉnh sửa đó. Đọc phần “Hộp thoại Tường trình Chỉnh sửa” để có được toàn bộ câu chuyện.

Một trong những tính năng của tất cả các hệ thống kiểm soát phiên bản là họ cho phép bạn lùi lại thay đổi mà bạn đã thực hiện trước đó. Như bạn mong đợi, TortoiseSVN làm cho việc này được dễ dàng để truy cập.

Nếu bạn muốn được thoát khỏi những thay đổi mà bạn chưa cam kết và thiết lập lại tập tin của bạn như trước khi bạn bắt đầu chỉnh sửa, TortoiseSVN → Hoàn nguyên là bạn của bạn. Điều này loại bỏ những thay đổi (vào thùng rác, chỉ để phòng hờ) và trở lại với phiên bản cam kết bạn bắt đầu. Nếu bạn muốn thoát khỏi chỉ một số trong những thay đổi, bạn có thể sử dụng TortoiseMerge để xem sự khác biệt và chọn lọc trở lại các dòng thay đổi.

Nếu bạn muốn phục hồi lại những ảnh hưởng của một phiên bản nhất định, bắt đầu với hộp thoại Tường Trình và tìm những sửa đổi vi phạm. Chọn Thực Đơn Ngữ Cảnh → Hoàn nguyên các thay đổi từ phiên bản này và những thay đổi sẽ được hoàn tác.

Hãy xem xét kịch bản này: giả sử chúng ta có hai đồng nghiệp, Harry và Sally. Mỗi quyết định chỉnh sửa các tập tin kho lưu trữ tại cùng một thời gian. Nếu Harry lưu thay đổi của mình vào kho lưu trữ đầu tiên, có thể một vài khoảnh khắc sau đó Sally vô tình có thể ghi đè lên chúng với phiên bản mới của tập tin. Trong khi Harry phiên bản của tập tin sẽ không bị mất mãi mãi (do hệ thống nhớ mỗi lần thay đổi), bất kỳ thay đổi nào Harry đã thực hiện sẽ không có mặt trong phiên bản mới hơn của Sally của tập tin, bởi vì cô không bao giờ nhìn thấy những thay đổi để bắt đầu với Harry. Tác phẩm của Harry vẫn còn có hiệu quả bị mất hoặc ít nhất là mất tích từ các phiên bản mới nhất của tập tin - và có lẽ do tai nạn. Điều này chắc chắn là một tình huống mà chúng ta muốn tránh!

Hình 2.2. Vấn đề cần tránh

Nhiều phiên bản kiểm soát hệ thống sử dụng một mô hình khoá-thay đổi-mở khóa để giải quyết vấn đề này, mà là một giải pháp rất đơn giản. Trong hệ thống như vậy, kho lưu trữ chỉ cho phép một người thay đổi một tập tin tại một thời điểm. Đầu tiên Harry phải khóa các tập tin trước khi có thể bắt đầu thay đổi nó. Khóa một tập tin là rất giống như mượn một cuốn sách từ thư viện, nếu Harry đã khóa một tập tin, thì sau đó Sally không thể thực hiện bất kỳ thay đổi với nó. Nếu cô ấy cố gắng để khóa các tập tin, các kho lưu trữ sẽ từ chối yêu cầu. Tất cả những gì có thể làm là đọc các tập tin, và chờ đợi cho Harry để kết thúc những thay đổi của mình và phát hành khóa của mình. Sau khi Harry mở các tập tin, hết lượt của mình, và bây giờ Sally có thể lần lượt của mình bằng cách khóa và chỉnh sửa.

Hình 2.3. Giải pháp Khóa-Sửa-Mở khóa

Vấn đề với mô hình khóa, sửa đổi, mở khóa là nó có một chút hạn chế, và thường trở thành một rào cản cho người sử dụng:

Subversion, CVS, and other version control systems use a copy-modify-merge model as an alternative to locking. In this model, each user's client reads the repository and creates a personal working copy of the file or project. Users then work in parallel, modifying their private copies. Finally, the private copies are merged together into a new, final version. The version control system often assists with the merging, but ultimately a human being is responsible for making it happen correctly.

Dưới đây là một ví dụ. Hãy nói rằng Harry và Sally đều tạo ra các bản sao làm việc cùng một dự án, sao chép từ kho. Họ làm việc đồng thời, và thay đổi cùng một tập tin A trong bản sao của họ. Sally lưu thay đổi của mình vào kho lưu trữ đầu tiên. Khi Harry cố gắng để lưu các thay đổi của ông sau đó, kho lưu trữ thông báo cho ông rằng tập tin của mình quá cũ . Nói cách khác, tập tin A đó trong kho lưu trữ bằng cách nào đó thay đổi kể từ khi ông mới sao chép nó. Vì vậy, Harry yêu cầu khách hàng của mình để hợp nhất bất kỳ thay đổi mới nhất từ ​​kho vào bản sao hoạt động của tập tin A. Có thể là những thay đổi của Sally không chồng chéo lên nhau với bản của riêng ông ta, do đó, một khi ông có cả bộ những thay đổi tích hợp, ông lưu bản sao làm việc của mình trở lại vào kho.

Hình 2.4. Giải pháp Sao chép-Sửa đổi-Hợp nhất

Hình 2.5. ... Sao chép-Sửa đổi-Hợp nhất Tiếp theo

Nhưng điều gì sẽ xảy ra nếu thay đổi của Sally làm trùng với thay đổi của Harry? Những gì sau đó? Tình trạng này được gọi là một xung đột , Và nó thường là không phải là một vấn đề gì nhiều. Khi Harry yêu cầu khách hàng của mình để hợp nhất các thay đổi kho lưu trữ mới nhất vào bản sao làm việc của mình, bản sao của tập tin A là bằng cách nào đó gắn cờ là trong trạng thái xung đột: anh ta sẽ có thể nhìn thấy cả hai bộ những thay đổi xung đột, và tự lựa chọn giữa chúng . Lưu ý rằng phần mềm có thể không tự động giải quyết xung đột, con người chỉ có khả năng hiểu biết và thực hiện những lựa chọn thông minh cần thiết. Khi Harry đã giải quyết thủ công những thay đổi chồng chéo (có lẽ bằng cách thảo luận về cuộc xung đột với Sally), ông một cách an toàn có thể lưu các tập tin bị sáp nhập trở lại vào kho.

Mô hình sao chép, sửa đổi, sáp nhập có thể nghe một chút hỗn loạn, nhưng trong thực tế, nó chạy rất trơn tru. Người dùng có thể làm việc song song, không bao giờ chờ đợi nhau. Khi họ làm việc trên các tập tin tương tự, nó hóa ra rằng hầu hết các thay đổi đồng thời của họ không chồng chéo lên nhau ở tất cả các xung đột hiếm khi xảy ra. Và số lượng thời gian cần thiết để giải quyết xung đột là ít hơn so với thời gian đã mất bằng một hệ thống khóa.

Cuối cùng, nó đi xuống đến một yếu tố quan trọng: người sử dụng thông tin liên lạc. Khi người sử dụng giao tiếp kém, cả hai cú pháp và ngữ nghĩa xung đột gia tăng. Không có hệ thống có thể buộc người dùng để giao tiếp hoàn hảo, và không có hệ thống có thể phát hiện xung đột ngữ nghĩa. Vì vậy, không có điểm bị đẩy vào một lời hứa sai lầm rằng một hệ thống khóa bằng cách nào đó sẽ ngăn chặn xung đột, trong thực tế, khóa có vẻ ức chế năng suất hơn bất cứ điều gì khác.

Có một tình hình phổ biến nơi mô hình khóa-sửa đổi-mở khóa cho kết quả tốt hơn, và đó là nơi mà bạn có các tập tin không hợp nhất được. Ví dụ, nếu kho lưu trữ của bạn có chứa một số hình ảnh đồ họa, và hai người thay đổi hình ảnh tại cùng một thời gian, không có cách nào cho những thay đổi được sáp nhập với nhau. Hoặc là Harry hoặc Sally sẽ mất các thay đổi.

Subversion sử dụng các bản sao chỉnh sửa, kết hợp giải pháp theo mặc định, và trong nhiều trường hợp này là tất cả những gì mà bạn cần. Tuy nhiên, phiên bản 1.2, Subversion cũng hỗ trợ các khóa tập tin, vì vậy nếu bạn có các tập tin không hợp nhất được, hoặc nếu bạn chỉ đơn giản là bị ép buộc vào một chính sách khóa bởi ban quản lý, Subversion vẫn sẽ cung cấp các tính năng bạn cần.

Bạn đã đọc về bản sao làm việc, bây giờ chúng tôi sẽ chứng minh làm thế nào các khách hàng Subversion tạo ra và sử dụng chúng.

Một bản sao làm việc Subversion là một cây thư mục bình thường trên hệ thống địa phương của bạn, có chứa một bộ sưu tập các tập tin. Bạn có thể chỉnh sửa những tập tin này tuỳ cách bạn muốn, và nếu chúng là tập tin mã nguồn, bạn có thể biên dịch chương trình của bạn từ chúng theo cách thông thường. Bản sao làm việc của bạn là khu vực làm việc riêng tư của riêng bạn: Subversion sẽ không bao giờ kết hợp với thay đổi của người khác, cũng không thay đổi của bạn có sẵn cho những người khác, cho đến khi bạn cho nó để làm như vậy một cách rõ ràng .

Sau khi bạn đã thực hiện một số thay đổi các tập tin trong bản sao làm việc của bạn và xác nhận rằng chúng hoạt động đúng, Subversion cung cấp cho bạn các lệnh để xuất bản thay đổi của bạn cho người khác làm việc với bạn về dự án của bạn (bằng cách viết vào kho lưu trữ). Nếu người khác công bố những thay đổi riêng của họ, Subversion cung cấp cho bạn với lệnh hợp nhất những thay đổi đó vào thư mục làm việc của bạn (bằng cách đọc từ kho).

A working copy also contains some extra files, created and maintained by Subversion, to help it carry out these commands. In particular, your working copy contains a subdirectory named .svn, also known as the working copy administrative directory . The files in this administrative directory help Subversion recognize which files contain unpublished changes, and which files are out-of-date with respect to others' work. Prior to 1.7 Subversion maintained .svn administrative subdirectories in every versioned directory of your working copy. Subversion 1.7 takes a completely different approach and each working copy now has only one administrative subdirectory which is an immediate child of the root of that working copy.

Một kho lưu trữ Subversion điển hình thường xuyên tổ chức các tập tin (hoặc mã nguồn) cho nhiều dự án, thông thường, mỗi dự án là một thư mục con trong cây hệ thống tập tin của kho lưu trữ. Trong sự sắp xếp này, bản sao làm việc của người dùng thường sẽ tương ứng với một cây con đặc biệt của kho.

Ví dụ, giả sử bạn có một kho lưu trữ có chứa hai dự án phần mềm.

Hình 2.6. Các hệ thống tập tin của kho

Nói cách khác, thư mục gốc của kho lưu trữ có hai thư mục con: paint và calc .

To get a working copy, you must check out some subtree of the repository. (The term check out may sound like it has something to do with locking or reserving resources, but it doesn't; it simply creates a private copy of the project for you.)

Suppose you make changes to button.c. Since the .svn directory remembers the file's modification date and original contents, Subversion can tell that you've changed the file. However, Subversion does not make your changes public until you explicitly tell it to. The act of publishing your changes is more commonly known as committing (or checking in ) changes to the repository.

Để xuất bản các thay đổi của bạn cho người khác, bạn có thể sử dụng lệnh Subversion cam kết .

Bây giờ thay đổi của bạn button.c đã được cam kết vào kho lưu trữ, nếu một người dùng khác kiểm tra một bản sao làm việc của / Calc , Họ sẽ thấy các thay đổi trong phiên bản mới nhất của tập tin.

Giả sử bạn có một cộng tác viên, Sally, người kiểm tra ra một bản sao làm việc của /calc tại cùng một thời gian bạn đã làm. Khi bạn thực hiện thay đổi của bạn trên button.c , bản sao làm việc của Sally thì không thay đổi; Subversion chỉ thay đổi bản sao làm việc theo yêu cầu của người dùng.

Để mang lại cho dự án của mình được cập nhật, Sally có thể yêu cầu Subversion để cập nhật bản sao làm việc, bằng cách sử dụng lệnh Subversion cập nhật . Điều này sẽ kết hợp các thay đổi của bạn vào bản sao làm việc của mình, cũng như bất kỳ những người khác đã được cam kết kể từ khi cô kiểm tra nó ra.

Lưu ý rằng Sally đã không cần phải xác định các tập tin để cập nhật; Subversion sử dụng các thông tin trong thư mục . Svn , và biết thêm thông tin trong kho, để quyết định các tập tin cần được đưa đến nay.

Kho Subversion có thể được truy cập thông qua nhiều phương pháp khác nhau - trên đĩa địa phương, hoặc thông qua giao thức mạng khác nhau. Một vị trí kho, tuy nhiên, luôn luôn là một URL. Giản đồ URL cho thấy phương pháp truy cập:

Đối với hầu hết các phần, URL của Subversion sử dụng các cú pháp tiêu chuẩn, cho phép đối với tên máy chủ và số cổng được xác định như là một phần của URL. Các file:// phương pháp tiếp cận thường được sử dụng cho truy cập địa phương, mặc dù nó có thể được sử dụng với các đường dẫn UNC đến một máy chủ mạng. Do đó, URL có dạng file://hostname/path/to/repos . Đối với các máy tính địa phương, phần hostname của URL được yêu cầu để vắng mặt hoặc localhost . Vì lý do này, các đường dẫn địa phương thường xuất hiện với ba dấu gạch chéo, file:///path/to/repos .

Ngoài ra, người sử dụng lược đồ file:// trên nền tảng Windows sẽ cần phải sử dụng một cách không chính thức “ tiêu chuẩn ” cú pháp để truy cập vào kho lưu trữ trên cùng một máy, nhưng trên một ổ đĩa khác với ổ đĩa làm việc hiện tại của khách hàng. Một trong hai cú pháp đường dẫn URL sau đây sẽ làm việc X là ổ đĩa mà kho cư trú:

file:///X:/path/to/repos
...
file:///X|/path/to/repos
...
      

Lưu ý rằng một URL sử dụng dấu gạch chéo bình thường mặc dù hình thức bản địa (không phải URL) của một đường dẫn trên Windows sử dụng những dấu xồ nguợc.

You can access a FSFS repository via a network share, but this is not recommended for various reasons:

Một tác vụ cam kết svn có thể công bố thay đổi đối với bất kỳ số lượng các tập tin và thư mục như là một giao dịch nguyên tử duy nhất. Trong bản sao làm việc của bạn, bạn có thể thay đổi nội dung tập tin, tạo, xóa, đổi tên và sao chép các tập tin và thư mục, và sau đó cam kết các bộ hoàn chỉnh của các thay đổi như một đơn vị.

Trong kho lưu trữ, mỗi cam kết được đối xử như là một giao dịch nguyên tử: hoặc là tất cả các cam kết thay đổi diễn ra, hoặc không gì trong số đó diễn ra. Subversion giữ lại tính nguyên tử này trong khi đối mặt với tai nạn chương trình, sự cố hệ thống, các vấn đề mạng, và hành động khác của người dùng.

Mỗi khi kho chấp nhận một cam kết, điều này tạo ra một trạng thái mới của cây hệ thống tập tin, được gọi là sửa đổi . Mỗi sửa đổi được chỉ định một số tự nhiên duy nhất, lớn hơn số của sửa đổi trước. Việc sửa đổi ban đầu của một kho lưu trữ mới được tạo ra là số không, và bao gồm không có gì ngoài một thư mục gốc rỗng.

Một cách tốt đẹp để hình dung ra các kho lưu trữ như một loạt các cây. Hãy tưởng tượng một mảng các số sửa đổi, bắt đầu từ 0, kéo dài từ trái sang phải. Mỗi số sửa đổi có một cây treo hệ thống tập tin bên dưới nó, và mỗi cây là một “ ảnh chụp ” cách kho nhìn sau mỗi cam kết.

Hình 2.7. Kho lưu trữ

Điều quan trọng cần lưu ý rằng các bản sao làm việc không phải luôn luôn tương ứng với bất kỳ phiên bản duy nhất trong kho, chúng có thể chứa tập tin từ nhiều chỉnh sửa. Ví dụ, giả sử bạn kiểm tra ra một bản sao làm việc từ một kho lưu trữ có sửa đổi gần đây nhất là 4:

calc/Makefile:4
integer.c:4
button.c:4
      

Tại thời điểm này, thư mục làm việc này tương ứng chính xác với sửa đổi 4 trong kho. Tuy nhiên, giả sử bạn thực hiện một sự thay đổi đến button.c, và cam kết thay đổi đó. Giả sử không có các cam kết đã diễn ra, cam kết của bạn sẽ tạo sửa đổi 5 của kho, và bản sao của bạn làm việc bây giờ sẽ như thế này:

calc/Makefile:4
integer.c:4
button.c:5
      

Giả sử rằng, vào thời điểm này, Sally cam kết thay đổi trong integer.c , tạo ra sửa đổi 6. Nếu bạn sử dụng svn cập nhật để mang lại bản sao làm việc của bạn được cập nhật nhất, sau đó nó sẽ như thế này:

calc/Makefile:6
integer.c:6
button.c:6
      

Thay đổi của Sally trong integer.c sẽ xuất hiện trong bản sao làm việc của bạn, và thay đổi của bạn sẽ vẫn có mặt trong button.c . Trong ví dụ này, các văn bản của Makefile là giống hệt nhau trong phiên bản 4, 5, và 6, nhưng Subversion sẽ đánh dấu bản sao của bạn làm việc của Makefile với phiên bản 6 để chỉ ra rằng nó vẫn còn hiện tại. Vì vậy, sau khi bạn làm một cập nhật sạch sẽ ở trên cùng của bản sao làm việc của bạn, nó thường sẽ tương ứng chính xác với một bản sửa đổi trong kho.

Đối với mỗi tập tin trong một thư mục làm việc, Subversion ghi lại hai phần thông tin thiết yếu trong khu vực hành chính svn/.:

Với thông tin này, bằng cách nói chuyện với kho, Subversion có thể cho biết trong bốn trạng thái sau đây mà một tập tin làm việc có:

Bây giờ bạn đã có một kho lưu trữ mới đặt tại D:\SVN\MyNewRepository .

Để truy cập vào kho lưu trữ địa phương của bạn, bạn cần đường dẫn đến thư mục đó. Chỉ cần nhớ rằng Subversion hy vọng tất cả các đường dẫn kho lưu trữ trong mẫu file:///C:/SVNRepository/. Lưu ý việc sử dụng xuyên suốt các dấu gạch chéo về phía trước.

Để truy cập vào một kho lưu trữ nằm trên một mạng chia sẻ, bạn có thể sử dụng ánh xạ ổ đĩa, hoặc bạn có thể sử dụng đường dẫn UNC. Đối với các đường dẫn UNC, hình thức là file://ServerName/path/to/Repos/ . Lưu ý rằng có chỉ có 2 dấu gạch chéo hàng đầu ở đây.

Trước SVN 1.2, đường dẫn UNC đã được đưa ra trong các hình thức mơ hồ hơn file:///\ServerName/path/to/Repos . Hình thức này vẫn còn được hỗ trợ, nhưng không khuyến khích.

Although in theory it is possible to put a FSFS repository on a network share and have multiple users access it using file:// protocol, this is most definitely not recommended. In fact we would strongly discourage it, and do not support such use for various reasons:

truy cập file:// chỉ là để dành cho truy cập người sử dụng duy nhất của địa phương, đặc biệt là kiểm tra và gỡ lỗi. Khi bạn muốn chia sẻ các kho lưu trữ, bạn thực sự cần lập một máy chủ thích hợp, và nó gần như không khó khăn như bạn nghĩ. Đọc phần “Truy cập Kho” để được hướng dẫn về lựa chọn và thiết lập một máy chủ.

Trước khi bạn nhập dữ liệu vào kho lưu trữ trước tiên bạn nên suy nghĩ về cách bạn muốn tổ chức dữ liệu của bạn. Nếu bạn sử dụng một trong các bố trí được đề nghị, sau đó bạn sẽ có nó dễ dàng hơn nhiều.

Có một số cách, tiêu chuẩn được đề nghị cho việc tổ chức một kho lưu trữ. Hầu hết mọi người tạo ra một thư mục thân cây để giữ “dòng chính” của việc phát triển, một thư mục chi nhánh để chứa các bản sao chi nhánh, và một thư mục thẻ để chứa bản sao thẻ. Nếu kho lưu trữ chứa chỉ có một dự án, sau đó thường người ta tạo ra các thư mục cấp cao nhất này:

/trunk
/branches
/tags
    

Bởi vì cách bố trí này thường được sử dụng, khi bạn tạo ra một kho lưu trữ mới sử dụng TortoiseSVN, nó cũng sẽ đề nghị tạo ra các cấu trúc thư mục đó cho bạn.

Nếu một kho lưu trữ có nhiều dự án, mọi người thường đánh chỉ số bố trí theo nhánh:

/trunk/paint
/trunk/calc
/branches/paint
/branches/calc
/tags/paint
/tags/calc
    

... hoặc bởi dự án:

/paint/trunk
/paint/branches
/paint/tags
/calc/trunk
/calc/branches
/calc/tags
    

Lập chỉ mục bởi dự án có ý nghĩa nếu dự án không liên quan chặt chẽ và mỗi dự án được kiểm tra ra một cách cá nhân. Đối với các dự án liên quan nơi bạn có thể muốn kiểm tra tất ra cả các dự án trong một bươc, hoặc các dự án liên kết cùng nhau trong một gói phân phối duy nhất, nó thường tốt hơn để chỉ số theo chi nhánh. Bằng cách này bạn chỉ có một thân cây để kiểm tra ra, và các mối quan hệ giữa các tiểu dự án dễ dàng nhìn thấy được.

Nếu bạn áp dụng tiếp cận theo mức cao nhất /Trunk/tags/branches, không có gì để nói rằng bạn phải sao chép toàn bộ thân cây cho mỗi chi nhánh và thẻ, trong một số cách thì cấu trúc này cung cấp sự linh hoạt nhất.

Đối với các dự án không liên quan, bạn có thể thích sử dụng kho riêng biệt. Khi bạn cam kết thay đổi, đó là số phiên bản của toàn bộ kho với thay đổi, không phải là số phiên bản của dự án. Có 2 dự án không liên quan chia sẻ một kho lưu trữ có thể có nghĩa là những cách biệt lớn giữa các số sửa đổi. Các dự án Subversion và TortoiseSVN xuất hiện tại cùng một địa chỉ host, nhưng là kho hoàn toàn riêng biệt cho phép phát triển độc lập, và không có sự nhầm lẫn về số bản xây dựng.

Tất nhiên, bạn có thể tùy ý bỏ qua các bố cục chung này. Bạn có thể tạo ra bất kỳ loại biến thể, bất cứ điều gì làm việc tốt nhất cho bạn hoặc nhóm của bạn. Hãy nhớ rằng bất cứ điều gì bạn chọn, nó không phải là một cam kết lâu dài. Bạn có thể tổ chức lại kho lưu trữ của bạn bất cứ lúc nào. Bởi vì các ngành và các thẻ là những thư mục bình thường, TortoiseSVN có thể di chuyển hoặc đổi tên chúng bất cứ cách nào bạn muốn.

Chuyển đổi từ một trong những bố trí khác chỉ là một vấn đề phát hành một loạt các di chuyển phía máy chủ Nếu bạn không thích cách mà mọi thứ được tổ chức trong kho, chỉ cần sắp xếp các thư mục vòng vòng.

Vì vậy, nếu bạn chưa tạo ra một cấu trúc thư mục cơ bản bên trong kho của bạn, bạn nên làm điều đó bây giờ. Có hai cách để đạt được điều này. Nếu bạn chỉ đơn giản là muốn tạo ra một cấu trúc /Trunk/tags/branches, bạn có thể sử dụng trình duyệt kho để tạo ra ba thư mục (trong ba cam kết riêng biệt). Nếu bạn muốn tạo ra một hệ thống phân cấp sâu sắc hơn sau đó nó đơn giản tạo ra một cấu trúc thư mục trên đĩa đầu tiên và nhập khẩu nó trong một cam kết duy nhất, như thế này:

Note that the name of the folder you are importing does not appear in the repository, only its contents. For example, create the following folder structure:

C:\Temp\New\trunk
C:\Temp\New\branches
C:\Temp\New\tags
      

Import C:\Temp\New into the repository root, which will then look like this:

/trunk
/branches
/tags
      

Hình 4.1. Explorer hiển thị lớp phủ biểu tượng

Một trong các tính năng dễ thấy nhất của TortoiseSVN là các lớp phủ biểu tượng xuất hiện trên các tập tin trong bản sao làm việc của bạn. Những cái này chỉ cho bạn trong nháy mắt các tập tin của bạn đã được sửa đổi. Tham khảo phần “Biểu tượng Lớp phủ” để tìm hiểu các lớp phủ khác nhau đại diện những gì.

Hình 4.2. Trình đơn ngữ cảnh cho một thư mục dưới sự kiểm soát phiên bản

Tất cả các lệnh TortoiseSVN được gọi từ trình đơn ngữ cảnh của cửa sổ thám hiểm. Phần lớn trực tiếp nhìn thấy được, khi bạn bấm chuột phải vào một tập tin hoặc thư mục. Các lệnh mà có sẵn phụ thuộc vào việc các tập tin hoặc thư mục hoặc thư mục cha của nó là dưới sự kiểm soát phiên bản hoặc không. Bạn cũng có thể thấy trình đơn TortoiseSVN như là một phần của trình đơn khám phá tập tin.

Trong một số trường hợp, bạn có thể thấy nhiều mục TortoiseSVN. Đây không phải là lỗi!

Hình 4.3. Trình đơn explorer tập tin cho một phím tắt trong một thư mục được phiên bản

Ví dụ này là dành cho một shortcut chưa phiên bản trong một thư mục được phiên bản, và trong trình đơn khám phá tập tin có ba mục cho TortoiseSVN. Một là cho các thư mục, một cho chính các shortcut, và thứ ba cho các đối tượng shortcut trỏ đến. Để giúp bạn phân biệt giữa chúng, các biểu tượng có một chỉ báo ở góc dưới bên phải để hiển thị cho biết các mục trình đơn là cho một tập tin, thư mục, shortcut hoặc cho nhiều mục được lựa chọn.

Hình 4.4. Kéo phải trình đơn cho một thư mục dưới sự kiểm soát phiên bản

Các lệnh khác như xử lý kéo, khi bạn kéo phải các tập tin hoặc thư mục vào một vị trí mới bên trong bản sao làm việc hoặc khi bạn kéo phải một tập tin hoặc thư mục không được phiên bản vào một thư mục được kiểm soát phiên bản.

Một số tác vụ phổ biến có các phím tắt của Windows, nhưng không xuất hiện trên các nút hoặc trong các trình đơn. Nếu bạn không thể nghĩ ra làm thế nào để làm một cái gì đó rõ ràng, giống như làm mới một cảnh xem, hãy kiểm tra ở đây.

Nếu các kho lưu trữ mà bạn đang cố gắng truy cập có mật khẩu bảo vệ, một hộp thoại xác thực sẽ xuất hiện.

Hình 4.5. Hộp thoại xác thực

Nhập tên người dùng và mật khẩu của bạn. Hộp kiểm sẽ làm cho TortoiseSVN lưu trữ các thông tin trong thư mục mặc định của Subversion: %APPDATA%\Subversion\auth trong ba thư mục con:

If you want to clear the authentication cache, you can do so from the Saved Data page of TortoiseSVN's settings dialog. The button Clear all will clear the cached authentication data for all repositories. The button Clear... however will show a dialog where you can chose which cached authentication data should be deleted. Refer to phần “Thiết Lập Cho Dữ Liệu Đã Lưu”.

Some people like to have the authentication data deleted when they log off Windows, or on shutdown. The way to do that is to use a shutdown script to delete the %APPDATA%\Subversion\auth directory, e.g.

@echo off
rmdir /s /q "%APPDATA%\Subversion\auth"
      

You can find a description of how to install such scripts at http://www.windows-help-central.com/windows-shutdown-script.html.

Để biết thêm thông tin về việc làm thế nào để thiết lập máy chủ của bạn để xác thực và kiểm soát truy cập, tham khảo phần “Truy cập Kho” .

Nhiều người trong số các hộp thoại TortoiseSVN có rất nhiều thông tin để hiển thị, nhưng nó thường là hữu ích để tối đa hóa chỉ có chiều cao, chỉ có chiều rộng, chứ không phải là tối đa hóa để điền vào màn hình. Là một tiện nghi, có các phím tắt cho điều này trên Tối đa hóa nút. Sử dụng nút chuột giữa để tối đa hóa theo chiều dọc, và chuột phải để tối đa hóa theo chiều ngang.

Nếu bạn đang nhập vào một kho lưu trữ hiện tại đã có một số dự án, thì cấu trúc kho lưu trữ đã được quyết định. Nếu bạn đang nhập dữ liệu vào một kho lưu trữ mới, thì nó đáng để dành thời giansuy nghĩ về nó sẽ được tổ chức như thế nào. Đọc phần “Bố cục Kho chứa” để được tư vấn thêm.

Phần này mô tả các lệnh nhập khẩu Subversion được thiết kế để nhập khẩu một hệ thống phân cấp thư mục vào kho lưu trữ trong một lần. Mặc dù nó làm được việc, nó có một số thiếu sót:

Vì những lý do này, chúng tôi khuyên bạn không sử dụng lệnh nhập khẩu chút nào mà nên làm theo phương pháp hai bước được mô tả trong phần “Nhập khẩu Tại chỗ” , Trừ khi bạn đang thực hiện bước đơn giản để tạo ra một cấu trúc /trunk/tags/branches ban đầu trong kho lưu trữ của bạn. Bởi vì bạn đang ở đây, đây là cách việc nhập khẩu cơ bản hoạt động...

Trước khi bạn nhập khẩu dự án của bạn vào một kho lưu trữ, bạn nên:

Bây giờ chọn thư mục cấp cao nhất của cấu trúc thư mục dự án của bạn trong cửa sổ thám hiểm và click chuột phải để mở trình đơn ngữ cảnh. Chọn lệnh TortoiseSVN → Nhập khẩu ... để gọi lên một hộp thoại:

Hình 4.6. Hộp thoại nhập khẩu

In this dialog you have to enter the URL of the repository location where you want to import your project. It is very important to realise that the local folder you are importing does not itself appear in the repository, only its content. For example if you have a structure:

C:\Projects\Widget\source
C:\Projects\Widget\doc
C:\Projects\Widget\images
      

and you import C:\Projects\Widget into http://mydomain.com/svn/trunk then you may be surprised to find that your subdirectories go straight into trunk rather than being in a Widget subdirectory. You need to specify the subdirectory as part of the URL, http://mydomain.com/svn/trunk/Widget-X. Note that the import command will automatically create subdirectories within the repository if they do not exist.

Các thông báo nhập khẩu được sử dụng như một thông điệp tường trình.

Theo mặc định, các tập tin và thư mục mà phù hợp với các mô hình bỏ qua toàn cục không được nhập khẩu. Để ghi đè lên hành vi này, bạn có thể sử dụng hộp kiểm Bao gồm các file bị bỏ qua . Tham khảo phần “Các Thiết Lập Tổng Qu” để biết thêm thông tin về việc thiết lập một mô hình bỏ qua toàn cục.

Ngay sau khi bạn nhấn OK TortoiseSVN nhập khẩu các cây thư mục hoàn chỉnh bao gồm tất cả các tập tin vào kho lưu trữ. Dự án hiện đang được lưu trữ trong kho dưới sự kiểm soát phiên bản. Xin lưu ý rằng thư mục mà bạn đã nhập khẩu KHÔNG theo phiên bản kiểm soát! Để có được một bản sao làm việc có kiểm soát phiên bản bạn cần phải làm một Kiểm Xuất của các phiên bản bạn vừa nhập khẩu. Hoặc đọc để tìm hiểu làm thế nào để nhập khẩu một thư mục tại chỗ.

Giả sử bạn đã có một kho lưu trữ, và bạn muốn thêm vào một cấu trúc thư mục mới cho nó, chỉ cần làm theo các bước sau:

Đôi khi bạn cần phải có một tập tin dưới sự kiểm soát phiên bản, trong đó có chứa các dữ liệu người dùng cụ thể. Điều đó có nghĩa là bạn có một tập tin mà mọi nhà phát triển / người dùng cần phải sửa đổi để phù hợp với thiết lập địa phương của anh / cô ta. Tuy nhiên, phiên bản một tập tin như vậy là khó khăn bởi vì mỗi người sử dụng sẽ cam kết thay đổi của anh / cô ta mỗi khi vào kho lưu trữ.

Trong trường hợp này, chúng tôi đề nghị sử dụng các tập tin mẫu . Bạn tạo một tập tin mà chứa tất cả các dữ liệu mà nhà phát triển của bạn sẽ cần, thêm tập tin đó vào để kiểm soát phiên bản và để cho các nhà phát triển kiểm tra tập tin này ra. Sau đó, mỗi nhà phát triển tạo một bản sao của tập tin đó và đổi tên bản sao đó. Sau đó, sửa đổi các bản sao không phải là một vấn đề nữa.

As an example, you can have a look at TortoiseSVN's build script. It calls a file named default.build.user which doesn't exist in the repository. Only the file default.build.user.tmpl. default.build.user.tmpl is the template file which every developer has to create a copy from and rename that file to default.build.user. 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 default.build.user to the ignore list of its parent folder, i.e. we've set the Subversion property svn:ignore to include that filename. That way it won't show up as unversioned on every commit.

Bạn có thể chọn chiều sâu bạn muốn kiểm xuất, cho phép bạn chỉ định độ sâu đệ quy vào các thư mục con. Nếu bạn muốn chỉ là một vài phần của một cây lớn, Bạn có thể kiểm xu các thư mục cấp cao nhất, sau đó cập nhật các thư mục được lựa chọn theo cách đệ quy.

Để dễ dàng lựa chọn các chỉ mục mà bạn muốn cho kiểm xuất và ép buộc bản sao làm việc chỉ giữ những mục đó, nhấp vào nút bấm Chọn mục ... . Điều này sẽ mở ra một hộp thoại mới, nơi bạn có thể kiểm tra tất cả các mục mà bạn muốn sao chép của bạn và bỏ chọn tất cả các mục bạn không muốn. Bản sao làm việc sau đó được biết đến như một kiểm xuất thưa thớt . Bản cập nhật của bản sao làm việc đó sẽ không nạp các tập tin và thư mục bị thiếu nhưng chỉ cập nhật những gì bạn đã có trong bản sao làm việc của bạn.

Nếu bạn kiểm xuất một bản làm việc rời rạc (có nghĩa là, bằng cách chọn mục gì đó không phải đệ quy hoàn toàn cho độ sâu kiểm xuất), bạn có thể dễ dàng thêm hoặc bớt các thư mục con sau này bằng cách dùng một trong các cách sau.

Tính năng này rất hữu ích khi bạn chỉ muốn để kiểm tra các bộ phận của một cây lớn, nhưng bạn muốn sự tiện lợi của việc cập nhật một bản sao làm việc duy nhất. Giả sử bạn có một cây lớn trong đó có thư mục con Project01 đến Project99 , Và bạn chỉ muốn kiểm tra Project03 , Project25 và Project76/SubProj . Sử dụng các bước sau:

Nếu bản sao làm việc của bạn được cập nhật và không có xung đột, bạn đã sẵn sàng cam kết thay đổi của bạn. Chọn bất kỳ tập tin và / hoặc thư mục mà bạn muốn cam kết, sau đó TortoiseSVN → Cam kết ... .

Hình 4.8. Hộp thoại Cam kết

Hộp thoại cam kết sẽ cho bạn thấy tất cả các tập tin thay đổi, bao gồm cả các tập tin được thêm, xoá và không được phiên bản. Nếu bạn không muốn một tập tin thay đổi được cam kết, chỉ cần bỏ chọn tập tin đó. Nếu bạn muốn để bao gồm một tập tin không được phiên bản, chỉ cần kiểm tra tập tin để thêm vào cam kết.

To quickly check or uncheck types of files like all versioned files or all modified files, click the link items just above the list of shown items.

Để biết thêm thông tin về màu sắc và lớp phủ của các mục tùy theo trạng thái của chúng, xin xem phần “Trạng thái địa phương và từ xa”.

Các mục đã được chuyển sang một đường dẫn kho lưu trữ khác cũng được chỉ định sử dụng một đánh dấu (s) . Bạn có thể đã chuyển một cái gì đó trong khi làm việc trên một chi nhánh và quên trở về với thân cây. Đây là dấu hiệu cảnh báo của bạn!

Nhấp đúp chuột trên bất kỳ tập tin được sửa đổi trong hộp thoại cam kết sẽ khởi động công cụ tìm khác biệt bên ngoài để hiển thị các thay đổi của bạn. Trình đơn ngữ cảnh sẽ cung cấp cho bạn nhiều lựa chọn hơn, như thể hiện trong ảnh chụp màn hình. Bạn cũng có thể kéo tập tin từ ở đây vào một ứng dụng khác chẳng hạn như một trình soạn thảo văn bản hoặc một IDE.

Bạn có thể chọn hoặc bỏ chọn các mục bằng cách nhấp vào hộp kiểm bên trái của mục đó. Trong thư mục, bạn có thể sử dụng Shift-chọn để làm cho hành động đệ quy.

Các cột hiển thị ở khung bên dưới có thể tùy chỉnh. Nếu bạn click chuột phải trên bất kỳ tiêu đề cột, bạn sẽ thấy một trình đơn ngữ cảnh cho phép bạn chọn các cột được hiển thị. Bạn cũng có thể thay đổi chiều rộng cột bằng cách sử dụng xử lý kéo xuất hiện khi bạn di chuyển chuột lên một ranh giới cột. Các tùy chỉnh được bảo tồn, vì vậy bạn sẽ thấy cùng các tiêu đề trong thời gian tiếp theo.

Theo mặc định khi bạn cam kết thay đổi, bất kỳ ổ khóa mà bạn giữ trên các tập tin được phát hành tự động sau khi cam kết thành công. Nếu bạn muốn giữ những ổ khóa, đảm bảo hộp kiểm Giữ khóa được đánh dấu. Trạng thái mặc định của hộp kiểm này được lấy từ tùy chọn no_unlock trong file cấu hình Subversion. Đọc phần “Các Thiết Lập Tổng Qu” để có thông tin về việc làm thế nào để chỉnh sửa các file cấu hình Subversion.

Hộp thoại cam kết hỗ trợ tính năng danh sách thay đổi Subversion để giúp đỡ với nhóm các tập tin liên quan với nhau. Tìm hiểu về tính năng này trong phần “Danh sách Thay đổi” .

Thỉnh thoảng bạn chỉ muốn cam kết vài phần của các thay đổi bạn thực hiện tới một tập tin. Tình huống như vậy thường xảy ra khi bạn làm việc trên vài thứ nhưng rồi một việc sửa chửa khẩn cấp cần được cam kết, và việc sửa chửa đó tình cờ xảy ra trong cùng tập tin bạn đang làm việc.

right click on the file and use Context Menu → Restore after commit. This will create a copy of the file as it is. Then you can edit the file, e.g. in a text editor and undo all the changes you don't want to commit. After saving those changes you can commit the file.

Sau khi việc cam kết xong, bản sao của tập tin được khôi phục một cách tự động, và bạn nhận lại một tập tin với tất cả các chỉnh sửa không được cam kết.

Đôi khi bạn có các tập tin được phiên bản mà thay đổi thường xuyên nhưng mà bạn thực sự không muốn cam kết. Đôi khi điều này cho thấy một lỗ hổng trong quá trình xây dựng của bạn - tại sao các tập tin được phiên bản? bạn có nên sử dụng tập tin mẫu? Nhưng đôi khi nó là không thể tránh khỏi. Một lý do cổ điển là IDE của bạn thay đổi dấu thời gian trong các tập tin dự án mỗi khi bạn xây dựng. Các hồ sơ dự án phải được phiên bản vì nó bao gồm tất cả các thiết lập xây dựng, nhưng nó không cần phải được cam kết chỉ vì các dấu thời gian đã thay đổi.

Để giúp đỡ trong các trường hợp khó xử như thế này, chúng tôi đã dành một danh sách thay đổi gọi là bỏ qua cam kết . Bất kỳ tập tin thêm vào danh sách thay đổi này sẽ tự động được đánh dấu trong hộp thoại cam kết. Bạn vẫn có thể cam kết thay đổi, nhưng bạn phải chọn nó trong hộp thoại cam kết.

Hãy chắc chắn để nhập vào một thông điệp tường trình trong đó mô tả những thay đổi bạn đang cam kết. Điều này sẽ giúp bạn xem những gì đã xảy ra và khi nào, khi bạn duyệt qua các thông điệp tường trình dự án vào một ngày sau đó. Các thông điệp có thể dài hoặc ngắn gọn như bạn thích, nhiều dự án có hướng dẫn cho những gì nên được bao gồm, ngôn ngữ sử dụng, và đôi khi thậm chí là một định dạng nghiêm ngặt.

Bạn có thể áp dụng định dạng đơn giản cho thông điệp tường trình của bạn bằng cách sử dụng một quy ước tương tự như được sử dụng trong email. Để áp dụng phong cách vào văn bản , sử dụng *Văn bản* cho chữ đậm, _text_ gạch chân, và ^Văn bản^ cho chữ in nghiêng.

Hình 4.9. Bộ kểm tra chính tả của Hộp Thoại Cam Kết

TortoiseSVN bao gồm một bộ kiểm tra chính tả để giúp bạn có thông điệp tường trình của bạn đúng. Điều này sẽ làm nổi bật bất kỳ từ sai chính tả. Sử dụng trình đơn ngữ cảnh để truy cập vào chỉnh sửa được đề nghị. Tất nhiên, nó không biết tất cả thuật ngữ kỹ thuật mà bạn biết, vì vậy từ được đánh vần một cách chính xác đôi khi sẽ xuất hiện như là lỗi. Nhưng đừng lo lắng. Bạn chỉ có thể thêm vào từ điển cá nhân của bạn bằng cách sử dụng trình đơn ngữ cảnh.

The log message window also includes a filename and function auto-completion facility. This uses regular expressions to extract class and function names from the (text) files you are committing, as well as the filenames themselves. If a word you are typing matches anything in the list (after you have typed at least 3 characters, or pressed Ctrl+Space), a drop-down appears allowing you to select the full name. The regular expressions supplied with TortoiseSVN are held in the TortoiseSVN installation bin folder. You can also define your own regexes and store them in %APPDATA%\TortoiseSVN\autolist.txt. Of course your private autolist will not be overwritten when you update your installation of TortoiseSVN. If you are unfamiliar with regular expressions, take a look at the introduction at https://en.wikipedia.org/wiki/Regular_expression, and the online documentation and tutorial at http://www.regular-expressions.info/.

Để có regex đúng có thể được hóc búa, do đó, để giúp bạn sắp xếp một biểu thức phù hợp có một hộp thoại kiểm tra cho phép bạn nhập một biểu thức và sau đó gõ vào tên tập tin để kiểm tra trên đó. Bắt đầu từ dấu nhắc lệnh bằng cách sử dụng lệnh TortoiseProc.exe/command:autotexttest .

The log message window also includes a commit message snippet facility. These snippets are shown in the autocomplete dropdown once you type a snippet shortcut, and selecting the snippet in the autocomplete dropdown then inserts the full text of the snippet. The snippets supplied with TortoiseSVN are held in the TortoiseSVN installation bin folder. You can also define your own snippets and store them in %APPDATA%\TortoiseSVN\snippet.txt. # is the comment character. Newlines can be inserted by escaping them like this: \n and \r. To insert a backslash, escape it like this: \\.

Bạn có thể sử dụng lại thông điệp tường trình được nhập vào trước đó. Chỉ cần nhấp vào Các thông điệp gần đây để xem một danh sách các các tin nhắn cuối cùng mà bạn nhập vào cho bản sao làm việc này. Số lượng thông điệp được lưu trữ có thể được tùy chỉnh trong hộp thoại cài đặt TortoiseSVN.

Bạn có thể dọn dẹp tất cả thông điệp tường trình cam kết được lưu trữ từ trang Dữ liệu được lưu của các thiết lập TortoiseSVN, hoặc bạn có thể xóa từng thông điệp từ bên trong hộp thoại Các thông điệp gần đây bằng cách sử dụng phím Xóa .

Nếu bạn muốn bao gồm các đường dẫn được kiểm tra trong thông điệp tường trình của bạn, bạn có thể sử dụng lệnh Trình đơn ngữ cảnh → Dán danh sách tên tập tin trong trong hộp biên tập.

Một cách khác để chèn đường dẫn vào thông điệp tường trình là chỉ cần kéo các tập tin từ danh sách tập tin vào hộp biên tập.

Sau khi nhấn OK, một hộp thoại sẽ xuất hiện hiển thị tiến độ cam kết.

Hình 4.10. Hộp thoại tiến độ thể hiện một cam kết đang tiến triển

Hộp thoại tiến triển sử dụng màu sắc mã hóa để làm nổi bật hành động cam kết khác nhau

Đây là sơ đồ màu mặc định, nhưng bạn có thể tùy chỉnh những màu sắc bằng cách sử dụng hộp thoại thiết lập. Đọc phần “Thiết Lập Màu TortoiseSVN” để biết thêm thông tin.

A file conflict occurs when two or more developers have changed the same few lines of a file. As Subversion knows nothing of your project, it leaves resolving the conflicts to the developers. The conflicting area in a text file is marked like this:

<<<<<<< filename
your changes
=======
code merged from repository
>>>>>>> revision
      

Also, for every conflicted file Subversion places three additional files in your directory:

Bạn có thể khởi động một công cụ hợp nhất / biên tập xung đột bên ngoài với TortoiseSVN → Chỉnh Sửa Xung Đột hoặc bạn có thể sử dụng bất kỳ trình soạn thảo văn bản để giải quyết cuộc xung đột bằng tay. Bạn nên quyết định các mã nên trông như thế nào, làm những thay đổi cần thiết và các tập tin. Sử dụng một công cụ hợp nhất như TortoiseMerge hoặc một trong những công cụ phổ biến khác là lựa chọn dễ dàng hơn bởi chúng nói chung trình bày các tập tin liên quan trong một cửa sổ xem 3-bảng và bạn không phải lo lắng về những dấu hiệu xung đột. Nếu bạn sử dụng một trình soạn thảo văn bản thì bạn nên tìm kiếm các dòng bắt đầu với chuỗi <<<<<<< .

Sau đó thực hiện các lệnh TortoiseSVN → Giải quyết và cam kết sửa đổi của bạn vào kho lưu trữ. Xin lưu ý rằng lệnh Giải Quyết không thực sự giải quyết cuộc xung đột. Chỉ cần loại bỏ các tập tin filename.ext.mine và filename.ext.r * , sẽ cho phép bạn cam kết thay đổi của bạn.

Nếu bạn có xung đột với các tập tin nhị phân, Subversion không cố gắng để hợp nhất các tập tin. Các tập tin địa phương vẫn không thay đổi (chính xác như lần cuối bạn thay đổi nó) và bạn có các tập tin filename.ext.r * . Nếu bạn muốn loại bỏ các thay đổi của bạn và giữ các phiên bản trong kho lưu trữ, chỉ cần sử dụng lệnh Hoàn Nguyên. Nếu bạn muốn giữ phiên bản của bạn và ghi đè lên phiên bản kho lưu trữ, sử dụng lệnh Giải Quyết, sau đó cam kết phiên bản của bạn.

Bạn có thể sử dụng lệnh Giải Quyết cho nhiều tập tin nếu bạn kích chuột phải vào thư mục mẹ và chọn TortoiseSVN → Giải Quyết ... Điều này sẽ mang đến một hộp thoại liệt kê tất cả các tập tin mâu thuẫn trong thư mục đó, và bạn có thể chọn những cái để đánh dấu là đã giải quyết.

Sự xung đột giữa các thuộc tính xảy ra khi hai hay nhiều nhà phát triển đã thay đổi cùng một thuộc tính. Như với nội dung tập tin, giải quyết cuộc xung đột chỉ có thể được thực hiện bởi các nhà phát triển.

Nếu một trong những thay đổi phải ghi đè lên nhau thì chọn tùy chọn để Giải quyết bằng cách sử dụng tính chất địa phương hoặc Giải quyết bằng cách sử dụng tính chất từ xa . Nếu thay đổi phải được sáp nhập sau đó chọn Tự chỉnh sửa tính chất , sắp xếp những gì giá trị tính chất nên là và đánh dấu như đã giải quyết.

Sự xung đột giữa các cây xảy ra khi một nhà phát triển di chuyển / đổi tên / xóa một tập tin hoặc thư mục, mà một nhà phát triển khác hoặc cũng đã di chuyển / đổi tên / xóa hoặc chỉ cần sửa đổi. Có rất nhiều tình huống khác nhau có thể dẫn đến một cuộc xung đột cây, và tất cả chúng yêu cầu các bước khác nhau để giải quyết cuộc xung đột.

Khi một tập tin bị xóa tại địa phương trong Subversion, tập tin đó cũng bị xóa từ hệ thống tập tin địa phương, do đó, ngay cả nếu nó là một phần của một cuộc xung đột cây nó không thể hiển thị một lớp phủ mâu thuẫn và bạn không thể nhấp chuột phải vào nó để giải quyết cuộc xung đột. Sử dụng hộp thoại Kiểm tra xem có sửa đổi thay vì truy cập vào tùy chọn Chỉnh sửa xung đột .

TortoiseSVN có thể giúp tìm đúng nơi để sáp nhập các thay đổi, nhưng các việc cần thiết có thể cần thêm để sắp xếp những cuộc xung đột. Hãy nhớ rằng sau khi cập nhật một bản làm việc CƠ SỞ thì sẽ luôn luôn có các sửa đổi ở từng hạng mục như trong kho tại thời điểm cập nhật. Nếu bạn trở lại một sự thay đổi sau khi cập nhật thì nó đi trở lại tình trạng kho, không giống như nó trước đó khi bạn bắt đầu tạo ra những thay đổi của địa phương của bạn.

Hình 4.12. Explorer hiển thị lớp phủ biểu tượng

Bởi vì bây giờ bạn đã kiểm xuất một bản sao làm việc từ một kho lưu trữ Subversion bạn có thể xem các tập tin của bạn trong nhà thám hiểm cửa sổ với các biểu tượng đã được thay đổi. Đây là một trong những lý do tại sao TortoiseSVN là rất phổ biến. TortoiseSVN thêm vào một biểu tượng lớp phủ lên mỗi biểu tượng tập tin chồng lên biểu tượng tập tin ban đầu. Tùy thuộc vào tình trạng Subversion của tập tin mà biểu tượng lớp phủ sẽ là khác nhau.

Một bản sao làm việc mới kiểm xuất có một dấu kiểm màu xanh lá cây làm lớp phủ. Điều đó có nghĩa là tình trạng Subversion là bình thường .

Ngay sau khi bạn bắt đầu chỉnh sửa một tập tin, trạng thái đổi sang sửa đổi và lớp phủ biểu tượng sau đó thay đổi thành một dấu chấm than màu đỏ. Bằng cách đó bạn có thể dễ dàng nhìn thấy các tập tin đã được thay đổi kể từ lần cuối bạn cập nhật bản sao làm việc của bạn và cần phải được cam kết.

Nếu trong quá trình cập nhật một xung đột xảy ra thì biểu tượng thay đổi thành một dấu chấm than màu vàng.

Nếu bạn đã thiết lập thuộc tính svn:needs-lock vào một tập tin, Subversion làm cho tập tin đó chỉ đọc cho đến khi bạn nhận được một khóa trên tập tin đó. Các tập tin như vậy có lớp phủ để cho biết rằng bạn phải có được khóa trước khi bạn có thể chỉnh sửa tập tin đó.

Nếu bạn giữ một khóa trên một tập tin, và tình trạng Subversion là bình thường , lớp phủ biểu tượng này nhắc nhở bạn rằng bạn nên phát hành các khóa nếu bạn không sử dụng nó để cho phép người khác thực hiện các thay đổi của họ lên tập tin.

Biểu tượng này cho thấy rằng một số tập tin hoặc thư mục bên trong thư mục hiện hành đã được dự kiến ​​sẽ được xóa từ kiểm soát phiên bản hoặc một tập tin dưới sự kiểm soát phiên bản đã mất trong một thư mục.

Dấu cộng cho bạn biết rằng một tập tin hoặc thư mục đã được dự kiến ​​sẽ được thêm vào kiểm soát phiên bản.

Dấu hiệu thanh nói với bạn rằng một tập tin hoặc thư mục bị bỏ qua cho mục đích kiểm soát phiên bản. Lớp phủ này là tùy chọn.

Biểu tượng này cho thấy các tập tin và thư mục không phải nằm dưới sự kiểm soát phiên bản, nhưng đã không được bỏ qua. Lớp phủ này là tùy chọn.

Trong thực tế, bạn có thể thấy rằng không phải tất cả các biểu tượng này được sử dụng trên hệ thống của bạn. Điều này là bởi vì số lượng của lớp phủ cho phép Windows là rất hạn chế và nếu bạn cũng sử dụng một phiên bản cũ của TortoiseCVS, sau đó có không đủ chỗ cho lớp phủ có sẵn. TortoiseSVN cố gắng là một “Công Dân Tốt (TM)” và hạn chế sử dụng lớp phủ để cung cấp cho các ứng dụng khác một cơ hội.

Bởi vì bây giờ có nhiều trình khách Tortoise xung quanh (TortoiseCVS, TortoiseHg, ...) giới hạn của biểu tượng sẽ trở thành một vấn đề thực sự. Để làm việc này, dự án TortoiseSVN giới thiệu một tập hợp biểu tượng chung chia sẻ, được nạp như một DLL, có thể được sử dụng bởi tất cả các trình khách Tortoise. Kiểm tra với nhà cung cấp dịch vụ khách hàng của bạn để xem nếu cái này đã được tích hợp chưa :-)

Đối với một mô tả của lớp phủ biểu tượng tương ứng với tình trạng Subversion và các chi tiết kỹ thuật khác, đọc phần “Biểu tượng Lớp phủ” .

Hình 4.13. trang thuộc tính Explorer, tab Subversion

Đôi khi bạn muốn có thêm thông tin chi tiết về một tập tin / thư mục hơn là với lớp phủ biểu tượng. Bạn có thể nhận được tất cả các thông tin Subversion cung cấp trong hộp thoại thám hiểm thuộc tính. Chỉ cần chọn các tập tin hoặc thư mục và chọn Trình đơn Cửa sổ → thuộc tính trong trình đơn ngữ cảnh (lưu ý: đây là các thuộc tính trình đơn bình thường mà trình thám hiểm cung cấp, không phải là một trong các trình đơn phụ của TortoiseSVN). Trong hộp thoại thuộc tính TortoiseSVN thêm một trang thuộc tính mới cho các tập tin / thư mục do Subversion kiểm soát, nơi bạn có thể nhìn thấy tất cả các thông tin có liên quan về các tập tin / thư mục được lựa chọn.

Hình 4.14. Kiểm tra xem có sửa đổi

Thường rất hữu ích để biết những tập tin mà bạn đã thay đổi và cũng có các tập tin đã thay đổi và cam kết bởi những người khác. Đó là nơi mà các lệnh TortoiseSVN → Kiểm tra xem có sửa đổi ... trở nên có ích. Hộp thoại này sẽ cho bạn thấy tất cả các tập tin đã thay đổi trong bất kỳ cách nào trong bản sao làm việc của bạn, cũng như bất kỳ tập tin không được phiên bản mà bạn có thể có.

Nếu bạn bấm vào Kiểm tra Kho thì bạn cũng có thể tìm những thay đổi trong kho. Bằng cách đó bạn có thể kiểm tra trước khi cập nhật nếu xung đột có thể xảy ra. Bạn cũng có thể cập nhật các tập tin được lựa chọn từ kho lưu trữ mà không cần cập nhật toàn bộ thư mục. Theo mặc định, nút Kiểm tra Kho chỉ lấy tình trạng từ xa với độ sâu kiểm xuất của các bản sao làm việc. Nếu bạn muốn xem tất cả các tập tin và thư mục trong kho lưu trữ, ngay cả những thứ bạn đã không kiểm xu, thì bạn phải giữ phím Shift khi bạn bấm vào nút Kiểm tra Kho .

Hộp thoại sử dụng mã màu để làm nổi bật tình trạng.

Đây là sơ đồ màu mặc định, nhưng bạn có thể tùy chỉnh những màu sắc bằng cách sử dụng hộp thoại thiết lập. Đọc phần “Thiết Lập Màu TortoiseSVN” để biết thêm thông tin.

Biểu tượng lớp phủ cũng được dùng để thể hiện các trạng thái khác. Ảnh chụp màn hình dưới đây cho thấy tất các các lớp phủ có thể mà được hiển thị khi cần.

Các lớp phủ được hiển thị cho các trạng thái sau đây:

Các mục đã được chuyển sang một đường dẫn kho lưu trữ khác cũng được chỉ định sử dụng một đánh dấu (s) . Bạn có thể đã chuyển một cái gì đó trong khi làm việc trên một chi nhánh và quên để chuyển đổi trở lại với thân cây. Đây là dấu hiệu cảnh báo của bạn! Trình đơn ngữ cảnh cho phép bạn chuyển đổi chúng trở lại đường dẫn bình thường.

Từ trình đơn ngữ cảnh của hộp thoại, bạn có thể hiển thị khác biệt trong những thay đổi. Kiểm tra các thay đổi cục bộ bạn thực hiện bằng cách sử dụng Trình đơn ngữ cảnh → So sánh với Cơ Sở . Kiểm tra những thay đổi của người khác trong các kho lưu trữ sử dụng Trình đơn ngữ cảnh → Hiển thị sự khác biệt dưới dạng khác biệt thống nhất .

Bạn cũng có thể trở lại những thay đổi trong các tập tin. Nếu bạn đã vô tình xóa một tập tin, nó sẽ hiển thị như là Thiếu và bạn có thể sử dụng Hoàn nguyên để phục hồi nó.

Các tập tin không phiên bản và bỏ qua có thể được gửi vào thùng rác từ đây bằng cách sử dụng Trình đơn ngữ cảnh → Xóa . Nếu bạn muốn xóa các tập tin vĩnh viễn (bỏ qua thùng rác) thì bấm phím Shift trong khi nhấp chuột vào Xóa .

Nếu bạn muốn kiểm tra chi tiết một tập tin, bạn có thể kéo nó từ đây vào một ứng dụng khác như một trình soạn thảo văn bản hay IDE, hoặc bạn có thể lưu một bản sao đơn giản bằng cách kéo nó vào một thư mục trong explorer.

Các cột có thể tùy chỉnh. Nếu bạn click chuột phải trên bất kỳ cột tiêu đề, bạn sẽ thấy một trình đơn ngữ cảnh cho phép bạn chọn các cột được hiển thị. Bạn cũng có thể thay đổi chiều rộng cột bằng cách sử dụng xử lý kéo xuất hiện khi bạn di chuyển chuột lên một ranh giới cột. Các tùy chỉnh được bảo tồn, vì vậy bạn sẽ thấy cùng các tiêu đề trong thời gian tiếp theo.

Nếu bạn đang làm việc trên một số nhiệm vụ không liên quan cùng một lúc, bạn cũng có thể nhóm các tập tin với nhau vào danh sách thay đổi. Đọc phần “Danh sách Thay đổi” để biết thêm thông tin.

Ở phía dưới của hộp thoại, bạn có thể nhìn thấy một bản tóm tắt của các chỉnh sửa trong kho lưu trữ sử dụng trong các bản sao làm việc của bạn. Đây là những cam kết sửa đổi, chứ không phải cập nhật sửa đổi, chúng đại diện cho một loạt các phiên bản mà các tập tin này được cam kết cuối cùng, không phải là phiên bản mà chúng đã được cập nhật. Lưu ý rằng đây là phạm vi sửa đổi thể hiện chỉ áp dụng cho các mục hiển thị, chứ không phải toàn bộ bản sao làm việc. Nếu bạn muốn xem thông tin đó cho toàn bộ bản sao làm việc, bạn phải đánh hộp kiểm Hiển thị các tập tin chưa sửa đổi .

Thường thì bạn muốn nhìn bên trong các tập tin của bạn, để có một cái nhìn vào những gì bạn đã thay đổi. Bạn có thể thực hiện điều này bằng cách chọn một tập tin đã thay đổi, và chọn Khác từ trình đơn ngữ cảnh của TortoiseSVN. Điều này bắt đầu trình xem khác biệt bên ngoài, mà sau đó sẽ so sánh các tập tin hiện tại cùng với bản sao nguyên sơ (bản sửa đổi BASE), đã được lưu trữ sau khi kiểm tra ra hoặc cập nhật cuối cùng.

Hình 4.18. Hộp thoại Tường Trình Sửa Đổi

Có nhiều nơi mà từ đó bạn có thể hiển thị hộp thoại Tường Trình:

Nếu kho lưu trữ không sẵn sàng, bạn sẽ thấy hộp thoại Bạn muốn ra ngoài mạng không? , được mô tả trong phần “Chế Độ Ngoại Tuyến” .

Các bảng trên cùng có một cột Hoạt động chứa các biểu tượng tóm tắt những gì đã được thực hiện trong bản chỉnh sửa đó. Có bốn biểu tượng khác nhau, được hiển thị trong cột riêng của mình.

Nếu một phiên bản sửa đổi một tập tin hoặc thư mục, biểu tượng sửa đổi được hiển thị trong cột đầu tiên.

Nếu một sửa đổi được thêm vào một tập tin hoặc thư mục, biểu tượng thêm được hiển thị trong cột thứ hai.

Nếu một phiên bản đã xóa một tập tin hoặc thư mục, biểu tượng xóa được hiển thị trong cột thứ ba.

Nếu một phiên bản thay thế một tập tin hoặc thư mục, biểu tượng thay thế được hiển thị trong cột thứ tư.

If a revision moved or renamed a file or directory, the moved icon is shown in the fourth column.

If a revision replaced a file or directory by moving/renaming it, the move replaced icon is shown in the fourth column.

If a revision merged a file or directory, the merged icon is shown in the fourth column.

If a revision reverse merged a file or directory, the reverse merged icon is shown in the fourth column.

Hình 4.19. Bảng trên cùng của hộp thoại tường trình sửa đổi với trình đơn ngữ cảnh

The top pane of the Log dialog has a context menu that allows you to access much more information. Some of these menu entries appear only when the log is shown for a file, and some only when the log is shown for a folder.

Hình 4.20. The Code Collaborator Settings Dialog

Hình 4.21. Bảng trên cùng của trình đơn ngữ cảnh trong 2 bản sửa đổi được lựa chọn

Nếu bạn chọn hai phiên bản cùng một lúc (bằng cách sử dụng phím thông thường Ctrl -Sửa đổi), trình đơn ngữ cảnh thay đổi và cung cấp cho bạn ít tùy chọn hơn:

Nếu bạn chọn hai hoặc nhiều sửa đổi (bằng cách sử dụng thông thường Ctrl hoặc Shift bổ), trình đơn ngữ cảnh sẽ bao gồm một mục vào Hoàn nguyên tất cả các thay đổi đã được thực hiện trong các phiên bản được lựa chọn. Đây là cách dễ nhất để quay lui một nhóm các phiên bản trong một lần.

Bạn cũng có thể chọn để kết hợp các phiên bản được lựa chọn thành một bản sao làm việc, như mô tả ở trên.

Nếu tất cả các sửa đổi được lựa chọn có cùng tác giả, bạn có thể chỉnh sửa các tác giả của tất cả những sửa đổi trong một lần.

Hình 4.22. Khung hộp thoại tường trình dưới đáy với trình đơn ngữ cảnh

The bottom pane of the Log dialog also has a context menu that allows you to

When multiple files are selected in the bottom pane of the Log dialog, the context menu changes to the following:

Hình 4.23. The Log Dialog Bottom Pane with Context Menu When Multiple Files Selected.

Hộp thoại Tường trình không phải luôn luôn hiển thị tất cả thay đổi từng được thực hiện vì một số lý do:

Nếu bạn muốn để xem nhiều thông điệp tường trình hơn, nhấp vào 100 tiếp theo để lấy 100 thông điệp tường trình tiếp theo. Bạn có thể lặp lại điều này nhiều lần khi cần thiết.

Bên cạnh nút này là nút đa chức năng nhớ lựa chọn cuối cùng bạn sử dụng nó cho. Nhắp chuột vào mũi tên để xem các tùy chọn khác được cung cấp.

Sử dụng Hiện Phạm Vi ... nếu bạn muốn xem một phạm vi cụ thể các phiên bản. Một hộp thoại sau đó sẽ nhắc bạn nhập vào bản sửa đổi bắt đầu và kết thúc.

Sử dụng Hiện tất cả nếu bạn muốn xem tất cả thông điệp tường trình từ HEAD tới lại phiên bản 1.

Để làm mới phiên bản mới nhất trong trường hợp có các cam kết trong khi hộp thoại tường trình đã được mở, nhấn phím F5 .

Để làm mới bộ nhớ cache tường trình, nhấn phím Ctrl-F5 .

Bởi vì các hộp thoại tường trình hiển thị cho bạn các tường trình từ HEAD, không phải từ bản sao làm việc hiện tại, nó thường xảy ra rằng có những thông điệp tường trình được hiển thị cho nội dung chưa được cập nhật trong bản sao làm việc của bạn. Để giúp thực hiện điều này rõ ràng hơn, thông báo cam kết tương ứng với sửa đổi bạn có trong bản sao làm việc của bạn sẽ được in đậm.

Khi bạn tường trình cho một thư bản mục sửa đổi được nhấn mạnh là bản sửa đổi cao nhất tìm thấy bất cứ nơi nào trong thư mục đó, đòi hỏi thu thập dữ liệu của bản sao làm việc. Thu thập dữ liệu diễn ra trong một mạch riêng biệt để không trì hoãn hiển thị các tường trình, nhưng là một kết quả nổi bật cho các thư mục có thể không xuất hiện ngay lập tức.

Subversion 1.5 và gần hơn giữ một hồ sơ của các kết hợp sử dụng thuộc tính. Điều này cho phép chúng tôi có được một lịch sử chi tiết hơn về những thay đổi được sáp nhập. Ví dụ, nếu bạn phát triển một tính năng mới trên một chi nhánh và sau đó hợp nhất chi nhánh trở lại với thân cây, sự phát triển tính năng sẽ xuất hiện trên nhật ký thân cây như một cam kết duy nhất cho việc hợp nhất, mặc dù có thể có 1000 cam kết trong quá trình phát triển chi nhánh .

Hình 4.24. Hộp Thoại Tường Trình Hiển Thị Theo Dõi Hợp Nhất Các Bản Sửa Đổi

Nếu bạn muốn xem chi tiết trong đó các bản sửa đổi đã được sáp nhập như là một phần của cam kết, sử dụng hộp kiểm Bao gồm các phiên bản được sáp nhập . Điều này sẽ lấy các thông điệp tường trình một lần nữa, nhưng cũng sẽ xen kẽ các thông điệp tường trình từ các phiên bản đã được sáp nhập. Sửa đổi được sáp nhập được thể hiện trong màu xám bởi vì chúng đại diện cho các thay đổi được thực hiện trên một phần khác nhau của cây.

Tất nhiên, sáp nhập không bao giờ là đơn giản! Trong quá trình phát triển tính năng trên chi nhánh có thể thỉnh thoảng sẽ có sáp nhập vào lại thân cây để giữ cho các chi nhánh đồng bộ với dòng mã chính. Vì vậy, lịch sử hợp nhất của chi nhánh cũng sẽ bao gồm một lớp lịch sử hợp nhất khác. Những lớp khác nhau được hiển thị trong hộp thoại tường trình bằng cách sử dụng các mức độ thụt đầu dòng.

Các thuộc tính sửa đổi hoàn toàn khác với các thuộc tính Subversion của từng hạng mục. Revprops là các mục mô tả được kết hợp với một con số của bản sửa đổi cụ thể trong kho, chẳng hạn như thông điệp tường trình, cam kết ngày tháng và tên người cam kết (tác giả).

Đôi khi bạn có thể muốn thay đổi một thông điệp tường trình mà bạn đã từng nhập vào, có thể bởi vì có một lỗi chính tả trong đó hoặc bạn muốn cải thiện hoặc thay đổi nó vì lý do khác. Hoặc bạn muốn thay đổi tác giả của cam kết bởi vì bạn quên thiết lập chứng thực hoặc ...

Subversion lets you change revision properties any time you want. But since such changes can't be undone (those changes are not versioned) this feature is disabled by default. To make this work, you must set up a pre-revprop-change hook. Please refer to the chapter on Hook Scripts in the Subversion Book for details about how to do that. Read phần “kịch bản móc phía máy chủ” to find some further notes on implementing hooks on a Windows machine.

Một khi bạn đã thiết lập máy chủ của bạn với các móc cần thiết, bạn có thể thay đổi các tác giả và tin nhắn tường trình (hoặc bất kỳ revprop khác) của bất kỳ bản sửa đổi nào, sử dụng trình đơn ngữ cảnh từ cửa sổ trên cùng của hộp thoại Tường Trình. Bạn cũng có thể chỉnh sửa một tin thông điệp tường trình bằng cách sử dụng trình đơn ngữ cảnh cho các cửa sổ giữa.

Nếu bạn muốn hạn chế các thông điệp tường trình để chỉ hiển thị những người bạn đang quan tâm đến chứ không phải di chuyển qua một danh sách của hàng trăm, bạn có thể sử dụng các điều khiển bộ lọc ở phía trên cùng của Hộp Thoại Tường Trình. Kiểm soát ngày bắt đầu và kết thúc cho phép bạn hạn chế đầu ra cho một phạm vi ngày được biết đến. Hộp tìm kiếm cho phép bạn hiển thị các tin nhắn có chứa một cụm từ cụ thể.

Nhấp chuột vào biểu tượng tìm kiếm để chọn thông tin mà bạn muốn tìm kiếm, và để lựa chọn regex chế độ. Bình thường, bạn chỉ cần một cách tìm kiếm chuỗi con đơn giản, nhưng nếu bạn cần cách tìm kiếm linh hoạt hơn, bạn có thể sử dụng biểu thức thông thường. Nếu bạn di chuyển chuột trên hộp, một tooltip sẽ đưa ra gợi ý về làm thế nào để sử dụng chức năng regex, hoặc chức năng chuỗi con. Các bộ lọc hoạt động bằng cách kiểm tra xem chuỗi bộ lọc của bạn phù hợp với các mục tường trình không, và sau đó chỉ có những mục phù hợp với chuỗi lọc được hiển thị.

Simple sub-string search works in a manner similar to a search engine. Strings to search for are separated by spaces, and all strings must match. You can use a leading - to specify that a particular sub-string is not found (invert matching for that term), and you can use ! at the start of the expression to invert matching for the entire expression. You can use a leading + to specify that a sub-string should be included, even if previously excluded with a -. Note that the order of inclusion/exclusion is significant here. You can use quote marks to surround a string which must contain spaces, and if you want to search for a literal quotation mark you can use two quotation marks together as a self-escaping sequence. Note that the backslash character is not used as an escape character and has no special significance in simple sub-string searches. Examples will make this easier:

Alice Bob -Eve
      

searches for strings containing both Alice and Bob but not Eve

Alice -Bob +Eve
      

searches for strings containing both Alice but not Bob, or strings which contain Eve.

-Case +SpecialCase
      

searches for strings which do not contain Case, but still include strings which contain SpecialCase.

!Alice Bob
      

searches for strings which do not contain both Alice and Bob

!-Alice -Bob
      

do you remember De Morgan's theorem? NOT(NOT Alice AND NOT Bob) reduces to (Alice OR Bob).

"Alice and Bob"
      

searches for the literal expression “Alice and Bob”

""
      

searches for a double-quote anywhere in the text

"Alice says ""hi"" to Bob"
      

searches for the literal expression “Alice says "hi" to Bob”.

Mô tả việc sử dụng tìm kiếm bằng các biểu thức thông thường là vượt quá phạm vi của sổ tay này, nhưng bạn có thể tìm thấy tài liệu trực tuyến và hướng dẫn tại http://www.regular-expressions.info/ .

Lưu ý rằng các bộ lọc này hoạt động trên các thông điệp đã được lấy ra. Chúng không kiểm soát việc tải xuống các thông điệp từ kho lưu trữ.

Bạn cũng có thể lọc tên đường dẫn ở khung bên dưới bằng cách sử dụng hộp kiểm Chỉ hiển thị đường dẫn bị ảnh hưởng . Đường dẫn bị ảnh hưởng là những cái có chứa các đường dẫn được sử dụng để hiển thị các tường trình. Nếu bạn lấy các tường trình cho một thư mục, có nghĩa là bất cứ điều gì trong thư mục đó hoặc dưới nó. Đối với một tập tin, nó có nghĩa là chỉ là một tập tin. Thông thường danh sách đường dẫn cho thấy bất kỳ đường dẫn khác bị ảnh hưởng bởi các cam kết tương tự, nhưng bằng màu xám. Nếu hộp được kiểm tra, những đường dẫn sẽ được ẩn.

Đôi khi cách thực hành làm việc của bạn sẽ yêu cầu các tin nhắn đăng nhập vào phải theo một định dạng cụ thể, điều đó có nghĩa rằng các văn bản mô tả những thay đổi không nhìn thấy được trong phần tóm tắt viết tắt được hiển thị trong cửa sổ trên cùng. Thuộc tính TSVN: logsummary có thể được sử dụng để trích xuất một phần của thông điệp tường tình được hiển thị trong cửa sổ trên cùng. Đọc phần “Thuộc tính dự án TortoiseSVN” để tìm hiểu làm thế nào để sử dụng thuộc tính này.

Nút Thống kê sẽ trả về một hộp hiển thị một số thông tin thú vị về các phiên bản được hiển thị trong hộp thoại Tường Trình. Điều này cho thấy có bao nhiêu tác giả đã tại nơi làm việc, bao nhiêu cam kết mà họ đã thực hiện, tiến độ theo tuần, và nhiều hơn nữa. Bây giờ bạn có thể nhìn thấy trong nháy mắt ai đã làm việc chăm chỉ nhất và ai là người đang uể oải ;-)

Trang các Cam kết của Tác giả

Hình 4.25. Biểu đồ phân phối của các Cam kết-bở-Tác giả

Biểu đồ này cho bạn thấy các tác giả nào đã hoạt động tích cực trên dự án như một biểu đồ phân phối đơn giản, biểu đồ phân phối xếp chồng lên nhau hoặc biểu đồ hình bánh.

Hình 4.26. Biểu đồ hình bánh của các Cam kết-bởi-Tác giả

Trường hợp có một vài tác giả chính và nhiều người đóng góp nhỏ, số lượng các phân đoạn nhỏ có thể làm cho đồ thị khó đọc hơn. Thanh trượt ở phía dưới cho phép bạn thiết lập một ngưỡng (như là một tỷ lệ phần trăm của tổng số cam kết) mà dưới ngưỡng đó các hoạt động bất kỳ được nhóm lại thành một danh mục có tên Những phần khác .

Trang cam kết theo ngày

Hình 4.27. Đồ thị Cam kết-theo-ngày

Trang này cung cấp cho bạn một trình bày đồ họa của các hoạt động trong dự án tính bằng số các cam kết và tác giả. Điều này một số ý tưởng khi nào dự án đang có người làm việc, và những người đang làm việc là ai tại thời gian nào.

Khi có nhiều tác giả, bạn sẽ nhận được nhiều dòng trên đồ thị. Có hai cách xem có sẵn ở đây: bình thường , nơi mà mỗi tác giả hoạt động liên quan đến đường cơ sở, và xếp chồng lên nhau , nơi hoạt động của mỗi tác giả có liên quan đến đường bên dưới. Tùy chọn thứ hai tránh làm các dòng chéo qua nhau, có thể làm cho đồ thị dễ đọc hơn, nhưng không dễ dàng để thấy công sức bỏ ra của một tác giả.

Theo mặc định, việc phân tích có phân biệt chữ hoa, vì vậy người sử dụng PeterEgan và PeteRegan được coi là các tác giả khác nhau. Tuy nhiên, trong nhiều trường hợp tên người dùng không phân biệt chữ hoa, và đôi khi được nhập vào không thống nhất, vì vậy bạn có thể muốn DavidMorgan và davidmorgan được coi là cùng một người. Sử dụng hộp kiểm Tác giả phân biệt chữ hoa để kiểm soát việc này được xử lý như thế nào.

Lưu ý rằng các số liệu thống kê bao gồm các giai đoạn tương tự như hộp thoại Tường Trình. Nếu đó là chỉ hiển thị một bản sửa đổi thì các số liệu thống kê sẽ không nói lên gì nhiều cho bạn.

Hình 4.28. Đến Hộp Thoại Ngoại Tuyến

Nếu máy chủ không thể truy cập được, và bạn có bộ nhớ đệm cho tường tình được kích hoạt, bạn có thể sử dụng hộp thoại tường tình và biểu đồ sửa đổi trong chế độ ngoại tuyện. Điều này sử dụng dữ liệu từ bộ nhớ cache, cho phép bạn tiếp tục làm việc mặc dù các thông tin có thể không được cập nhật hoặc thậm chí không hoàn chỉnh.

Ở đây bạn có ba lựa chọn:

Hộp kiểm Lấy nó làm mặc định ngăn chặn các hộp thoại này xuất hiện lại và luôn luôn chọn các tùy chọn mà bạn chọn tiếp theo. Bạn vẫn có thể thay đổi (hoặc loại bỏ) mặc định sau khi làm điều này từ TortoiseSVN → Thiết lập .

Nếu bạn muốn kiểm tra máy chủ một lần nữa cho thông điệp tường trình mới, bạn đơn giản là có thể làm mới màn xem bằng cách sử dụng F5 . Nếu bạn đang sử dụng bộ nhớ cache tường trình (kích hoạt mặc định), điều này sẽ kiểm tra các kho lưu trữ cho các thông điệp mới và chỉ lấy những cái mới. Nếu bộ nhớ cache tường trình trong chế độ ngoại tuyến, nó cũng sẽ cố gắng để trở lại trực tuyến.

Nếu bạn đang sử dụng bộ nhớ cache tường trình và bạn nghĩ nội dung thông điệp hay tác giả có thể đã thay đổi, bạn có thể sử dụng Shift-F5 hoặc Ctrl-F5 để nạp lại các thông điệp được hiển thị từ máy chủ và cập nhật bộ nhớ cache tường trình. Lưu ý rằng điều này chỉ ảnh hưởng đến các thông điệp hiện đang thể hiện và không làm mất hiệu lực toàn bộ bộ nhớ cache cho kho lưu trữ đó.

Nếu bạn đã cấu hình một công cụ bên thứ ba khác, bạn có thể sử dụng Shift khi chọn lệnh Diff để sử dụng công cụ thay thế. Đọc phần “Các Thiết Lập Cho Chương Trình Bên Ngoài ” để tìm hiểu về cấu hình các công cụ tìm khác biệt khác.

Đôi khi trong cuộc đời của một dự án bạn có thể thay đổi kết thúc dòng CRLF sang LF , hoặc bạn có thể thay đổi thụt đầu dòng của một phần. Tiếc là điều này sẽ đánh dấu một số lượng lớn các dòng như đã thay đổi, mặc dù không có thay đổi ý nghĩa của mã. Các tùy chọn ở đây sẽ giúp quản lý những thay đổi này khi nói đến việc so sánh và áp dụng sự khác biệt. Bạn sẽ thấy các thiết lập trong hộp thoại Hợp nhất và Đổ lỗi , cũng như trong các thiết lập cho TortoiseMerge.

Bỏ qua kết thúc dòng không bao gồm thay đổi do sự khác biệt trong phong cách cuối dòng.

So sánh các khoảng trắng bao gồm tất cả các thay đổi trong thụt đầu dòng và khoảng trắng nội tuyến nhu các dòng được thêm / gỡ bỏ.

Bỏ qua khoảng trắng thay đổi không bao gồm thay đổi do sự thay đổi trong số lượng hoặc loại khoảng trắng, ví dụ như thay đổi thụt đầu dòng hoặc thay đổi các tab thành khoảng trắng. Thêm khoảng trắng nơi không có trước kia, hoặc loại bỏ một khoảng trắng hoàn toàn vẫn còn được hiển thị như là một thay đổi.

Bỏ qua tất cả các khoảng trắng không bao gồm tất cả thay đổi chỉ có khoảng trắng.

Đương nhiên, bất kỳ dòng nào với nội dung thay đổi luôn luôn bao gồm trong khác biệt.

Hình 4.29. Hộp Thoại So Sánh Bản Sửa Đổi

Khi bạn chọn hai cây trong trình duyệt kho lưu trữ, hoặc khi bạn chọn hai bản sửa đổi của một thư mục trong hộp thoại tường trình, bạn có thể Trình đơn ngữ cảnh → So sánh các bản sửa đổi .

Hộp thoại này cho thấy một danh sách của tất cả các tập tin đã thay đổi và cho phép bạn so sánh hoặc đổ lỗi cho từng tập tin một bằng cách sử dụng trình đơn ngữ cảnh.

Bạn có thể xuất khẩu một cây thay đổi , là hữu ích nếu bạn cần phải gửi tới một người khác cấu trúc cây dự án của bạn, nhưng chỉ chứa các tập tin đã thay đổi. Tác vụ này chỉ hoạt động trên các tập tin được lựa chọn, vì vậy bạn cần phải chọn các tập tin quan tâm - thường có nghĩa là tất cả trong số chúng - và sau đó Trình đơn ngữ cảnh → Xuất khẩu lựa chọn ... . Bạn sẽ được nhắc cho một vị trí để lưu cây thay đổi.

Bạn cũng có thể xuất khẩu danh sách các tập tin thay đổi vào một tập tin văn bản bằng cách sử dụng Trình đơn ngữ cảnh → Lưu danh sách các file được chọn ... .

Nếu bạn muốn xuất khẩu danh sách các tập tin và hành động (sửa đổi, bổ sung, xóa), bạn có thể làm điều đó bằng cách sử dụng Trình đơn ngữ cảnh → Sao chép lựa chọn vào clipboard .

Các nút ở trên cùng cho phép bạn thay đổi hướng so sánh. Bạn có thể hiển thị những thay đổi cần phải nhận được từ A đến B, hoặc nếu bạn thích, từ B đến A.

Các nút với các con số sửa đổi trên có thể được sử dụng để thay đổi một loạt phiên bản khác nhau. Khi bạn thay đổi phạm vi, danh sách các hạng mục khác nhau giữa hai phiên bản sẽ được cập nhật tự động.

Nếu danh sách các tên tập tin là rất dài, bạn có thể sử dụng hộp tìm kiếm để giảm bớt danh sách tên tập tin có chứa văn bản cụ thể. Lưu ý rằng một cách tìm kiếm văn bản đơn giản được sử dụng, vì vậy nếu bạn muốn hạn chế danh sách các tập tin nguồn C bạn nên nhập . c chứ không phải là *.c .

Có nhiều công cụ có sẵn cho tìm khác biệt tập tin văn bản, bao gồm cả TortoiseMerge của chúng ta, nhưng chúng ta thường thấy mình muốn xem làm thế nào một tập tin hình ảnh đã thay đổi. Đó là lý do tại sao chúng tôi tạo ra TortoiseIDiff.

Hình 4.30. Trình xem khác biệt hình ảnh

TortoiseSVN → Khác biệt cho bất kỳ các định dạng tập tin hình ảnh phổ biến sẽ bắt đầu TortoiseIDiff để hiển thị sự khác biệt hình ảnh. Theo mặc định, hình ảnh được hiển thị bên cạnh nhau nhưng bạn có thể sử dụng trình đơn Xem hoặc thanh công cụ để chuyển sang một góc nhìn từ trên xuống dưới, hoặc nếu bạn thích, bạn có thể che phủ những hình ảnh và giả vờ bạn đang sử dụng một hộp sáng.

Tự nhiên bạn cũng có thể phóng to và nhỏ và quay xung quanh hình ảnh. Bạn cũng có thể xoay hình ảnh đơn giản bằng cách kéo trái nó. Nếu bạn chọn tùy chọn Liên kết hình ảnh với nhau , sau đó điều khiển xoay (thanh cuộn, con lăn chuột) trên cả hai hình ảnh được liên kết.

Một hộp thông tin hình ảnh hiển thị chi tiết về các tập tin hình ảnh, chẳng hạn như kích thước, độ phân giải điểm ảnh và độ sâu màu. Nếu hộp này được hiện ra, sử dụng Xem → Thông tin về Hình ảnh để che giấu nó. Bạn có thể nhận được cùng một thông tin trong một tooltip nếu bạn di chuột lên trên thanh tiêu đề hình ảnh.

Khi những hình ảnh được phủ lên, cường độ tương đối của hình ảnh (sự pha trộn alpha) được điều khiển bởi một điều khiển thanh trượt ở phía bên trái. Bạn có thể bấm bất cứ nơi nào trên thanh trượt để thiết lập sự pha trộn trực tiếp, hoặc bạn có thể kéo thanh trượt để thay đổi sự pha trộn một cách tương tác. Ctrl+Shift - Bánh xe để thay đổi sự pha trộn.

Các nút trên thanh trượt bập bênh giữa 0% và hỗn hợp 100%, và nếu bạn nhấp đúp chuột vào nút, sự pha trộn các bập bênh tự động mỗi giây cho đến khi bạn nhấn vào nút này một lần nữa. Điều này có thể hữu ích khi tìm kiếm nhiều thay đổi nhỏ.

Đôi khi bạn muốn nhìn thấy một sự khác biệt chứ không phải là một sự pha trộn. Bạn có thể có các tập tin hình ảnh trong hai phiên bản của một bảng mạch in và muốn xem những rãnh nào đã thay đổi. Nếu bạn vô hiệu hóa chế độ pha trộn alpha, sự khác biệt sẽ được hiển thị như một XOR của các giá trị màu điểm ảnh. Các khu vực không thay đổi sẽ có màu trắng đều và các thay đổi sẽ được tô màu.

Khi bạn muốn tìm khác biệt các tài liệu văn bản bạn thường phải sử dụng phần mềm được sử dụng để tạo ra các tài liệu bởi nó hiểu được định dạng tập tin. Đối với bộ ứng dụng thường được sử dụng như Microsoft Office và Open Office thực sự là có một số hỗ trợ để xem khác biệt và TortoiseSVN bao gồm các kịch bản để gọi những cái này với các thiết lập phù hợp khi bạn tìm khác biệt tập tin với các phần mở rộng tập tin được biết rộng rãi. Bạn có thể kiểm tra những phần mở rộng tập tin nào được hỗ trợ và thêm vào của riêng bạn bằng cách vào TortoiseSVN → Thiết Lập và nhấp Nâng Cao trong phần Chương Trình Bên Ngoài .

Nếu các công cụ mà chúng tôi cung cấp không làm những gì bạn cần, hãy thử một trong các chương trình mã nguồn mở hoặc thương mại có sẵn. Mọi người đều có chương trình yêu thích của riêng họ, và danh sách này không có nghĩa là hoàn chỉnh, nhưng đây là một vài điều mà bạn có thể xem xét:

Đọc phần “Các Thiết Lập Cho Chương Trình Bên Ngoài ” để lấy thông tin về làm thế nào để cài đặt TortoiseSVN để sử dụng những công cụ này.

Các mẫu bỏ qua của Subversion sử dụng cách toàn cục hóa tên tập tin, một kỹ thuật ban đầu được sử dụng trong Unix để xác định các tập tin bằng cách sử dụng ký tự meta như là ký tự đại diện. Các ký tự sau đây có ý nghĩa đặc biệt:

Khớp mẫu có phân biệt chữ hoa, có thể gây ra vấn đề trên Windows. Bạn có thể bắt buộc không phân biệt chữ hoa theo cách khó khăn bằng cách ghép đôi ký tự, ví dụ như bỏ qua *.tmp bất kể chữ hoa, bạn có thể sử dụng một mẫu như *.[Tt][Mm][PP] .

Nếu bạn muốn có một định nghĩa chính thức cho globbing, bạn có thể tìm thấy nó trong các chi tiết kỹ thuật IEEE cho ngôn ngữ lệnh shell Khớp các mẫu ký hiệu .

Sử dụng TortoiseSVN → Xóa để loại bỏ các tập tin và thư mục khỏi Subversion.

Khi bạn TortoiseSVN → Xóa một tập tin hoặc thư mục, nó được loại bỏ khỏi bản làm việc của bạn ngay lập tức cũng như được đánh dấu xóa khỏi kho trong lần cam kết tiếp theo. Thư mục mẹ của mục đó hiển thị một biểu tượng lớp phủ “được sửa đổi”. Cho tới khi bạn cam kết các thay đổi, bạn có thể lấy lại tập tin bằng cách dùng TortoiseSVN → Hoàn Nguyên trên thư mục mẹ.

Nếu bạn muốn xóa một mục khỏi kho lưu trữ, nhưng giữ nó tại địa phương như là một tập tin / thư mục không được phiên bản, sử dụng Trình đơn ngữ cảnh mở rộng → Xóa (giữ lại địa phương) . Bạn phải giữ phím Shift trong khi nhấp chuột phải vào mục trong cửa sổ danh sách thám hiểm (cửa sổ bên phải) để thấy điều này trong trình đơn ngữ cảnh mở rộng.

Nếu một mục được xóa thông qua explorer thay vì dùng trình đơn ngữ cảnh TortoiseSVN, hộp thoại cam kết hiển thị các mục này như đã mất và để bạn loại bỏ chúng khỏi kiểm soát phiên bản trước khi cam kết. Tuy nhiên, nếu bạn cập nhật bản làm việc, Subversion sẽ phát hiện mục bị mất và thay thế nó với phiên bản mới nhất từ kho. Nếu bạn cần xóa một tập tin được đánh phiên bản, luôn luôn sử dụng TortoiseSVN → Xóa để Subversion không phải đoán điều bạn thật sự muốn làm.

Nếu bạn muốn làm một đổi tên tại chỗ đơn giản của một tập tin hoặc thư mục, sử dụng Trình đơn ngữ cảnh → Đổi tên ... Nhập tên mới cho mục đó và bạn xem như xong.

Nếu bạn muốn di chuyển các tập tin vòng vòng bên trong bản sao làm việc của bạn, có lẽ đến một thư mục con khác, sử dụng xử lý chuột phải kéo-và-thả:

Một cách khác để di chuyển hoặc sao chép các tập tin là sử dụng lệnh Windows sao chép / cắt. Chọn các tập tin mà bạn muốn sao chép, nhấn chuột phải và chọn Trình Đơn Ngữ Cảnh → Sao chép từ trình đơn ngữ cảnh thám hiểm. Sau đó duyệt đến thư mục đích, nhấn chuột phải và chọn TortoiseSVN → Dán . Đối với các tập tin di chuyển, chọn Trình Đơn Ngữ Cảnh → Cắt thay vì Trình Đơn Ngữ Cảnh → Sao chép .

Bạn cũng có thể sử dụng trình duyệt kho để di chuyển các mục vòng vòng. Đọc phần “Trình duyệt Kho” để tìm hiểu thêm.

Nếu kho lưu trữ đã có hai tập tin có cùng tên nhưng khác nhau chỉ trong kiểu chữ (ví dụ: Test.txt và test.txt ), Bạn sẽ không thể cập nhật hoặc kiểm tra các thư mục cha trên một máy khách Windows. Trong khi Subversion hỗ trợ các trường hợp nhạy cảm kiểu chữ tên tập tin, Windows thì lại không.

Điều này đôi khi sẽ xảy ra khi hai người cam kết, từ các bản sao làm việc riêng biệt, các tập tin ngẫu nhiên có cùng tên, nhưng với khác biệt về kiểu chữ. Nó cũng có thể xảy ra khi tập tin được cam kết từ một hệ thống với một hệ thống tập tin phân biệt kiểu chữ hoa, như Linux.

Trong trường hợp đó, bạn phải quyết định một trong số chúng bạn muốn giữ và xóa (hoặc đổi tên) cái kia từ kho lưu trữ.

Đôi khi IDE thân thiện của bạn sẽ đổi tên tập tin cho bạn như là một phần của bài tập cấu trúc lại, và tất nhiên nó không báo cho Subversion. Nếu bạn cố gắng cam kết thay đổi của bạn, Subversion sẽ xem tên tập tin cũ như đã bị mất tích và tên mới như là một tập tin không phiên bản. Bạn chỉ có thể kiểm tra tên tập tin mới để có được nó được thêm vào, nhưng sau đó bạn sẽ mất truy tìm lịch sử, bởi Subversion không biết các tập tin có liên quan.

Một cách tốt hơn là để thông báo cho Subversion rằng sự thay đổi này thực sự là một đổi tên, và bạn có thể làm điều này trong hộp thoại Cam kết và Kiểm tra cho sửa đổi . Đơn giản chỉ cần chọn cả hai tên (mất tích) và tên mới (chưa phiên bản) và sử dụng Trình Đơn Ngữ Cảnh → Sửa chữa Di chuyển để ghép hai tập tin như đổi tên một.

Thông thường bạn đặt danh sách bỏ qua của bạn theo cách mà tất cả các tập tin được tạo ra được bỏ qua trong Subversion. Nhưng điều gì sẽ xảy ra nếu bạn muốn để xóa tất cả những mục được bỏ qua để sản xuất một bản xây dựng sạch? Thông thường, bạn sẽ thiết lập rằng trong makefile của bạn, nhưng nếu bạn gỡ rối các makefile, hoặc thay đổi hệ thống xây dựng nó rất hữu ích để có một cách để dọn dẹp các sàn.

TortoiseSVN chỉ cung cấp một tùy chọn sử dụng Trình Đơn Ngữ Cảnh mở rộng → Xóa mục chưa phiên bản ... . Bạn phải giữ Shift trong khi cách nhấp chuột phải vào một thư mục trong cửa sổ danh sách thám hiểm (cửa sổ bên phải) để thấy điều này trong trình đơn ngữ cảnh mở rộng. Điều này sẽ tạo ra một hộp thoại trong đó liệt kê tất cả các tập tin chưa phiên bản bất cứ nơi nào trong bản sao làm việc của bạn. Sau đó, bạn có thể chọn hoặc bỏ chọn các mục được gỡ bỏ.

Khi các hạng mục bị xóa, thùng rác được sử dụng, vì vậy nếu bạn phạm sai lầm ở đây và xóa một tập tin mà cần phải có được phiên bản, bạn vẫn có thể phục hồi nó.

Hình 4.37. Trang thuộc tính Subversion

Bạn có thể đọc và thiết lập các thuộc tính Subversion từ hộp thoại thuộc tính Windows, nhưng cũng từ TortoiseSVN → thuộc tính và trong danh sách tình trạng TortoiseSVN, từ Trình đơn ngữ cảnh → thuộc tính .

Bạn có thể thêm thuộc tính của riêng bạn, hoặc một số thuộc tính với ý nghĩa đặc biệt trong Subversion. Những cái này bắt đầu với svn: . svn: externals là một thuộc tính như vậy, xem làm thế nào để xử lý thành phần bên ngoài phần “Mục bên ngoài” .

For more information about properties in Subversion see the Special Properties.

Thêm và Chỉnh sửa các Thuộc tính

Hình 4.38. Thêm thuộc tính

Để thêm một thuộc tính mới, trước tiên nhấp vào Mới ... . Chọn tên thuộc tính yêu cầu từ trình đơn, và sau đó điền vào các thông tin cần thiết trong hộp thoại thuộc tính cụ thể. Những hộp thoại thuộc tính cụ thể được mô tả chi tiết hơn trong phần “Bộ Biên tập Thuộc tính” .

Để thêm một thuộc tính mà không có hộp thoại riêng của mình, chọn Nâng cao từ trình đơn Mới ... . Sau đó chọn một thuộc tính hiện có trong hộp kết hợp hoặc nhập một tên thuộc tính tùy chỉnh.

Nếu bạn muốn áp dụng một thuộc tính cho nhiều mục cùng một lúc, chọn các tập tin / thư mục trong thám hiểm, sau đó chọn Trình đơn ngữ cảnh → thuộc tính .

Nếu bạn muốn áp dụng các thuộc tính cho mỗi tập tin và thư mục trong hệ thống phân cấp bên dưới thư mục hiện hành, kiểm tra hộp kiểm Đệ quy .

Nếu bạn muốn chỉnh sửa một thuộc tính hiện có, lựa chọn thuộc tính từ danh sách các thuộc tính hiện có, sau đó nhấn vào Biên tập ... .

Nếu bạn muốn loại bỏ một thuộc tính hiện có, lựa chọn thuộc tính từ danh sách các thuộc tính hiện có, sau đó nhấn vào Loại bỏ .

Các thuộc tính svn:externals có thể được sử dụng để kéo các dự án khác từ cùng kho lưu trữ hoặc kho lưu trữ hoàn toàn khác nhau. Để biết thêm thông tin, đọc phần “Mục bên ngoài” .

Biên tập các thuộc tính tại bản sửa đổi HEAD

Bởi vì thuộc tính là được phiên bản, bạn không thể chỉnh sửa các thuộc tính của phiên bản trước. Nếu bạn nhìn vào thuộc tính từ hộp thoại đăng nhập, hoặc từ một phiên bản không phải HEAD trong trình duyệt kho lưu trữ, bạn sẽ thấy một danh sách các thuộc tính và giá trị, nhưng không có điều khiển biên tập.

TortoiseSVN có một vài thuộc tính đặc biệt của riêng mình, và những cái đó bắt đầu với tsvn:.

TortoiseSVN có thể tích hợp với một số công cụ theo dõi lỗi. Điều này sử dụng các thuộc tính dự án bắt đầu bằng bugtraq: . Đọc phần “Tích hợp với Hệ thống Theo dõi Lỗi / Trình theo dõi Vấn đ” để biết thêm thông tin.

Nó cũng có thể tích hợp với một số trình duyệt kho lưu trữ dựa trên web, sử dụng các thuộc tính dự án bắt đầu bằng webviewer: . Đọc phần “Tích hợp với các Trình Xem Kho Lưu Trữ dựa trên Web” để biết thêm thông tin.

Khi bạn thêm mới các thư mục con vào một bản sao làm việc bằng cách sử dụng TortoiseSVN, bất kỳ thuộc tính dự án có trong thư mục mẹ sẽ tự động được thêm vào thư mục con.

Một số thuộc tính phải sử dụng các giá trị cụ thể, hoặc được định dạng theo một cách cụ thể để có thể được sử dụng cho tự động hóa. Để giúp có các định dạng chính xác, TortoiseSVN trình bày các hộp thoại chỉnh sửa đối với một số thuộc tính đặc biệt cho thấy các giá trị có thể hoặc phá vỡ thuộc tính thành các thành phần cá nhân.

Nội dung bên ngoài

Hình 4.39. Trang thuộc tính svn: externals

Các svn: externals thuộc tính có thể được sử dụng để kéo các dự án khác từ cùng một kho lưu trữ hoặc từ kho lưu trữ hoàn toàn khác nhau như được mô tả trong phần “Mục bên ngoài” .

Bạn cần phải xác định tên của thư mục con mà các thư mục bên ngoài được kiểm xuất ra, và URL Subversion của các mục bên ngoài. Bạn có thể kiểm xuất một thành phần bên ngoài tại bản CHÍNH của nó, để khi mục trong kho lưu trữ bên ngoài thay đổi, bản sao làm việc của bạn sẽ nhận được những thay đổi đó lúc cập nhật. Tuy nhiên, nếu bạn muốn thành phần bên ngoài tham khảo một điểm cụ thể ổn định thì bạn có thể xác định phiên bản cụ thể để sử dụng. Trong trường hợp này, bạn cũng có thể muốn xác định cùng phiên bản như một phiên bản làm mốc. Nếu mục bên ngoài được đổi tên tại một thời điểm nào đó trong tương lai thì Subversion sẽ không thể cập nhật mục này trong bản sao làm việc của bạn. Bằng việc chỉ định một phiên bản mốc bạn nói với Subversion tìm một mục có tên đó ở sửa đổi mốc hơn là tại bản CHÍNH.

Nút bấm Tìm bản sửa đổi Chính nạp bản sửa đổi CHÍNH của mỗi URL ngoài và hiển thị bản sửa đổi CHÍNH đó trong cột tận cùng bên phải. Sau khi một bản sửa đổi CHÍNH được biết, một cú nhấp chuột phải đơn giản trên một thành phần ngoài cho bạn một lệnh để neo các thành phần ngoài vào bản sửa đổi CHÍNH rõ ràng của chúng. Trong trường hợp bản sửa đổi CHÍNH chưa được biết, lệnh nhấp chuột phải sẽ nạp bản sửa đổi CHÍNH trước.

Từ khóa SVN

Hình 4.40. Trang thuộc tính svn:keywords

Chọn từ khoá mà bạn muốn được mở rộng trong tập tin của bạn.

Kiểu EOL

Hình 4.41. Trang thuộc tính svn:eol-style

Chọn phong cách-cuối-dòng mà bạn muốn sử dụng và TortoiseSVN sẽ sử dụng đúng giá trị thuộc tính.

Tích hợp bộ theo dõi lỗi

Hình 4.42. Trang thuộc tính tsvn:bugtraq

Kích thước thông điệp tường trình

Hình 4.43. Kích thước của trang thuộc tính thông điệp tường trình

3 thuộc tính này điều khiển định dạng của các thông điệp tường trinhyf. 2 cái đầu tiên vô hiệu hóa OK trong hộp thoại cam kết hoặc khóa cho đến khi thông điệp đáp ứng được chiều dài tối thiểu. Vị trí biên hiện một dấu hiệu tại chiều rộng cột như là một hướng dẫn cho những dự án có giới hạn chiều rộng trên những thông điệp tường trình của chúng. Đặt giá trị bằng không sẽ xóa thuộc tính này.

Ngôn ngữ dự án

Hình 4.44. Trang thuộc tính ngôn ngữ

Chọn ngôn ngữ để sử dụng cho kiểm tra chính tả cho thông điệp tường trình trong hộp thoại cam kết. Hộp kiểm danh sách tập tin có hiệu lực khi bạn nhấp chuột phải trong cửa sổ thông điệp tường trình và chọn Dán danh sách tập tin. Theo mặc định, trạng thái Subversion sẽ được hiển thị bằng ngôn ngữ địa phương của bạn. Khi hộp này được kiểm, trạng thái luôn luôn được đưa ra bằng tiếng Anh, đối với các dự án có yêu cầu thông điệp ghi chỉ tiếng Anh.

MIME-type

Hình 4.45. trang thuộc tính svn:mime-type

svn:needs-lock

Hình 4.46. trang thuộc tính svn:needs-lock

Thuộc tính này chỉ đơn giản là kiểm soát xem một tập tin sẽ được kiểm tra ra là chỉ đọc nếu không có khóa được giữ cho nó trong bản sao làm việc.

svn:executable

Hình 4.47. trang thuộc tính svn:executable

Thuộc tính này điều khiển xem một tập tin sẽ được thực thi khi kiểm tra ra trên một hệ thống Unix / Linux. Nó không có hiệu lực khi kiểm tra ra trên Windows.

Các mẫu thông điệp hợp nhất

Khi các bản sửa đổi được hợp nhất vào bản làm việc, TortoiseSVN tạo ra một thông điệp tường trình từ các bản chỉnh sửa được hợp nhất. Những bản đó được cung cấp từ nút bấm Các Thông Điệp Gần Đây trong hộp thoại cam kết.

Bạn có thể tùy chỉnh thông điệp được sinh ra với các thuộc tính sau:

Hình 4.48. Các mẫu thông điệp tường trình cho hộp thoại thuộc tính

tsvn:mergelogtemplatetitle, tsvn:mergelogtemplatereversetitle

Thuộc tính này chỉ định phần đầu tiên của thông điệp tường trình được sinh ra. Các từ khóa sau có thể được dùng:

{revisions}

Một danh sách các bản chỉnh sửa được hợp nhất được phân cách bởi dấu phẩy, ví dụ: 3, 5, 6, 7

{revisionsr}

Giống như {revisions}, nhưng với mỗi bản sửa đổi được gắn phía trước với chữ r, ví dụ, r3, r5, r6, r7

{revrange}

Một danh sách các bản chỉnh sửa được hợp nhất được phân cách bởi dấu phẩy, được nhóm thành các phạm vi nếu có thể, ví dụ: 3, 5-7

{mergeurl}

URL nguồn của kết hợp, ví dụ, nơi từ đó các bản sửa đổi được kết hợp.

Giá trị mặc định cho chuỗi là Các bản sửa đổi được hợp nhất {revrange} từ {mergeurl}: với đánh dấu dòng mới ở cuối.

tsvn:mergelogtemplatemsg

Thuộc tính này chỉ định cách văn bản cho mỗi bản hợp nhất sẽ nhìn thế nào. Các từ khóa sau có thể được dùng:

{msg}

Thông điệp tường trình của bản sửa đổi được hợp nhất, như nó được nhập vào.

{msgoneline}

Giống như {msg}, nhưng tất cả các dòng mới được thay thế bởi khoảng trắng, để cho toàn bộ các thông điệp tường trình được hiện ra trên một dòng.

{author}

Tác giả của bản hợp nhất

{rev}

Bản thân bản chỉnh sửa được hợp nhất.

{bugids}

ID lỗi của bản hợp nhất, nếu có.

tsvn:mergelogtemplatemsgtitlebottom

This property specifies the position of the title string specified with the tsvn:mergelogtemplatetitle or tsvn:mergelogtemplatereversetitle. If the property is set to yes or true, then the title string is appended at the bottom instead of the top.

Quan trọng

Việc này chỉ làm được nếu các bản hợp nhất đã nằm trong bộ nhớ cache tường trình. Nếu bạn vô hiệu hóa cache tường trình hoặc không hiện tường trình trước đó, thông điệp sinh ra sẽ không chứa thông tin về các bản hợp nhất.

Hãy nói rằng bạn hãy kiểm xuất một bản sao làm việc của /project1 sang D:\dev\project1 . Chọn thư mục D:\dev\project1 , nhấp chuột phải và chọn Cửa sổ trình đơn → Thuộc tính từ trình đơn ngữ cảnh. Hộp thoại Thuộc Tính xuất hiện. Sau đó vào tab Subversion. Ở đó, bạn có thể thiết lập các thuộc tính. Nhấp vào Thuộc tính ... . Trong hộp thoại thuộc tính, hoặc nhấp đúp chuột vào svn:externals nếu nó đã tồn tại, hoặc nhấp vào nút Mới ... và chọn externals từ trình đơn. Để thêm vào một thành phần bên ngoài mới, nhấp vào Mới ... và sau đó điền vào các thông tin cần thiết trong hộp thoại hiển thị.

Nếu bạn muốn đường dẫn địa phương bao gồm các khoảng trống hoặc ký tự đặc biệt khác, bạn có thể đặt nó bên trong dấu ngoặc kép, hoặc bạn có thể sử dụng ký tự \ (Dấu gạch chéo ngược) như ký tự thoát kiểu phong cách Unix shell trước bất kỳ ký tự đặc biệt nào. Trong quá trình này cũng có nghĩa là bạn phải sử dụng / (Dấu gạch chéo) như một dấu phân cách đường dẫn. Lưu ý rằng hành vi này mới có trong Subversion 1.6 và sẽ không làm việc với các máy khách cũ.

Nếu dự án bên ngoài là trong cùng một kho lưu trữ, bất kỳ thay đổi bạn thực hiện sẽ được bao gồm trong danh sách cam kết khi bạn cam kết dự án chính của bạn.

If the external project is in a different repository, any changes you make to the external project will be shown or indicated when you commit the main project, but you have to commit those external changes separately.

Nếu bạn sử dụng các URL tuyệt đối svn:externals trong các định nghĩa và bạn có di chuyển bản sao làm việc của bạn (ví dụ, nếu URL của kho của bạn thay đổi), sau đó các thành phần bên ngoài của bạn sẽ không thay đổi và có thể không làm việc nữa.

Để tránh các vấn đề như vậy, máy khách Subversion phiên bản 1.5 và mới hơn hỗ trợ các URL bên ngoài tương đối. Bốn phương pháp khác nhau để chỉ định một URL tương đối được hỗ trợ. Trong các ví dụ sau đây, giả sử chúng ta có hai kho: một ở http://example.com/svn/repos-1 và một tại http://example.com/svn/repos-2. Chúng ta đã kiểm xuất http://example.com/svn/repos-1/project/trunk vào C:\Working và thuộc tính svn:externals được thiết lập trên thân.

You can also specify a peg and operative revision for the URL if required. To learn more about peg and operative revisions, please read the corresponding chapter in the Subversion book.

Nếu bạn cần thêm thông tin về làm cách nào TortoiseSVN xử lý các thuộc tính đọc phần “Thiết lập Dự án” .

Để tìm hiểu về các phương pháp khác nhau để truy cập các tiểu dự án chung hãy đọc phần “Bao gồm các tiểu dự án chung” .

Kể từ Subversion 1.6, bạn có thể thêm các thành phần bên ngoài trong một tập tin vào bản sao làm việc của bạn bằng cách sử dụng các cú pháp tương tự như đối với các thư mục. Tuy nhiên, có một số hạn chế.

Một tập tin bên ngoài cư xử giống như bất kỳ tập tin được phiên bản khác trong nhiều khía cạnh, nhưng chúng không thể được di chuyển hoặc xóa bằng cách sử dụng các lệnh bình thường, thay vào đó thuộc tính svn:externals phải được sửa đổi.

If you already have a working copy of the files or folders you want to include as externals in another working copy, you can simply add those via drag and drop from the windows explorer.

Simply right drag the file or folder from one working copy to where you want those to be included as externals. A context menu appears when you release the mouse button: SVN Add as externals here if you click on that context menu entry, the svn:externals property is automatically added. All you have to do after that is commit the property changes and update to get those externals properly included in your working copy.

Nếu bạn đã nhập khẩu dự án của bạn với cấu trúc thư mục được đề nghị, việc tạo ra một chi nhánh hoặc phiên bản thẻ là rất đơn giản:

Hình 4.49. Hộp tho Chi nhánh / Thẻ

Chọn các thư mục trong bản sao làm việc của bạn mà bạn muốn sao chép vào một chi nhánh hoặc thẻ, sau đó chọn lệnh TortoiseSVN → Chi nhánh/Thẻ... .

The default destination URL for the new branch will be the source URL on which your working copy is based. You will need to edit that URL to the new path for your branch/tag. So instead of

http://svn.collab.net/repos/ProjectName/trunk
      

you might now use something like

http://svn.collab.net/repos/ProjectName/tags/Release_1.10
      

If you can't remember the naming convention you used last time, click the button on the right to open the repository browser so you can view the existing repository structure.

Bây giờ bạn phải chọn nguồn của bản sao. Ở đây bạn có ba lựa chọn:

Nếu bạn muốn bản sao làm việc của bạn được chuyển sang chi nhánh mới được tạo ra tự động, sử dụng hộp kiểm Chuyển bản sao làm việc cho chi nhánh / thẻ mới . Nhưng nếu bạn làm điều đó, trước tiên hãy chắc chắn rằng bản sao làm việc của bạn không có chứa sửa đổi. Nếu có, những sửa đổi sẽ được sáp nhập vào các chi nhánh WC khi bạn chuyển đổi.

If your working copy has other projects included with svn:externals properties, those externals will be listed at the bottom of the branch/tag dialog. For each external, the target path and the source URL is shown.

If you want to make sure that the new tag always is in a consistent state, check all the externals to have their revisions pinned. If you don't check the externals and those externals point to a HEAD revision which might change in the future, checking out the new tag will check out that HEAD revision of the external and your tag might not compile anymore. So it's always a good idea to set the externals to an explicit revision when creating a tag.

The externals are automatically pinned to either the current HEAD revision or the working copy BASE revision, depending on the source of the branch/tag:

Nhấn OK để cam kết bản sao mới vào kho lưu trữ. Đừng quên cung cấp một thông điệp tường trình. Lưu ý rằng bản sao được tạo ra bên trong các kho lưu trữ .

Lưu ý rằng trừ khi bạn chọn để chuyển đổi bản sao làm việc của bạn sang chi nhánh mới được tạo ra, việc tạo ra một Chi nhánh hoặc Thẻ không ảnh hưởng đến bản sao làm việc của bạn. Ngay cả khi bạn tạo ra các chi nhánh từ WC của bạn, những thay đổi được cam kết vào chi nhánh mới, chứ không phải thân cây, vì vậy WC của bạn vẫn có thể được đánh dấu là sửa đổi đối với thân cây.

Bạn cũng có thể tạo ra một chi nhánh hoặc thẻ mà không có một bản sao làm việc. Để làm được điều đó, hãy mở trình duyệt kho. Bạn có thể kéo các thư mục đến một vị trí mới. Bạn phải giữ phím Ctrl trong khi bạn kéo lê để tạo một bản sao, nếu không thư mục sẽ được di chuyển, chứ không được sao chép.

Bạn cũng có thể kéo một thư mục với nút chuột phải. Một khi bạn thả chuột bạn có thể lựa chọn từ trình đơn ngữ cảnh là bạn muốn thư mục được di chuyển hoặc sao chép. Tất nhiên để tạo ra một chi nhánh hoặc thẻ bạn phải sao chép thư mục, chứ không di chuyển nó.

Tuy nhiên, có một cách khác là từ hộp thoại tường trình. Bạn có thể hiển thị hộp thoại tường trình ví dụ như thân cây, chọn một bản sửa đổi (hoặc là bản sửa đổi CHÍNH ở đầu hoặc một bản sửa đổi trước đó), nhấp chuột phải và chọn tạo chi nhánh / thẻ từ sửa đổi ... .

... Đó (không thực sự) là câu hỏi. Trong khi một kiểm xuất tải xuống mọi thứ từ chi nhánh mong muốn trong kho lưu trữ vào thư mục làm việc của bạn, TortoiseSVN → Chuyển đổi ... chỉ chuyển dữ liệu được thay đổi vào bản sao làm việc của bạn. Tốt cho tải mạng, tốt cho sự kiên nhẫn của bạn. :-)

Để có thể làm việc với chi nhánh hay thẻ mới được tạo ra bạn có nhiều cách để xử lý nó. Bạn có thể:

Hình 4.50. Hộp thoại Chuyển ổi

Mặc dù Subversion chính nó làm cho không có sự phân biệt giữa các thẻ và các nhánh, cách mà chúng được sử dụng thường khác nhau một chút.

Hình 4.51. Tình hướng dẫn Hợp nh - Chọn Phạm vi Sửa đổi

Trong mục Từ: nhập vào URL thư mục đầy đủ của chi nhánh hoặc thẻ có chứa các thay đổi mà bạn đưa đến bản sao làm việc của bạn. Bạn cũng có thể nhấp chuột vào ... để duyệt qua các kho lưu trữ và tìm những chi nhánh mong muốn. Nếu bạn đã sáp nhập từ chi nhánh này trước đó, thì chỉ cần sử dụng danh sách thả xuống cho thấy một lịch sử của các URL được sử dụng trước đó.

Nếu bạn đang hợp nhất từ một nhánh được đổi tên hoặc bị xóa thì bạn sẽ phải đi ngược đến bản chỉnh sửa mà nhánh đó vẫn tồn tại. Trong trường hợp này bạn cũng sẽ phải chỉ định bản chỉnh sửa như một bản mốc trong phạm vi các bản chỉnh sửa đang được hợp nhất (xem phía dưới), nếu không việc hợp nhất sẽ thất bài khi nó không thể tìm được đường dẫn đó tại bản CHÍNH.

Trong trường Phạm vi sửa đổi để hợp nhất nhập vào danh sách các phiên bản bạn muốn kết hợp. Đây có thể là một bản sửa đổi duy nhất, một danh sách các bản sửa đổi cụ thể cách nhau bằng dấu phẩy, hoặc một loạt các bản sửa đổi được phân cách bởi một dấu gạch ngang, hoặc bất kỳ sự kết hợp của những cái đó.

Nếu bạn cần phải chỉ định một bản sửa đổi peg cho hợp nhất, bổ sung sửa đổi peg vào cuối của các phiên bản, ví dụ như 5-7,10@3 . Trong ví dụ trên, các phiên bản 5,6,7 và 10 sẽ được sáp nhập, với 3 là bản sửa đổi peg.

Cách dễ nhất để chọn phạm vi các bản sửa đổi bạn cần là bấm vào Hiện Tường Trình , vì điều này sẽ liệt kê những thay đổi gần đây với lời bình tường trình của họ. Nếu bạn muốn kết hợp các thay đổi từ một phiên bản duy nhất, chỉ cần chọn sửa đổi đó. Nếu bạn muốn kết hợp thay đổi từ một số sửa đổi, thì chọn phạm vi đó (bằng cách sử dụng phím Shift -modifier). Nhấp vào OK và danh sách các số sửa đổi để hợp nhất sẽ được điền vào cho bạn.

Nếu bạn muốn kết hợp thay đổi trở lại ra khỏi bản sao làm việc của bạn, để quay lại một sự thay đổi đã được cam kết, lựa chọn các phiên bản để trở lại và chắc chắn rằng hộp kiểm Đảo ngược hợp nhất được ch.

Nếu bạn đã sáp nhập một số thay đổi từ chi nhánh này, hy vọng là bạn sẽ để lại lưu ý về việc sửa đổi cuối cùng được sáp nhập trong thông điệp tường trình khi bạn cam kết thay đổi. Trong trường hợp đó, bạn có thể sử dụng Hiện Tường Trình cho Bản Sao Làm Việc để theo dõi thông điệp tường trình. Nhớ rằng chúng ta đang nghĩ đến các bản sửa đổi như các tập hợp thay đổi, bạn Nên sử dụng bản sửa đổi sau khi các điểm cuối của việc hợp nhất cuối cùng như là điểm bắt đầu cho việc hợp nhất này. Ví dụ, nếu bạn đã hợp nhất các phiên bản 37-39 lần cuối cùng, thì các điểm bắt đầu cho hợp nhất này nên là sửa đổi 40.

Nếu bạn đang sử dụng tính năng theo dõi hợp nhất của Subversion, bạn không cần phải nhớ các bản sửa đổi đã được sáp nhập - Subversion sẽ ghi lại điều đó cho bạn. Nếu bạn bỏ trống phạm vi sửa đổi, tất cả các phiên bản chưa được sáp nhập sẽ được bao gồm. Đọc phần “Theo dõi hợp nh” để tìm hiểu thêm.

Khi theo dõi hợp nhất được sử dụng, hộp thoại tường trình sẽ hiển thị các bản sửa đổi hợp nhất trước đây, và các bản sửa đổi có ngày tháng trước điểm tổ tiên chung, tức là trước khi chi nhánh đã được sao chép, như đã được làm xám. Hộp kiểm Ẩn sửa đổi không hợp nhất được cho phép bạn lọc ra những bản sửa đổi hoàn toàn để bạn chỉ nhìn thấy các bản sửa đổi có thể được hợp nhất.

Nếu người khác có lẽ đang cam kết các thay đổi thì hãy cẩn thận về việc sử dụng bản sửa đổi CHÍNH. Nó có thể không đề cập đến bản sửa đổi bạn nghĩ nếu một người nào khác đã thực hiện một cam kết sau lần cập nhật cuối cùng của bạn.

If you leave the range of revisions empty or have the radio button all revisions checked, then Subversion merges all not-yet merged revisions. This is known as a reintegrate or automatic merge.

Có một số điều kiện áp dụng đối với một hợp nhất tái tích hợp. Thứ nhất, các máy chủ phải hỗ trợ theo dõi kết hợp. Bản sao làm việc phải có chiều sâu vô hạn (không có kiểm xuất thưa thớt), và nó không được có bất kỳ thay đổi địa phương, hạng mục bị chuyển hay hạng mục đã được cập nhật vào các bản sửa đổi khác không phải bản CHÍNH. Mọi thay đổi vào thân cây được thực hiện trong quá trình phát triển chi nhánh phải được sáp nhập qua chi nhánh (hoặc đánh dấu là đã được sáp nhập). Phạm vi các bản sửa đổi để hợp nhất sẽ được tính toán tự động.

Nhấp vào Tiếp theo và đi đến phần “Tùy Chọn Hợp Nhất” .

Hình 4.52. Trình hướng dẫn sáp nh - Sáp nhập cây

Nếu bạn đang sử dụng phương pháp này để hợp nhất một chi nhánh tính năng quay trở lại với thân cây, bạn cần phải chạy trình hướng dẫn hợp nhất từ ​​bên trong một bản sao hoạt động của thân cây.

Trong trường Từ: nhập vào URL thư mục đầy đủ của thân cây . Điều này nghe có vẻ sai, nhưng hãy nhớ rằng thân cây là điểm bắt đầu mà bạn muốn thêm vào những thay đổi chi nhánh. Bạn cũng có thể nhấp chuột vào ... để duyệt qua kho lưu trữ.

Trong trường Đến: nhập vào URL thư mục đầy đủ của chi nhánh tính năng.

Trong cả hai trường Từ Bản Sửa Đổi và Đến Bản Sửa Đổi , nhập số phiên bản cuối cùng mà hai cây đã được đồng bộ. Nếu bạn chắc chắn không ai khác đã thực hiện cam kết, bạn có thể sử dụng bản sửa đổi CHÍNH trong cả hai trường hợp. Nếu có một khả năng mà một người nào đó có thể thực hiện một cam kết kể từ khi đồng bộ hóa, sử dụng số phiên bản cụ thể để tránh mất các cam kết gần đây.

Bạn cũng có thể sử dụng Hiện Tường Tr để lựa chọn sửa đổi.

Trang này của trình hướng dẫn cho phép bạn chỉ định các tùy chọn nâng cao, trước khi bắt đầu quá trình hợp nhất. Hầu hết thời gian bạn có thể chỉ sử dụng các thiết lập mặc định.

Bạn có thể chỉ định chiều sâu để sử dụng cho hợp nhất, tức là hợp nhất nên đi sâu như thế nào xuống bản sao làm việc của bạn. Các điều khoản độ sâu sử dụng được mô tả trong phần “Độ sâu Kiểm xu” . Độ sâu mặc định là Bản sao làm việc , trong đó sử dụng các thiết lập độ sâu hiện tại, và hầu như luôn luôn là những gì bạn muốn.

Most of the time you want merge to take account of the file's history, so that changes relative to a common ancestor are merged. Sometimes you may need to merge files which are perhaps related, but not in your repository. For example you may have imported versions 1 and 2 of a third party library into two separate directories. Although they are logically related, Subversion has no knowledge of this because it only sees the tarballs you imported. If you attempt to merge the difference between these two trees you would see a complete removal followed by a complete add. To make Subversion use only path-based differences rather than history-based differences, check the Ignore ancestry box. Read more about this topic in the Subversion book, Noticing or Ignoring Ancestry.

Bạn có thể chỉ định cách mà dòng kết thúc và thay đổi khoảng trắng được xử lý. Các tùy chọn này được mô tả trong phần “Tùy chọn cho Hêt-Dòng và Khoảng Trắng” . Các hành vi mặc định là để điều trị tất cả các sự khác biệt khoảng trắng và cuối dòng như thay đổi thực sự cần được sáp nhập.

Hộp kiểm được đánh dấu Buộc thực hiện hợp nhất được sử dụng để tránh một cuộc xung đột cây khi một việc xóa ảnh hưởng đến một tập tin được sửa đổi tại địa phương hay hòan toàn không được đánh phiên bản. Nếu tập tin này bị xóa thì không có cách nào để khôi phục lại nó, đó là lý do tại sao tùy chọn này không được chọn theo mặc định.

Nếu bạn đang sử dụng theo dõi kết hợp và bạn muốn đánh dấu một phiên bản đã được sáp nhập, mà không thực sự làm việc hợp nhất ở đây, kiểm tra hộp kiểm Chỉ ghi lại các hợp nhất . Có hai lý do có thể bạn có thể muốn làm điều này. Nó có thể là hợp nhất như vậy là quá phức tạp đối với các thuật toán hợp nhất, vì vậy bạn viết mã thay đổi bằng tay, sau đó đánh dấu sự thay đổi như sáp nhập để các thuật toán theo dõi hợp nhất nhận thức được nó. Hoặc bạn có thể muốn ngăn chặn một phiên bản nào đó khỏi bị sáp nhập. Đánh dấu nó như đã được sáp nhập sẽ ngăn chặn việc hợp nhất xảy ra với các chương trình khách biết theo dõi kết hợp.

Bây giờ tất cả mọi thứ được thiết lập, tất cả những gì bạn phải làm là nhấp vào nút Hợp nhất . Nếu bạn muốn xem trước kết quả Kiểm Tra Hợp Nhất mô phỏng các hoạt động hợp nhất, nhưng hoàn toàn không sửa đổi các bản sao làm việc. Nó cho bạn thấy một danh sách các tập tin mà sẽ được thay đổi bằng một hợp nhất thực sự, và ghi chú các tập tin mà mâu thuẫn có thể xảy ra. Do việc theo dõi kết hợp làm cho quá trình hợp nhất phức tạp hơn rất nhiều, không có cách nào bảo đảm có thể tìm hiểu trước xem việc hợp nhất sẽ hoàn thành mà không có xung đột, do đó, các tập tin đánh dấu là mâu thuẫn trong một kiểm tra hợp nhất về thực tế có thể hợp nhất mà không có bất kỳ vấn đề.

The merge progress dialog shows each stage of the merge, with the revision ranges involved. This may indicate one more revision than you were expecting. For example if you asked to merge revision 123 the progress dialog will report “ Merging revisions 122 through 123 ”. To understand this you need to remember that Merge is closely related to Diff. The merge process works by generating a list of differences between two points in the repository, and applying those differences to your working copy. The progress dialog is simply showing the start and end points for the diff.

Hợp nhất bây giờ là hoàn tất. Đó là một ý tưởng tốt để có một cái nhìn vào việc hợp nhất và xem nếu nó có như mong đợi không. Hợp nhất thường là khá phức tạp. Xung đột thường xảy ra nếu chi nhánh đã trôi dạt xa thân cây.

Đối với các máy khách và máy chủ Subversion trước 1.5, không có thông tin sáp nhập nào được lưu trữ và sửa đổi được sáp nhập phải được theo dõi bằng tay. Khi bạn đã thử nghiệm những thay đổi và đi đến cam kết sửa đổi này, thông điệp tường trình cam kết của bạn nên luôn luôn bao gồm các số sửa đổi đã được chuyển trong hợp nhất. Nếu bạn muốn áp dụng một hợp nhất tại một thời gian sau đó bạn sẽ cần phải biết những gì bạn đã sáp nhập, bởi bạn không muốn chuyển đổi một thay đổi nhiều hơn một lần. Để biết thêm thông tin về điều này, hãy tham khảo Thực tiễn Tốt nhất cho sáp nhập trong cuốn sách Subversion.

Nếu máy chủ của bạn và tất cả các máy khách đang chạy Subversion 1.5 hoặc cao hơn, hỗ trợ theo dõi kết hợp sẽ ghi lại các bản sửa đổi được sáp nhập và tránh việc một bản sửa đổi sáp nhập nhiều hơn một lần. Điều này làm cho cuộc sống của bạn đơn giản hơn nhiều khi bạn chỉ đơn giản là có thể hợp nhất toàn bộ phạm vi sửa đổi mỗi lần và biết rằng chỉ phiên bản mới sẽ thực sự được sáp nhập.

Quản lý chi nhánh là quan trọng. Nếu bạn muốn giữ cho chi nhánh này được cập nhật với thân cây, bạn nên chắc chắn là kết hợp thường xuyên để chi nhánh và thân cây không trôi quá xa nhau. Tất nhiên, bạn vẫn nên tránh lặp đi lặp lại kết hợp những thay đổi, như được giải thích ở trên.

Subversion 1.5 giới thiệu các hỗ trợ cho theo dõi hợp nhất. Khi bạn hợp nhất các thay đổi từ một cây khác, những con số sửa đổi sáp nhập được lưu trữ và thông tin này có thể được sử dụng cho nhiều mục đích khác nhau.

Thông tin theo dõi hợp nhất được lưu trữ trong thuộc tính svn:mergeinfo của máy khách khi thực hiện một hợp nhất. Khi hợp nhất được cam kết máy chủ lưu thông tin đó trong một cơ sở dữ liệu, và khi bạn yêu cầu thông tin hợp nhất, tường trình hoặc đổ lỗi, máy chủ có thể trả lời một cách thích hợp. Để cho hệ thống làm việc đúng cách, bạn phải đảm bảo rằng các máy chủ, kho lưu trữ và tất cả các máy khách được nâng cấp. Các máy khách cũ hơn sẽ không lưu trữ thuộc tính svn:mergeinfo và máy chủ cũ hơn sẽ không cung cấp các thông tin theo yêu cầu của máy khách mới.

Tìm hiểu thêm về theo dõi hợp nhất từ Subversion Tài liệu về theo dõi việc hợp nhất.

Merging does not always go smoothly. Sometimes there is a conflict. TortoiseSVN helps you through this process by showing the merge conflict dialog.

Hình 4.53. The Merge Conflict Dialog

It is likely that some of the changes will have merged smoothly, while other local changes conflict with changes already committed to the repository. All changes which can be merged are merged. The Merge Conflict dialog gives you different ways of handling the lines which are in conflict.

For normal conflicts that happen due to changes in the file content or its properties, the dialog shows buttons which allow you to chose which of the conflicting parts to keep or reject.

If there's a tree conflict, please first see phần “Mâu Thuẫn Cây” about the various types of tree conflicts and how and why they can happen.

To resolve tree conflicts after a merge, a dialog is shown with various options on how to resolve the conflict:

Hình 4.54. The Merge Tree Conflict Dialog

Since there are various possible tree conflict situations, the dialog will show buttons to resolve those depending on the specific conflict. The button texts and labels explain what the option to resolve the conflict does. If you're not sure, either cancel the dialog or use the Postpone button to resolve the conflict later.

Khi bạn phát triển một tính năng mới trên một nhánh riêng biệt, nó là một ý tưởng tốt để làm ra một chính sách tái tích hợp khi tính năng được hoàn tất. Nếu công việc khác đang xảy đồng thời ra trong thân cây bạn có thể thấy sự khác biệt đáng kể theo thời gian, và hợp nhất trở lại biến thành một cơn ác mộng.

Nếu tính năng là tương đối đơn giản và phát triển sẽ không mất nhiều thời gian thì bạn có thể áp dụng một phương pháp đơn giản, để giữ cho chi nhánh hoàn toàn riêng biệt cho đến khi tính năng này hoàn tất, sau đó hợp nhất các thay đổi chi nhánh trở lại vào thân cây. Trong trình hướng dẫn hợp nhất việc này sẽ đơn giản là Hợp nhất một loạt các sửa đổi , với phạm vi sửa đổi là khoảng sửa đổi của chi nhánh.

Nếu tính năng này sẽ mất nhiều thời gian và bạn cần vào tài khoản cho những thay đổi trong thân cây , thì bạn cần phải giữ cho chi nhánh đồng bộ. Điều này đơn giản chỉ có nghĩa là định kỳ, bạn hợp nhất các thay đổi thân cây vào chi nhánh, do đó chi nhánh có chứa tất cả các thay đổi thân cộng thêm tính năng mới. Quá trình đồng bộ sử dụng Hợp nhất một loạt các sửa đổi . Khi tính năng hoàn tất, sau đó bạn có thể kết hợp nó trở lại thân cây bằng cách sử dụng Tái tích hợp một chi nhánh hoặc Hợp nhất hai cây khác nhau .

Another (fast) way to merge all changes from trunk to the feature branch is to use the TortoiseSVN → Merge all... from the extended context menu (hold down the Shift key while you right click on the file).

Hình 4.55. The Merge-All Dialog

This dialog is very easy. All you have to do is set the options for the merge, as described in phần “Tùy Chọn Hợp Nhất”. The rest is done by TortoiseSVN automatically using merge tracking.

Theo mặc định, không có gì là bị khóa và bất cứ ai có quyền truy cập cam kết có thể cam kết những thay đổi ở bất kỳ tập tin vào bất cứ lúc nào. Những người khác sẽ cập nhật bản sao làm việc của họ định kỳ và thay đổi trong kho sẽ được sáp nhập với những thay đổi địa phương.

Nếu bạn Nhận được một khóa trên một tập tin, thì chỉ có bạn có thể cam kết tập tin đó. Cam kết của tất cả các người dùng khác sẽ bị chặn cho đến khi bạn phát hành khóa. Một tập tin bị khóa không thể được sửa đổi trong bất kỳ cách nào trong kho, vì vậy nó không thể bị xóa hay đổi tên hoặc, ngoại trừ b chủ sở hữu khóa.

Tuy nhiên, những người dùng khác sẽ không nhất thiết phải biết rằng bạn đã lấy khóa ra. Trừ khi họ kiểm tra tình trạng khóa thường xuyên, việc đầu tiên mà họ sẽ biết về nó là khi cam kết của họ thất bại, mà trong nhiều trường hợp không phải là rất hữu ích. Để làm cho nó dễ dàng hơn để quản lý ổ khóa, có một thuộc tính Subversion mới svn:needs-lock . Khi thuộc tính này được thiết lập (với bất kỳ giá trị nào) trên một tập tin, bất cứ khi nào tập tin được kiểm xuất hoặc cập nhật, các bản sao địa phương được đặt chỉ đọc trừ khi bản sao làm việc đó nắm giữ khóa cho tập tin đó. Điều này hoạt động như một lời cảnh báo rằng bạn không nên chỉnh sửa tập tin đó trừ khi bạn lấy khóa trước. Các tập tin này được phiên bản và được đánh dấu chỉ đọc bằng một lớp phủ đặc biệt trong TortoiseSVN để cho biết rằng bạn cần phải có được khóa trước khi biên t.

Các khóa được ghi lại bằng vị trí bản sao làm việc cũng như chủ sở hữu. Nếu bạn có nhiều bản sao làm việc (ở nhà, tại nơi làm việc) thì bạn chỉ có thể giữ một khóa ở một trong những bản sao làm việc đ.

Nếu một trong những đồng nghiệp của bạn có được một khóa và sau đó đi vào kỳ nghỉ mà không phát hành nó, bạn sẽ làm gì? Subversion cung cấp một phương tiện để các ép buộc ổ khóa. Phát hành một khóa giữ bởi người khác được gọi là Phá vỡ khóa, và ép buộc có được một khóa mà người khác đã giữ được gọi là Trộm cắp khóa. Đương nhiên đây không phải là điều bạn nên coi nhẹ nếu bạn muốn vẫn là bạn bè với các đồng nghiệp.

Các khóa được ghi lại trong kho, và một mã thông báo khóa được tạo ra trong bản sao của bạn làm việc tại địa phương. Nếu có sự khác biệt, ví dụ nếu một người nào khác đã phá vỡ khóa, mã thông báo khóa địa phương trở thành không hợp lệ. Kho luôn luôn là tham khảo cuối cùng.

Chọn tập tin trong bản sao làm việc của bạn mà bạn muốn lấy khóa, sau đó chọn lệnh TortoiseSVN → Nhận Khóa ... .

Hình 4.56. Hộp thoại khóa

Một hộp thoại xuất hiện, cho phép bạn nhập một bình luận, để những người khác có thể thấy lý do tại sao bạn đã khóa tập tin. Bình luận là tùy chọn và chỉ được sử dụng với các kho dựa trên Svnserve. Nếu (và chỉ nếu) bạn cần phải ăn cắp khóa từ một người nào khác, chọn hộp kiểm Ăn cắp khóa , sau đó nhấn vào OK .

Bạn có thể bật thuộc tính dự án tsvn:logtemplatelock để cung cấp một mẫu thông điệp cho người dùng để điền vào như thông điệp khóa. Tham khảo phần “Thiết lập Dự án” để được hướng dẫn làm thế nào để b các thuộc tính.

Nếu bạn chọn một thư mục và sau đó sử dụng TortoiseSVN → Nhận Khóa ... hộp thoại khóa sẽ mở ra với mỗi tập tin trong mỗi thư mục con được chọn để khóa. Nếu bạn thực sự muốn khóa toàn bộ một hệ thống phân cấp, đó là cách để làm điều đó, nhưng bạn có thể trở nên rất không được ưa thích với các đồng nghiệp nếu bạn khóa họ ra khỏi toàn bộ dự án. Sử dụng cẩn th ...

Để chắc chắn rằng bạn không quên phát hành một khóa bạn không còn cần nữa, tập tin bị khóa được hiển thị trong hộp thoại cam kết và được lựa chọn theo mặc định. Nếu bạn tiếp tục với cam kết, các khóa bạn giữ trên các tập tin được lựa chọn được loại bỏ, ngay cả nếu các tập tin không được sửa đổi. Nếu bạn không muốn phát hành một khóa trên các tập tin nào đó, bạn có thể bỏ chọn chúng (nếu chúng không bị sửa đổi). Nếu bạn muốn giữ khóa trên một tập tin bạn đã sửa đổi, bạn phải kích hoạt hộp kiểm Giữ khóa trước khi bạn cam kết các thay đổi của bạn.

Để phát hành một khóa theo cách thủ công, chọn các tập tin trong bản sao làm việc của bạn mà bạn muốn phát hành các khóa, sau đó chọn lệnh TortoiseSVN → Phát hành Khóa Không có gì hơn nữa để nhập vì thế TortoiseSVN sẽ liên lạc với các kho lưu trữ và phát hành các ổ khóa. Bạn cũng có thể sử dụng lệnh này vào một thư mục để phát hành tất cả các ổ khóa theo cách đệ quy.

Hình 4.57. Hộp thoại Kiểm tra Sửa đổi

Để xem những khóa nào mà bạn và những người khác giữ, bạn có thể sử dụng TortoiseSVN → Kiểm tra sửa đổi ... . Các mã khóa tại địa phương hiển thị ngay lập tức. Để kiểm tra cho các ổ khóa được giữ bởi những người khác (và để xem nếu có ổ khóa nào của bạn bị phá vỡ hoặc bị đánh cắp), bạn cần phải bấm vào Kiểm tra Kho .

Từ trình đơn ngữ cảnh ở đây, bạn cũng có thể nhận được và phát hành ổ khóa, cũng như phá vỡ và ăn cắp các khóa được tổ chức bởi những người khác.

Như đã đề cập ở trên, cách hiệu quả nhất để sử dụng khóa là bật thuộc tính svn:needs-lock trên các tập tin. Tham khảo phần “Thiết lập Dự án” để được hướng dẫn làm thế nào để bật các thuộc tính. Tập tin với thuộc tính này được bật sẽ luôn luôn được kiểm tra và cập nhật với cờ chỉ đọc trừ khi bản sao của bạn làm việc nắm giữ một khóa.

Xin nhắc lại, TortoiseSVN sử dụng một lớp phủ đặc biệt để cho biết điều này.

Nếu bạn điều hành một chính sách mà tất cả các tập tin bị khóa thì bạn có thể tìm thấy nó dễ dàng hơn để sử dụng tính năng auto-props của Subversion để thiết lập thuộc tính tự động mỗi khi bạn thêm các tập tin mới. Đọc phần “Thiết lập thuộc tính tự động” để biết thêm thông tin.

Khi bạn tạo một kho lưu trữ mới với Subversion 1.2 hoặc cao hơn, bốn mẫu hook được tạo ra ở thư mục hooks trong kho. Chúng được gọi là trước và sau khi nhận được một khóa, và trước và sau khi phát hành một khóa.

Đó là một ý tưởng tốt để cài đặt một kịch bản hook sau-khóa và sau-mở khóa trên máy chủ mà sẽ gửi email cho thấy các tập tin đã bị khóa. Với một kịch bản tại chỗ, tất cả người dùng của bạn có thể được thông báo nếu ai đó khóa / mở khóa một tập tin. Bạn có thể tìm thấy một kịch bản móc ví dụ tại hooks/post-lock.tmpl trong thư mục kho lưu trữ của bạn.

Bạn cũng có thể sử dụng móc để không cho phép phá vỡ hoặc ăn cắp ổ khóa, hoặc có thể hạn chế nó đến một quản trị viên được chỉ định. Hoặc có thể bạn muốn gửi email cho chủ sở hữu khi một trong những ổ khóa của họ bị phá vỡ hoặc bị đánh cắp.

Đọc phần “kịch bản móc phía máy chủ” để tìm hiểu thêm.

Trước tiên, bạn cần phải thực hiện và thử nghiệm các thay đổi của bạn. Sau đó thay vì sử dụng TortoiseSVN → Cam kết ... trên thư mục mẹ, bạn chọn TortoiseSVN → Tạo Bản Vá ...

Hình 4.58. Hộp thoại Tạo Bản Vá

bây giờ bạn có thể chọn các tập tin bạn muốn đưa vào bản vá, cũng giống như bạn làm với một cam kết đầy đủ. Việc này sẽ tạo ra một tập tin duy nhất có chứa một bản tóm tắt của tất cả các thay đổi bạn đã thực hiện trong các tập tin được chọn kể từ khi lần cập nhật cuối từ ​​kho.

Các cột trong hộp thoại này có thể được tùy chỉnh trong cùng một cách như các cột trong hộp thoại Kiểm tra để sửa đổi . Đọc phần “Trạng thái địa phương và từ xa” để biết thêm chi tiết.

Bằng cách nhấp vào nút Tùy chọn , bạn có thể xác định bản vá lỗi được tạo ra như thế nào. Ví dụ, bạn có thể xác định rằng những thay đổi trong các kết thúc dòng hay khoảng trắng không được bao gồm trong các tập tin vá lỗi cuối cùng.

Bạn có thể tạo ra các bản vá lỗi riêng biệt có chứa các thay đổi đối với các tập hợp tập tin khác nhau. Tất nhiên, nếu bạn tạo ra một tập tin bản vá, thực hiện thêm vài thay đổi đến cùng các tập tin và sau đó tạo ra một bản vá khác, tập tin vá lỗi thứ hai sẽ bao gồm cả hai tập h thay đổi.

Chỉ cần lưu tập tin bằng cách sử dụng một tên tập tin do bạn lựa chọn. Các tập tin vá lỗi có thể có bất kỳ phần mở rộng mà bạn thích, nhưng theo quy ước, họ nên sử dụng phần mở rộng .patch hoặc .diff . Bây giờ bạn đã sẵn sàng để n tập tin bản vá của bạn.

Bạn cũng có thể lưu các bản vá vào clipboard thay vì vào một tập tin. Bạn có thể muốn làm điều này để bạn có thể dán nó vào một thư điện tử để xem xét bởi những người khác. Hoặc nếu bạn có hai bản sao làm việc trên một máy và bạn muốn chuyển giao thay đổi từ một bản đến bản khác, một bản vá lỗi trong clipboard là một cách thuận tiện để làm điều này.

Nếu bạn thích, bạn có thể tạo một tập tin bản vá từ bên trong hộp thoại Cam kết hoặc Kiểm tra cho sửa đổi . Chỉ cần chọn các tập tin và sử dụng các mục trình đơn ngữ cảnh để tạo ra một bản vá từ những tập tin. Nếu bạn muốn xem hộp thoại Tùy chọn , bạn phải giữ shift khi bạn nhấp chuột phải .

Các tập tin vá lỗi được áp dụng vào bản sao làm việc của bạn. Điều này nên được thực hiện từ cấp độ thư mục tương tự như đã được sử dụng để tạo ra các bản vá. Nếu bạn không chắc chắn việc này là gì, chỉ cần nhìn vào dòng đầu tiên của các tập tin vá lỗi. Ví dụ, nếu tập tin đầu tiên đang được làm việc là doc/source/english/chapter1.xml và dòng đầu tiên trong các tập tin vá lỗi là Index: english/chapter1.xml thì bạn cần phải áp dụng các bản vá vào thư mục doc/source/ . Tuy nhiên, giả sử là bạn đang ở trong bản sao làm việc đúng, nếu bạn chọn cấp độ thư mục sai, TortoiseSVN sẽ thông báo và đề nghị mức độ chính xác.

Để áp dụng một tập tin bản vá vào bản sao làm việc của bạn, bạn cần phải có ít nhất là truy cập đọc vào kho lưu trữ. Lý do cho điều này là chương trình hợp nhất phải tham khảo các thay đổi trở lại bản sửa đổi mà đã được thực hiện bởi nhà phát triển từ xa.

Từ trình đơn ngữ cảnh cho thư mục đó, nhấp chuột vào TortoiseSVN → Áp dụng bản vá... Việc này sẽ mang đến một hộp thoại mở tập tin cho phép bạn chọn tập tin vá lỗi để áp dụng. Mặc định, chỉ có tập tin .patch hoặc .diff được hiển thị, nhưng bạn có thể lựa chọn “ Tất cả các tập tin ”. Nếu bạn trước đó đã lưu một bản vá vào clipboard, bạn có thể sử dụng Mở từ clipboard ... trong hộp thoại mở tập tin. Lưu ý rằng tùy chọn này chỉ xuất hiện nếu bạn đã lưu các bản vá vào clipboard bằng cách sử dụng TortoiseSVN → Tạo bản vá... . Sao chép một bản vá vào clipboard từ ứng dụng khác sẽ không làm cho nút bấm này xuất hiện.

Cách khác, nếu các tập tin vá lỗi có phần mở rộng .patch hoặc .diff , bạn có thể nhấp chuột phải vào nó trực tiếp và chọn TortoiseSVN → Áp dụng bản vá ... . Trong trường hợp này, bạn sẽ được nhắc nhở để nhập vào vị trí một bản sao làm việc.

Hai phương pháp này chỉ cung cấp các cách khác nhau để làm làm cùng một chuyện. Với phương pháp đầu tiên, bạn chọn WC và duyệt đến tập tin vá lỗi. Với cách thứ hai bạn chọn tập tin vá lỗi và duyệt đến WC.

Một khi bạn đã lựa chọn các tập tin vá lỗi và vị trí bản sao làm việc, TortoiseMerge sẽ chạy để hợp nhất các thay đổi từ tập tin vá lỗi với bản sao làm việc của bạn. Một cửa sổ nhỏ liệt kê các tập tin đã được thay đổi. Lần lượt kích đúp vào mỗi tập tin, xem xét những thay đổi và lưu các tập tin đã được hợp nhất.

Bản vá của các nhà phát triển từ xa đã được áp dụng vào bản sao làm việc của bạn, vì vậy bạn cần phải cam kết để cho phép tất cả mọi người khác được truy cập vào thay đổi từ kho lưu trữ.

Hình 4.59. Chú Thích / Hộp Thaọi Đổ Lỗi

Nếu bạn không quan tâm đến thay đổi từ các phiên bản trước đó, bạn có thể thiết lập bản sửa đổi để từ đó bắt đầu đổ lỗi. Thiết lập nó thành 1 , nếu bạn muốn đổ lỗi cho m sửa đổi.

Theo mặc định tập tin lỗi được xem bằng cách sử dụng TortoiseBlame , trong đó làm nổi rõ các phiên bản khác nhau để làm cho nó dễ đọc hơn. Nếu bạn muốn in hay chỉnh sửa các tập tin lỗi, chọn Sử dụng trình xem Văn Bản để xem đổ lỗi .

Bạn có thể chỉ định cách mà các thay đổi kết thúc dòng và khoảng trắng được xử lý. Các tùy chọn này được mô tả trong phần “Tùy chọn cho Hêt-Dòng và Khoảng Trắng” . Hành vi mặc định là để xư lý tất cả các sự khác biệt khoảng trắng và cuối dòng như là thay đổi thực sự, nhưng nếu bạn muốn bỏ qua một sự thay đổi thụt đầu dòng và tìm ra tác giả ban đầu, bạn có thể chọn một tùy chọn thích hợp ở đây.

Bạn có thể bao gồm thông tin hợp nhất nếu bạn muốn, mặc dù tùy chọn này có thể mất đáng kể nhiều thời gian hơn để lấy từ máy chủ. Khi các dòng được sáp nhập từ một nguồn khác, thông tin đổ lỗi cho thấy bản sửa đổi mà thay đổi đã được thực hiện trong nguồn nguyên thủy cũng như bản sửa đổi khi nó được sáp nhập vào tập tin này.

Once you press OK TortoiseSVN starts retrieving the data to create the blame file. Once the blame process has finished the result is written into a temporary file and you can view the results.

Hình 4.60. TortoiseBlame

TortoiseBlame, được bao gồm với TortoiseSVN, làm cho việc đổ lỗi cho tập tin dễ đọc hơn. Khi bạn di chuyển chuột trên một dòng trong cột thông tin đổ lỗi, tất cả các dòng với cung bản sửa đổi được hiển thị với một nền tối hơn. Các dòng từ các phiên bản khác đã được thay đổi bởi cùng một tác giả được thể hiện với một nền sáng. Màu sắc có thể làm việc không rõ ràng nếu bạn đặt màn hình của bản ở chế độ 256 màu.

Nếu bạn nhấp chuột trái trên một dòng, tất cả các dòng cùng bản sửa đổi được làm nổi, và các dòng từ các phiên bản khác của cùng tác giả được làm nổi trong một màu sáng hơn. Việc làm nổi bật này là dính, cho phép bạn di chuyển chuột mà không làm mất những nổi bật. Nhấp vào vào sửa đổi đó một lần nữa để tắt nổi bật.

Các ý kiến ​​sửa đổi (thông điệp tường trình) được thể hiện trong một hộp gợi ý bất cứ khi nào chuột di chuyển lên cột thông tin đổ lỗi. Nếu bạn muốn sao chép các thông điệp tường trình cho bản sửa đổi đó, sử dụng trình đơn ngữ cảnh xuất hiện khi bạn kích chuột phải vào cột thông tin đổ lỗi đ.

Bạn có thể tìm kiếm trong các báo cáo đổ lỗi sử dụng Biên tập → Tìm kiếm... . Điều này cho phép bạn tìm kiếm các số sửa đổi, tác giả và nội dung của tập tin. Thông điệp tường trình không được bao gồm trong tìm kiếm - bạn nên sử dụng Hộp thoại Tường trình để tìm kiếm những cái đ.

Bạn cũng có thể nhảy đến một dòng cụ thể bằng cách sử dụng Biên tập → Đi đến dòng ... .

Khi chuột nằm trên các cột thông tin đổ lỗi, một trình đơn ngữ cảnh có sẵn giúp so sánh các phiên bản và kiểm tra lịch sử, bằng cách sử dụng số phiên bản của dòng dưới con chuột như là một tài liệu tham khảo. Trình đơn ngữ cảnh → Đổ lỗi cho sửa đổi trước tạo ra một báo cáo đổ lỗi cho cùng một tập tin, nhưng sử dụng bản sửa đổi trước đó làm giới hạn trên. Điều này cung cấp cho bạn báo cáo đổ lỗi cho tình trạng của tập tin ngay trước dòng bạn đang nhìn vào được thay đổi lần cuối. Trình đơn ngữ cảnh → Hiển thị những thay đổi chạy trình xem khác biệt của bạn, hiển thị cho bạn những gì thay đổi trong phiên bản tham chiếu. Trình đơn ngữ cảnh → Hiện tường trình hiển thị hộp thoại đăng nhập sửa đổi bắt đầu với bản sửa đổi được tham chiếu.

Nếu bạn cần một chỉ dấu hình ảnh tốt hơn của những thay đổi lâu đời nhất và mới nhất, chọn Xem → Màu tuổi của dòng . Điều này sẽ sử dụng một màu sắc với độ chuyển đậm nhạt để hiển thị dòng mới trong các đường màu đỏ và dòng cũ trong màu xanh. Các màu mặc định là khá nhẹ, nhưng bạn có thể thay đổi nó bằng cách sử dụng các thiết lập của TortoiseBlame.

Nếu bạn đang sử dụng Theo Dõi Hợp Nhất và yêu cầu thông tin hợp nhất khi bắt đầu đổ lỗi, các dòng bị sáp nhập được thể hiện hơi khác nhau. Khi một dòng đã thay đổi do kết quả hợp nhất từ đường dẫn khác, TortoiseBlame sẽ hiển thị bản sửa đổi và tác giả của thay đổi mới nhất trong các tập tin ban đầu chứ không phải là bản sửa đổi nơi việc hợp nhất đã diễn ra. Những dòng này được thể hiện bằng cách hiển thị các sửa đổi và tác giả trong chữ in nghiêng. Bản sửa đổi nơi hợp nhất đã diễn ra được hiển thị một cách riêng biệt trong tooltip khi bạn di chuyển chuột lên các cột thông tin đổ lỗi. Nếu bạn không muốn các dòng sáp nhập được thể hiện trong cách này, bỏ chọn hộp kiểm Bao gồm thông tin hợp nhất khi bắt đầu đổ lỗi.

Nếu bạn muốn nhìn thấy các đường dẫn liên quan đến việc hợp nhất, chọn Xem → Các đường dẫn hợp nhất . Điều này cho thấy đường dẫn nơi dòng đã được thay đổi lần cuối, không bao gồm các thay đổi từ một hợp nhất.

Bản sửa đổi được hiển thị trong thông tin đổ lỗi đại diện cho bản sửa đổi cuối cùng nơi mà nội dung của dòng đó thay đổi. Nếu tập tin được tạo ra bằng cách sao chép một tập tin khác, thì cho đến khi bạn thay đổi một dòng, đổ lỗi cho sửa đổi của nó sẽ hiển thị thay đổi mới nhất trong tập tin nguồn gốc, chứ không phải bản sửa đổi nơi bản sao đã được thực hiện. Điều này cũng áp dụng cho các đường dẫn được hiển thị với thông tin kết hợp. Đường dẫn hiển thị vị trí kho lưu trữ nơi sự thay đổi cuối cùng đã được thực hiện tới dòng đó.

Các thiết lập cho TortoiseBlame có thể được truy cập bằng cách sử dụng TortoiseSVN → Thiết lập ... trên tab TortoiseBlame. Tham khảo phần “Thiết Lập TortoiseBlame” .

Một trong những hạn chế của báo cáo đổ lỗi là nó chỉ cho thấy các tập tin như lúc nó đã ở trong một phiên bản nhất định, và người cuối cùng thay đổi mỗi dòng. Đôi khi bạn muốn biết những thay đổi gì đã được thực hiện, cũng như những người đã làm ra nó. Nếu bạn nhấp chuột phải trên một dòng trong TortoiseBlame bạn có một mục trình đơn ngữ cảnh để hiển thị các thay đổi được thực hiện trong bản chỉnh sửa đó. Nhưng nếu bạn muốn xem các thay đổi và các thông tin đổ lỗi một cách đồng thời thì bạn cần một sự kết hợp của các báo cáo tìm khác biệt và đổ lỗi.

Hộp thoại tường trình sửa đổi bao gồm một số tùy chọn cho phép bạn làm điều này.

Mỗi nút đồ thị sửa đổi đại diện cho một sửa đổi trong kho, nơi một cái gì đó thay đổi trong cây mà bạn đang nhìn vào. Các loại khác nhau của nút có thể được phân biệt bởi hình dạng và màu sắc. Các hình dạng là cố định, nhưng màu sắc có thể được thiết lập bằng cách sử dụng TortoiseSVN → Thiết l

Lưu ý rằng theo mặc định, đồ thị chỉ hiển thị các điểm của các mục đã được thêm vào, sao chép hoặc bị xóa. Hiển thị tất cả các sửa đổi của dự án sẽ tạo ra một đồ thị rất lớn cho các trường hợp không tầm thường. Nếu bạn thực sự muốn xem tất cả các bản sửa đổi mà thay đổi được thực hiện, có một tùy chọn để làm điều này trong trình đơn Xem và trên thanh công cụ.

Giao diện mặc định (xếp nhóm) đặt các nút theo cách mà vị trí thẳng đứng của chúng theo thứ tự chỉnh sửa nghiêm ngặt, vì vậy bạn có một dấu hiệu trực quan cho thứ tự mà trong đó mọi thứ đã được thực hiện. Trường hợp hai nút trong cùng một cột thì thứ tự là rất rõ ràng. Khi các nút hai cột liền kề độ chênh lệch là nhỏ hơn nhiều vì không có nhu cầu để ngăn chặn các nút chồng chéo lên nhau, và dẫn đến kết quả là thứ tự là ít rõ ràng hơn một chút. Việc tối ưu hóa như vậy là cần thiết để giữ cho các đồ thị phức tạp ở một kích thước hợp lý. Xin lưu ý rằng lệnh này sử dụng biên của các nút trên cạnh cũ như là một tham chiếu, tức là cạnh dưới của nút khi biểu đồ được hiển thị với nút cũ nhất ở phía dưới. Cạnh tham chiếu có ý nghĩa quan trọng bởi vì hình dáng nút không phải tất cả là cùng một chiều cao.

Bởi vì một đồ thị sửa đổi thường khá phức tạp, có một số tính năng có thể được sử dụng điều chỉnh cách xem theo cách bạn muốn. Đây là có sẵn trong trình đơn Xem và thanh công cụ.

Để làm cho nó dễ dàng hơn để định hướng một đồ thị lớn, sử dụng cửa sổ tổng quan. Cái này cho thấy toàn bộ đồ thị trong một cửa sổ nhỏ, với phần đang hiển thị được làm nổi bật. Bạn có thể kéo các khu vực được làm nổi bật để thay đổi khu vực hiển thị.

Ngày sửa đổi, tác giả và bình luận ​​được thể hiện trong một hộp gợi ý bất cứ khi nào dao động chuột lên một hộp sửa đổi.

Nếu bạn chọn hai phiên bản (Sử dụng Ctrl- chuột trái ), bạn có thể sử dụng trình đơn ngữ cảnh để hiển thị sự khác biệt giữa các bản sửa đổi. Bạn có thể chọn để hiển thị các khác biệt như tại các điểm tạo ra chi nhánh, nhưng thông thường bạn sẽ muốn thể hiện các sự khác biệt tại điểm cuối chi nhánh, tức là ở sửa đổi CHÍNH.

Bạn có thể xem các khác biệt như là một tập tin khác biệt-thống nhất, trong đó cho thấy tất cả các sự khác biệt trong một tập tin đơn lẻ với bối cảnh tối thiểu. Nếu bạn lựa chọn Trình đơn Ngữ cảnh → So Sánh các Sửa Đổi bạn sẽ được trình bày với một danh sách các tập tin được thay đổi. Kích đúp vào một tên tập tin để lấy cả hai bản sửa đổi của tập tin và so sánh chúng bằng cách sử dụng công cụ khác biệt trực quan.

Nếu bạn nhấp chuột phải trên một bản sửa đổi, bạn có thể sử dụng Trình Đơn Ngữ Cảnh → Hiện Tường Trình để xem lịch sử.

Bạn cũng có thể sáp nhập các thay đổi trong các bản sửa đổi được lựa chọn vào một bản sao làm việc khác. Một hộp thoại lựa chọn thư mục cho phép bạn chọn bản sao làm việc để sáp nhập vào, nhưng sau đó không có hộp thoại xác nhận, cũng không có bất kỳ cơ hội để thử một thử nghiệm hợp nhất. Đó là một ý tưởng tốt để kết hợp vào một bản sao hoạt động chưa sửa đổi để bạn có thể hoàn nguyên các thay đổi nếu việc này không xong! Đây là một tính năng hữu ích nếu bạn muốn kết hợp các phiên bản được lựa chọn từ một chi nhánh sang một chi nhánh khác.

Nếu bạn muốn kiểm tra máy chủ một lần nữa cho thông tin mới hơn, bạn chỉ đơn giản là có thể làm mới màn hình xem bằng cách sử dụng F5 . Nếu bạn đang sử dụng bộ nhớ cache tường trình (được kích hoạt theo mặc định), điều này sẽ kiểm tra kho lưu trữ cho các cam kết mới hơn và lấy chỉ những cái mới. Nếu bộ nhớ cache tường trình trong chế độ ngoại tuyến, hành động này cũng sẽ cố gắng để trở lại trực tuyến.

Nếu bạn đang sử dụng bộ nhớ cache tường trình và bạn nghĩ nội dung thông điệp hay tác giả có thể đã thay đổi, bạn nên sử dụng hộp thoại tường tình để làm mới các thông điệp mà bạn cần. Bở vì đồ thị sửa đổi hoạt động từ gốc của kho, chúng ta sẽ làm mất hiệu lực bộ toàn bộ nhớ cache tường trình, và việc lấp đầy lại nó có thể mất một thời gian rất dài.

Một cây lớn có thể là khó khăn để định hướng và đôi khi bạn sẽ muốn ẩn các phần của nó, hoặc phá vỡ nó thành một khu rừng các cây nhỏ hơn. Nếu bạn di chuyển chuột trên một nút nơi một liên kết nút đi vào hoặc rời khỏi nút, bạn sẽ thấy một hoặc nhiều nút bật lên mà cho phép bạn làm điều này.

Nhấp chuột vào nút bấm dấu trừ để sập các cây con gắn v.

Click vào nút dấu cộng để mở rộng một cây sụp đổ. Khi cây đã bị sụp đổ, nút này vẫn được nhìn thấy để chỉ ra cây con ẩn.

Nhắp chuột vào nút chéo để phân chia các con cây gắn theo và hiển thị nó như một cây riêng biệt trên đồ thị.

Nhấp chuột vào nút tròn để gắn lại một cây được chia tách. Khi một cây đã được chia đi, nút này vẫn được nhìn thấy để cho biết rằng có một cây con riêng biệt.

Nhấp chuột vào nền đồ thị cho trình đơn ngữ cảnh chính, trong đó cung cấp các tùy chọn để Mở rộng tất cả và Tham gia tất cả . Nếu không có chi nhánh nào đã bị sập, tách, trình đơn ngữ cảnh sẽ không được hiển thị.

Thỉnh thoảng bạ có một bản sao làm việc mà bạn muốn chuyển đổi về lại thành một thư mục bình thường mà không có thư mục .svn. Tất cả bạn cần phải làm là xóa thư mục .svn từ gốc bản sao làm việc.

Một cách khác là bạn có thể xuất khẩu thư mục vào chính nó. Trong Windows Explorer dùng chuột phải kéo lê thư mục gốc của bản làm việc từ bảng thư mục vào chính nó trong bảng thư mục. TortoiseSVN phát hiện trường hợp đặc biệt này và hỏi nếu bạn muốn bỏ phiên bản khỏi bản sao làm việc. Nếu bạn trả lời vâng thư mục điều khiển sẽ bị bỏ và bạn sẽ có một cây thư mục trơn, không đánh phiên bản.

Bạn có thể tích hợp một công cụ theo dõi lỗi do bạn chọn trong TortoiseSVN. Để làm điều này, bạn phải xác định một số thuộc tính, bắt đầu với bugtraq: . Chúng phải được thiết lập trên thư mục: ( phần “Thiết lập Dự án” )

Hình 4.65. Hội Thoại Thuộc Tính Bugtraq

Khi bạn chỉnh sửa bất kỳ các thuộc tính Bugtraq một trình soạn thảo thuộc tính đặc biệt được sử dụng để làm cho nó dễ dàng hơn để thiết lập các giá trị thích hợp.

Có hai cách để tích hợp TortoiseSVN với bộ theo dõi vấn đề. Một là dựa trên các chuỗi đơn giản, cách khác là dựa trên biểu thức thông thường. Các thuộc tính được sử dụng bởi cả hai cách tiếp cận trên là:

Nếu cả hai thuộc tính bugtraq:message và bugtraq:logregex được thiết lập, logregex sẽ được ưu tiên.

Một số thuộc tính tsvn: đòi hỏi phải có giá trị đúng/sai . TortoiseSVN cũng hiểu vâng như một từ đồng nghĩa với đúng và không như một từ đồng nghĩa với sai .

Khi bạn thêm mới các thư mục con vào một bản sao làm việc bằng cách sử dụng TortoiseSVN, bất kỳ thuộc tính dự án có trong thư mục mẹ sẽ tự động được thêm vào thư mục con.

This issue tracker integration is not restricted to TortoiseSVN; it can be used with any Subversion client. For more information, read the full Issue Tracker Integration Specification in the TortoiseSVN source repository. (phần “Giấy phép” explains how to access the repository.)

Các phần trước đảm đương việc thêm thông tin vào các thông điệp tường trình. Nhưng nếu những gì cần để nhận được thông tin từ bộ theo dõi vấn đề? Hộp thoại cam kết có một giao diện COM cho phép tích hợp một chương trình bên ngoài mà có thể nói chuyện với bộ theo dõi của bạn. Thông thường bạn có thể muốn truy vấn bộ theo dõi để có được một danh sách các vấn đề mở được giao cho bạn, để bạn có thể chọn những vấn đề đang được đề cập trong cam kết này.

Any such interface is of course highly specific to your issue tracker system, so we cannot provide this part, and describing how to create such a program is beyond the scope of this manual. The interface definition and sample plugins in C# and C++/ATL can be obtained from the contrib folder in the TortoiseSVN repository. (phần “Giấy phép” explains how to access the repository.) A summary of the API is also given in Chương 7, giao diện IBugtraqProvider. Another (working) example plugin in C# is Gurtle which implements the required COM interface to interact with the Google Code issue tracker.

Đối với mục đích minh họa, chúng ta hãy giả sử rằng quản trị viên hệ thống của bạn đã cung cấp cho bạn một plugin theo dõi vấn đề mà bạn đã cài đặt, và rằng bạn đã thiết lập một số bản sao làm việc của bạn sử dụng các plugin trong hộp thoại thiết lập TortoiseSVN của. Khi bạn mở hộp thoại cam kết từ một bản sao làm việc mà các plugin đã được chỉ định, bạn sẽ thấy một nút mới ở trên cùng của hộp thoại.

Hình 4.66. Hộp thoại ví dụ truy vấn theo dõi vấn đề

Trong ví dụ này, bạn có thể chọn một hoặc nhiều vấn đề mở. Các plugin sau đó có thể tạo ra văn bản được định dạng đặc biệt mà nó bổ sung vào thông điệp tường trình của bạn.

Hình 4.67. Hộp Thoại Thiết Lập, Trang Tổng Quát

Hộp thoại này cho phép bạn chỉ định ngôn ngữ ưa thích của bạn, và các thiết lập cụ thể cho Subversion.