本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

codeCompatibilityReport

创建代码兼容性报告

说明

示例

codeCompatibilityReport 为当前工作文件夹和子文件夹创建代码兼容性分析报告。代码兼容性报告 在 MATLAB® Web 浏览器中打开。升级到较新版本的 MATLAB 后,您可以使用此报告来确定现有代码中潜在的兼容性问题。

codeCompatibilityReport(names)names 指定的文件或文件夹创建报告。

codeCompatibilityReport(___,'IncludeSubfolders',tf) 指定是否对子文件夹进行报告。默认情况下,分析包含子文件夹。请将此语法与上述语法中的任何参数结合使用。

示例

codeCompatibilityReport(cca) 根据指定为 CodeCompatibilityAnalysis 对象的现有代码兼容性结果创建报告。

示例

全部折叠

为当前文件夹和子文件夹中的代码创建代码兼容性报告。报告在 MATLAB Web 浏览器中打开。

codeCompatibilityReport

再创建一个报告,但在分析中忽略子文件夹。

codeCompatibilityReport('IncludeSubfolders',false)

为当前工作文件夹和子文件夹中的代码生成兼容性分析结果。

r = analyzeCodeCompatibility;

根据结果创建报告。报告在 MATLAB Web 浏览器中打开。

codeCompatibilityReport(r)

输入参数

全部折叠

要分析的文件或文件夹的名称,指定为字符向量、字符向量元胞数组、字符串标量或字符串数组。

文件名必须是有效的 MATLAB 代码或 App 文件(.m.mlx.mlapp)。

示例: '../thisFile.m'

示例: {'folderA','folderB','fileA'}

数据类型: char | string

子文件夹分析指示符,指定为 truefalse、0 或 1。默认情况下,analyzeCodeCompatibility 在分析时包含子文件夹。要忽略子文件夹,请将 tf 设置为 false 或 0。

代码兼容性分析结果,指定为 CodeCompatibilityAnalysis 对象。

详细信息

全部折叠

代码兼容性报告

代码兼容性报告包含可帮助您将代码升级到新版本 MATLAB 的信息。它包含以下各部分。

  • 语法错误 - 该表包含语法错误详细信息。例如:Using ~ to ignore a value is not permitted in this context.语法错误会导致代码无法运行,虽然它们不是新版本的 MATLAB 引入的,但语法错误会影响兼容性分析。

    下表包含这些信息。

    报告列说明
    出现次数文件中语法错误的总数。
    文件名包含语法错误的文件的名称。

  • 已经删除的功能 - 该表包含关于被分析的代码中还在使用但实际已删除的功能的详细信息。例如:'wavfinfo' has been removed.Use 'AUDIOINFO' instead.

    下表包含这些信息。

    报告列说明

    说明

    有关检查的说明。该说明与代码分析器的消息相同。

    文档

    链接,指向文档中的详细信息。

    删除于已删除该功能的版本。
    文件名包含所标记检查的文件的名称。
    行号,指示所标记的检查在文件中的位置。

  • 行为已经改变的功能 - 该表包含关于被分析的代码中还在使用但其行为已更改的功能的详细信息。例如,'legend' 已更改,可能会将参数的名称解释为图例属性而不是标签。要包含与图例属性同名的标签,请使用元胞数组或字符串数组指定标签。请参阅相关文档查看受影响的属性名称列表。

    下表包含这些信息。

    报告列说明

    说明

    有关检查的说明。该说明与代码分析器的消息相同。

    文档

    链接,指向文档中的详细信息。

    影响以前编写的代码该功能已发生更改的版本。
    文件名包含所标记检查的文件的名称。
    行号,指示所标记的检查在文件中的位置。

  • 将要删除的功能 - 该表包含被分析的代码中还在使用但将在以后的版本中删除的功能的详细信息。例如:'aviinfo' will be removed in a future release.Use 'VideoReader' instead.

    下表包含这些信息。

    报告列说明

    说明

    有关检查的说明。该说明与代码分析器的消息相同。

    文档

    链接,指向文档中的详细信息。

    文件名包含所标记检查的文件的名称。
    行号,指示所标记的检查在文件中的位置。

  • 行为将要改变的功能 - 该表包含被分析的代码中还在使用但将在以后的版本中更改行为的功能的详细信息。例如,'interp1(...,'cubic')' 在以后的版本中将更改为执行三次卷积。要继续使用保形分段三次插值,请改用 'interp1(...,'pchip')'。

    该表包含与将要删除的功能部分相同的列。

  • 不建议使用的功能 - 该表包含代码改进建议。例如:Programmatic use of DISPLAY is not recommended.Use DISP or FPRINTF instead.

    下表包含这些信息。

    报告列说明

    说明

    有关检查的说明。该说明与代码分析器的消息相同。

    文档

    链接,指向文档中的详细信息。

    文件名包含所标记检查的文件的名称。
    行号,指示所标记的检查在文件中的位置。
    隐藏是否以及如何在编辑器中隐藏此检查。值为表示未隐藏检查。

  • 所有已执行检查的列表 - 该表包含关于对指定代码执行的检查的信息。它包括以下信息。

    报告列说明

    出现次数

    在分析的代码中,某项检查被标记的总次数。

    文件

    在分析的代码中,标记了某项检查的文件数。

    说明

    有关检查的说明。例如:Use a newline, semicolon, or comma before this statement or STRMATCH is not recommended.Use STRNCMP or VALIDATESTRING instead.该说明与代码分析器的消息相同。

    严重性

    问题的严重性。例如,错误警告。“错误”可能指示语法错误或使用了不再支持的功能。“警告”可能指示改进代码的机会。

    标识符

    MATLAB 代码分析器消息的标识符。

    文档

    链接,指向文档中的详细信息。

  • 所有已分析文件的列表 - MATLAB 为了检查代码兼容性而分析的文件列表。

提示

备选方法

为当前文件夹浏览器中的当前工作文件夹和子文件夹中的代码生成代码兼容性报告。在当前文件夹浏览器中,点击 或在空白处点击鼠标右键。然后选择报告 > 代码兼容性报告。请参阅MATLAB 代码兼容性报告

在 R2017b 中推出