Atsushi4のブログ

へたれQtプログラマの備忘録的ななにか

Qtプロジェクトにコミットしてみた

※ より詳しい記事を@IoriAYANEさんが書かれているのでそちらをどうぞ。

Qtプロジェクトにコミットしようよ - 理ろぐ






自分用の備忘録としてMacからQtにコミットした時の手順を残しておきます。
git 超初心者なのと英語サッパリなのと
思い出しながら書いているのとで,間違っているところも多々有ると思います。
お気づきの点が有れば是非教えて下さい。

実施手順一覧的なもの

  1. JIRAアカウント作成
  2. sshの準備
    1. ホストの追加
    2. sshキーペア作成
  3. Gerritの準備
    1. ログイン
    2. 同意事項の確認
    3. ssh公開鍵登録
  4. Gitの準備
    1. ユーザ,メールアドレスの設定
    2. Change-Id自動付与設定
  5. 修正
    1. Qtリポジトリからクローン
    2. ブランチ変更
    3. トピックブランチの作成
    4. コード修正
    5. コミット,プッシュ
  6. レビュー
    1. レビュワー追加
    2. コメント返信
    3. コミット取り下げ

1つずつ説明します。
JIRA 及び Gerrit に,ユーザ名 "atsushi4" で登録するとします。

JIRAアカウント作成

https://bugreports.qt-project.org/ で登録する。

sshの準備

ホストの追加

~/.ssh/config ファイルに3行追加。

Host codereview.qt-project.org
        Port 29418
        User atsushi4

sshキーペア作成

ターミナルを開いてsshのキーペアを作成。

$ ssh-keygen

Gerrit準備

ログイン

JIRAのID,パスワードでログインする。

同意事項の確認

Gerritにログインした状態で Settings ー Agreements の順に選択。
個人なので Individual で Agreement する。

ssh公開鍵登録

Gerrit の Settings ー SSH Public Keys で Add Key ... ボタンを押し,
~/.ssh/id_rsa.pub ファイルの中身を全て貼り付ける。

Gitの準備

ユーザ,メールアドレスの設定

ターミナルから git のグローバル設定。
名前とアドレスは Gerrit の Settings ー Profile の Full Name と Email Address に合わせる。

$ git config --global core.autocrlf input
$ git config --global user.name "Full Name"
$ git config --global user.email "Email Address"

Change-Id自動付与設定

$ scp -p atsushi4@codereview.qt-project.org:hooks/commit-msg .git/hooks

修正

Qtリポジトリからクローン

今回はQt4.8をベースにしたので

$ git clone ssh://codereview.qt-project.org/qt/qt

/qt/qt の部分は Gerrit の Admin ー Projects を参照。
Qt5なら

$ git clone ssh://codereview.qt-project.org/qt/qt5

ブランチ変更

ブランチは Projects の対象プロジェクトページへ飛んで
Branches を参照。
Qt4.8をベースにしたので

$ git checkout 4.8
$ git pull

トピックブランチの作成

$ git checkout -b mytopic

コード修正

コードいじる。

コミット,プッシュ

変更をローカルにコミット

$ git commit

リモートにプッシュ

$ git push ssh://codereview.qt-project.org/qt/qt HEAD:refs/for/master

だったような気がする(ぇ

レビュー

レビュワー追加

Gerrit の My ー Changes あたりから自分の変更ページに飛んで
レビュワーを入力して Add Reviewer ボタンを押す。

自分はqmakeで検索かけて
なんとなく近そうな変更のレビュワーさんを追加した。

コメント返信

変更のページで Review ボタンを押す。

コミット取り下げ

変更のページで Abandan ボタンを押す。この時にコメントも付けられる。