GitHub との連携

ここでは、Public 指定されたリポジトリを対象として解説を進めます。Private 指定のリポジトリに接続する場合には、対応する Monaca プランに加入する必要があります。詳細は、 料金プラン をご確認ください。

セットアップ

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

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

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

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

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

1 つの GitHub アカウントに対して、1 つの Monaca アカウントのみ、連携を行えます。「 一対多数 」の設定はできません。設定した場合、エラーになります。

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 のメニューから、**プロジェクト → プル**を選択します。リモートリポジトリ側の内容が更新されている場合、その内容がダウンロードされ、対応するブランチ側に反映されます。

IDE 上でプロジェクトを作成した場合、開発者側が自由に作業できるファイルのほとんどは、www フォルダー内に置かれています。これ以外にも、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 アカウント連携 ] ページに移動して、次のような画面が表示されていることを確認します。