對 V8 貢獻

本頁面上的資訊說明如何對 V8 貢獻。請務必在向我們傳送貢獻之前閱讀完整內容。

取得程式碼 #

在貢獻之前 #

在 V8 的郵件清單上尋求指導 #

在開始進行較大型的 V8 貢獻之前，您應先透過 V8 貢獻者郵件清單與我們聯繫，以便我們提供協助並可能為您提供指導。事先協調可讓您更輕鬆地避免日後感到沮喪。

簽署 CLA #

在我們可以使用您的程式碼之前，您必須線上簽署 Google 個人貢獻者授權合約。這是因為即使您的貢獻已成為我們程式碼庫的一部分，您仍擁有對變更的著作權，因此我們需要您的許可才能使用和散布您的程式碼。我們也需要確認其他事項，例如您會告知我們您知道您的程式碼侵犯了其他人的專利。您不必在提交程式碼供審查且有成員核准之後才執行此動作，但您必須在我們將您的程式碼放入程式碼庫之前執行此動作。

公司所做的貢獻適用於與上述不同的合約，即軟體授權及公司貢獻者授權合約。

請按這裡線上簽署。

提交您的程式碼 #

V8 的原始程式碼遵循 Google C++ 風格指南，因此您應熟悉這些指南。在提交程式碼之前，您必須通過我們所有的測試，並且必須成功執行提交前檢查

git cl presubmit

提交前檢查指令碼使用 Google 的程式碼檢查工具 cpplint.py。它是 depot_tools 的一部分，而且必須在您的 PATH 中 — 因此，如果您的 PATH 中有 depot_tools，一切都應該正常運作。

上傳至 V8 的程式碼審查工具 #

所有提交，包含專案成員的提交，都需要審查。我們使用與 Chromium 專案相同的程式碼審查工具和流程。若要提交補丁程式，您需要取得 depot_tools，並依照請求審查中的說明進行操作（使用您的 V8 工作區，而非 Chromium 工作區）。

注意中斷或回歸 #

取得程式碼審查核准後，您可以使用提交佇列提交您的補丁程式。它會執行多項測試，並在所有測試通過時提交您的補丁程式。變更提交後，建議您觀看主控台，直到機器人在變更後顯示為綠色，因為主控台會執行比提交佇列更多的測試。