最近更新: 2007-03-23

在 GoogleCode 建立軟體專案的第一步

Google Code 是一項開放源碼專案管理服務平台 - Google Code Home,它採用 Subversion 作為版本控制系統(See also: Programming with Subversion Quickstart)。想申請建立專案非常容易,只要到 Prject Hosting 中填好申請表格即可建立專案。唯一限制是軟體授權證一定要採用 Google Code 提供的開放源碼授權證 (如 GPL, Apache License, New BSD License)。必須先登入 Gmail 帳號之後,才會出現 Create a new project 的申請表連結。提醒事項:

  1. 用 Google 帳號不能建立專案,一定要用 Gmail 帳號。如果你是以其他服務商的 E-Mail 帳號申請 Google 帳號,請轉換成 Gmail 帳號。
  2. Google Code 的 Subversion server 使用另一個登入密碼,請在登入 Gmail 帳號後查看 GoogleCode.com Password 得知你的 GoogleCode 密碼。當你自 repository 提出或提交資料時,就要輸入你的 Gmail 帳號以及這個 GoogleCode 密碼。

當你送出申請表,GoogleCode 就會建立一個專案網站: http://code.google.com/?/專案代名/,其中提供檔案下載、維護使用文件(使用wiki)、問題處理等功能服務。附帶一提,Wiki之內容也會被包含在 repository 中。專案的 repository URL 則為: (認證)https://專案代名.googlecode.com/svn/ / (匿名)http://專案代名.googlecode.com/svn/

建立專案後第一步是上傳源碼內容。如果你已經有一個 repository (專案貯藏庫),那麼你可以用 svnsync 將原有的 repository 內容轉移到 Google Code 的 repository 。但是在上傳之前,請務必確認原有 repository 之內容沒有私人資料或帳號密碼。當我們建立一個私人的本地 repository 時,常常不自覺地將一些帶有隱密性資料的源碼提交進 repository ,例如測試案例中的帳號密碼、使用者資料等等。如果你原有的私人 repository 內容中有這些資料,那麼就不應該用 svnsync 轉移資料。碰到這種情形,只能手動添加。

svnsync 是 Subversion 1.4 版時新增的指令,主要功能是同步兩地 repository 的紀錄內容。首先以 initialize 指令選項初始化 GoogleCode 的 repository ,這動作只能做一次。接著以 synchronize 指令選項取得同步資訊,最後以 copy 指令選項複製原有 repository 的內容至 GoogleCode repository 。說明:

svnsync init dest_url src_url
svnsync sync dest_url
svnsync copy dest_url rev

如果你很不幸地在轉移原有 repository 之後才發現內含隱密性資料,為防資料外洩,請儘快於 Hosting at Google Code 網上論壇發出 Repository reset 訊息請求清空 repository。GoogleCode 管理者在看到你發文後,通常當天就會重置你的 repository 。不要擔心英文不好,論壇上常常有人發出 reset 訊息,拿一篇當範本改一下就行了... 我也是這樣做的。

樂多舊網址: http://blog.roodo.com/rocksaying/archives/2897049.html