Руководство по миграции веб-пакета SDK Карты Azure
Благодарим вас за выбор веб-пакета SDK Карты Azure для сопоставления. Это руководство по миграции помогает перейти с версии 1 и 2 до версии 3, что позволяет воспользоваться преимуществами новейших функций и улучшений.
Общие сведения об изменениях
Прежде чем начать процесс миграции, важно ознакомиться с ключевыми изменениями и улучшениями, представленными в веб-пакете SDK версии 3. Просмотрите заметки о выпуске, чтобы получить область новых функций.
Обновление версии веб-пакета SDK
Сеть доставки содержимого
Если вы используете CDN (сеть доставки содержимого), обновите ссылки на таблицу стилей версии 3 и JavaScript в head элементе HTML-файлов.
Версия 1
<link rel="stylesheet" href="https://atlas.microsoft.com/sdk/css/atlas.min.css?api-version=1" type="text/css" />
<script src="https://atlas.microsoft.com/sdk/js/atlas.min.js?api-version=1"></script>
Версия 2
<link rel="stylesheet" href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/2/atlas.min.css" type="text/css" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/2/atlas.min.js"></script>
Версия 3
<link rel="stylesheet" href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3/atlas.min.css" type="text/css" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3/atlas.min.js"></script>
npm
Если вы используете npm, обновите последнюю версию элемента управления Azure Карты, выполнив следующую команду:
npm install azure-maps-control@latest
Проверка методов проверки подлинности (необязательно)
Для повышения безопасности дополнительные методы проверки подлинности включены в веб-пакет SDK, начиная с версии 2. К новым методам относятся проверка подлинности Microsoft Entra и проверка подлинности с общим ключом. Дополнительные сведения о безопасности веб-приложений Azure Карты см. в статье "Управление проверкой подлинности в Azure Карты".
Тестирование
Комплексное тестирование является важным во время миграции. Проводите тщательное тестирование функциональных возможностей, производительности и взаимодействия с пользователем в разных браузерах и устройствах.
Постепенное развертывание
Рассмотрим стратегию постепенного развертывания для обновленной версии. Выпустите перенесенную версию в меньшую группу пользователей или в управляемой среде, прежде чем сделать ее доступной для всей базы пользователей.
Следуя этим инструкциям и учитывая рекомендации, вы можете успешно перенести приложение из Azure Карты веб-пакет SDK версии 1 и версии 2 в версию 3. Обнимайте новые возможности и улучшения, предлагаемые последней версией, обеспечивая плавный и простой переход для пользователей. Дополнительные сведения см. в рекомендациях по веб-пакету SDK для Azure Карты.
Следующие шаги
Узнайте, как добавлять карты в веб-приложения и мобильные приложения с помощью клиентской библиотеки JavaScript на стороне клиента Map Control в Azure Карты: