Nội quy chuyên mục: - Chuyên mục này chỉ sử dụng cho việc chia sẻ các tài liệu và hướng dẫn, vui lòng không đặt câu hỏi tại đây. Các thảo luận có liên quan vui lòng gửi đúng topic.
- Các tài liệu chính thức được cung cấp tại http//wiki.nukeviet.vn/technical_manual
#40351 gửi bởi laser
Ngày 02 Tháng 08 2009 , 13:36


Trên Google code, NukeViet sử dụng Hệ thống quản lý phiên bản (Version control system - VCS) Subversion (SVN).

VCS là gì?
Hệ thống quản lý phiên bản (Version control system - VCS) là một dạng phần mềm Quản lý mã nguồn (Source Code Management- SCM)

Vì sao phải sử dụng VCS:
VCS là hệ thống hỗ trợ làm việc theo nhóm rất hiệu quả. Khi một nhóm làm việc cùng trên một project, việc nhiều người cùng chỉnh sửa nội dung của một file là điều không thể tránh khỏi. VCS cung cấp các chức năng để có thể thực hiện việc này một cách đơn giản và an toàn.

Subversion là gì?
Subversion (SVN) là một phần mềm VCS dùng để quản lý và kiểm tra các phiên bản mã nguồn khác nhau trong quá trình phát triển mã nguồn.

Nếu bạn muốn tìm hiểu thông tin về Subversion thì xem tại đây:

Hệ thống Subversion quản lý tập trung trên 1 máy chủ Google code. Để tương tác với hệ thống này, chúng ta phải thông qua một phần mềm trung gian (gọi là chương trình phía client (khách) của Subversion system). Ở đây tôi chọn phần mềm TortoiseSVN để giới thiệu với các bạn.

Tóm lại, để làm việc trên hệ thống Google code, coder phải sử dụng phần mềm TortoiseSVN.
(thế mà nãy giờ cứ dài dòng =)) )

Đầu tiên: Download và Cài đặt TortoiseSVN

Download:
Phần mềm TortoiseSVN có thể tải về miễn phí tại đây: http://downloads.sourceforge.net/tortoisesvn/TortoiseSVN-1.6.3.16613-win32-svn-1.6.3.msi?download

Cài đặt:
Cài đặt bình thường thôi, cứ next mấy cái, sau khi cài xong thì phải khởi động lại máy trước khi sử dụng.

Tiếp theo: lấy thông tin đăng nhập trên Google code
Để đăng nhập vào hệ thống VCS Subversion trên Google code bằng phần mềm TortoiseSVN bạn vừa cài, bạn phải làm một bước đó là lấy thông tin đăng nhập hệ thống mà Google code cung cấp cho bạn. Để có thông tin này bạn phải là một thành viên của đội coder. (Xem thêm tại đây: http://nukeviet.vn/vi/news/community/NukeViet-mo-rong-doi-phat-trien-code-22/)

Trong trường hợp không phải là thành viên đội code, bạn vẫn có thể tải code về bằng cách sd các thông tin sau khai báo cho TortoiseSVN:
Use this command to anonymously check out the latest project source code:
# Non-members may check out a read-only working copy anonymously over HTTP.
svn checkout http://nuke-viet.googlecode.com/svn/trunk/ nuke-viet-read-only


Khi là thành viên của đội coder của NukeViet rồi, login vào Gmail sau đó truy cập tới địa chỉ http://code.google.com/p/nuke-viet/source/checkout bạn sẽ thấy thông báo như sau:
If you plan to make changes, use this command to check out the code as yourself using HTTPS:
Mã: Chọn hết
# Project members authenticate over HTTPS to allow committing changes.
svn checkout https://nuke-viet.googlecode.com/svn/trunk/ nuke-viet --username xxxxxxxxx


When prompted, enter your generated googlecode.com password.

Trong đó xxxxxxxxx là tên tài khoản của bạn.

Để lấy mật khẩu đăng nhập bạn hãy nhấp chuột vào link "googlecode.com password". Xem hình 1
Hình ảnh
Hình 1: Thành viên đội code sẽ được cấp quyền truy cập để chỉnh sửa mã nguồn.

Google sẽ cung cấp cho bạn mật khẩu. (Xem hình 2)
Hình ảnh
Hình 2: Mật khẩu truy cập máy chủ VCS.

Bạn sẽ phải sử dụng mật khẩu này trong quá trình đăng nhập máy chủ bằng phần mềm TortoiseSVN. Lưu ý rằng mật khẩu này có thể tạo mới bằng cách nhấp vào nút Regenerate.

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

Phần mềm TortoiseSVN sau khi cài đặt sẽ không làm việc như một phần mềm độc lập mà tích hợp luôn vào Windows Explorer. Bạn có thể thấy điều này qua các menu mà phần mềm tích hợp thêm vào (xem hình 3, 4)
Hình ảnh
Hình 3: Menu File của Windows
Hình ảnh
Hình 4: Menu xuất hiện khi click chuột phải (để tạo thư mục mới)


Lần đầu tiên kết nối với hệ thống máy chủ VCS của Google code bạn cần thiết lập thông số để phần mềm TortoiseSVN kết nối vào máy chủ cũng như thiết đặt vùng làm việc của bạn. (từ lần sau bạn không cần làm lại thao tác này)

Thiết lập vùng làm việc (chứa mã nguồn giao tiếp với Serrver) trên máy tính của bạn
Thực hiện các bước sau:
a, Hãy tạo một thư mục mới để chứa mã nguồn mà bạn sẽ làm việc. Giả sử tôi tạo thư mục NukeVietCMS source code tại thư mục D:\VertrigoServ\www\.
b, Click chuột phải lên thư mục NukeVietCMS source code, chọn SVN checkout (hình 5)
Hình ảnh
Hình 5

c, Điền các thông số kết nối mà phần mềm đòi hỏi (hình 6)
URL repository: https://nuke-viet.googlecode.com/svn/trunk/
Checkout directory: Thư mục mà bạn dự định làm việc, ở đây là D:\VertrigoServ\www\NukeVietCMS source code
Sau đó nhấp OK.
Hình ảnh
Hình 6: Điền thông số kết nối.

d, Điền thông tin đăng nhập (hình 7):
Username: tên đăng nhập của bạn vào hệ thống Google code, ở trên là xxxxxxxxx (hình 1)
Password: mật khẩu mà Gooogle code cung cấp cho bạn lúc trước (hình 2)
Sau đó nhấp OK.
Hình ảnh
Hình 7: Điền thông tin đăng nhập.

Một của sổ sẽ hiện lên như hình 8, đợi một lúc để chương trình cập nhật danh sách file trên máy chủ. Hãy chờ đến khi quá trình Checkout sẽ kết thúc. Phần mềm sẽ tải hết mã nguồn trên máy chủ xuống máy của bạn.
Hình ảnh
Hình 8

Những file và thư mục được đồng bộ với máy chủ sẽ có màu xanh. Những file, thư mục chưa được đồng bộ với máy chủ sẽ có màu đỏ. Dấu hiệu màu đỏ nhắc nhở bạn cần đồng bộ với máy chủ (xem hình 9)
Hình ảnh
Hình 9

Sau khi lấy các file trên máy chủ về rồi, bạn có thể bắt đầu công việc lập trình, chỉnh sửa code của mình.

Lưu ý: Đừng bao giờ trực tiếp đổi tên, xóa, di chuyển các file trong thư mục NukeVietCMS source code. Mọi việc cần làm đều phải thông qua menu của TortoiseSVN để phần mềm này có thể theo dõi và cập nhật những thay đổi lên máy chủ (Nếu không chưng trình sẽ báo lỗi)
Một vài thao tác hay sử dụng:

Thêm một file mới hoặc thư mục mới vào mã nguồn.
Khi thêm một file mới hoặc thư mục mới, bạn cần báo cho hệ thống biết bàng cách:
1. Click chuột phải vào thư mục (file), chon TortoiseSVN > Add (hình 10)
Hình ảnh
Hình 10

2. Chương trình sẽ liệt kê những tệp tin trong thư mục bạn đã chọn, nhấp OK để chấp nhận. (hình 11)
Hình ảnh
Hình 11

3. Quá trình thêm những tập tin này lên server sẽ bắt đầu (hình 12). Bạn cần chờ cho đến khi quá trình này kết thúc. Trong khi đó có thể làm bất cứ việc gì bạn thích.
Hình ảnh
Hình 12

Cập nhật những thay đổi lên máy chủ
Sau khi chỉnh sửa xong mã nguồn, bạn cần cập nhật nó lên máy chủ để lưu trữ trên đó hoặc chia sẻ với mọi người. mỗi lần cập nhật của bạn đều được lưu trữ trên máy chủ, vì vậy hãy chắc chắn bạn đã làm xong một phần việc trước khi tải nó lên máy chủ, tránh trừng hợp người khác có thể tải về phiên bản của bạn làm hệ thống bị lỗi. Đừng bao giờ cập nhật lên máy chủ trong khi đang làm dở việc.

Để cập nhật những thay đổi của bạn lên máy chủ hãy làm như sau:
1. Click chuột phải vào thư mục và chọn SVN Commit (hình 13)
Hình ảnh
Hình 13

2. Nhập ghi chú của bạn về thay đổi lần này vào ô Message và nhấp OK (hình 14)
Hình ảnh
Hình 14

3. 3. Quá trình thêm những tập tin này lên server sẽ bắt đầu (hình 15). Bạn cần chờ cho đến khi quá trình này kết thúc. Thời gian phụ thuộc số lượng file. Trong khi chờ bạn có thể làm bất cứ việc gì bạn thích.
Hình ảnh

Trong quá trình làm việc với máy chủ, cs thể phát sinh những tình huống khác: Ví dụ xung đột khi có nhiều người cùng sửa 1 file, bị lỗi khi đồng bộ... các hình thức xử lý vui lòng đọc thêm tài liệu đính kèm.

huong_dan_su_dung_SUBVERSION.rar

HDSD_Subversion-2.rar


Xem thêm: Video hướng dẫn sử dụng: viewtopic.php?f=117&t=20208
Đính kèm
(396.96 KB) Đã tải về 165 lần
(424.93 KB) Đã tải về 331 lần
(574.42 KB) Đã tải về 329 lần

Mọi nẻo đường đều dẫn tới tương lai!
#58817 gửi bởi quangpc
Ngày 20 Tháng 07 2010 , 02:55
Chú ý:
TortoiseSVN sẽ tạo ra 1 thư mục .svn trong tất cả các thư mục của mã nguồn.
Đây là thư mục ẩn đối với cả Windows lẫn Linux nên các bạn sẽ chỉ thấy được khi để chế độ cho phép xem file ẩn.
Nếu không để ý thì khi đóng gói code hay đưa lên server thì các thư mục này cũng được kèm theo luôn.

Cá nhân: http://www.khuvuonbimat.info Công ty: http://www.vienaco.com
#64414 gửi bởi laser
Ngày 04 Tháng 09 2010 , 12:49
quangpc đã viết:Chú ý:
TortoiseSVN sẽ tạo ra 1 thư mục .svn trong tất cả các thư mục của mã nguồn.
Đây là thư mục ẩn đối với cả Windows lẫn Linux nên các bạn sẽ chỉ thấy được khi để chế độ cho phép xem file ẩn.
Nếu không để ý thì khi đóng gói code hay đưa lên server thì các thư mục này cũng được kèm theo luôn.

sử dụng chức năng đóng gói của TortoiseSVN sẽ không bị "đóng" nhầm các thư mục này.

Mọi nẻo đường đều dẫn tới tương lai!
#103644 gửi bởi zairo
Ngày 05 Tháng 12 2011 , 22:13
sao mình không thấy chỗ nào để di chuyển file nhỉ ?

Thằng thích thằng chê, mặc kệ người đời soi mói Tao thích tao làm, tao làm những gì tao thích. http://www.tuongdep.com.vn | http://www.banhtrungthukinhdo.com.vn