Qodana 2024.1 ヘルプ

JVM の Qodana コミュニティ

official project

JVM languages

JVM の Qodana コミュニティは IntelliJ IDEA Community に基づいています。IntelliJ IDEA コミュニティからのあらゆる賢い機能が提供され、次のことに役立ちます。

  • 異常なコードと潜在的なバグを検出する

  • デッドコードを削除する

  • スペルの問題をハイライトする

  • 全体的なコード構造を改善する

  • コーディングのベストプラクティスを紹介する

  • インスペクションの結果を Qodana クラウドにアップロードする

サポートされているテクノロジー

Qodana Community for JVM は、次のテクノロジ用のインスペクションを提供します。

プログラミング言語

Java

Kotlin

Groovy

マークアップ言語

HTML

JSON および JSON5

RELAX NG

XML

XPath

XSLT

ビルド管理

Ant

Gradle

Maven

フレームワークおよびライブラリ

JavaBeans

JPA

JUnit

Lombok

Reactive Streams

TestNG

サポートされている機能

JVM リンターの Qodana コミュニティは、次の Qodana 機能を提供します。

フィーチャー

ライセンスに基づいて利用可能

ベースライン

Community

FlexInspect

Community

クオリティゲート

Community

やってみよう

プロジェクトをローカルで分析する

分析を実行できるようにするには、プロジェクトが適切に構築され、目的の環境で実行できることを確認します。つまり、JRE が適切に構成され、プロジェクトの依存関係がインストールされ、ビルドスクリプトまたは起動タスクが実行されます。

Qodana には、コードのローカル分析のための 2 つのオプションが用意されています。Qodana CLI(英語) は最も簡単に開始できるオプションです。あるいは、「Docker イメージ」タブから Docker コマンドを使用することもできます。

マシンに Qodana CLI がすでにインストールされている(英語)と仮定すると、プロジェクトのルートディレクトリで次のコマンドを実行できます。

qodana scan \ -e QODANA_TOKEN="<cloud-project-token>" \ -l jetbrains/qodana-jvm-community:2024.1

ここで、QODANA_TOKEN 変数はプロジェクトトークンを参照します。

ここでリンター名 jetbrains/qodana-jvm-community:2024.1 を省略すると、代わりに JVM 用 Qodana リンターが実行されます。

まず、Docker Hub からイメージをプルします (最新バージョンを取得する場合にのみ必要です)。

docker pull jetbrains/qodana-jvm-community:2024.1

source-directory がプロジェクトのルートを指し、QODANA_TOKENプロジェクトトークンを参照して、ローカル分析を開始します。

docker run \ -v <source-directory>/:/data/project/ \ -e QODANA_TOKEN="<cloud-project-token>" \ jetbrains/qodana-jvm-community:2024.1

ブラウザーで Qodana クラウド(英語)を開き、インスペクションの結果を調べます。ここで分析を再構成することもできます。詳細については、インスペクションレポートセクションを参照してください。

次のステップ

関連ページ:

Qodana クラウド

Qodana を複数のプロジェクトまたはリポジトリで実行する場合、特にコードベースが複数のサーバーと仮想プライベートネットワークに分散されていて、各チームが独立して作業している場合は、すべての分析レポートを 1 か所に読み込んで集約すると便利です。このような場合、すべての Qodana インスタンスからレポート情報を収集して表示するための集中型ソリューションが役立ちます。Qodana クラウドは、さまざまな Qodana レポートを蓄積し、プロジェクトの進捗状況を一元的に追跡するのに役立つクラウ...

ベースライン

ベースラインは、特定の Qodana 実行時に取得され、ファイルに含まれているコードベースの問題のスナップショットです。ベースライン機能を使用すると、現在のコードとベースラインの状態を比較し、新しい問題、変更されていない問題、解決された問題を確認できます。この機能は、Community、Ultimate、Ultimate Plus ライセンスとその試用版で利用可能なすべてのリンターでサポートされています。使い方:ベースラインなしで Qodana を実行すると、現在の実行時に検出された問題を確認...

FlexInspect

IntelliJ IDEA のバージョン 2024.1 以降では、IntelliJ API と Kotlin を使用して、プロジェクト固有の独自のインスペクションを開発できます。次のことが可能です。ソースコードの PSI 表現にアクセスします。新しいインスペクションをオンザフライでデバッグします。期待どおりに動作しないコードフラグメントのハイライトなど、新しいカスタムインスペクションの動作を観察します。FlexInspect を使用すると、すべての IntelliJ IDEA および Qodana イ...

クオリティゲート

高品質のゲートは、コードの品質を制御し、期待される品質を満たすソフトウェアを構築できるようにする手法です。品質ゲート条件が失敗すると、Qodana は終了コード 255 を使用して終了し、CI/CD ワークフローまたはパイプラインが失敗します。例: プロジェクトの品質ゲートが 10 個の問題に設定され、コードカバレッジが 40% に設定されている場合、Qodana が 11 個目の問題またはコードカバレッジが 40% のしきい値を下回っていることが検出されると、ビルドワークフローは失敗します。品...

インスペクションレポート

Qodana を使用すると、ローカルまたは Qodana クラウドで、インタラクティブでユーザーフレンドリーな形式でインスペクションレポートを確認できます。各レポートには次のタブが含まれています。実際の問題は、Qodana が最新のインスペクション中に検出した問題を明らかにします、ベースラインには、ベースラインとしてマークされ、それ以降修正されていない問題がリストされます。構成により、将来の使用に備えて Qodana を構成できます、ライセンス監査は