V8 への貢献

このページの情報は、V8 への貢献方法について説明しています。私たちに貢献を送付する前に、必ずすべてをお読みください。

コードの取得 #

貢献する前に #

# V8 のメーリングリストでガイダンスを求める

大規模な V8 への貢献の作業を開始する前に、最初に V8 のコントリビューターのメーリングリスト https://groups.google.com/group/v8-dev からご連絡いただき、支援を受けるか、ご案内していただければと思います。最初に調整することで、後になってイライラすることがはるかに少なくなります。

CLA に署名する #

コードを使用するには、Google 個人の貢献者向けライセンス同意書にオンライン上で署名する必要があります。これは主に、あなたの変更に対する著作権が、貢献がコードベースの一部になった後もあなたに帰属するため、あなたのコードを使用および配布するための許可が必要になるからです。さらに、たとえばあなたのコードが他者の特許を侵害するかどうかを知っている場合は教えていただくなど、その他のさまざまなことを確認する必要があります。コードのレビューのためにコードを提出してメンバーが承認するまでこれを行う必要はありませんが、コードをコードベースに入れる前にこれを行う必要があります。

法人による貢献には、上記のライセンス同意書とは異なるソフトウェア譲渡および法人コントリビューターライセンス同意書が適用されます。

こちらからオンラインで署名します。

コードを提出する #

V8 のソースコードはGoogle C++ スタイルガイドに従っているため、これらのガイドラインに精通する必要があります。コードを送信する前に、すべてのテストに合格する必要があり、送信前チェックを正常に実行する必要があります。

git cl presubmit

送信前スクリプトは Google のリンター cpplint.py を使用します。これはdepot_tools の一部であり、PATH にある必要があります。したがって、PATH にdepot_toolsがある場合は、すべて正常に機能するはずです。

V8 の codereview ツールにアップロードする #

プロジェクトメンバーによる提出を含むすべての提出には、レビューが必要です。Chromium プロジェクトと同じコードレビューツールとプロセスを使用します。パッチを送信するには、depot_toolsを取得し、レビューをリクエストするに関するこの手順に従う必要があります（Chromium ワークスペースではなく V8 ワークスペースを使用します）。

破損または退行に注意する #

コードレビュー承認を受けたら、コミットキューを使用してパッチを取得できます。これにより、一連のテストが実行され、すべてのテストが合格すればパッチがコミットされます。変更がコミットされたら、コンソールはコミットキューよりもさらに多くのテストを実行するため、変更後にボットが緑色になったらコンソールを確認することをお勧めします。