V8コントリビュート超入門

このスライドはSlidevで作られており、以下のレポジトリで公開しています
https://github.com/riya-amemiya/amemiya_riya_slide_data/blob/main/v8_contribute_intro

Transcript

1. コントリビュート 超入門 V8 西 悠太 / 株式会社ダイニー
2. 自己紹介 西 悠太 (Nishi Yuta) 21歳(重要、important) V8 Contributor Platform Engineer at Dinii Inc. TSKaigi Staff が好きです。 にパッチを送るのも好きです。 TypeScript V8 @riya-amemiya
3. 今日のゴール V8 にコントリビュートする方法を覚える
4. とは？ V8 V型8気筒（ブイがたはちきとう）は、レシプロエンジン等のシリンダー配列形式の一つで、直列4気筒2組 がV字様に配置されている形式を指す。当記事では専らピストン式内燃機関のそれについて述べる注釈 1。 V8（ブイはち）と略されることが多い。 多気筒レシプロエンジンとして広く用いられるエンジン形式の一つであり、自動車用としては特に大排気量 車の多かったアメリカ合衆国で発達してきた。ガソリンエンジン、ディーゼルエンジン双方あるも､現代では 大型乗用車用のエンジン形式として普及している。 引用: V型8気筒 - Wikipedia
5. とは？ V8 V8は、Googleが開発するオープンソースのJIT仮想マシン型のJavaScriptエンジンである3。この名前は同じ く「V8」と略されるV型8気筒エンジンに由来している4。Google ChromeなどのChromiumベースのブラウ ザや、Node.jsなどで採用されている。 概要 ECMAScript (ECMA-262) 準拠で、C++で記述されている。スタンドアローンでの実行が可能なほか、C++で 書かれたアプリケーションの一部として動作させることもできる。 引用: V8 (JavaScriptエンジン) - Wikipedia
6. リポジトリはGitHubではありません 本体 公式ミラー https://chromium.googlesource.com/v8/v8.git https://github.com/v8/v8 で検索すると v8/v8 が出てきますが、あれは公式ミラーです。 GitHub
7. ミラーにPull Requestは送れません → GitHub側の Issues は開いていません → Pull Request も受け付けていません
8. V8 のコードレビューは、Chromiumと同じGerritで行われます。 Gerrit chromium-review.googlesource.com
9. 言葉の対応 → CL (Change List) Merge ボタン → Commit Queue CI → try bot Pull Request
10. 全体の流れ 1 2 3 4 5 6 を入れる ソースを取る ビルドする 直して、テストを足す CLを送る レビューを受けて、Commit Queueに載せる depot_tools
11. depot_tools と V8 の開発には depot_tools が必須です。 git clone して、パスを通します。 Chromium git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git export PATH="$(pwd)/depot_tools:$PATH"
12. 1. ソースを取る fetch v8 cd v8 は depot_tools に入っています。 取得のあと、意図的に detached HEAD になります。 fetch の設定&mainにswitchします。 Gerrit git config --local gerrit.host true git switch main # or checkout main
13. 2. 依存取得&ビルド git pull origin main gclient sync ./tools/dev/gm.py arm64.release でビルドします。 Macbook ProのM4 Proで1時間ぐらいかかります gm.py
14. 3. 直して、テストを足す 初めてのときは、AUTHORS に名前とメールを追記します。最初のパッチに含めます。 変更にはテストが必要です。 → JavaScriptから見える変更は test/mjsunit/ → C++の単体テストは test/unittests/ → バグ修正の回帰テストは test/mjsunit/regress/
15. 回帰テストのファイル名 test/mjsunit/regress/regress-crbug-1000094.js regress-crbug- のあとにバグ番号を付けます。
16. を送る 4. CL まずブランチを作ります。 git new-branch mychange コードを編集したり、テストを書いたりする~ #~ git checkout -b でも問題ありませんが、公式では git new-branch が推奨されています。
17. コミットメッセージ [component] Fix various typos in comments Bug: v8:12345
18. Gerrit のアカウント に、コミットに使う Google アカウントでログインします。 コミットのメールアドレスと、Google アカウントのメールアドレスを一致させます。 chromium-review.googlesource.com
19. 初回だけ、CLAを出します https://cla.developers.google.com/ の Google Contributor License Agreement に署名します。
20. Upload する git cl format git cl presubmit git cl upload git cl upload を打つと、Gerrit 上に CL ができます。
21. 5. レビューとCommit Queue git cl owners → 変更したディレクトリの OWNERS から承認をもらいます → Commit-Queue +1 は、コミットせずに try bot だけ回します → Commit-Queue +2 で、testが全て成功したら自動でコミットされます → (CQを押す権限はcommitterにのみあります)
22. されてから 約 分待ったらマージされます🎉 Commit-Queue +2 30
23. 今日覚えて帰ってほしいこと ✓ V8の本体はchromium.googlesource.comにあり、GitHubの v8/v8 はミラー ✓ 変更は、GerritにCLとして送る ✓ depot_tools を入れてから fetch v8 でソースを取り、 tools/dev/gm.py でビルドする ✓ 挙動が変わる変更には、テストを付ける ✓ OWNERSの承認が付いてCommit Queueを通ると、自動でコミットされる
24. 参考資料 V8 Docs: Contributing depot_tools: Setting up V8 Docs: Checking out the V8 source code V8 Docs: Building V8 from source Chromium Docs: Contributing to Chromium
25. ご清聴ありがとうございました