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

Отчет Совместимости Кода является удобным инструментом, который анализирует ваш код, перечисляет целый набор проблем совместимости в табличном формате и предоставляет вам инструкции относительно того, как обратиться к этим проблемам совместимости. Отчет позволяет:

  • Идентифицируйте проблемы совместимости, к которым необходимо обратиться для кода, чтобы запуститься правильно в текущем релизе MATLAB®.

  • Оцените усилие, требуемое обновить ваш код, когда вы обновите до более нового релиза MATLAB.

  • Улучшите свой код, заменив функциональность, которая не рекомендуется.

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

Сгенерируйте отчет совместимости кода

Запускать Отчет Совместимости Кода:

  1. В Браузере текущей папки перейдите к и откройте папку, которая содержит файлы кода, которые вы хотите анализировать.

  2. В Браузере текущей папки, который перечисляет файлы, которые вы хотите анализировать, или кликните или щелкните правой кнопкой по пробелу браузера. Обе опции открывают меню. Выберите Reports> Code Compatibility Report. В качестве альтернативы можно запустить codeCompatibilityReport в командной строке, чтобы сгенерировать отчет.

    Отчет отображается в веб-браузере MATLAB, показывая потенциальные проблемы совместимости. Например:

  3. Обновите свой код, чтобы разрешить синтаксические ошибки для каждого файла, перечисленного в разделе Syntax Errors. Синтаксические ошибки приводят к коду, который не запускается. В то время как, скорее всего, код не запускался правильно в предыдущих релизах, синтаксические ошибки влияют на анализ совместимости. Например, Ошибка анализа в '}': использование может быть недопустимым синтаксисом MATLAB.

  4. Для каждой функциональности, перечисленной в отчете, рассмотрите описание проблемы и ваш код. Сообщения включают номера строки, чтобы помочь определить местоположение проблемы в вашем коде. Чтобы открыть файл в Редакторе той линии, кликните по номеру строки. Затем измените файл на основе сообщения. Если вы не уверены, что означает сообщение или что измениться в коде, щелкнуть по ссылке Documentation, сопоставленной с сообщением.

    Каждая функциональность, перечисленная в отчете, отображает рекомендуемое действие. Также можно использовать следующий общий совет:

    • Functionality that has been removed — Обновите свой код, чтобы избежать ошибок совместимости в текущем релизе.

    • Functionality that has changed behavior — Подтвердите, что изменение в поведении приемлемо, и в противном случае обновите свой код для текущего релиза.

    • Functionality that will be removed — Обновите свой код теперь или в более позднем релизе. Обновление вашего кода теперь делает будущие обновления легче.

    • Functionality that will change behavior — Исследуйте эти изменения теперь, чтобы сделать будущие обновления легче.

    • Functionality that is not recommended — Рассмотрите обновление вашего кода. Код, как ожидают, продолжит работать в будущей функциональности релизов но использования, которая не рекомендуется.

    Отчет Совместимости Кода также включает в себя информацию о проверках, выполненных на вашем коде и списке файлов, которые MATLAB анализировал для совместимости кода.

Программируемое использование

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

  • Чтобы сгенерировать отчет, который открывается в MATLAB® Web Browser программно, используйте codeCompatibilityReport функция.

  • Возвратить CodeCompatibilityAnalysis объект, который содержит информацию об отчете, использует analyzeCodeCompatibility функция. Можно затем отобразить отчет для хранившего объекта с помощью codeCompatibilityReport функция.

Смотрите также

| |