Блог API Яндекс.Карт

Дополнение в систему версионирования API

7 августа 2012, 17:12

Мы решили дополнить существующую систему версионирования API.

С момента запуска в API 2.0 было два варианта подключения:
api-maps.yandex.ru/2.0 — последняя опубликованная версия.
api-maps.yandex.ru/2.0.х — конкретная желаемая версия (например, api-maps.yandex.ru/2.0.13).

Теперь мы добавили еще один вариант:
api-maps.yandex.ru/2.0-stable — подключение последней стабильной версии.

2.0-stable будет отставать от 2.0 на несколько релизов и будет переключаться на новую версию, только если в ней не будет выявлено явных ошибок и на нее не будет жалоб от пользователей клуба.

Рекомендуем в продакшене подключать api-maps.yandex.ru/2.0-stable, а для разработки использовать api-maps.yandex.ru/2.0.

Уверены, что благодаря этим изменениям работа карты в вашем проекте станет еще более стабильной.

Команда разработчиков API Яндекс.Карт.

12 комментариев
Подписаться на комментарии к посту

молодцы

Спасибо :-)

Ведь действительно молодцы.

Попросили changelog - сделали,

начались бока с отваливающимися функциями  - выкатили stable.

Оставайтесь столь же отзывчивыми, этого многим не хватает.

надо было /2.0 сделать как stable
и отдельно ввести /2.0-dev
а то получается вы бету в продакшен отдаете
API уже 4 года живёт по этой системе.
Внезапно менять этот подход нам показалось негуманным.

с вариантом api-maps.yandex.ru/2.0 перестал правильно работать кластер

ошибку можно посмотреть здесь http://egorl.ru/eeyore/ при масштабировании

лечится записью api-maps.yandex.ru/2.0-stable

Спасибо за сообщение. В коде образовалась глобальная переменная cluster, и из-за этого затиралось значение, которое вы присваивали переменной cluster. Мы поправим это в следующем релизе. Сейчас вы можете обойти ошибку просто поменяв имя переменной, например с 'cluster' на 'clusterer'.

Добрый день.

 

Скажите, а новые версии обратносовместимы с предыдущими? То есть если я разрабатывал под 2.0.18 могу ли я в продакшене указать 2.0-stable и не бояться, что в 1 прекрасный момент карты у меня отвалятся, потому что в 2.0-stable положат необратносовместимую версию?

Мы стараемся поддерживать полную обратную совместимость. Однако 100%-ой гарантии дать не можем, т.к. возможны разные ситуации (например, починка бага может сломать какой-то функционал).
В вашем случае мы рекомендуем зафиксировать на продакшене конкретную версию (2.0.21, например) и периодически обновлять.

перехожу по ссылке http://api-maps.yandex.ru/2.0-stable/  выдает

missing lang parameter

Конечно. Это же ссылка для подключения API. Почитайте вот тут об обязательный параметрах урла для подключения http://api.yandex.ru/maps/doc/jsapi/2.x/dg/concepts/load.xml.

Все, спасибо "протупил", целые сутки работал в разработке сайта, голова неи бум-бум))))