JetBrains IDE との Space 統合

Space プラグインのインストール (古い IDE バージョンでのみ必要)

Space にログイン

Space プラグインの使用を開始する前に、Space 組織のアドレスを指定して Space にログインする必要があります。

リポジトリの表示とクローン作成

Space 組織でホストされているすべてのプロジェクトとリポジトリを表示し、貢献したいリポジトリのクローンを作成します。

リポジトリのクローンを作成する前に、SSH 公開鍵(英語)を Space にアップロードするか、HTTP パスワードを設定する必要があります (リポジトリで使用される認証方法に応じて)

コミットに署名するために GPG キーが必要になる場合もあります。

手順については、Git キーを参照してください。

これで、IDE からリポジトリを表示してクローンを作成できるようになりました。

コードのレビュー

Space コードレビューツールウィンドウでは、現在のプロジェクトのすべてのコードレビューを参照して検索したり、コメントを表示して残したり、変更を調べて受け入れたり、コードレビューを作成したり、リクエストをマージしたりできます。

コードレビューツールウィンドウを開くには、左側のそれぞれのサイドバーメニュー項目をクリックするか、ツール→ Space →コードレビューに移動します。

クイックフィルターを使用して以下を表示します。

• オープンまたはクローズドのコードレビュー。

• 変更を含むレビュー。

• 注意が必要なレビュー。

• レビューする必要がある変更。

• 割り当てられたレビュー。

レビューをクリックして開きます。

左側には、作成者やレビュー担当者、作成日などのコードレビューの詳細が表示されます。右側には、コメントを含むレビューのタイムラインが表示されます。

変更をインスペクションする

「ファイル」タブに、追加、変更、削除されたファイルのリストが表示されます。ファイルをクリックして差分ビューアーで開き、変更を確認します。

コメントと返信を残す

差分ビューアーでは、他の人が残したコメントに返信したり、新しい行コメントを追加したりできます。コード行の上にカーソルを置き、プラス記号をクリックするだけです。

コメントは下書きとして保存され、他の人には表示されません。これらは、コードレビュープロセスの順番の終了時に送信されます。コメントをすぐに送信するには、タイムラインに移動して今すぐ投稿をクリックします。

タイムラインビューでは、一般的な (コミットレベルの) コメントを残したり、他の参加者が残したコメントに返信したりすることもできます。

ターンを終了する: 変更を受け入れるか、応答を待ちます

変更のレビューが完了したら、コードレビュープロセスの順番を終了できます。詳細ビューでは、次のことを選択できます。

• 変更を受け入れる — すべてが順調で、変更を承認する準備ができたら。

• 応答を待つ — 質問、懸念事項、提案がある場合、変更を承認しないその他の理由がある場合。

これら 2 つのオプションのいずれかを選択すると、コードレビュープロセスでの順番が終了します。コードを確認しているときに追加した下書きのコメントが投稿され、他の参加者に作業が完了したことが通知されます。

誤ってこのレビューに割り当てられたと思われる場合は、そのままをクリックしてください。

コードレビューを作成してリクエストをマージする

プロジェクトのコードベースに変更を加えた後、コードレビューまたはマージリクエストを作成できます。2 つの違いは次のとおりです。

• コードレビューは、1 つ以上のコミット、またはブランチ全体に関連付けることができます。これにより、あなたのチームはコードの特定の行にコメントし、レビュー中のコードについて話し合うことができます。

• マージリクエストは、レビューの補完後に変更をブランチにマージすることを目的とした特別な種類のコードレビューです。例: マージリクエストを作成して、フィーチャーブランチをメインのブランチにマージし直す前に、フィーチャーブランチの変更を確認できます。

プロジェクトのチェックリスト、課題、コミットをブラウザーで開く

IDE で現在作業しているプロジェクトに関連する課題、チェックリスト、コミットにすばやく移動します。

IDE でコミットログを表示すると、Space で即座にコミットを開いてコメントしたり、コードレビューを開始したり、作成者に連絡したりできます。

自動化ジョブをインスペクションし、スクリプトを作成する

Space でホストされているリポジトリには、Kotlin スクリプトを使用して自動化ジョブを記述する .space.kts ファイルが含まれています。

Space プラグインは、次のスクリプトを作成および編集するための追加機能を提供します。

• コード補完と構文のハイライト。

• 共通ロジックを関数に移動する

• メソッドの抽出リファクタリングを使用して、既存のスクリプトコードを別の関数に移動します。

自動化ジョブのステータスを IDE で直接プレビューすることもできます。IDE の Git ログウィンドウを開いて、オートメーションジョブがまだ実行中か、エラーで失敗したか、正常に終了したかを確認します。

開発環境を管理する

JetBrains IDE または JetBrains Gateway UI から開発環境を直接管理できます。

IDE が Space 組織に接続されている場合:

• 既存の開発環境はすべて同期されます。

• リポジトリとブランチ用の新しい開発環境を作成し、JetBrains Client を使用してすぐにコーディングを開始できます。

• 開発環境を休止状態にしてリソースの消費を削減したり、作業が終了したら単に削除したりすることができます。