AppCode で Git 入門
このチュートリアルでは、日常的に使用される最も一般的な Git 操作について説明し、AppCode ユーザーインターフェースから実行する方法を示します。プロジェクトから Git リポジトリを作成し、それを GitHub で共有する方法、変更をコミットしてプッシュする方法、ブランチを作成してマージする方法、ファイルの履歴を調査する方法などを学習します。
ビデオチュートリアルを見て、以下のステップバイステップの手順に従ってください。
始める前に
このチュートリアルでは、簡単なプロジェクトを作成して GitHub で共有し、以下で説明する Git タスクをいくつか実行します。GitHub でホストされている既存のプロジェクトを使用する場合は、リモートホストからプロジェクトをチェックアウトする (クローン) の説明に従ってプロジェクトを複製します。
新しいプロジェクトを作成するには:
AppCode を起動し、ウェルカム画面で新規プロジェクトをクリックします。
開いたダイアログで 次へをクリックします。
を選択し、次のフィールドに入力します。
製品名 :
gitdemo
.組織名 : あなたまたはあなたの会社の名前。
組織識別子 : 逆 DNS 形式の会社の識別子(例:
com.mycompany
)。
言語のリストで Swift を選択し、ファイルされたユーザーインターフェースで SwiftUI を選択します。ファイルされたライフサイクルで、Swift UI アプリを選択します。すべてのチェックボックスがオフになっていることを確認し、完了をクリックします。
開いた Finder ウィンドウで、プロジェクトを配置するディレクトリを選択します。
新しいプロジェクトが AppCode ですぐに開きます。

ステップ 1. Git 統合を有効にする
メインメニューから
を選択します。開いたダイアログで、使用可能なバージョン管理システムのリストから Git を選択し、OK をクリックします。
または、Alt+` を押して Git リポジトリの作成を選択します(または 1 を押します)。表示される Finder ウィンドウで、ローカル Git リポジトリのルートフォルダーを指定します。
ローカル Git リポジトリがプロジェクト用に作成されたという通知が届きます。ツールバーとステータスバーに、Git 関連のコントロールが表示されます。

Git を操作するための専用ツールウィンドウが使用可能になりました: コミット(Ctrl+K または )および Git(Alt+9 または )。
コミットツールウィンドウ Alt+0 から、ローカルの変更を確認し、ローカル Git リポジトリにコミットできます。Git ツールウィンドウからは、Git ログを操作したり、GitHub からのプルリクエストを管理したりできます。
ステップ 2. .gitignore にファイルを追加する
コミットツールウィンドウ Alt+0 のローカルの変更タブに、プロジェクトに属するファイルのリストが表示されます。これらのファイルはまだ Git リポジトリに追加されていません。共有するファイルと、VCS で無視するファイルを選択する必要があります。
ファイルをディレクトリごとにグループ化します。Ctrl+Alt+P を押すか、ツールバーの
をクリックしてディレクトリを選択します。
共有したくないディレクトリを選択します。例: 次のディレクトリは、プロジェクトの整合性を損なうことなく無視できます。
.idea : ローカル AppCode インストールの設定。チームメンバー間で設定を共有する場合を除き、このディレクトリは無視してください。
xcuserdata : Xcode プロジェクトのユーザーデータとワークスペース設定。これらのファイルはプロジェクトを開くときに再生成され、通常は共有する必要はありません。
選択範囲を右クリックし、
を選択します。プロジェクトのルートディレクトリに新しい .gitignore ファイルを作成することを確認するプロンプトが表示されます。作成をクリックします。
開いたダイアログから、新しく作成されたファイルを追加を押してすぐに Git に追加するか、キャンセルを押してこれを延期できます。
追加をクリックします。.gitignore ファイルがプロジェクトのルートディレクトリに追加され、変更領域に配置されていることがわかります。無視するように選択したディレクトリは、バージョン管理外ファイルリストに表示されなくなります。
いつでも、.gitignore ファイルを編集して、リストに新しいディレクトリを追加したり、既存のディレクトリを削除したりできます。
ステップ 3. プロジェクトをローカル Git リポジトリにコミットする
これで、バージョン管理されていないファイルのリストから不要なディレクトリがすべて除外されたら、すべてのファイルをリポジトリに追加し、コミットして現在の状態を保存する必要があります。
コミットツールウィンドウ Alt+0 で、ドラッグアンドドロップを使用して、すべてのファイルをバージョン管理外ファイルリストから変更に移動します。ルートフォルダーのチェックボックスをクリックして、すべてのファイルを選択します。
最初のコミットのメッセージを入力してください:
コミットをクリックします。コミットが実行されると、対応する通知が表示されます。
ステップ 4. GitHub でプロジェクトを共有する
プロジェクトを他のコントリビューターが利用できるようにするには、プロジェクトをリモートリポジトリ (たとえば、github.com(英語)) に公開する必要があります。AppCode は GitHub との統合を提供しており、これにより、GitHub でホストされているプロジェクトの管理、外部リポジトリのフォーク、プルリクエストの管理、および IDE からのその他の GitHub 操作の実行が可能になります。詳細については、GitHub セクションを参照してください。
メインメニューから
を選択します。開いたダイアログで、GitHub のログイン名とパスワードを入力し、ログインをクリックします。
GitHub に登録していない場合は、Github にサインアップをクリックして github.com(英語) に移動し、そこに新しいアカウントを作成します。
GitHub で二要素認証を有効にしている場合は、次のダイアログが表示されます。
コードを入力して OK をクリックします。
開いたダイアログで、リポジトリ名(デフォルトではプロジェクト名と同じ)、リモートの名前(デフォルトではオリジン)を変更し、リポジトリタイプ(パブリックまたはプライベート)を選択して、追加できます。必要に応じていくつかの説明:
共用をクリックします。プロジェクトが GitHub で正常に公開されると、次の通知が表示されます。
通知のリンクをクリックして、GitHub のリポジトリを開きます。
ステップ 5. 新規ブランチの作成
たとえば、新しい機能に取り組んでいて、テストする前にメイン(マスター)ブランチに変更を反映させたくない場合は、別のブランチを作成する必要がある場合があります。
Ctrl+T を押して、現在のブランチの最新バージョンを取得します。
Git ブランチメニューから新規ブランチを選択します。
開いたダイアログで、ブランチ名(例:
new_feature
)を指定し、ブランチをチェックアウトするチェックボックスを選択して、新しいブランチにすぐに切り替えます。これで、新しく作成されたブランチに切り替わります。
対応するブランチをリモートリポジトリに追加します。これを行うには、Git ブランチメニューでローカルブランチを選択し、プッシュをクリックします。開いたダイアログで、プッシュをクリックします。新しいブランチがリモートリポジトリに追加され、Git ブランチメニューのリモートブランチリストに表示されます。
ステップ 6. 変更を加えて表示する
Ctrl+T を押して、現在のブランチの最新バージョンを取得します。
プロジェクトに SecondContentView.swift などの新しいファイルを追加し、ContentView.swift ファイルを変更します。
プロジェクトツールウィンドウとエディタータブでは、AppCode はファイルに異なる色を適用します。青は変更されたファイル、緑は新たに追加されたファイルです。さらに、変更されたファイルのガター領域では、変更された行の隣に色付きの変更マーカーが表示されます。
マーカーをクリックして詳細を表示します。
をクリックして、別のウィンドウに違いを表示します。
コミットツールウィンドウ Alt+0 に移動して、すべての変更を一度にプレビューします。ファイルをダブルクリックして、エディターで差分ビューを開きます。
変更を確認するで詳細を参照してください。
ステップ 7. 変更をコミットしてプッシュする
Ctrl+T を押して、現在のブランチの最新バージョンを取得します。
コミットツールウィンドウ Alt+0 で変更を確認し、Git に追加する新しいファイルが選択されていることを確認して、コミットメッセージを入力し、コミットをクリックします。
Ctrl+Shift+K をプッシュするか、メインメニューから コミットのプッシュダイアログが開きます。ここでは、プッシュされるすべてのコミットと、影響を受けるすべてのファイルを確認できます。変更をプッシュする前に、各ファイルの違いを確認できます。これを行うには、ファイルを右クリックして差分の表示を選択するか、Ctrl+D をプッシュします。
を選択して、変更をリモートリポジトリにプッシュします。プッシュをクリックします。
ステップ 8. ブランチをマージし、競合を解決する
1 つのブランチから別のブランチに変更を適用する方法はいくつかあります。たとえば、ブランチのマージとリベース、コミットの選択、個別の変更またはファイルの適用などです。これらのメソッドはすべて Git ブランチから別の Git へ変更を適用するで詳しく説明されています。
このチュートリアルでは、2 つのブランチとコミットのチェリーピックをマージする方法を学習します。
ブランチのマージ
異なるブランチの同じファイルに変更を加えたため、競合ダイアログが表示されます。

競合の解決
競合ダイアログには、競合を解決するためのいくつかのオプションがあります。
自分側を適用 : 現在のブランチで行われた変更を保持します。
相手側を適用 : 現在のブランチにマージする変更を適用します。
マージ : 専用ダイアログで手動で競合を解決します。
マージをクリックします。リビジョンをマージダイアログが開きます。
このダイアログでは、
/
をクリックして変更を受け入れ、
をクリックして変更を拒否し、結果ペインにコードを入力できます。詳細については、Git の競合を解決するを参照してください。
構文エラーは、リビジョンをマージウィンドウでハイライトされます。
上のスクリーンショットのように競合を解決し、適用をクリックします。
Ctrl+Shift+K をプッシュするか、メインメニューから
を選択して、変更をリモートリポジトリにプッシュします。
Git ツールウィンドウ Alt+9 のログタブですべてのブランチのコミットを確認できます。

ここから、コミットを元に戻したり、あるブランチから別のブランチに変更をチェリーピックしたりすることもできます。詳細については、ログタブを参照してください。
ステップ 9. 履歴を表示
master
ブランチで、ContentView.swift ファイルを開きます。ファイルの構文が壊れていることがわかります。1 つのビュー内に 2 つのコンテナーがあります。これらの変更がずっと前に、または他の誰かによって行われたと想像してください。このコードがどのコミットから来たのか興味があるかもしれません。それを見つけるには、次のいずれかを実行します。
エディターまたはプロジェクトツールウィンドウ Alt+1 でファイルを右クリックし、 を選択します。Git ツールウィンドウのヒストリータブが開きます。
このタブでは、ファイルに影響を与えたすべてのコミットを表示し、目的の変更が追加されたコミットを確認できます。
エディターで、履歴を表示するコードフラグメントを選択し、選択部分を右クリックして、選定の歴史ウィンドウが開きます。
を選択します。ここでは、関心のあるコード選択に影響を与えたすべてのコミットを確認できます。
Git リポジトリの変更を調査するで Git 履歴を探索するその他の方法を見つけてください。
ステップ 10. コミットのチェリーピック
この操作では、選択したコミットの変更を 1 つのブランチから別のブランチに適用できます。
master
ブランチで、List
コンテナーでVStack
とHStack
をラップするなどして、ContentView.swift
ファイルのエラーを修正します。Ctrl+K をコミットし、Ctrl+Shift+K にこの変更をプッシュします。new_feature
ブランチに切り替えます。Git ツールウィンドウ Alt+9 で、ログタブを開きます。
ブランチリストで、
master
を選択します。ユーザーリストで、コミットを表示するユーザー —me
を選択します。最後のコミットを選択し、
をクリックします。
開いたダイアログから相手側を適用を押して、競合を解決します。つまり、ContentView.swift ファイル内のコードを、厳選されたコミットからの変更によってオーバーライドします。
開いた変更のコミットダイアログから変更をコミットし、Ctrl+Shift+K にプッシュします。
次は
このチュートリアルで特定の Git タスクを実行する方法が見つからなかった場合は、Git ガイドラインを参照してください。IDE で使用できるすべての Git 操作について説明されています。
バージョン管理システムの操作に関する一般的な情報については、バージョン管理セクションに移動してください。AppCode は、Mercurial、Perforce、Subversion もサポートしています。
プロジェクトがバージョン管理されていない場合でも、ローカル履歴機能を使用して、ローカルの変更の追跡と管理、特定のファイル状態へのロールバック、削除されたファイルの復元などを行うことができます。
関連ページ:

Git リポジトリのセットアップ
既存の Git リポジトリのクローンを作成するか、既存のプロジェクトを Git バージョン管理下に置くと、AppCode は Git がコンピューターにインストールされているかどうかを自動的に検出します。IDE が Git 実行可能ファイルを見つけられない場合は、ダウンロードすることをお勧めします。AppCode は、Windows10 バージョン 2004 で使用可能な Windows Subsystem for Linux 2 (WSL2) の Git をサポートします。Git が Wind...

バージョン管理下のファイルを管理する
VCS にファイルを追加するコミットツールウィンドウを開きます。を押すか、コンテキストメニューから VCS に追加を選択して、バージョン管理下のバージョン管理外ファイル変更リストにファイルを置きます。変更リスト全体を追加するか、別のファイルを選択することができます。プロジェクトで VCS 統合を有効にしている場合、AppCode は、新しく作成された各ファイルをバージョン管理下に追加することを提案します(この動作は、バージョン管理 | 確認の設定ダイアログで変更できます)。特定のファイルを常に...

Git リポジトリの変更を調査する
AppCode では、プロジェクト内のすべての変更を追跡できます。これにより、変更の作成者を特定し、ファイルバージョンまたはコミット間の違いを確認し、必要に応じて変更を安全にロールバックして元に戻すことができます。プロジェクト履歴を確認する:指定したフィルターに一致するプロジェクトソースに加えられたすべての変更を確認できます。プロジェクト履歴を表示するには、Git ツールウィンドウのログタブを開きます。すべてのブランチおよびリモートリポジトリにコミットされたすべての変更が表示されます。マルチリ...

GitHub プルリクエストを操作する
プルリクエストは、オープンソースプロジェクトや一部の企業のワークフローで、コントリビュータからの変更を管理したり、変更がマージされる前にコードレビューを開始したりするために使用されます。プルリクエストを作成することで、元のリポジトリにプッシュしたい変更を他のユーザーに伝えることができます。これにより、そのリポジトリのメンテナーが変更を確認し、議論し、ベースブランチに統合できます。プルリクエストを作成する:メインメニューからを選択します。プルリクエストツールウィンドウが開きます。情報タブでは、左

プロジェクト設定
プロジェクト設定は、現在のプロジェクトにのみ適用されます。これらは、他のプロジェクトファイルと一緒に XML 形式で .idea ディレクトリに保存されます。例: プロジェクト設定には、VCS 設定、コードスタイル設定、言語インジェクションのリストなどが含まれます。これらの設定は、他のプロジェクトファイルと一緒に VCS に追加できます。プロジェクト設定を構成するには、メインメニューからを選択します。または、を押して IDE 設定を表示することもできます。環境設定ダイアログでは、現在のプロジェクト...

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