【Google Code】線上版本控制器


Google code http://code.google.com/intl/zh-TW/

【使用】
這邊記一下我常會忘記的東西。

  • 申請方式
    1. 先將網頁連到 http://code.google.com/hosting/ 。 選擇 Create a new project
      image
    2. 接下來需要的就是填寫專案的名稱與說明。授權方面,如要要其他人(拿你的程式去再製的人)也要開放原始碼的話,可以先選擇GPLv2,填完了之後就選下面的 Create project
      image
    3. 如果有更需要對此專案做更詳細的說明與進階設定(如增加更多關鍵字讓其他人更容易找到或搭配Google Analytics)的話,就選 Administer。進入之後把該填的填一填。
      image
  • 使用方式
    • 首先連到 Source 這一頁先記一下申請的 Svn server address。如果我沒有誤解的話,上面的是給開發者 check-out 用的,而下面是給其他人/使用者用的。
       image
    • 當然密碼也是必須的。在Google code 裡面的密碼和一般在用的Google密碼是不一樣的。進入下面的截圖中的 googlecode.com password 裡面就是密碼。
      image 
    • Svn checkout 有許多方式,用command-line是最迅速方便的方式。不過在Windows環境,搭配 TortoiseSVN 也是一個方式。以下為此方式說明。 首先在桌面按右鍵選擇 SVN Checkout
       image
    • 將準備好的 svn server address 填到 URL of repository。按 OK
       image
    • 這時候桌面就多了跟專案名稱一樣的目錄了。
  • Initial/Commit Document
    • 要寫程式之前,先寫文件勾勒一下專案的用途。
    • 專案最主要的有幾個重點文件。
      • README.TXT 概略說明專案用途。
      • CHANGELOG.TXT/HISTORY.TXT/RELEASENOTE.TXT 更新狀態。
      • INSTALL.TXT 如何安裝。
    • 先在專案目錄新增一個 README.TXT,裡面說明一下專案的用途。
    • 在 README.TXT 使用滑鼠右鍵,選 Add 加入 README.TXT。
      image
    • 接下來就可以用 SVN Commit 將檔案加入。
      image 
    • 可以把Save authentication 打勾。省掉下次還要在輸入的麻煩。
      image
  • Commit Source code
    • 方式和上面類似,這邊只是提醒,如果專案有需要跨平台的話,建議使用下面目錄將source code 分開(如 Qt create 在不同平台,可能會有不同的檔案管理/分類方式)
      • ubuntu: 給 ubuntu/linux 用的
      • win32vc: 給 windows 配合 visual studio用的。
      • macos:給Apple MacOs用的
    • 老實說這種分類方式不是很好,也是目前我比較頭疼的部份。我還在尋找比較好的方式來處理跨平台的source code 管理。如切 branch…
    • 20100611更新: 會有上面的問題是因為我在Windows底下使用VC add-in for Qt,而在Ubuntu是用Qt Creator,目前都改用Qt Creator 之後目前這問題看起來已經不重要了。
  • 網頁維護方式
    • 為了讓大家更了解你所正在做的事,專案網頁上的解說文件也非常重要。
    • Wiki/Issue 寫作方式建議參考別人的專案(可參考 qwit http://code.google.com/p/qwit/)。
  • Source code 維護方式
    • Release/Version tag
  • 其它
    • 只下載所需要目錄之檔案
      • 先由 ls 來查看目前目錄下的檔案
        $ svn ls svn://192.168.0.1/home/svn/z1
        trunk
      • 再透過 co 來抓取檔案
        $ svn co –R vn://192.168.0.1/home/svn/z1/trunk

【參考】

 

Ed32. Copyright 2008 All Rights Reserved Revolution Two Church theme by Brian Gardner Converted into Blogger Template by Bloganol dot com