MMpy.set_api_version
Синтаксис
MMpy.set_api_version(major, minor, micro)
Описание
Устанавливает версию MMpy API для сессии скрипта.
Параметры
Имя |
Тип |
Описание |
|---|---|---|
|
major |
int | Версия Major API для использования. |
|
minor |
int | Версия Minor API для использования. |
| micro | int | Версия Micro API для использования. |
Примечания
Эта функция предусмотрена для скриптов, чтобы обеспечить улученную прямую совместимость с будущими версиями приложения.
Для того чтобы получить улучшенные интерфейсы Python, приложение иногда может быть вынуждено нарушить совместимость API с существующими скриптами. Это случается редко, но может произойти.
При использовании этой функции устанавливается среда Python, которая обеспечивает совместимость старых API, поэтому имеется возможность запускать уже существующие скрипты.
Управление версиями API следует принятым практикам сообщества Python, согласно тому, как описано здесь: https://www.python.org/dev/peps/pep-0440/ и https://semver.org/.
По сути, схема управления версиями выполняется по шаблону: "major.minor.micro", где приращение номера основной версии означает критическое изменение API.
По умолчанию, если этого не происходит (например, для записанных скриптов до версии 2020), основной версией API будет считаться v1.0.0.
Скрипты, записанные в приложении версии 2020 и далее, будут автоматически вставляться в первую строку, выполненняемую в скрипте.
Примеры
MMpy.set_api_version(1, 0, 0)
ID ресурса
IDPH_SET_API_VERSION