JetBrains Rider 2024.1 ヘルプ

バージョン管理を始めましょう

JetBrains Rider には、すべてのメジャーバージョン管理システムをサポートする本格的な VCS クライアントが含まれています。Git を例として取り上げ、基本的な VCS 機能について説明します。ソリューションのローカル Git リポジトリを作成し、コードの変更の追跡を開始してから、それをリモートリポジトリに関連付けて、ソリューションを他のコントリビューターが利用できるようにします。

ステップ 1. Git を入手

マシンで Git を使用したことがある場合は、この手順をスキップできます。Git はすでにインストールされており、Rider が自動的に検出します。

それ以外の場合は、公式ページ(https://git-scm.com/downloads(英語))から Git をダウンロードしてインストーラーを実行してください。

Rider が Git 実行可能ファイルを検出したことを確認するには、JetBrains Rider 設定 Ctrl+Alt+Sバージョン管理 | Git ページに移動します。ほとんどの場合、検出されたパスが表示されますが、システム環境がカスタマイズされていて Git パスが空の場合は、パスを手動で指定してください。正しいパスを取得したら、テストをクリックします。

JetBrains Rider: Checking the status of Git executable

ステップ 2. Git リポジトリの作成

ソリューションを Git でバージョン管理するには、ソリューションのルートディレクトリに Git リポジトリを作成する必要があります。JetBrains Rider はあなたのためにそれを行うことができます。

  1. Alt+` を押して VCS 操作のポップアップを開き、VCS 連携を有効にするを選択します。

    あるいは、VCS | VCS 連携を有効にするに進みます。

  2. バージョン管理システムとして Git を選択し、OK をクリックします。

    JetBrains Rider: Enabling Git integration

    プロジェクト全体が単一の Git ディレクトリに関連付けられるため、各ファイルを Git ディレクトリに個別に追加する必要はありません。

  3. VCS 統合を有効にすると、JetBrains Rider は、VCS を介してプロジェクト設定ファイルを共有するかどうかを確認します。常に追加を選択して、JetBrains Rider で作業する他のリポジトリユーザーとプロジェクト設定を同期できます。

    Notification prompting to select how to treat configuration files

    詳細は、ディレクトリベースの設定を共有するを参照してください。

ステップ 3. バージョンを作成する対象を決定する

ソリューションが Git リポジトリに関連付けられたらすぐに、コードのバージョン管理を開始できます。

  1. 最初に行く場所はコミットウィンドウです。バージョン管理外ファイルにすべてのプロジェクトファイルが表示されます。

  2. ファイルをディレクトリごとにグループ化して、ディレクトリ構造を視覚化します。

    JetBrains Rider VCS: Grouping unversioned files by directory
  3. バージョン管理したくないファイルやディレクトリは無視してください。これらは通常 binobj プロジェクトディレクトリとユーザー固有の設定DotSettings.user ファイルを含みます。

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

    • .git/info/exclude ファイル。

      このファイルにリストされているパターンは、リポジトリのローカルコピーにのみ適用されます。

      このファイルは、Git リポジトリを初期化またはチェックアウトすると自動的に作成されます。

    • VCS ルートディレクトリとそのサブディレクトリにある 1 つ以上の .gitignore ファイル。

      これらのファイルはリポジトリにチェックインされるため、ファイル内の無視パターンをチーム全体が利用できるようになります。無視されたファイルパターンを保存する最も一般的な場所です。

      VCS ルートディレクトリに .gitignore ファイルがない場合は、エクスプローラーウィンドウをファイルシステムビューに切り替え、ルートノードを右クリックして追加 | ファイルを選択し、新規ファイルダイアログに .gitignore と入力します。

      JetBrains Rider: .gitignore in the project root

    これで、VCS ルートに .gitignore がある場合、無視するバージョン管理されていないファイルまたはフォルダーを右クリックして、Git | .gitignore に追加するを選択できます。

    JetBrains Rider: adding files to .gitignore
  4. .idea ディレクトリに表示される .gitignore ファイルとプロジェクト設定ファイルをバージョン管理すること、つまり無視しないことをお勧めします。

ステップ 4. 変更をコミットする

バージョン管理されていないファイルは追跡されません。Git に新しいファイルの追加をログに記録するには、ファイル(または、Git の用語を用いて、段階それを)追加する必要があり、その後、リポジトリにコミットします。Rider では、これら 2 つのことを 1 つのコマンドとして実行できます。つまり、ステージングされていないファイルをコミットできますが、ファイルの状態をよりよく理解するために、2 つの別々のコマンドを使用して実行します。

  1. ステージングするファイルまたはディレクトリ(この場合はバージョン管理外ファイルノード全体)を右クリックし、コンテキストメニューから VCS に追加を選択するか、Ctrl+Alt+A を押します。

  2. ファイルの色の変化に注目してください。ブラウンはステージングされていないことを意味し、グリーンはコミットのために新たにステージングされたことを意味します。

  3. すべてのファイルがステージングされたら、チェックボックスを使用してコミットする必要があるものを選択します。この例ではデフォルト変更リスト全体であるため、Ctrl+K を押してすべてのコミットされていないファイルを選択することもできます。

  4. ビューの下部に意味のあるコミットメッセージを入力し、コミットをクリックするか、Ctrl+Enter を押します。これにより、現在のソリューションの状態のスナップショットが Git に記録され、今後このスナップショットに戻ることができます。

  5. 追跡されていない変更はもうないことがわかります。すべてが Git リポジトリに保存されます。

ステップ 5. 変更を追跡する

コードが VCS にあるときは、何がどのように変化しているのかをいつでも確認できます。

  1. 編集を行うと、行が変更されたことを知らせる青いガターマークが表示されます。

  2. ガターマークをクリックして、変更前の違いを確認してください。編集を元に戻すには、行のロールバックをクリックします。

    JetBrains Rider: Viewing VCS changes in the editor
  3. 追跡および変更されたすべてのファイルは、コミットウィンドウに青色で表示されます。差分プレビューを開いて、選択したファイルの変更を確認できます。

  4. 変更に満足したら、コミットするファイルを選択するか、Ctrl+K を押してすべてのファイルを選択し、コミットメッセージを入力してからコミットをクリックします。

  5. リポジトリツールウィンドウ Alt+9ログタブですべてのコミットを見つけることができます。

  6. 履歴でコミットを選択すると、その詳細と、このコミットで変更されたすべてのファイルが表示されます。コミットで変更されたファイルをクリックして、このファイルで正確に変更された内容を確認します。

ステップ 6. 分散ストレージ

これで、Git リポジトリをローカルに設定しました。これにより、変更の履歴を調べたり、コミットされた状態に戻ることができます。

ただし、Git を最大限に活用するには、ローカルリポジトリをオリジンとも呼ばれるリモートリポジトリに関連付ける必要があります。これにより、ローカルリポジトリが破損した場合でもコードとその履歴を安全に保つことができ、最も重要なこととして、同じプロジェクトで作業している他のユーザーと共同作業を行うことができます。

GitHub(おそらく最も人気のある Git ホスティングサービス)を使用して、この例のリモートリポジトリを作成しましょう。

  1. github.com(英語) にログインし(アカウントがない場合は無料のアカウントを作成できます)、リポジトリビューに切り替えます。

  2. 新規をクリックし、リポジトリの名前を指定してからリポジトリの作成をクリックします。

    Creating a new repository on GitHub
  3. リポジトリが作成されると、その URL が表示されます。その横のボタンをクリックしてクリップボードにコピーします。

  4. Rider に戻って、メニューから Git | リモートの管理を選択し、コピーした GitHub の URL を使用して新しいリモートを追加します。

  5. メニューから Git | プッシュを選択するか、Ctrl+Shift+K を押します。開いたダイアログで、これまでに行ったコミットのリストを見ることができます。ダイアログでプッシュをクリックしてリモートに転送します。

  6. GitHub 証明書を提供するとすぐに、GitHub で作成したばかりのリモートリポジトリにコミットがプッシュされます。

これで、GitHub リポジトリの URL を使って他のマシンから自分のコードにアクセスしたり、自分のプロジェクトを他の人と共有したりすることができます。

関連ページ:

ソリューション設定を共有する

Rider は 2 つのメカニズムを使用して設定を保存します。フロントエンドの IntelliJ プラットフォームの機能の設定の一部は、ディレクトリベースのフォーマットに保存されます。バックエンド ReSharper 機能用の設定の他の部分は、レイヤーベースのフォーマットに保存されます。レイヤーベースの設定は ReSharper と互換性があるため、ReSharper を使用している場合、チームメンバーのいずれかがそれを使用している場合、Rider は ReSharper で構成した設定を読み取...

レイヤーベースの設定

Rider 設定ダイアログでは、ページアイコンを見て、特定のページに使用されている設定管理メカニズムを確認できます。任意のアイコンでマークされていないページは、ユーザープロファイルに保存されている IDE 設定をホストします。レイヤーベースの設定は ReSharper と互換性があるため、ReSharper を使用している場合、チームメンバーのいずれかがそれを使用している場合、Rider は ReSharper で構成した設定を読み取って適用できます。「ソリューションパーソナル」および「ソリュ...

ディレクトリベースの設定

Rider 設定ダイアログでは、ページアイコンを見て、特定のページに使用されている設定管理メカニズムを確認できます。任意のアイコンでマークされていないページは、ユーザープロファイルに保存されている IDE 設定をホストします。ソリューションレベルと IDE レベルの設定:IntelliJ プラットフォームに基づく Rider のフロントエンド機能の設定は、ディレクトリベースの形式で保存されます。XML ファイルの 2 つの特定の場所に保存されます。IDE レイアウト、優先キーマップ、エディター...

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

ファイルステータス:プロジェクトツールウィンドウでは、ファイルをさまざまな色で表示でき、コード分析の結果やバージョン管理状態などに応じて、エディタータブをハイライトできます。設定のバージョン管理 | ファイルステータスの色ページで VCS ファイルのステータスの色を設定できます。一部でリストのデフォルトのファイルステータスの色と意味下表のカラースキーム。#0A7700 追加済みアクティブな変更リストのファイルは、リポジトリへの追加がスケジュールされています。#0EAA00 非アクティブ変更リスト...

ユニットテストを開始する

JetBrains Rider には、単体テストプロジェクトのテンプレートからテスト結果の分析まで、単体テストに役立つツールが多数用意されています。このチュートリアルでは、NUnit フレームワークを例として取り上げ、単体テストを作成して実行し、結果を確認します。ステップ 1. ユニットテストプロジェクトを追加する:この例では、という単一のプロジェクトを使ったソリューションがあります。このプロジェクトには、プリミティブ計算機を実装するクラスがあります。namespace Sandbox { p...