Отчет о совместимости кода 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 ® программно, используйте
codeCompatibilityReportфункция.Возврат
CodeCompatibilityAnalysisобъект, который содержит информацию отчета, используйтеanalyzeCodeCompatibilityфункция. Затем можно просмотреть отчет для хранимого объекта с помощьюcodeCompatibilityReportфункция.
Неподдерживаемая функциональность
Отчет о совместимости кода проверяет функциональность, неподдерживаемую, недокументированную и не предназначенную для использования. Такие функции могут быть изменены или удалены без уведомления и могут вызвать будущие ошибки. В некоторых случаях имеется задокументированная функциональность замены, но может не быть простой замены. Обратитесь в службу поддержки MathWorks, чтобы описать ваше использование и запросить поддерживаемую замену.
См. также
analyzeCodeCompatibility | CodeCompatibilityAnalysis | codeCompatibilityReport