GitHub との連携

セットアップ

この項目では、Monaca アカウントと GitHub アカウントをリンクする方法を解説します。

1. GitHubアカウント連携 ページへ移動します。

2. 連携するボタンをクリックします。GitHub にログインする必要があります。

3. [ Authorize application ] ページでは、Monaca と GitHub の連携に必要となる認証手続きを行います。Authorize application ( アプリケーションの認証 ) をクリックます。

4. ここまでの手順で、Monaca アカウントと GitHub アカウントの連携が完了しました。

Monaca プロジェクトを新しい GitHub リポジトリに接続する

ステップ 1: 新しい空のリポジトリを作成する

GitHub アカウントに移動し、新しい空のリポジトリを作成します（Readme ファイルなし）。

ステップ 2: リポジトリと Monaca プロジェクトの接続

連携完了後、次に、リポジトリとプロジェクトを接続させるため、Monaca クラウド IDE 側で行う設定があります。なお、ここでは、Monaca と GitHub 間の連携が完了していることを前提に解説します。

次の手順に従い、設定を行います。

1. Monaca Dashboard から、リポジトリに接続するプロジェクトを開きます。

2. Monaca クラウド IDE のメニューから、**プロジェクト → バージョン管理設定**を選択します。

3. GitHub を選択します。

4. リモートの空のリポジトリを選択します。 次に、設定するボタンをクリックして設定を保存します。

5. GitHub 上の新規のリポジトリにプロジェクトがアップロードされます。デフォルトでは、作業ブランチは master として設定されます。別の作業ブランチに切り替える場合は、 プロジェクト → バージョン管理設定 へ移動します。

プロジェクトを GitHub リポジトリから Monaca にインポートする

Monaca と GitHub の連携後、GitHub リポジトリ―に置かれているプロジェクトを、Monaca クラウド IDE にインポートすることもできます。

1. ダッシュボード上で、インポートを選択します。

2. [ プロジェクトのインポート ] ダイアログが表示されます。必要な情報の入力後、GitHubのリポジトリからインポート を選択します。次に、対象のリポジトリを選択して、インポートボタンをクリックします。

3. インポートの完了後、ダッシュボード上で対象のプロジェクトが表示されていることを確認します。デフォルトでは、master ブランチのコンテンツがインポート対象となります。ブランチは、 **プロジェクト → VCS バージョン管理設定**で切り替えることができます。

リモートリポジトリを使用した作業

リポジトリとプロジェクト間の接続完了後は、チームメンバーと同じプロジェクトで作業を開始し、Monaca クラウド IDE から最新のアップデートと同期させることができます。

Monaca クラウド IDE では、ユーザーフレンドリーなバージョン管理用のインターフェイスを提供しています。このインターフェイスを使用すれば、Git のコマンドの詳細を意識せずに、基本的な操作を一通り行うことができます。

ブランチの切り替え ( Git コマンドの checkout )

複数のブランチを使用したプロジェクトで、ブランチの切り替えを行う場合は、次の手順に従います。

1. Monaca クラウド IDE のメニューから、**プロジェクト → バージョン管理設定**を選択します。

2. 現在の作業ブランチから切り替えたいブランチを選択し、アップデートボタンをクリックします。

リモートリポジトリから最新の内容を取得

Git コマンドでは、リモートリポジトリから最新の情報を取得/ダウンロードする場合、git pull ( git プル ) コマンドを使用します。Monaca クラウド IDE では、リモートリポジトリから最新の情報を取得する場合、Monaca クラウド IDE のメニューから、**プロジェクト → プル**を選択します。リモートリポジトリ側の内容が更新されている場合、その内容がダウンロードされ、対応するブランチ側に反映されます。

変更箇所のコミットとリモートリポジトリへの反映

現在作業をしているブランチで行った変更を、リモートリポジトリ側に反映させます。最初に、次の手順に従い、コミットを行い、リモートリポジトリ側へプッシュします ( コミット前に、ファイルを保存する必要があります )。

1. Monaca クラウド IDE のメニューから、**プロジェクト → コミット**を選択します。

2. コミットメッセージを入力して、コミット対象のファイルにチェックを入れます。次に、コミットボタンをクリックします。

3. ここまでの手順で、リモートリポジトリに更新を反映させる準備ができました。次に、 **プロジェクト → プッシュ**を選択します。コミット後、リモートリポジトリ側が更新されているか確認します。

リモートリポジトリ側のコミット履歴の表示 ( GitHub 側の履歴ページ )

リモートリポジトリ側 ( GitHub 側 ) のコミット履歴を確認する場合、**プロジェクト → リモートのコミット履歴**を選択します。現在作業しているブランチのコミット履歴が表示された、GitHub 側のサイト ( 外部ページ ) にリダイレクトされます。

ローカルコミットの履歴表示 ( Monaca クラウド IDE 側の履歴ページ )

ローカルコミットとは、Monaca クラウド IDE 上で行ったコミットを指します。 **プロジェクト → コミット履歴**を選択すれば、ローカルコミットの履歴を表示できます。各コミットの内容を確認する場合には、コミットメッセージ横の ID をクリックします。

Monaca アカウントと GitHub アカウントとの連携の解除

1. GitHubアカウント連携 ページへ移動します。

2. 連携を解除するボタンをクリックします。

GitHub との再度の連携時にエラーが発生した場合

Monaca と GitHub の連携を解除して、再び上記の セットアップ に従い、連携を行ったところ、次のようなエラーが表示される場合があります。

この場合、次の手順に従います。

1. Monaca クラウド IDE からログアウトします。

2. Monaca ログイン ページに移動して、Sign In With GitHubをクリックします。

3. GitHub のアカウント情報を入力します。

4. GitHub の [ Authorize application ] ページにリダイレクトされます。Authorize applicationボタンをクリックして、先に進みます。

5. ここまでの手順を行えば、Monaca と GitHub が再び連携されています。[ GitHub アカウント連携 ] ページに移動して、次のような画面が表示されていることを確認します。