AppCode 2023.1 ヘルプ

AppCode で Git 入門

このチュートリアルでは、日常的に使用される最も一般的な Git 操作について説明し、AppCode ユーザーインターフェースから実行する方法を示します。プロジェクトから Git リポジトリを作成し、それを GitHub で共有する方法、変更をコミットしてプッシュする方法、ブランチを作成してマージする方法、ファイルの履歴を調査する方法などを学習します。

ビデオチュートリアルを見て、以下のステップバイステップの手順に従ってください。

始める前に

このチュートリアルでは、簡単なプロジェクトを作成して GitHub で共有し、以下で説明する Git タスクをいくつか実行します。GitHub でホストされている既存のプロジェクトを使用する場合は、リモートホストからプロジェクトをチェックアウトする (クローン) の説明に従ってプロジェクトを複製します。

新しいプロジェクトを作成するには:

  1. AppCode を起動し、ウェルカム画面で新規プロジェクトをクリックします。

  2. 開いたダイアログで iOS | アプリケーション | アプリを選択し、次へをクリックします。

    Create a new project: project templates
  3. 次のフィールドに入力します。

    • 製品名 : gitdemo .

    • 組織名 : あなたまたはあなたの会社の名前。

    • 組織識別子 : 逆 DNS 形式の会社の識別子(例: com.mycompany)。

  4. 言語のリストで Swift を選択し、ファイルされたユーザーインターフェースSwiftUI を選択します。ファイルされたライフサイクルで、Swift UI アプリを選択します。すべてのチェックボックスがオフになっていることを確認し、完了をクリックします。

    New project
  5. 開いた Finder ウィンドウで、プロジェクトを配置するディレクトリを選択します。

新しいプロジェクトが AppCode ですぐに開きます。

Project not connected to any VCS

ステップ 1. Git 統合を有効にする

  1. メインメニューから VCS | VCS 連携を有効にするを選択します。

  2. 開いたダイアログで、使用可能なバージョン管理システムのリストから Git を選択し、OK をクリックします。

    Enable Git integration

または、Alt+` を押して Git リポジトリの作成を選択します(または 1 を押します)。表示される Finder ウィンドウで、ローカル Git リポジトリのルートフォルダーを指定します。

ローカル Git リポジトリがプロジェクト用に作成されたという通知が届きます。ツールバーとステータスバーに、Git 関連のコントロールが表示されます。

Git integration enabled

Git を操作するための専用ツールウィンドウが使用可能になりました: コミットCtrl+K または表示 | ツールウィンドウ | コミット)および GitAlt+9 または表示 | ツールウィンドウ | Git)。

The Git tool window

コミットツールウィンドウ Alt+0 から、ローカルの変更を確認し、ローカル Git リポジトリにコミットできます。Git ツールウィンドウからは、Git ログを操作したりGitHub からのプルリクエストを管理したりできます。

ステップ 2. .gitignore にファイルを追加する

コミットツールウィンドウ Alt+0ローカルの変更タブに、プロジェクトに属するファイルのリストが表示されます。これらのファイルはまだ Git リポジトリに追加されていません。共有するファイルと、VCS で無視するファイルを選択する必要があります。

  1. ファイルをディレクトリごとにグループ化します。Ctrl+Alt+P を押すか、ツールバーの the Group By button をクリックしてディレクトリを選択します。

    Group by directory
  2. 共有したくないディレクトリを選択します。例: 次のディレクトリは、プロジェクトの整合性を損なうことなく無視できます。

    • .idea : ローカル AppCode インストールの設定。チームメンバー間で設定を共有する場合を除き、このディレクトリは無視してください。

    • xcuserdata : Xcode プロジェクトのユーザーデータとワークスペース設定。これらのファイルはプロジェクトを開くときに再生成され、通常は共有する必要はありません。

    Directories to be ignored by Git
  3. 選択範囲を右クリックし、.gitignore に追加 | .gitignore に追加を選択します。

    Add to .gitignore
  4. プロジェクトのルートディレクトリに新しい .gitignore ファイルを作成することを確認するプロンプトが表示されます。作成をクリックします。

  5. 開いたダイアログから、新しく作成されたファイルを追加を押してすぐに Git に追加するか、キャンセルを押してこれを延期できます。

    Add .gitignore to Git

    追加をクリックします。.gitignore ファイルがプロジェクトのルートディレクトリに追加され、変更領域に配置されていることがわかります。無視するように選択したディレクトリは、バージョン管理外ファイルリストに表示されなくなります。

    .gitignore added to Git

    いつでも、.gitignore ファイルを編集して、リストに新しいディレクトリを追加したり、既存のディレクトリを削除したりできます。

ステップ 3. プロジェクトをローカル Git リポジトリにコミットする

これで、バージョン管理されていないファイルのリストから不要なディレクトリがすべて除外されたら、すべてのファイルをリポジトリに追加し、コミットして現在の状態を保存する必要があります。

  1. コミットツールウィンドウ Alt+0 で、ドラッグアンドドロップを使用して、すべてのファイルをバージョン管理外ファイルリストから変更に移動します。ルートフォルダーのチェックボックスをクリックして、すべてのファイルを選択します。

  2. 最初のコミットのメッセージを入力してください:

    The Commit tool window
  3. コミットをクリックします。コミットが実行されると、対応する通知が表示されます。

    The Files Commited notification

ステップ 4. GitHub でプロジェクトを共有する

プロジェクトを他のコントリビューターが利用できるようにするには、プロジェクトをリモートリポジトリ (たとえば、github.com(英語)) に公開する必要があります。AppCode は GitHub との統合を提供しており、これにより、GitHub でホストされているプロジェクトの管理外部リポジトリのフォークプルリクエストの管理、および IDE からのその他の GitHub 操作の実行が可能になります。詳細については、GitHub セクションを参照してください。

  1. メインメニューから VCS | GitHub でプロジェクトを共有を選択します。

  2. 開いたダイアログで、GitHub のログイン名とパスワードを入力し、ログインをクリックします。

    Log in to GitHub

    GitHub に登録していない場合は、Github にサインアップをクリックして github.com(英語) に移動し、そこに新しいアカウントを作成します。

  3. GitHub で二要素認証を有効にしている場合は、次のダイアログが表示されます。

    Two-factor authentication on GitHub

    コードを入力して OK をクリックします。

  4. 開いたダイアログで、リポジトリ名(デフォルトではプロジェクト名と同じ)、リモートの名前(デフォルトではオリジン)を変更し、リポジトリタイプ(パブリックまたはプライベート)を選択して、追加できます。必要に応じていくつかの説明:

    GitHub repository settings

    共用をクリックします。プロジェクトが GitHub で正常に公開されると、次の通知が表示されます。

    The repo is shared on GitHub

    通知のリンクをクリックして、GitHub のリポジトリを開きます。

ステップ 5. 新規ブランチの作成

たとえば、新しい機能に取り組んでいて、テストする前にメイン(マスター)ブランチに変更を反映させたくない場合は、別のブランチを作成する必要がある場合があります。

  1. Ctrl+T を押して、現在のブランチの最新バージョンを取得します。

  2. ステータスバーで、現在のブランチ — master を確認できます。クリックして Git ブランチメニューを開きます。

    Git branch menu
  3. Git ブランチメニューから新規ブランチを選択します。

  4. 開いたダイアログで、ブランチ名(例: new_feature)を指定し、ブランチをチェックアウトするチェックボックスを選択して、新しいブランチにすぐに切り替えます。

    New Git branch

    これで、新しく作成されたブランチに切り替わります。

    Switched to the new branch
  5. 対応するブランチをリモートリポジトリに追加します。これを行うには、Git ブランチメニューでローカルブランチを選択し、プッシュをクリックします。開いたダイアログで、プッシュをクリックします。新しいブランチがリモートリポジトリに追加され、Git ブランチメニューのリモートブランチリストに表示されます。

    Remote Git branch

ステップ 6. 変更を加えて表示する

  1. Ctrl+T を押して、現在のブランチの最新バージョンを取得します。

  2. プロジェクトに SecondContentView.swift などの新しいファイルを追加し、ContentView.swift ファイルを変更します。

    プロジェクトツールウィンドウとエディタータブでは、AppCode はファイルに異なる色を適用します。青は変更されたファイル、緑は新たに追加されたファイルです。さらに、変更されたファイルのガター領域では、変更された行の隣に色付きの変更マーカーが表示されます。

    Changes in Editor and Project tool Window
  3. マーカーをクリックして詳細を表示します。

    Colored change markers
  4. the Show diff icon をクリックして、別のウィンドウに違いを表示します。

    Diff for range
  5. コミットツールウィンドウ Alt+0 に移動して、すべての変更を一度にプレビューします。ファイルをダブルクリックして、エディターで差分ビューを開きます。

    Local Changes

    変更を確認するで詳細を参照してください。

ステップ 7. 変更をコミットしてプッシュする

  1. Ctrl+T を押して、現在のブランチの最新バージョンを取得します。

  2. コミットツールウィンドウ Alt+0 で変更を確認し、Git に追加する新しいファイルが選択されていることを確認して、コミットメッセージを入力し、コミットをクリックします。

  3. Ctrl+Shift+K をプッシュするか、メインメニューから Git | プッシュを選択して、変更をリモートリポジトリにプッシュします。コミットのプッシュダイアログが開きます。ここでは、プッシュされるすべてのコミットと、影響を受けるすべてのファイルを確認できます。変更をプッシュする前に、各ファイルの違いを確認できます。これを行うには、ファイルを右クリックして差分の表示を選択するか、Ctrl+D をプッシュします。

    Push commits
  4. プッシュをクリックします。

ステップ 8. ブランチをマージし、競合を解決する

1 つのブランチから別のブランチに変更を適用する方法はいくつかあります。たとえば、ブランチのマージとリベース、コミットの選択、個別の変更またはファイルの適用などです。これらのメソッドはすべて Git ブランチから別の Git へ変更を適用するで詳しく説明されています。

このチュートリアルでは、2 つのブランチとコミットのチェリーピックをマージする方法を学習します。

ブランチのマージ

  1. ステータスバーの Git ブランチメニューで master ブランチを選択し、チェックアウトをクリックします。

  2. new_feature ブランチで以前に変更された ContentView.swift をいくつか変更します。例:

    Change in master

    このようにして、競合状況をシミュレートします。上記の説明に従って、変更をプッシュしてコミットします。

  3. Git ブランチメニューから new_feature を選択し、現在のブランチにマージをクリックします。

異なるブランチの同じファイルに変更を加えたため、競合ダイアログが表示されます。

Conflicts

競合の解決

  1. 競合ダイアログには、競合を解決するためのいくつかのオプションがあります。

    • 自分側を適用 : 現在のブランチで行われた変更を保持します。

    • 相手側を適用 : 現在のブランチにマージする変更を適用します。

    • マージ : 専用ダイアログで手動で競合を解決します。

    マージをクリックします。リビジョンをマージダイアログが開きます。

    Resolve conflict
  2. このダイアログでは、the Apply changes from the left / the Apply changes from the right をクリックして変更を受け入れ、App diff remove をクリックして変更を拒否し、結果ペインにコードを入力できます。詳細については、Git の競合を解決するを参照してください。

    構文エラーは、リビジョンをマージウィンドウでハイライトされます。

    Conflicts resolved

    上のスクリーンショットのように競合を解決し、適用をクリックします。

  3. Ctrl+Shift+K をプッシュするか、メインメニューから Git | プッシュを選択して、変更をリモートリポジトリにプッシュします。

Git ツールウィンドウ Alt+9ログタブですべてのブランチのコミットを確認できます。

The Log tab

ここから、コミットを元に戻したり、あるブランチから別のブランチに変更をチェリーピックしたりすることもできます。詳細については、ログタブを参照してください。

ステップ 9. 履歴を表示

master ブランチで、ContentView.swift ファイルを開きます。ファイルの構文が壊れていることがわかります。1 つのビュー内に 2 つのコンテナーがあります。これらの変更がずっと前に、または他の誰かによって行われたと想像してください。このコードがどのコミットから来たのか興味があるかもしれません。それを見つけるには、次のいずれかを実行します。

  • エディターまたはプロジェクトツールウィンドウ Alt+1 でファイルを右クリックし、Git | 履歴の表示を選択します。Git ツールウィンドウのヒストリータブが開きます。

    File history

    このタブでは、ファイルに影響を与えたすべてのコミットを表示し、目的の変更が追加されたコミットを確認できます。

  • エディターで、履歴を表示するコードフラグメントを選択し、選択部分を右クリックして、Git | 選択範囲の履歴を表示を選択します。選定の歴史ウィンドウが開きます。

    File history

    ここでは、関心のあるコード選択に影響を与えたすべてのコミットを確認できます。

Git リポジトリの変更を調査するで Git 履歴を探索するその他の方法を見つけてください。

ステップ 10. コミットのチェリーピック

この操作では、選択したコミットの変更を 1 つのブランチから別のブランチに適用できます。

  1. master ブランチで、List コンテナーで VStackHStack をラップするなどして、ContentView.swift ファイルのエラーを修正します。Ctrl+K をコミットし、Ctrl+Shift+K にこの変更をプッシュします。

  2. new_feature ブランチに切り替えます。

  3. Git ツールウィンドウ Alt+9 で、ログタブを開きます。

  4. ブランチリストで、master を選択します。ユーザーリストで、コミットを表示するユーザー — me を選択します。

  5. 最後のコミットを選択し、App icons cherry pick をクリックします。

    Cherry-pick
  6. 開いたダイアログから相手側を適用を押して、競合を解決します。つまり、ContentView.swift ファイル内のコードを、厳選されたコミットからの変更によってオーバーライドします。

  7. 開いた変更のコミットダイアログから変更をコミットし、Ctrl+Shift+Kプッシュします。

次は

このチュートリアルで特定の Git タスクを実行する方法が見つからなかった場合は、Git ガイドラインを参照してください。IDE で使用できるすべての Git 操作について説明されています。

バージョン管理システムの操作に関する一般的な情報については、バージョン管理セクションに移動してください。AppCode は、MercurialPerforceSubversion もサポートしています。

プロジェクトがバージョン管理されていない場合でも、ローカル履歴機能を使用して、ローカルの変更の追跡と管理、特定のファイル状態へのロールバック、削除されたファイルの復元などを行うことができます。

関連ページ:

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 に関連付けるために、ユーザー名を知っている必要があります。ユーザー名...