Tortoisesvn hướng dẫn sử dụng

Hướng dẫn sử dụng Google Code v à TortoiseSVN

Hướng dẫn sử dụng

Google Code và TortoiseSVN
Lời nói đầu:
Trong quá trình phát triển phần mềm theo nhóm hay theo từng cá nhân, chúng ta th ường xuyên
sẽ phải gặp với những vấn đề:
- Làm thế nào để quản lý được các phiên bản của quá trình phát triển phần mềm? [Thông
thường chúng ta phải copy, đổi t ên, nén file]
- Làm thế nào để có thể quản lý mã nguồn chung cho cả nhóm? [Bình thường các thành
viên trong nhóm phải sao chép, gửi email cho nhau rồi chỉnh sửa -> tam sao thất bản,
không biết bản nào là bản mới nhất, ổn định nhất]

Để giải quyết những vấn đề đó, một số công cụ quản lý phi ên bản đã ra đời, phố biến nhất có
thể nói đến là Subversion. Với công cụ này, toàn bộ mã nguồn sẽ được lưu trữ tại một thư mục
[Repository] và tất cả các thành viên tham gia dự án có thể thực hiện những thao tác:
- Import: đưa mã nguồn dự án vào repository
- Check out: lấy về mã nguồn dự án
- Commit: cập nhật những thay đổi lên repository
- Update: lấy về các thay đổi do các thành viên khác commit trước đó
- Diff: kiểm tra xem những sự thay đổi so với phiên bản hiện có

Việc tạo ra một Repository trên mạng để dùng chung cho cả nhóm dự án sẽ thật dễ dàng với các
công ty, các tổ chức tuy nhiên với những nhóm nhỏ hay cá nhân th ì việc này không thật sự đơn
giản. Google đã đưa ra dịch vụ Google code để đáp ứng nhu cầu này. Bài hướng dẫn này sẽ
giúp các bạn có thể tiếp cận nhanh hơn với dịch vụ này.
Bài hướng dẫn được chia làm hai phần
Phần 1. Hướng dẫn cách tạo một dự án tr ên Google Code, cách tạo và quản lý các thành viên
trong nhóm dự án.
Phần 2. Hướng dẫn sử dụng phần mềm TortoiseSVN để thực hiện các thao tác kết nối v à quản

lý phiên bản với Google Code.

Phạm Văn Thuận []


Hướng dẫn sử dụng Google Code v à TortoiseSVN

PHẦN 1. Tạo một dự án trên google code
Bước 1: Vào trang web có địa chỉ: //code.google.com
Trang chủ của google code sẽ hiện ra. Nhấn vào nút Sign In [Đăng nhập]

Hình 1. Giao diện trang chủ google code
Bước 2: Đăng nhập sử dụng chung t ài khoản thư điện tử của google [gmail]
Sau khi đăng nhập [Hình 2], giao diện trang chủ của google code lại hiện ra.
Bước 3: Vào trang web có địa chỉ: //code.google.com/hosting/createProject
Giao diện tạo dự án trên Google Code sẽ hiện ra. [Hình 3]
Phạm Văn Thuận []


Hướng dẫn sử dụng Google Code v à TortoiseSVN

Hình 2. Giao diện đăng nhập

Hình 3. Giao diện tạo dự án

Phạm Văn Thuận []


Hướng dẫn sử dụng Google Code v à TortoiseSVN
Tiến hành nhập thông tin cho dự án

Project name: nhập tên dự án [Ví dụ: t0907g]
Project summary: nhập tóm tắt về dự án
Project description: mô tả về dự án
Version control system: chọn hệ thống quản trị phiên bản Subversion
Source code license: chọn hình thức quản lý bản quyền [Ví dụ: GNU General Public
License v3]
Nhấn nút Create Project. Sau khi dự án được tạo ra, giao diện làm việc với dự án hiện ra với
địa chỉ: //code.google.com/p/t0907g/
Địa chỉ này cũng chính là địa chỉ cho phép tất cả mọi ng ười truy xuất đến dự án của bạn.

Trong giao diện này có một số tab cần lưu ý
Downloads: nơi cung cấp các tài nguyên cho phép người sử dụng download
Issues: nơi các thành viên của đội dự án có thể đưa ra các lỗi, các trường hợp phát sinh
trong quá trình viết phần mềm và cách thức chỉnh sửa [nếu có]
Phạm Văn Thuận []


Hướng dẫn sử dụng Google Code v à TortoiseSVN
Source: nơi quản lý mã nguồn
Administer: nơi quản lý dự án [thêm người dùng, sửa, xóa dự án]
Bước 4: tạo tài khoản cho các thành viên đội dự án
Chú ý: Chỉ người có quyền sở hữu [owner] dự án mới có thể tạo các t ài khoản cho thành viên
trong đội dự án.
Trong cửa sổ dự án, chọn tab Administer ->Project Members. Ở đây có 3 nhóm người dùng,
chúng ta tạm thời chỉ cần quan tâm tới 2 nhóm ng ười dùng
Project owners: người sở hữu dự án [mặc định là người tạo ra dự án]
Project Commiters: thành viên c ủa dự án [có quyền check out [download dự án], commit
[cập nhật thay đổi lên dự án], update [cập nhật các thay đổi do các th ành viên khác của dự án
đã commit] và một số quyền khác.


Để thêm một người dùng mới, chỉ cần thêm địa chỉ email [gmail] của ng ười dùng đó vào trong
nhóm người dùng tương ứng. Ví dụ như ở trên, chúng ta vừa thêm người dùng có địa chỉ
vào nhóm Project Commiters. Nhấn nút Save changes để lưu thay đổi.

Phạm Văn Thuận []


Hướng dẫn sử dụng Google Code v à TortoiseSVN

Chú ý:
Mỗi thành viên [kể cả người tạo dự án] đều có một mật khẩu để có thể l àm việc với dự án. Mật
khẩu này không trùng với mật khẩu mà các thành viên sử dụng để đăng nhập các dịch vụ của
Google như gmail hay Google code. Đ ể xem mật khẩu này, bạn cần chọn vào mục Profile, sau
đó vào phần Settings

Chọn Settings, bạn có thể nhìn thấy mât khẩu của mình. Bạn cũng có thể nhấn vào nút
Regenerate để hệ thống sinh ra một mật khẩu mới.

Bước 5: Thiết lập cho phép google code tự động gửi các thông tin cập nhật về
email của các thành viên trong dự án
Gửi các thông tin về các lỗi phát sinh trong quá tr ình phát triển dự án
1] Chọn tab Administer -> Issue Tracking
2] Tìm đến mục thiết lập địa chỉ email để gửi thông báo, tốt nhất n ên tạo ra một mail
group cho tất cả các thành viên trong nhóm

Phạm Văn Thuận []


Hướng dẫn sử dụng Google Code v à TortoiseSVN


Gửi các thông tin về các thay đổi trong dự án [th êm, bớt, sửa, xóa các file trong dự án]
1] Chọn tab Administer -> Source
2] Tìm đến mục thiết lập địa chỉ email để gửi thông báo, tốt nhất n ên tạo ra một mail
group cho tất cả các thành viên trong nhóm

PHẦN 2. Sử dụng phần mềm TortoiseSVN
Thao tác 1: Cài đặt phần mềm TortoiseSVN
Phiên bản TortoiseSVN tôi giới thiệu trong t ài liệu này là TortoiseSVN-1.6.7 [Bản chạy trên
Windows]
Thao tác 2: Import [Upload] file dự án lên Repository của Google Code
Kịch bản sử dụng: Khi mới khởi tạo dự án và nhóm dự án có một số tài nguyên ban đầu muốn
đưa lên lưu trữ và chia sẻ trong toàn nhóm.
Click chuột phải vào thư mục chứa mã nguồn ban đầu của dự án và chọn TortoiseSVN ->
Import.
Phạm Văn Thuận []


Hướng dẫn sử dụng Google Code v à TortoiseSVN

Cửa sổ thao tác sẽ hiện ra, bạn cần điền thông tin
- URL of repository: đường dẫn tới Repository của dự án, có câu trúc như sau
//Tên_Dự_Án.googlecode.com/svn/trunk/
- Import message: thông tin ghi chú lý do th ực hiện thao tác import, rất cần thiết để các
thành viên trong dự án có thể dò vết thay đổi của dự án.

Hình 4. Giao diện import dự án
Phạm Văn Thuận []


Hướng dẫn sử dụng Google Code v à TortoiseSVN

- Sau khi bạn bấm nút OK, một giao diện sẽ hiện ra y êu cầu bạn nhập thông tin tài khoản.
Bạn nhập tên truy cập và mật khẩu [Chú ý: sử dụng mật khẩu của Google Code]

Hình 5. Cửa sổ nhập thông tin xác thực
- Các file của dự án sẽ được upload lên Repository của dự án

Hình 6. Kết quả sau khi import
- Bạn có thể kiểm tra các file mã nguồn của dự án trên Repository của Google code bằng
cách chọn tab Source -> Browse - > trunk

Phạm Văn Thuận []


Hướng dẫn sử dụng Google Code v à TortoiseSVN

Hình 7. Giao diện quản lý file trên Google Code
Thao tác 3: Checkout [Download] d ự án
Kịch bản sử dụng: khi thành viên dự án hoặc người dùng lần đầu tiên muốn lấy các tài nguyên
dự án đưa về máy cá nhân để sử dụng, phát triển.
Bước 1: Tạo một thư mục định chứa dự án
Bước 2: Click chuột phải vào thư mục vừa tạo [chú ý thư mục nên rỗng], chọn chức năng SVN
Checkout.

Phạm Văn Thuận []


Hướng dẫn sử dụng Google Code v à TortoiseSVN
Một cửa sổ sẽ hiện ra yêu cầu người dùng nhập các thông tin cần thiết nh ư đường dẫn tới
Repository, thư mục đích chứa file sẽ download về. Cần chú ý mục Revision, mục n ày cho phép
người dùng chọn phiên bản cần lấy về [Vì một dự án qua quá trình phát triển của nó bao gồm

nhiều phiên bản, người dùng cần lựa chọn phiên bản phù hợp với yêu cầu của mình].
Thông thường, tùy chọn mặc định cho mục này là HEAD tức là lấy về phiên bản mới nhất
[Hình 8]. Sau đó, cửa sổ xác thực hiện ra yêu cầu bạn nhập thông tin tài khoản. Khi quá trình
check out thành công, các file đư ợc download về thư mục chỉ định, bạn sẽ thấy một cửa sổ
thông báo như Hình 9.

Hình 8. Cửa sổ checkout

Hình 9. Két quả checkout
Phạm Văn Thuận []


Hướng dẫn sử dụng Google Code v à TortoiseSVN
Để chọn các phiên bản khác [không phải phiên bản mới nhất], trong cửa sổ checkout bạn nhấn
vào nút Revision rồi chọn Show Log để nhìn danh sách tất cả các phiên bản, từ đó chọn số
phiên bản cho phù hợp.

Sau khi Checkout [hoặc update], mã nguồn sẽ ở dạng chưa chỉnh sửa và được ký hiệu như dưới
đây

Nếu có bất cứ sự thay đổi nào trong mã nguồn, nó sẽ được ký hiệu

Phạm Văn Thuận []


Hướng dẫn sử dụng Google Code v à TortoiseSVN
Thao tác 4: Commit [Cập nhật thay đổi lên Server]
Kịch bản sử dụng: sau khi bạn chỉnh sửa một số đoạn mã trong dự án và bạn đã kiểm thử các
đoạn mã đó cho kết quả tốt, bạn muốn cập nhật l ên Server để các thành viên trong dự án có thể
cùng sử dụng.


Chú ý: bạn có thể commit cả thư mục dự án hay commit từng file riêng lẻ
Bước 1: Click phải chuột vào file hay thư mục muốn commit, ở đây tôi chọn th ư mục làm ví dụ

Bước 2: Cửa sổ Commit sẽ hiện ra

Hình 10. Cửa sổ Commit change
Phạm Văn Thuận []


Hướng dẫn sử dụng Google Code v à TortoiseSVN
Trong cửa sổ này, bạn cần quan tâm tới những thô ng tin
Message: chú thích sự thay đổi. Thông tin này rất quan trọng cho quá trình dò vết, kiểm tra
sự thay đổi của dự án cũng nh ư cho các thao tác Checkout, Update nên b ạn cần mô tả thật
ngắn gọn nhưng xúc tích lý do commit mã nguồn lên Server.
Changes made: liệt kê tất cả các file có sự thay đổi so với lần Update hay Checkout gần nhất,
bạn tích vào những file có sự thay đổi mà bạn muốn cập nhật lên server.
Tiếp đến, nhấn nút OK để commit l ên server. Cửa sổ xác thực hiện ra, bạn tiến h ành nhập thông
tin tài khoản của mình. Sau quá trình commit thành công, m ột cửa sổ sẽ hiện ra cho biết thông
tin quá trình commit. Bạn đặc biệt chú ý tớ thông tin At revision: 3. Sau mỗi lần th ành viên
của dự án commit những thay đổi, số phi ên bản [revision] này sẽ tự động tăng thêm 1.

Hình 11. Kết quả thao tác commit
Thao tác 5: update [cập nhật thay đổi từ trên server]
Kịch bản: khi thành viên của dự án biết rằng đã có những thay đổi trên server và anh ta muốn
cập nhật, lấy về những thay đổi mới nhất này.
Bước 1: Chọn thư mục chứa dự án trên máy cục bộ và nhấn chuột phải, chọn SVN update

Phạm Văn Thuận []



Hướng dẫn sử dụng Google Code v à TortoiseSVN
Cửa sổ xác thực sẽ hiện ra, bạn tiến h ành nhập thông tin tài khoản. Sau khi quá trình update
hoàn thành, một cửa sổ thông báo sẽ hiện ra

Hình 12. Kết quả update

LỜI KẾT:
Trên đây chỉ là những hướng dẫn rất cơ bản, hy vọng sẽ giúp ích cho các bạn. Để có thể tận
dụng hết sức mạnh của công cụ quản trị phi ên bản SVN , bạn cần đọc thêm các tài liệu về công
cụ này, tôi xin khuyến cáo bạn nên đọc tài liệu: Version Control with Subversion và thực
hành các tính năng mới với phần mềm Tortoise.

ENJOY YOURSELF !!!

Phạm Văn Thuận []