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

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

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

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

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

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

В Браузере текущей папки перейдите к и откройте папку, которая содержит файлы кода, которые вы хотите анализировать.
В Браузере текущей папки, который перечисляет файлы, которые вы хотите анализировать, или кликните или щелкните правой кнопкой по пробелу браузера. Обе опции открывают меню. Выберите Reports> Code Compatibility Report. В качестве альтернативы можно запуститься codeCompatibilityReport в командной строке, чтобы сгенерировать отчет.
Отчет отображается в веб-браузере MATLAB, показывая потенциальные проблемы совместимости. Например:
Обновите свой код, чтобы разрешить синтаксические ошибки для каждого файла, перечисленного в разделе Syntax Errors. Синтаксические ошибки приводят к коду, который не запускается. В то время как, скорее всего, код не запускался правильно в предыдущих релизах, синтаксические ошибки влияют на анализ совместимости. Например, Ошибка анализа в '}': использование может быть недопустимым синтаксисом MATLAB.
Для каждой функциональности, перечисленной в отчете, рассмотрите описание проблемы и ваш код. Сообщения включают номера строки, чтобы помочь определить местоположение проблемы в вашем коде. Чтобы открыть файл в Редакторе той линии, кликните по номеру строки. Затем измените файл на основе сообщения. Если вы не уверены, что означает сообщение или что измениться в коде, щелкнуть по ссылке Documentation, сопоставленной с сообщением.
Каждая функциональность, перечисленная в отчете, отображает рекомендуемое действие. Также можно использовать следующий общий совет:
- Functionality that has been removed — Обновите свой код, чтобы избежать ошибок совместимости в текущем релизе.
- Functionality that has changed behavior — Подтвердите, что изменение в поведении приемлемо, и в противном случае обновите свой код для текущего релиза.
- Unsupported functionality that might cause errors — Файлы, перечисленные здесь, используют функциональность, которая не поддержана, не документирована, и не предназначается для потребительского использования. Обновите свой код, чтобы использовать зарегистрированную функциональность, чтобы избежать ошибок и неожиданных изменений поведения.
- Functionality that will be removed — Обновите свой код теперь или в более позднем релизе. Обновление вашего кода теперь делает будущие обновления легче.
- Functionality that will change behavior — Исследуйте эти изменения теперь, чтобы сделать будущие обновления легче.
- New functionality that might improve code — Рассмотрите обновление вашего кода. Текущий код, как ожидают, продолжит работать в будущих релизах, но более новая функциональность рекомендуется.
Отчет Совместимости Кода также включает в себя информацию о проверках, выполненных на вашем коде и списке файлов, которые MATLAB анализировал для совместимости кода.

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

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

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

Неподдерживаемая функциональность

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

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