AppCode 2023.1 ヘルプ

テストの実行

単一テストの実行

テストを開始する前に特定のアクションを必要とせず、コードカバレッジなどの追加オプションを構成したくない場合は、次のオプションを使用してテストを実行できます。

  • キャレットをテストクラスに配置して、そのクラスのすべてのテストを実行するか、テストメソッドに配置し、Ctrl+Shift+F10 を押します。または、テストクラスまたはテストメソッドの横にあるガターアイコンをクリックします。

    Gutter icons for running tests
  • ファイル内のすべてのテストを実行するには、プロジェクトツールウィンドウでこのファイルを選択し、コンテキストメニューから実行 'All in <filename>' を選択します。

実行 / デバッグ構成を介してテストを実行する

テストを実行すると、AppCode は一時的な実行構成を作成します。一時的な実行構成を保存したり、設定を変更したり、チームの他のメンバーと共有したりできます。詳細については、実行 / デバッグ構成を参照してください。

  1. 新しい実行構成を作成するまたは一時的なものを保存します。

  2. メインツールバーのリストから、実行する構成を選択します。

    Select test configuration

  3. the Run button をクリックするか、Shift+F10 を押します。

テスト設定を作成する

  1. 次のいずれかを実行して実行 / デバッグ構成ダイアログを開きます。

    • メインツールバーのリストから、実行 | 実行構成の編集を選択します。

    • メインメニューから実行 | 実行構成の編集を選択します。

    • Alt+Shift+F10 を押して、コンテキストメニューから構成の編集を選択します。

  2. ツールバーの Add New Configuration をクリックし、目的の構成タイプを選択します。

  3. 表示されたダイアログで、テストの実行前に実行するテストの範囲、構成パラメーター、アクティビティを指定します。変更を適用してダイアログを閉じます。

AppCode がテストの実行を完了すると、テストランナータブの実行ツールウィンドウに結果が表示されます。テスト結果の分析方法の詳細については、テスト結果を調べるを参照してください。

コミット後にテストを実行する

変更をプッシュする前に変更によってコードが壊れないことを確認したい場合は、コミットチェックとしてテストを実行することでそれを行うことができます。

テスト構成をセットアップする

  1. 次のトピックの説明に従って、コミットツールウィンドウを開きます。

  2. コミットオプションを表示 the Settings button をクリックします。メニューで、テストの実行の近くにある構成の選択をクリックし、実行する構成を選択します。

    Pre-commit checks menu

テスト構成をセットアップした後、コミットするたびに指定されたテストが実行されます。

Non-modal commit dialog running a test

テストを停止

テストランナータブの実行ツールバーで次のオプションを使用します。

  • the Stop button をクリックするか、Ctrl+F2 を押してプロセスを直ちに終了します。

  • the Exit button をクリックしてプロセスを正常に終了し、シャットダウンフックを実行できるようにします。

テストの再実行

1 つのテストを再実行

  • 実行ツールウィンドウのテストランナータブでテストを右クリックし、実行 'test name' を選択します。

セッションですべてのテストを再実行する

  • 実行ツールバーの the Run button をクリックするか、Ctrl+F5 を押して、セッション内のすべてのテストを再実行します。

失敗したテストの再実行

  • 失敗したテストのみを再実行するには、実行ツールバーの the Rerun Failed Tests button をクリックします。

    Shift を押しながら the Rerun Failed Tests button をクリックして、テストを再度実行するか、テストをデバッグするかを選択します。

    失敗したテストとともに、前回のテスト実行中に無視された、または開始されなかったテストをトリガーするように IDE を構成できます。テストランナーツールバーの the Settings button をクリックし、再実行失敗に開始されていないテストを含めるオプションを有効にします。

テストを自動的に再実行する

AppCode では、自動テストのようなランナーを有効にすることができます。現在の実行構成のテストは、関連するソースコードを変更すると自動的に再起動します。

  • 実行ツールバーの Toggle auto-test 自動テストの切り替えをクリックして、自動テストのようなランナーを有効にします。

失敗したテストをデバッグする

テストが失敗する理由がわからない場合は、デバッグできます。

  1. エディターで、ブレークポイントを設定する行のガターをクリックします。

    プログラムを中断したい場所に応じて、使用できるブレークポイントにはさまざまなタイプがあります。詳細については、ブレークポイントを参照してください。

  2. 失敗したテストの横にある the Rerun the Run button ガターアイコンを右クリックし、デバッグ 'test name' を選択します。

    失敗したテストは、デバッグモードで再実行されます。その後、テストは一時停止され、現在の状態を確認できます。

    テストをステップ実行して、その実行を詳細に分析できます。

関連ページ:

コードカバレッジ

コードカバレッジを使用すると、単体テスト中に実行されているコードの量を確認できるため、これらのテストの効果を理解できます。AppCode は、カバレッジデータの収集に llvm-cov を使用します。コードカバレッジ結果は、カバレッジツールウィンドウ、プロジェクトツールウィンドウのプロジェクトビュー、エディターに表示されます。カバレッジ測定結果はカバレッジスイートを構成します。新しいシミュレーションの結果を既存のスイートとマージすることができます。この場合、少なくとも 1 つのシミュレーションでカバ...

テスト用の実行 / デバッグ構成を作成する

実行 / デバッグ構成を使用して、通常のアプリケーションを実行するのと同様の方法でテストを実行できます。テスト設定を作成するメインメニューからを選択します。ツールバーのをクリックして、利用可能なテストフレームワークのいずれかを選択します: Boost.Test、Catch、Google Test、または XCTest。開いたダイアログで、次の構成を変更できます。名前フィールドで、実行 / デバッグ構成の名前を変更します。デフォルト名には、選択したクラス / メソッドとテストターゲットが含まれます...

実行 / デバッグ構成

AppCode は、実行 / デバッグ構成を使用して、コードを実行、デバッグ、テストします。各構成は、何を実行し、どのパラメーターと環境を使用するかを定義する、名前付きのスタートアッププロパティのセットです。AppCode の実行 / デバッグ構成は Xcode スキームと同等であり、それらとの同期が維持されます。実行 / デバッグ構成には 2 つのタイプがあります。一時的 — テストクラスまたはメソッドを実行するたびに作成され、ガターアイコン / を使用します。永続的 — テンプレートから明示的に作成さ...

テスト結果を調べる

AppCode がテストの実行を完了すると、テストランナータブの実行ツールウィンドウに結果が表示されます。右側のコンソールには、現在のテストセッションの出力が表示されます。テストの実行に関する詳細情報と、テストが失敗したか無視された理由を確認できます。テスト結果のリストの上にあるテストランナーツールバーを使用すると、成功したテストと無視されたテストの表示と非表示、各テストの実行、エクスポート、インポート、およびテスト結果の並べ替えにかかった時間を表示できます。IDE は、テストランナータブの各テ...

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

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

ブレークポイント

ブレークポイントは、特定のポイントでプログラムの実行を一時停止する特別なマーカーです。これにより、プログラムの状態と動作を調べることができます。ブレークポイントは、単純な場合(たとえば、コード行に到達したときにプログラムを一時停止する場合)や、より複雑なロジック(追加の条件に対するチェック、ログメッセージの書き込みなど)を伴う場合があります。設定したブレークポイントは、一時的なブレークポイントを除いて、明示的に削除するまでプロジェクトに残ります)。ブレークポイントの種類:AppCode では、...