最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

MATLAB コードの互換性レポート

コードの互換性レポートの生成

コードの互換性レポートにはコードの潜在的な互換性の問題が表示されます。このレポートは、新しい MATLAB® リリースへのアップグレード時に既存のコードの潜在的な互換性の問題を特定するのに役立ちます。たとえば、レポートには、非推奨の関数や削除された関数、または無効な構文がコードで使用されている箇所が示されます。MATLAB の新しいバージョンにアップグレードした後、このレポートを使用して、既存のコードの潜在的な互換性の問題を特定できます。

コードの互換性レポートを実行するには、次を行います。

  1. 現在のフォルダー ブラウザーで、解析するコード ファイルを格納するフォルダーに移動します。

  2. 現在のフォルダー ブラウザーで、 をクリックするか、空白の領域を右クリックします。次に [レポート][コードの互換性レポート] を選択します。

    レポートが MATLAB Web ブラウザーで開き、潜在的な互換性の問題が表示されます。以下に例を示します。

  3. コードを更新して、[構文エラー] セクションにリストされているファイルごとに構文エラーを解決します。構文エラーの場合はコードが実行されません。コードは以前のリリースで適切に実行されなかった可能性が高いですが、構文エラーは互換性の解析に影響を与えます。例: "'}' での解析エラー: 使用法は、無効な MATLAB 構文である可能性があります。"

  4. レポートに表示される各機能について、問題の説明とコードを確認します。メッセージには、コードにある問題の箇所を特定しやすいよう行番号が含まれています。行番号をクリックしてエディターでファイルのその行を開きます。メッセージに基づいてファイルを変更します。メッセージの意味やコードに必要な変更が不明な場合、メッセージに関連付けられている [ドキュメンテーション] リンクをクリックします。

    レポートに表示される各機能には、推奨アクションが表示されます。以下の一般情報も使用できます。

    • 削除済みの機能 — コードを更新して現在のリリースでの互換性エラーを回避します。

    • 動作が変更された機能 — 動作の変更が許容可能であることを確認し、許容可能ではない場合は、現在のリリースに合わせてコードを更新してください。

    • 削除予定の機能—今すぐ、または後のリリースでコードを更新してください。コードを今すぐ更新すると、今後のアップグレードが容易になります。

    • 動作が変更される予定の機能 — これらの変更を今すぐ調査し、今後のアップグレードを容易にします。

    • 推奨されない機能 — コードの更新を検討してください。コードは、将来のリリースでも引き続き動作すると予想されますが、推奨されない機能を使用しています。

    コードの互換性レポートには、コードに対して行われたチェックに関する情報と、コードの互換性について MATLAB が解析したファイルのリストも含まれています。

プログラムでの使用

現在のフォルダー ブラウザーを使ってコードの互換性レポートを生成する場合、MATLAB は現在の作業フォルダーおよびサブフォルダーにあるコードを解析します。ただし、レポートをプログラムによって生成すると、解析対象に特定のファイルを指定したり、解析からサブフォルダーを除外したりすることができます。レポートをプログラムによって生成するには、次のいずれかの方法を使用します。

  • MATLAB® Web ブラウザーで開くレポートをプログラムによって生成するには、関数 codeCompatibilityReport を使用します。

  • レポート情報を含む CodeCompatibilityAnalysis オブジェクトを返すには、関数 analyzeCodeCompatibility を使用します。その後、関数 codeCompatibilityReport を使用して格納オブジェクトのレポートを表示できます。

参考

| |