Git リポジトリのセットアップ

既存の Git リポジトリのクローンを作成するか、既存のプロジェクトを Git バージョン管理下に置くと、 AppCode は Git がコンピューターにインストールされているかどうかを自動的に検出します。IDE が Git 実行可能ファイルを見つけられない場合は、ダウンロードすることをお勧めします。

AppCode は、Windows10 バージョン 2004(英語) で使用可能な Windows Subsystem for Linux 2 (WSL2) の Git をサポートします。

Git が Windows にインストールされていない場合、AppCode は WSL で Git を検索し、そこから使用します。また、\\wsl$ パスを使用すると開かれるプロジェクトの場合、AppCode は WSL から Git に自動的に切り替わります。

WSL から Git を使用するように AppCode を手動で構成する必要がある場合は、IDE 設定 Ctrl+Alt+S のバージョン管理 | Git ページに移動し、Git 実行可能ファイルのパスフィールドの参照アイコンをクリックして、\wsl$ パス（\\wsl$\debian\usr\bin\git など）を介して WSL から Git を選択します。

リモートホストからプロジェクトをチェックアウトする (クローン)

AppCode を使用すると、既存のリポジトリをチェックアウトして（Git の用語で clone）、ダウンロードしたデータに基づいて新しいプロジェクトを作成できます。

メインメニューから Git | クローンを選択するか、現在プロジェクトが開いていない場合は、ウェルカム画面で VCS から取得をクリックします。
バージョン管理から取得ダイアログで、クローンを作成するリモートリポジトリの URL を指定するか、左側の VCS ホスティングサービスの 1 つを選択します。
選択したホスティングサービスにすでにログインしている場合は、完了すると、複製できる利用可能なリポジトリのリストが表示されます。
クローンをクリックします。複製したソースに基づいてプロジェクトを作成する場合は、確認ダイアログではいをクリックします。Git ルートマッピングは、プロジェクトのルートディレクトリに自動的に設定されます。
プロジェクトにサブモジュール(英語)が含まれている場合、それらも複製され、プロジェクトルートとして自動的に登録されます。

既存のプロジェクトを Git バージョン管理下に置く

既存のプロジェクトソースに基づいてローカル Git リポジトリを作成できます。

プロジェクト全体を単一の Git リポジトリに関連付けます

Git の中に入れたいプロジェクトを開きます。
Alt+` を押して VCS 操作のポップアップを開き、VCS 連携を有効にするを選択します。
または、メインメニューから VCS | VCS 連携を有効にするを選択します。
バージョン管理システムとして Git を選択し、OK をクリックします。
プロジェクト全体が 1 つの Git ディレクトリに関連付けられるため、各ファイルを個別に Git ディレクトリに追加する必要はありません。
VCS 統合を有効にすると、AppCode は、VCS を介してプロジェクト設定ファイルを共有するかどうかを確認します。常に追加を選択して、AppCode で作業する他のリポジトリユーザーとプロジェクト設定を同期できます。

プロジェクト内のさまざまなディレクトリをさまざまな Git リポジトリに関連付ける

Git の中に入れたいプロジェクトを開きます。
メインメニューから VCS | Git リポジトリの作成を選択します。
表示されたダイアログで、新しい Git リポジトリを作成するディレクトリを指定します。
Git は外部パスをサポートしていないため、プロジェクトルートの外にあるディレクトリを選択した場合は、リポジトリを作成するフォルダーにもプロジェクトルートが含まれていることを確認してください。
プロジェクト構造内に複数の Git リポジトリを作成している場合は、各ディレクトリに対して前の手順を繰り返します。

プロジェクトの Git リポジトリを初期化した後、プロジェクトファイルをリポジトリに追加する必要があります。

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

コミットツールウィンドウ Alt+0 で、バージョン管理外ファイルノードを展開します。
Git または変更リスト全体に追加するファイルを選択し、Ctrl+Alt+A を押すか、コンテキストメニューから VCS に追加を選択します。
プロジェクトツールウィンドウからローカル Git リポジトリにファイルを追加することもできます。追加するファイルを選択し、Ctrl+Alt+A を押すか、コンテキストメニューから Git | 追加を選択します。

プロジェクトで Git 統合が有効になっている場合、AppCode は、AppCode の外部から追加された場合でも、Git に新しく作成された各ファイルを追加することを提案します。この動作は、IDE 設定 Ctrl+Alt+S のバージョン管理 | 確認ページで変更できます。特定のファイルを常にバージョン管理されていないままにしておきたい場合は、無視できます。

バージョン管理からファイルを除外する (無視)

特定のファイルをバージョン管理しないでおく必要がある場合があります。これらには、VCS 管理ファイル、ユーティリティのアーティファクト、バックアップコピーなどがあります。AppCode を介してファイルを無視することができ、IDE はそれらを Git に追加することを提案せず、無視されたものとしてハイライトします。

バージョン管理されていないファイル、つまりバージョン管理外ファイル変更リストに表示されるファイルのみを無視できます。ファイルがされている場合は Git に追加ではなく、コミット、ローカルの変更ビューで右クリックしてロールバックを選択することができます。

Git では、2 種類の構成ファイルで無視されたファイルパターンをリストできます。

.git/info/exclude ファイル。
このファイルにリストされているパターンは、リポジトリのローカルコピーにのみ適用されます。
このファイルは、Git リポジトリを初期化またはチェックアウトすると自動的に作成されます。
VCS ルートディレクトリとそのサブディレクトリにある 1 つ以上の .gitignore ファイル。
これらのファイルはリポジトリにチェックインされるため、チーム全体で無視パターンを利用できます。無視されたファイルパターンを保存する最も一般的な場所です。
VCS ルートディレクトリに .gitignore ファイルがない場合は、プロジェクトツールウィンドウの任意の場所を右クリックし、新規 | ファイルを選択して、新規ファイルダイアログで .gitignore と入力します。

ファイルを .gitignore または .git/info/exclude に追加する

ファイルを無視するために使用する Git 構成ファイルの種類を決定します。疑わしい場合は、.gitignore を使用してください。
ローカルの変更ビューまたはプロジェクトツールウィンドウで、無視するバージョン管理外のファイルまたはフォルダーを見つけます。これらのビューのファイルの色は、ファイルのステータスを特定できます。
選択範囲を右クリックして、Git | .gitignore に追加するまたは Git | .git/info/exclude に追加を選択します。
これらのビューのファイルの色は、ファイルのステータスを識別できます。

特定のパターンまたは特定のタイプのファイルでファイルを除外する必要がある場合は、.gitignore または .git/info/exclude ファイルを直接編集できます。.gitignore パターンフォーマット(英語)を参照してください。

プロジェクトの確認

AppCode を使用すると、プロジェクトのリポジトリバージョンと比較してローカル作業コピーのステータスを確認できます。特定の色を使用して、変更されたファイル、VCS に追加された新しいファイル、Git によって追跡されていないファイルを確認できます。

ローカルの変更ビューを開きます。

変更リストには、リモートリポジトリと最後に同期してから変更されたすべてのファイル (青色でハイライト) と、VCS に追加されたがまだコミットされていないすべての新しいファイル (緑色でハイライト) が表示されます。
バージョン管理外ファイル変更リストには、あなたのプロジェクトに追加されたが、Git によって追跡されていないすべてのファイルが表示されます。

変更リストの詳細については、変更を異なる変更リストにグループ化するを参照してください。

エディターでファイルへの変更を追跡する

エディターでファイルを変更するときに、ファイルへの変更を追跡することもできます。すべての変更は、変更された行の横のガターに表示される変更マーカーでハイライトされ、リポジトリと最後に同期してから導入された変更のタイプを示します。リポジトリに変更をコミットすると、変更マーカーが消えます。

テキストに加えた変更は色分けされています。

行が追加されました。
行が変更されました。
行が削除されました。

変更マーカー上にマウスカーソルを置いてクリックすると表示されるツールバーを使用して変更を管理できます。ツールバーは、変更された行の前の内容を示すフレームとともに表示されます。

をクリックして変更をロールバックし、をクリックして現在の行の現在のバージョンとリポジトリバージョンの違いを調べることができます。変更されたフラグメントをハイライトするには、をクリックします。

ファイル全体を元に戻す代わりに、このポップアップの内容の一部をコピーしてエディターに貼り付けることができます。

リモートリポジトリを追加する

ローカルソースに基づいて Git リポジトリを作成した場合は、リモートリポジトリを追加して、Git プロジェクトで共同作業できるようにするとともに、すべてのコードベースをローカルに保存するリスクを排除する必要があります。作業を共有し、そこからデータをプルして、他のコントリビューターによって行われた変更をローカルリポジトリのバージョンに統合する必要がある場合は、変更をリモートリポジトリにプッシュします。

たとえば GitHub(英語) からリモート Git リポジトリのクローンを作成した場合、リモートは自動的に構成され、同期するときに指定する必要はありません。Git がクローンを作成したリモートに付けるデフォルト名は origin です。

リモートを定義する

Bitbucket(英語) や GitHub(英語) などの Git ホスティングに空のリポジトリを作成します。AppCode を移動せずに GitHub にリポジトリを作成できます。GitHub でプロジェクトを共有するを参照してください。
メインメニューから Git | プッシュを選択してコミットをプッシュする準備ができたら、プッシュダイアログを起動するか、Ctrl+Shift+K をプッシュします。
これまでリモートを追加していない場合は、リモートの代わりにリモートの定義リンクが表示されます。クリックすると、リモートが追加されます。
表示されるダイアログで、リモートの名前とホストする URL を指定し、OK をクリックします。

2 台目のリモートを追加

場合によっては、2 番目のリモートリポジトリも追加する必要があります。これは、たとえば、書き込みアクセス権のないリポジトリを複製し、元のプロジェクトの独自のフォークに変更をプッシュする場合に便利です。もう 1 つの一般的なシナリオは、他の誰かのプロジェクトフォークである独自のリポジトリを複製し、元のプロジェクトと同期して、そこから変更をフェッチする必要がある場合です。

メインメニューから Git | リモートの管理を選択します。Git リモートダイアログが開きます。
ツールバーの追加ボタンをクリックするか、Alt+Insert を押してください。
表示されたダイアログで、リモートの名前と URL を指定し、OK をクリックします。

リモートを編集するには（たとえば、クローンを作成した元のプロジェクトの名前を変更するには）、Git ログツールウィンドウのブランチペインでリモートブランチを右クリックし、コンテキストメニューからリモートの編集を選択します。
無効になったリポジトリを削除するには、Git ログツールウィンドウのブランチペインでリポジトリを右クリックし、コンテキストメニューからリモートを削除しますを選択します。

このビデオからさらに詳しく学ぶ:

最終更新日: 2023 年 3 月 30 日

関連ページ：

Git リポジトリに変更をコミットしてプッシュする

Git リポジトリに新しいファイルを追加した後、またはすでに Git バージョン管理下にある変更されたファイルを追加し、それらの現在の状態に満足したら、作業の結果を共有できます。これには、リポジトリのスナップショットをプロジェクト履歴に記録するためにローカルにコミットしてから、プッシュをリモートリポジトリにコミットして、他のユーザーが利用できるようにすることが含まれます。Git ユーザー名を設定する Git は、コミットを ID に関連付けるために、ユーザー名を知っている必要があります。ユーザー名...

ファイルステータスのハイライト

ファイルステータス：プロジェクトツールウィンドウでは、ファイルをさまざまな色で表示でき、コード分析の結果やバージョン管理状態などに応じて、エディタータブをハイライトできます。VCS ファイルのステータスの色は、IDE 設定のバージョン管理 | ファイルステータスの色ページで構成できます。以下の表は、いくつかのカラースキームにおけるデフォルトのファイルステータスの色とその意味を示しています。

Git を使用して複数のフィーチャーを同時に処理する

場合によっては、未完成のものを使って別のタスクに切り替えてから、それらに戻る必要があります。AppCode はあなたの作業を失うことなくいくつかの異なる機能に便利に取り組むためのいくつかの方法を提供します: 保留中の変更はスタッシュまたはシェルブできます。スタッシュの変更は、シェルブに非常に似ています。唯一の違いは、パッチの生成方法と適用方法にあります。スタッシュは Git によって生成され、AppCode の内部または外部から適用できます。変更がシェルブされたパッチは AppCode によって生...

リモート Git リポジトリと同期する (フェッチ、プル、更新)

変更をアップストリームにプッシュして作業結果を共有する前に、リモートリポジトリと同期して、プロジェクトのローカルコピーが最新であることを確認する必要があります。これを行うには、次のいずれかの方法があります: 変更のフェッチ、変更のプル、プロジェクトの更新 Git ブランチポップアップは、ブランチにまだフェッチされていない受信コミットがあるかどうかを示します。変更のフェッチ：アップストリームから変更をフェッチすると、リモートリポジトリと最後に同期してから行われたコミットからのすべての新しいデータがロー...

GitHub でホストされているプロジェクトを管理する

プロジェクトをチェックアウトする (クローン)：AppCode から直接貢献したいリポジトリのクローンを作成し、それに基づいて新しいプロジェクトを作成できます。メインメニューからを選択します。Git メニューが使用できない場合は、を選択します。バージョン管理から取得ダイアログで、左側の GitHub を選択します。次のいずれかを実行して、GitHub にログインします。トークンがある場合は、トークンを使用するをクリックし、トークンをトークンフィールドに貼り付けて、ログインをクリックします。それ以外の場...