exponenta event banner

codeCompatibilityReport

Создать отчет о совместимости кода

Описание

пример

codeCompatibilityReport создает отчет о совместимости кода для текущей рабочей папки и подпапок. Отчет о совместимости кода открывается в веб-браузере MATLAB ®. После обновления до более новой версии MATLAB этот отчет можно использовать для выявления потенциальных проблем совместимости существующего кода.

codeCompatibilityReport(names) создает отчет для файлов или папок, указанных в names.

codeCompatibilityReport(___,'IncludeSubfolders',tf) указывает, следует ли создавать отчеты по подпапкам. По умолчанию вложенные папки включаются в анализ. Используйте этот синтаксис с любым из аргументов в предыдущих синтаксисах.

пример

codeCompatibilityReport(cca) создает отчет из существующего результата совместимости кода, указанного как CodeCompatibilityAnalysis объект.

Примеры

свернуть все

Создайте отчет о совместимости кода для кода в текущей папке и подпапках. Отчет открывается в веб-браузере MATLAB.

codeCompatibilityReport

Создайте другой отчет, но пропустите вложенные папки из анализа.

codeCompatibilityReport('IncludeSubfolders',false)

Создание результатов анализа совместимости для кода в текущей рабочей папке и подпапках.

r = analyzeCodeCompatibility;

Создайте отчет на основе результатов. Отчет открывается в веб-браузере MATLAB.

codeCompatibilityReport(r)

Входные аргументы

свернуть все

Имя анализируемых файлов или папок, указанное как символьный вектор, массив ячеек символьных векторов, строковый скаляр или строковый массив.

Имя файла должно быть допустимым кодом MATLAB или файлом приложения (.m, .mlx, или .mlapp).

Пример: '../thisFile.m'

Пример: {'folderA','folderB','fileA'}

Типы данных: char | string

Индикатор анализа подпапок, указанный как true, false, 0 или 1. По умолчанию analyzeCodeCompatibility включает вложенные папки в анализ. Чтобы пропустить вложенные папки, установите tf кому false или 0.

Результаты анализа совместимости кода, указанные как CodeCompatibilityAnalysis объект.

Подробнее

свернуть все

Отчет о совместимости кода

Отчет о совместимости кода содержит информацию, помогающую обновить код до новой версии MATLAB. Он содержит эти разделы.

  • Синтаксические ошибки - таблица с подробными сведениями о синтаксических ошибках. Например, Использование ~ для игнорирования значения в данном контексте не допускается. Синтаксические ошибки приводят к невыполняемому коду, и, хотя они не представлены в новой версии MATLAB, синтаксические ошибки влияют на анализ совместимости.

    Эта информация содержится в таблице.

    Столбец отчетаОписание
    СлучаиОбщее число синтаксических ошибок в файле.
    Имя файлаИмя файла, содержащего синтаксические ошибки.

  • Функция, которая была удалена - таблица с подробными сведениями о функциональности, которая используется в анализируемом коде и которая была удалена. Например, «wavfinfo» был удален. Вместо этого используйте «AUDIOINFO».

    Эта информация содержится в таблице.

    Столбец отчетаОписание

    Описание

    Описание проверки. Описание совпадает с сообщением анализатора кода.

    Документация

    Ссылка на дополнительные сведения в документации.

    Удалено вВерсия, в которой была удалена функциональность.
    Имя файлаИмя файла, содержащего помеченную проверку.
    ЛинияНомер строки, указывающий местоположение в файле помеченной проверки.

  • Функциональность, изменившая поведение - таблица с подробными сведениями о функциональности, используемой в анализируемом коде и изменившей поведение. Например, «легенда» изменилась и может интерпретировать имя аргумента как свойство легенды вместо метки. Чтобы включить метку с тем же именем, что и свойство легенды, укажите метки, используя массив ячеек или строковый массив. Список затронутых имен свойств см. в документации.

    Эта информация содержится в таблице.

    Столбец отчетаОписание

    Описание

    Описание проверки. Описание совпадает с сообщением анализатора кода.

    Документация

    Ссылка на дополнительные сведения в документации.

    Влияет на код, написанный доВерсия, в которой была изменена функциональность.
    Имя файлаИмя файла, содержащего помеченную проверку.
    ЛинияНомер строки, указывающий местоположение в файле помеченной проверки.

  • Неподдерживаемая функциональность, которая может привести к ошибкам - перечисленные здесь файлы используют функциональность, которая не поддерживается, не документирована и не предназначена для использования заказчиком. Обновите код, чтобы использовать документированные функции, чтобы избежать ошибок и неожиданных изменений поведения. Например, «awtinvoke» не поддерживается и мог быть изменен или удален без уведомления. С соответствующими изменениями кода используйте JavaMethodEDT.

    Эта информация содержится в таблице.

    Столбец отчетаОписание

    Описание

    Описание проверки. Описание совпадает с сообщением анализатора кода.

    Документация

    Ссылка на дополнительные сведения в документации.

    Имя файлаИмя файла, содержащего помеченную проверку.
    ЛинияНомер строки, указывающий местоположение в файле помеченной проверки.

  • Функция, которая будет удалена - таблица с подробными сведениями о функциональности, которая используется в анализируемом коде и будет удалена в следующем выпуске. Например, «aviinfo» будет удален в следующем выпуске. Вместо этого используйте VideoReader.

    Эта информация содержится в таблице.

    Столбец отчетаОписание

    Описание

    Описание проверки. Описание совпадает с сообщением анализатора кода.

    Документация

    Ссылка на дополнительные сведения в документации.

    Имя файлаИмя файла, содержащего помеченную проверку.
    ЛинияНомер строки, указывающий местоположение в файле помеченной проверки.

  • Функциональные возможности, которые изменят поведение - таблица с подробными сведениями о функциональных возможностях, используемых в анализируемом коде и изменяющих поведение в будущей версии. Например, «interp1 (...,» cubic «)» изменится в будущем выпуске для выполнения кубической свертки. Чтобы продолжить использование кусочно-кубической интерполяции с сохранением формы, используйте interp1 (..., pchip).

    Таблица содержит те же столбцы, что и удаляемый раздел «Функциональность».

  • Новая функциональность, которая может улучшить код - рассмотрите возможность обновления кода. Ожидается, что текущий код продолжит работу в будущих выпусках, но рекомендуется использовать более новые функциональные возможности. Например, программное использование DISPLAY не рекомендуется. Вместо этого используйте DISP или FPRINTF.

    Эта информация содержится в таблице.

    Столбец отчетаОписание

    Описание

    Описание проверки. Описание совпадает с сообщением анализатора кода.

    Документация

    Ссылка на дополнительные сведения в документации.

    Имя файлаИмя файла, содержащего помеченную проверку.
    ЛинияНомер строки, указывающий местоположение в файле помеченной проверки.
    ПодавлениеПодавляется ли эта проверка в редакторе. Значение «Нет» указывает на то, что проверка не подавлена.

  • Полный перечень выполненных проверок - Таблица с информацией о проведенных проверках по указанному коду. Он содержит следующую информацию.

    Столбец отчетаОписание

    Случаи

    В анализируемом коде общее количество вхождений, в которых отмечена определенная проверка.

    Файлы

    В анализируемом коде количество файлов, в которых отмечена определенная проверка.

    Описание

    Описание проверки. Например, использование новой строки, точки с запятой или запятой перед этой инструкцией или STRMATCH не рекомендуется. Вместо этого используйте STRNCMP или VALIDATESTRING. Описание совпадает с сообщением анализатора кода.

    Серьезность

    Степень серьезности проверки. Например, Error или Warning. Ошибки могут указывать на синтаксические ошибки или использование функций, которые больше не поддерживаются. Предупреждения могут указывать на возможность улучшения кода.

    Идентификатор

    Идентификатор сообщений анализатора кода MATLAB.

    Документация

    Ссылка на дополнительные сведения в документации.

  • Полный список проанализированных файлов - список файлов, проанализированных MATLAB на совместимость с кодом.

Совет

Альтернативы

Создание отчета о совместимости кода для кода в текущей рабочей папке и подпапках в браузере текущей папки. В браузере текущей папки щелкните или щелкните правой кнопкой мыши пробел. Затем выберите Отчеты > Отчет о совместимости кода. См. раздел Отчет о совместимости кода MATLAB.

Представлен в R2017b