如何使用GTWS管理Git工作空間

這篇文章主要講解了“如何使用GTWS管理Git工作空間”，文中的講解內容簡單清晰，易于學習與理解，下面請大家跟著小編的思路慢慢深入，一起來研究和學習“如何使用GTWS管理Git工作空間”吧！

Great Teeming Workspaces（GTWS）是一個 Git 的復雜工作空間管理工具包，它使我們在開發環境中管理不同的項目和項目的各個版本變得很容易。

有點像 Python 的 venv，但不是為  Python 語言準備的。GTWS  用來管理多個項目的多個版本的工作空間。你可以很容易地創建、更新、進入和離開工作空間，每個項目或版本的組合（最多）有一個本地的  origin，用來與 upstream 同步 — 其余的所有工作空間都從本地的 origin 更新。

部署

${GTWS_ORIGIN}/<project>/<repo>[/<version>]${GTWS_BASE_SRCDIR}/<project>/<version>/<workspacename>/{<repo>[,<repo>...]}

源代碼目錄的每一級（包括全局的家目錄）可以包含一個 .gtwsrc 文件，這個文件中維護與當前級相關的設置和 bash 代碼。每一級的配置會覆蓋上一級。

安裝

用下面的命令檢出 GTWS：

git clone https://github.com/dang/gtws.git

配置你的 ${HOME}/.gtwsrc。它應該包含 GTWS_ORIGIN，也可以再包含 GTWS_SETPROMPT。

把倉庫目錄加到環境變量中：

export PATH="${PATH}:/path/to/gtws

配置

通過級聯 .gtwsrc 文件來進行配置。它從根目錄向下遍歷，會執行在每級目錄中找到的 .gtwsrc 文件。下級目錄的文件會覆蓋上一級。

在你最上層的文件 ~/.gtws/.gtwsrc 中進行如下設置：

• GTWS_BASE_SRCDIR：所有項目源文件目錄樹的基目錄。默認為 $HOME/src。

• GTWS_ORIGIN： 指定 origin git 目錄樹的路徑。默認為 $HOME/origin。

• GTWS_SETPROMPT： 可選配置。如果配置了這個參數，shell 提示符會有工作空間的名字。

• GTWS_DEFAULT_PROJECT： 不指定項目或項目未知時默認的項目名。如果不指定，使用命令行時必須指明項目。

• GTWS_DEFAULT_PROJECT_VERSION： 檢出的默認版本。默認為 master。

在每個項目的根目錄進行以下設置：

• GTWS_PROJECT： 項目的名字（和基目錄）。

• gtws_project_clone： 這個函數用于克隆一個項目的指定版本。如果未定義，它會假定項目的 origin 對每一個版本都有一個單獨的目錄，這樣會導致克隆一堆 Git 倉庫。

• gtws_project_setup： 在克隆完所有的倉庫后，可以選擇是否調用這個函數，調用后可以對項目進行必要的配置，如在 IDE 中配置工作空間。

在項目版本級進行以下設置：

• GTWS_PROJECT_VERSION： 項目的版本。用于正確地從 origin 拉取代碼。類似 Git 中的分支名字。

下面這些參數可以在目錄樹的任意地方進行配置，如果能生效，它們可以被重寫多次：

• GTWS_PATH_EXTRA： 這些是工作空間中加到路徑后的額外的路徑元素。

• GTWS_FILES_EXTRA： 這些是不在版本控制內，但應該在工作空間中被檢出的額外的文件。這些文件包括 .git/info/exclude，每個文件都與倉庫的基目錄相關聯。

origin 目錄

GTWS_ORIGIN （大部分腳本中）指向拉取和推送的原始 Git 檢出目錄。

${GTWS_ORIGIN} 部署：

• /<project>

• 這是一個項目的倉庫的基目錄。

• 如果指定了 gtws_project_clone，你可以配置任意的部署路徑。

• 如果沒有指定 gtws_project_clone，這個路徑下必須有個名為 git 的子目錄，且 git 目錄下有一系列用來克隆的裸 Git 倉庫。

工作流示例

假設你有一個項目名為 Foo，它的 upstream 為 github.com/foo/foo.git。這個倉庫有個名為 bar 的子模塊，它的 upstream 是 github.com/bar/bar.git。Foo 項目在 master 分支開發，使用穩定版本的分支。

為了能在 Foo 中使用 GTWS，你首先要配置目錄結構。本例中假設你使用默認的目錄結構。

• 配置你最上層的 .gtwsrc：

• cp ${GTWS_LOC}/examples/gtwsrc.top ~/.gtwsrc

• 根據需要修改 ~/.gtwsrc。

• 創建頂級目錄：

• mkdir -p ~/origin ~/src

• 創建并配置項目目錄：

• mkdir -p ~/src/foo

  cp ${GTWS_LOC}/examples/gtwsrc.project ~/src/foo/.gtwsrc

• 根據需要修改 ~/src/foo/.gtwsrc。

• 創建并配置 master 版本目錄：

• mkdir -p ~/src/foo/master

  cp ${GTWS_LOC}/examples/gtwsrc.version ~/src/foo/master/.gtwsrc

• 根據需要修改 ~/src/foo/master/.gtwsrc。

• 進入版本目錄并創建一個臨時工作空間來配置鏡像：

• mkdir -p ~/src/foo/master/tmp

  cd ~/src/foo/master/tmp

  git clone --recurse-submodules git://github.com/foo/foo.git

  cd foo

  gtws-mirror -o ~/origin -p foo（譯注：這個地方原文有誤，不加 -s 參數會報錯）

• 上面命令會創建 ~/origin/foo/git/foo.git 和 ~/origin/foo/submodule/bar.git。

• 以后的克隆操作會從這些 origin 而不是 upstream 克隆。

• 現在可以刪除工作空間了。

到現在為止，Foo 的 master 分支的工作可以結束了。假設你現在想修復一個 bug，名為 bug1234。你可以脫離你當前的工作空間為修復這個 bug 單獨創建一個工作空間，之后在新創建的工作空間中開發。

• 進入版本目錄，創建一個新的工作空間：

• cd ~/src/foo/master

  mkws bug1234

• 上面的命令創建了 bug1234/，在這個目錄下檢出了 Foo（和它的子模塊 bar），并創建了 build/foo 來構建它。

• 有兩種方式進入工作空間：

• cd ~/src/foo/master/bug1234

  startws

  或者

  cd ~/src/foo/master/

  startws bug1234

• 上面的命令在 bug1234 工作空間中開啟了一個子 shell。這個 shell 有 GTWS 的環境和你在各級 .gtwsrc 文件中設置的環境。它也把你工作空間的基目錄加入到了 CD，因此你可以從 base 路徑 cd 到相關的目錄中。

• 現在你可以修復 bug1234 了，構建、測試、提交你的修改。當你可以把代碼推送到 upstream 時，執行下面的命令：

  cd foo

  wspush

• wspush 會把代碼推送到與你工作空間相關的分支 — 先推送到本地的 origin，再推送到 upstream。

• 當 upstream 有修改時，你可以用下面的命令同步到本地：

  git sync

• 上面的命令調用了 GTWS 的 git-sync 腳本，會從本地 origin 更新代碼。使用下面的命令來更新本地的 origin：

  git sync -o

• 上面的命令會更新你本地的 origin 和子模塊的鏡像，然后用那些命令來更新你的檢出倉庫的代碼。git-sync 也有一些其他的很好的工鞥。

• 當要結束工作空間中的工作時，直接退出 shell：

  exit

• 你可以在任何時間重復進入工作空間，也可以在同一時間在相同的工作空間中開多個 shell。

• 當你不需要某個工作空間時，你可以使用 rmws 來刪除它，或者直接刪除它的目錄樹。

• 還有一個腳本 tmws 使用 tmux 進入工作空間，能創建一系列的窗口/窗格，這完美契合我的工作流。你可以根據你自己的需求來修改它。

感謝各位的閱讀，以上就是“如何使用GTWS管理Git工作空間”的內容了，經過本文的學習后，相信大家對如何使用GTWS管理Git工作空間這一問題有了更深刻的體會，具體使用情況還需要大家實踐驗證。這里是億速云，小編將為大家推送更多相關知識點的文章，歡迎關注！