Отчет о совместимости кода - это удобный инструмент, который анализирует код, перечисляет весь набор проблем совместимости в табличном формате и предоставляет инструкции по устранению этих проблем совместимости. Отчет позволяет:
Определите проблемы совместимости, которые необходимо устранить для правильной работы кода в текущей версии MATLAB ®.
Оцените усилия, необходимые для обновления кода при обновлении до более новой версии MATLAB.
Улучшите код, заменив функции, которые не рекомендуется использовать.
Отчет о совместимости кода отображает расположения в коде, на которые влияют проблемы совместимости, и содержит ссылки на документацию для получения дополнительной информации о внесении необходимых изменений в каждое расположение.
Чтобы запустить отчет о совместимости кода:
В браузере текущей папки перейдите к папке, содержащей файлы кода, которые требуется проанализировать, и откройте ее.
В браузере «Текущая папка», в котором перечислены файлы, подлежащие анализу, щелкните
или щелкните правой кнопкой мыши в свободном пространстве браузера. Обе опции открывают меню. Выберите «Отчеты» > «Отчет о совместимости кода». Кроме того, можно выполнить codeCompatibilityReport в командной строке для создания отчета.
Отчет отображается в веб-браузере MATLAB и показывает возможные проблемы совместимости. Например:
Обновите код, чтобы устранить синтаксические ошибки для каждого файла, указанного в разделе «Синтаксические ошибки». Синтаксические ошибки приводят к тому, что код не запускается. Хотя, скорее всего, код не работал должным образом в предыдущих выпусках, синтаксические ошибки влияют на анализ совместимости. Например, ошибка синтаксического анализа в «»} «»: использование может быть недопустимым синтаксисом MATLAB.
Для каждой функции, указанной в отчете, просмотрите описание проблемы и код. Сообщения содержат номера строк, помогающие найти проблему в коде. Чтобы открыть файл в редакторе в этой строке, щелкните номер строки. Затем измените файл на основе сообщения. Если вы не уверены, что означает сообщение или что нужно изменить в коде, щелкните ссылку Документация, связанную с сообщением.
Каждая функция, указанная в отчете, отображает рекомендуемое действие. Также можно использовать следующие общие рекомендации:
Функция, которая была удалена - обновите код, чтобы избежать ошибок совместимости в текущей версии.
Функциональность, изменившая поведение - подтвердите, что изменение поведения допустимо, и, если нет, обновите код для текущей версии.
Неподдерживаемая функциональность, которая может привести к ошибкам - перечисленные здесь файлы используют функциональность, которая не поддерживается, не документирована и не предназначена для использования заказчиком. Обновите код, чтобы использовать документированные функции, чтобы избежать ошибок и неожиданных изменений поведения.
Функция, которая будет удалена - обновите код сейчас или в более поздней версии. Обновление кода теперь упрощает будущие обновления.
Функциональные возможности, которые изменят поведение - изучите эти изменения сейчас, чтобы упростить будущие обновления.
Новая функциональность, которая может улучшить код - рассмотрите возможность обновления кода. Ожидается, что текущий код продолжит работу в будущих выпусках, но рекомендуется использовать более новые функциональные возможности.
Отчет о совместимости кода также содержит информацию о проверках кода и список файлов, проанализированных MATLAB на совместимость кода.
При создании отчета о совместимости кода с помощью текущего браузера папок MATLAB анализирует код в текущей рабочей папке и подпапках. Однако при создании отчета программным путем можно указать определенные файлы для анализа или исключить вложенные папки из анализа. Чтобы создать отчет программным способом, используйте один из следующих методов.
Для создания отчета, который открывается в веб-браузере MATLAB ® программным способом, используйте codeCompatibilityReport функция.
Для возврата CodeCompatibilityAnalysis , который содержит информацию отчета, используйте analyzeCodeCompatibility функция. Затем можно просмотреть отчет для сохраненного объекта с помощью codeCompatibilityReport функция.
Отчет о совместимости кода проверяет функциональность, которая не поддерживается, не документирована и не предназначена для использования. Такие функции могут быть изменены или удалены без предварительного уведомления и могут привести к будущим ошибкам. В некоторых случаях задокументированы функциональные возможности замены, но простой замены может не быть. Обратитесь в службу поддержки MathWorks, чтобы описать использование и запросить поддерживаемую замену.
analyzeCodeCompatibility | CodeCompatibilityAnalysis | codeCompatibilityReport