Xem mẫu
- Hướng dẫn sử dụng Google Code v à TortoiseSVN
Hướng dẫn sử dụng
“Google C ode” 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 n hấ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ự tha y đổ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 (phamvanthuanbk@gmail.com)
- 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ỉ: http://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ỉ: http://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 (phamvanthuanbk@gmail.com)
- 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 (phamvanthuanbk@gmail.com)
- 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ỉ: http://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 (phamvanthuanbk@gmail.com)
- 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ỉ
thaonhi8487@gmail.com vào nhóm Project Commiters. Nhấn nút Save changes để l ưu thay đ ổi.
Phạm Văn Thuận (phamvanthuanbk@gmail.com)
- 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 (phamvanthuanbk@gmail.com)
- 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 Tortoise SVN
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 (phamvanthuanbk@gmail.com)
- 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
https://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 (phamvanthuanbk@gmail.com)
- 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 (phamvanthuanbk@gmail.com)
- 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 (phamvanthuanbk@gmail.com)
- 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 (phamvanthuanbk@gmail.com)
- 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 (phamvanthuanbk@gmail.com)
- 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 com mit 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 (phamvanthuanbk@gmail.com)
- 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 mad e: 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 (phamvanthuanbk@gmail.com)
- 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 (phamvanthuanbk@gmail.com)
nguon tai.lieu . vn
