Механизм контроля версий Document API

Константы версии Document API Major и Minor позволяют проверить совместимость предыдущей и текущей версии Document API.

Если была изменена константа Major версии Document API, т. е. в Document API произошли обратно несовместимые изменения, то программный код должен быть пересмотрен и обновлен. Обратно несовместимыми изменениями считаются: переименование, удаление или несовместимое изменение подписи существующих классов или методов, а также добавление новых методов, типов и членов класса.

Если была изменена константа Minor версии Document API, то в Document API произошли только обратно совместимые изменения, и нет необходимости менять программный код, чтобы он работал с более новой версией Document API. Но гарантируется совместимость только на уровне исходного кода, поэтому необходимо перекомпилировать программный код приложения с более новой версией библиотеки Document API.

Рекомендуется проверить версию Document API до инициализации, как указано ниже:

print(myOfficeSDK.Minor)
print(myOfficeSDK.Major)

if __name__ == '__main__':
 expected_major_api_version = 1
 expected_minor_api_version = 0

 if not myOfficeSDK.isAPIVersionCompatible(expected_major_api_version, expected_minor_api_version):

 # Вывод сообщения о серьезной ошибке несовместимости версии библиотеки Document API и выход из программы

 pass

 # Работа с библиотекой Document API (создание объекта Application и т. д.)