入門

主要元件

使用 Odoo.sh 時,了解其中涉及的主要元件十分重要:

雖然這些元件彼此相互關聯,但每個元件在 Odoo 應用程式的開發和部署過程中都扮演著不同的角色。它們共同組成一個從程式碼開發到實際商業應用的完整流程。

GitHub 儲存庫

GitHub 儲存庫就像電腦中的一個資料夾,其中包含特定專案的所有檔案和資料夾。不同之處在於,它儲存在 GitHub 上,可供多台電腦上的多人存取和編輯。

換句話說,GitHub 儲存庫是您存放專案檔案的地方,您可以與他人分享這些檔案,讓他們與您協作、進行變更並貢獻於您的專案。它還會追蹤專案隨時間的所有變更,讓您在需要時能輕鬆回復到先前的版本。

此外,GitHub 還提供許多功能來協助您管理專案,例如問題追蹤、提取請求和程式碼審查。它是管理和協作軟體專案的強大工具,廣受全球開發人員使用。這是一個版本控制的空間,用於儲存 Odoo 應用程式的原始碼。它會追蹤每項變更,支援協作,且可設為公開或私人。

GitHub 儲存庫範例

Odoo.sh 專案

Odoo.sh 專案是一種與 GitHub 整合的 *平台即服務*(PaaS),可簡化 Odoo 應用程式的開發、測試和部署流程。它包含自動備份、暫存環境和持續整合流程等工具。

Odoo.sh 專案範例

Odoo 資料庫

Odoo 資料庫儲存 Odoo 應用程式所使用及產生的所有營運資料,例如業務記錄、配置和使用者資料。

Odoo 資料庫範例

使用者類型

Odoo.sh 涉及不同類型的使用者,每種使用者在專案生命週期中都有特定的角色:

  • GitHub 使用者:擁有存取權限,可存取已連結至 Odoo.sh 專案之 GitHub 儲存庫的開發人員。擁有儲存庫的存取權限,並不代表自動成為 Odoo.sh 專案的協作者。

  • Odoo.sh 協作者:管理 Odoo.sh 專案的人員。每位協作者都必須連結至一個 GitHub 使用者。但協作者與資料庫使用者並不相同。

  • 資料庫使用者:已部署之 Odoo 資料庫的終端使用者。他們與正式系統互動,但不參與開發或專案管理工作。

技術概念

使用 Odoo.sh 時,了解數個技術概念也很重要:

分叉存放庫

在 GitHub 上分叉存放庫,是指在您自己的帳戶中建立其他人存放庫的複本。這樣您就可以對存放庫進行變更,而不會影響原始版本。

當您分叉存放庫時,會建立該存放庫的個人複本,其中包含原始存放庫中的所有檔案和資料夾。接著,您可以像處理任何其他存放庫一樣,對複本中的檔案進行變更並提交。

分叉存放庫的好處在於,您可以在不影響原始版本的情況下對程式碼進行變更,這在您想要嘗試新功能或修復他人程式碼中的錯誤時非常有用。您也可以將分叉的存放庫作為專案的起點,並根據需要進行變更。

在對分叉的存放庫進行變更後,您可以向原始存放庫擁有者提交拉取請求(pull request),請求他們將您的變更合併回其存放庫。這是開源專案接受其他開發人員貢獻的常見方式,也是參與社群和提升程式設計技能的絕佳途徑。

推送提交

當您在本地電腦上的 Git 存放庫中對一個或多個檔案進行變更時,這些變更會被視為 未提交。換句話說,Git 知道已進行變更,但尚未正式儲存或記錄。

若要儲存這些變更並將其加入 Git 存放庫,您需要建立一個 提交。提交是您在特定時間點對檔案所做變更的快照。它記錄了進行了哪些變更、由誰進行以及何時進行。

建立提交後,您就可以將其 推送 至遠端存放庫,例如代管在 GitHub 上的存放庫。推送提交是指將您在提交中所做的變更從本地存放庫傳送至遠端存放庫,以便其他人可以檢視和使用。

總結來說,推送提交是指將您在本地電腦上的 Git 存放庫中對檔案所做的變更傳送至遠端存放庫。這是與他人分享您的變更並在專案中共同作業的一種方式。

合併分支

將一個分支合併至另一個分支,是將一個分支中所做的變更整合至另一個分支的過程。例如,假設您建立了一個名為 feature-branch 的新分支來開發專案的新功能。當您完成該分支的變更後,就可以將這些變更合併回主分支(通常稱為 master 或 main 分支)。

當您合併分支時,Git 會檢查兩個分支中的變更並嘗試將其整合。如果兩個分支所做的變更之間存在任何衝突,Git 會提示您在完成合併之前解決這些衝突(在程式碼層面)。