はじめに

今回はGitばかりに注目が集まってイマイチ人気がないように思えるMercurial連携についてです。リポジトリにはBitbucketを使います。Bitbucketから連携用プラグインが提供されていますが、まずはAndroid Studio標準機能だけで説明を進めます（Bitbucketプラグインについては、別枠で解説します⁠）⁠。

今回も第3回で紹介したサンプルコードを題材に説明していきます。

事前準備

Git連携と同じくAndroid Studio単体ではMercurialと連携できませんので、別途 hgコマンドを準備しておいてください。hgコマンドはMercurialの公式サイトから、それぞれのプラットフォーム用のバイナリがダウンロードできます。

インストールしたhgコマンドをAndroid Studioに認識させます。設定箇所は「Preferences / Version Control / Mercurial」の「Specifiy executable path」です。環境変数PATHにhgコマンドが登録済みの場合は、この設定は不要です。

Android StudioのMercurial連携の実態はGit連携と同じく、Android Studioからhgコマンドを呼び出しているだけです。そのためMercurialに関する諸設定はAndroid Studioではなくhgコマンドに対して行います。たとえば、企業内ネットワークからインターネット上のリポジトリにアクセスする場合は、リスト1のように<HOME>/.hgrcまたは<HOME>/mercurial.iniにプロキシサーバの設定を行います。

[http_proxy]
host = proxy.example.com:8080

HGENCODING=utf-8

[ui]
username=masanobu imai <[email protected]>
[extensions]
eol=
[encode]
**=cleverencode:
[decode]
**=cleverdecode:
[http_proxy]
host = proxy.example.com:8080

PC側の準備はこれでおしまいです。Git、Subversionの時と同じく、MercurialもAndroid Studioの他に専用のクライアントを用意しておきましょう。Gitの時に紹介したSourceTreeがWindowsでもMacでも使えて便利です。WindowsだとTortoiseHgというクライアントもあります。

最後に、今回利用するBitbucketですが、アカウントを登録しておくのはもちろんのこと、公開するリポジトリもあらかじめ準備しておいてください。リポジトリタイプは当然、Mercurialです。

プロジェクトをMercurial連携する

これと同じ説明をするのは3回目なのですが、まずはMercurial連携をするプロジェクトを準備します。既存のプロジェクトを利用するも良しですし、新規に作成するも良しです。

Gitの例にならえば、Mercurial連携もメニューバーから「VCS → Enable Version Control Integration...」を実行し「Mercurial」を選ぶのですが、これを実行してもMercurial連携は開始されません。むしろエラーになります（Android Studio v0.3.6で確認⁠）⁠。

おそらくバグなのだと思います。このバグが解消するまでは次に紹介する方法でMercurial連携を開始しましょう。

プロジェクトをMercurial連携するもうひとつの方法は、メニューバーから「VCS → Import into Version Control → Create Mercurial Repository」を実行する事です。コマンドを実行すると 図4のようなダイアログが表示されます。

「どこにMercurialリポジトリを作成する？」と問い合わせてきているので「今のプロジェクト」を指す「Create repository for the whole project」を選択します。もう一方の選択肢「Select where to create repository」は任意の場所にMercurialリポジトリを作成します⁠）⁠。

これでプロジェクトがMercurial連携状態になりました。ツールバーにVCS関連のアイコンが追加され、「⁠Changesツールウィンドウ」と「Version Controlツールウィンドウ」が表示されます。

Git連携の時と同じく、ステータスバーの右端にブランチ名が表示されます。Mercurialでも、この地味ぃなインターフェイスは意外に便利なので、存在を覚えておいてください。

ちなみに、この状態はまだ何もMercurialリポジトリにAddされていませんが、プロジェクト自体はMercurialリポジトリになっています。

Mercurialリポジトリに対する操作

では、実際にファイルを追加し、それをMercurialリポジトリにコミットしてみましょう。

除外ファイルを設定する

早速ファイルを登録したいところですが、その前にMercurialリポジトリに対する除外ファイルの設定を行います。Subversion連携の時と同じく、リポジトリに対する除外ファイル設定はほとんど行われていないため、プロジェクト配下のすべてのファイルがコミット候補になり得ます。

Mercurialの除外ファイル設定はSubversionより面倒ではないので、ファイルを追加する前にちゃちゃっと設定してしまいます。Mercurialの除外ファイル設定はGit同様、専用の設定ファイル（.hgignore）を用意するだけです。

プロジェクトのトップディレクトリ（<PROJECT_HOME>）に.hgignoreファイルを作成し、リスト4の内容を登録します。Android Studioの"New..."コマンドで .hgignore ファイルを作成した場合「そのファイルはナニモノだ？」と問われるので、テキストファイル（Text files）に割り当てておきます。

syntax: glob
.gradle/
local.properties
.idea/workspace.xml
MyFirstApp/build/
.DS_Store

.hgignoreができたのなら「Changesツールウィンドウ / Localタブ」を更新して、それが「Ignored Files」に反映されていることを確認しましょう。

このように.hgignoreの内容がきちんと「Ignored Files」に反映されるため、Android Studioの「Ignored Files」設定は不要です。

なお、作成した.hgignoreもMercurialリポジトリに追加するファイルに含めます。

リポジトリにファイルを追加する

.hgignore の設定のおかげで「Unversioned Files」の数がだいぶ減ったので、第24回の時と同じく「Changesツールウィンドウ / Localタブ」をドラッグ＆ドロップして、対象ファイルをリポジトリに追加しましょう。

.hgignoreを設定しても「Unversioned Files」が大量にあるプロジェクトの場合は、第28回の時と同じく「Click to browse」リンクを押して、対象ファイルをリポジトリに追加します。

リポジトリの変更を取りやめる

リポジトリの変更を取りやめるのは、連携するバージョン管理システムに関わりなく "Revert" を実行すればよいです。Mercurialの場合、メニューバーの「VCS → Mercurial → Revert」にありますが、ツールバーの"Revert"も「Changesツールウィンドウ」のツールバーにある"Revert"もやってることはすべて同じです。

リポジトリにコミットする

ファイルの登録が一通り完了したなら"Commit Changes"を実行して、それらをリポジトリにコミットします。

画面右側にある「Before Commit」はとりあえず全部OFFでよいです。「⁠Commit」ボタンのブルダウンは「Preferences / Appearance」の「Allow merging buttons on dialogs」をOFFすると図11のようになります。

まだリモートリポジトリにプッシュしないので「Commit」ボタンを押し、ローカルのリポジトリに変更をコミットします。

リポジトリのコミットログをみる

無事にコミットができたなら、そのログを確認してみましょう。コミットログは「Changesツールウィンドウ」の「Log」タブで確認することができます。

リポジトリをBitbucketに公開する

ローカルのMercurialリポジトリをBitbucketに公開します。とは言え、これから説明する内容はBitbucket固有の話ではないので、他のリモートリポジトリに対しても通用します。

メニューバーの「VCS → Mercurial」のサブメニューを見ても、リモートリポジトリに関する設定は見当たりませんが、その辺は気にせず「VCS → Mercurial → Push」を実行します。

この「Push」ダイアログの「Destination Repository URL」にプッシュ先のURL（BitbucketのリポジトリURL）を入力して「Push」ボタンを押すだけです。その他のオプションについては次回説明します。

「Push」ボタンを押した後、必要があればリポジトリへの認証ダイアログが表示されるので、リポジトリにアクセスするIDとパスワードを入力してください。

Gitの時にくらべると簡単に見えますが、ちょっとした落とし穴があります。この一連の方法だと、プッシュ時にだけリモートリポジトリを指定したに過ぎません。リモートリポジトリの変更を取得するプッシュ操作で不都合が生じるので、ローカルのリポジトリにリモートリポジトリを登録しておきます。<PROJECT_HOME>/.hg/hgrcファイルにリスト5のように登録名defaultでリモートリポジトリを設定してください。

[paths]
default=https://[email protected]/masanobuimai/myfirstappproject

これさえできれば、一連の操作はAndroid Studioで完結するのに、実に惜しいです（⁠「⁠Terminalツールウィンドウ」から、hgrcファイルを編集すれば、すべてAndroid Studioでできるという屁理屈もありますが……⁠）⁠。ちなみに、リモートリポジトリが登録されているかどうかは「Terminalツールウィンドウ」で次のコマンドを実行するとわかります。

または、SourceTreeのサイドバーから確認することができます。

ちょっと手こずりましたが、これでリポジトリは図16のような状態になりました。

Bitbucketからプロジェクトをチェックアウト（クローン）する

Bitbucketのリポジトリからローカルにチェックアウト（クローン）してみます。

ホントウは「クローン」が正しくて「チェックアウト」は間違いなのですが、Android Studioのメニュー表記はSubversion由来になっているため「リモートリポジトリをクローンする」は「リモートリポジトリから（ローカルに）チェックアウトする」という表現になりがちです。

Android Studioのウェルカム画面、もしくはメニューバーの「VCS」から"Checkout from Version Control"を実行して「Mercurial」を選びます。

コマンドを実行すると図19のような「Clone Mercurial Repository」ダイアログが表示されるので「Mercurial Repository URL」にBitbucketのリポジトリURLを入力します。

ダイアログに入力する項目の意味はそれぞれ表1の通りです。

ダイアログに必要な情報を入力したなら「Clone」を押してチェックアウト（クローン）を開始します。それが済むと、そのままプロジェクトを開くかと聞いてくるので、指示に従ってプロジェクトを開きましょう。

この操作で作成したリポジトリには、はじめから <PROJECT_HOME>/.hg/hgrc にクローンを取得したリモートリポジトリが登録されているので、hgrcの編集は不要です。

次回の予定

Mercurial連携の流れをざっと紹介しました。次回はもう少し踏み込んだMercurial連携の使い方について紹介します

［補足］Bitbucketプラグインについて

プラグインについてはまだちゃんと説明していませんが、「⁠Preferences / Plugins」からプラグインの登録・解除ができます。すごく省略して説明しますが、Bitbucketプラグインのインストール方法は以下のとおりです。

1. 「Preferences / Plugins」設定画面を開く。
2. 画面下にある「Browse repositories...」ボタンを押す。
3. 「Browse Repositories」ダイアログから「Bitcuketプラグイン」を探す。
4. 「Bitcuketプラグイン」を選択して、ツールバーの「Download and Install（⁠）⁠」を押す。
5. 「Download and Install」ダイアログが表示されるので「Yes」を選ぶ。
6. プラグインのダウンロードが開始される。
7. 「Close」ボタンを押して「Browse Repositories」ダイアログを閉じる。
8. 「Preferences / Plugins」設定画面の下にある「OK」ボタンを押す。
9. 「再起動しすか？」と聞いてくるので「Restart」を選ぶ。
10. Android Studioが再起動するので、それ以降「Bitbucketプラグイン」が有効になる。

Bitbucketプラグインができることは次の3つです。

• プロジェクトをBitbucketに公開する
• Bitbucketからプロジェクトをチェックアウト（クローン）する
• Bitbucketの課題管理システムと連携する

上の2つはいずれもBitbucketプラグインがなくてもできてしまいましたが、プラグインを使うと若干便利になるので、その違いについて紹介します。なお、課題管理システムとの連携については、別の回で改めて説明します。

プロジェクトをBitbucketに公開する

Bitbucketプラグインがインストールしてあると、メニューバーの「VCS → Import into Version Control」に「Share project...」が追加されているので、それを実行します。

「Share project on Bitbucket」ダイアログが表示されるので、登録するプロジェクト名（Name⁠）⁠、説明文（Description）などを設定して「OK」ボタンを押します。プロジェクト名（Name）には、モジュール名がプリセットされていますが、先ほどのチェックアウト時の弊害があるためプロジェクト名に直しておいた方がよいでしょう。また非常にわかりづらいのですが「Description」欄には文字を入力することができます。

なお、すでに同名のプロジェクトがBitbucketに存在する場合は、ダイアログにその旨を示すエラーが通知されます。

「OK」ボタンを押すとプロジェクトをBitbucketに公開する処理を行います。処理が完了すると図23 のようなメッセージが表示されます。「⁠Bitbucket」という思わせぶりなリンクが表示されていますが、クリックしても何も起こりませんでした……。

若干詰めの甘いところもありますが、それでもプロジェクト公開後は<PROJECT_HOME>/.hg/hgrcにリモートリポジトリも登録されているので、ちょっとは楽できると思います。

Bitbucketからクローン

Welcome画面やメニューバーの「VCS → Check out from Version Control」に「Bitbucket」が追加されてているので、それを選択します。すると、図25のような「Select repository to clone from Bitbucket」ダイアログが表示されます。

「Repository list」のドロップダウンリストにBitbucket上のプロジェクトがリストアップしてあるので、チェックアウト（クローン）したいプロジェクトを選び「OK」ボタンを押します。

これ以降は「Mercurial」でチェックアウトしたときと同じように、リポジトリのクローン＆プロジェクトのオープンを順次実行します。しかし、なぜかこのプラグイン、Bitbucketにsshで接続しにいこうとするため、企業内ネットワーク中など使用できるプロトコルが制限されている環境ではうまく機能しません。

図26にチェックアウト後に確認したhg pathの実行結果を示します。

まぎらわしいことに「Select repository to clone from Bitbucket」ダイアログの「Repository list」はHTTPで取得しているようで途中までうまく行くのですが、肝心のチェックアウトでプロキシを越えられずにエラーになります。

サードパーティのプラグインなので多少は大目に見るしか無いのでしょうが、Bitbucket本家が出しているだけに、もうちょっとしっかりしてもらいたいものです。とりあえず、今後のバージョンアップに期待しましょう（Android Studio v0.3.6とBitbucketプラグイン v1.2.1で確認しました⁠）⁠。

HGENCODING=cp932

[ui]
username=masanobu imai <[email protected]>
[extensions]
eol=
[http_proxy]
host = proxy.example.com:8080

[patterns]
**.iml = LF
**.xml = LF
**.bat = LF
**.gradle = LF
**.properties = LF
**.java = LF
**.txt = LF