Migruj Azure Maps Web SDK Map Control v1 i v2.0.x do wersji v3

Azure Maps Web SDK Map Control v1 oraz Map Control wersje 2.0.0 do 2.0.32 zostały wycofane. Zaktualizuj wszystkie aplikacje korzystające z tych wersji do Map Control v3. Ten przewodnik wyjaśnia, jak przeprowadzić migrację.

Zrozum zmiany

Zanim rozpoczniesz proces migracji, ważne jest, aby zapoznać się z kluczowymi zmianami i ulepszeniami wprowadzonymi w Web SDK v3. Zapoznaj się z informacjami o wydaniu, aby zapoznać się z zakresem nowych funkcji.

Aktualizacja wersji Web SDK

CDN

Jeśli korzystasz z CDN (sieci dostarczania treści), zaktualizuj arkusz stylów i odniesienia do JavaScriptu w elementach head plików HTML.

Przed migracją: Map Control v1

<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>

Przed migracją: Map Control v2

Ogólna ścieżka CDN Map Control v2 ładuje najnowszą wersję v2, a nie konkretną wersję v2.0.x. Dlatego sam ten adres URL nie wskazuje, że aplikacja korzysta z dotkniętej wersji v2.0.x:

<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>

W przypadku aplikacji instalujących Map Control za pośrednictwem npm sprawdź ustaloną wersję azure-maps-control w pliku package-lock. Wersje od 2.0.0 do 2.0.32 zostały wycofane.

Po migracji: Map Control v3

<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

Jeśli używasz npm, zaktualizuj do najnowszej wersji sterowania Azure Maps, uruchamiając następujące polecenie:

npm install azure-maps-control@latest

Przegląd metod uwierzytelniania (opcjonalnie)

Aby zwiększyć bezpieczeństwo, od wersji 2 w Web SDK dodano więcej metod uwierzytelniania. Nowe metody obejmują uwierzytelnianie Microsoft Entra oraz uwierzytelnianie kluczem współdzielonym. Więcej informacji na temat bezpieczeństwa aplikacji webowych Azure Maps można znaleźć w artykule Manage Authentication in Azure Maps.

Testing

Kompleksowe testowanie jest niezbędne podczas migracji. Przeprowadz dokładne testowanie funkcjonalności, wydajności i doświadczenia użytkownika swojej aplikacji w różnych przeglądarkach i urządzeniach.

Stopniowe wdrażanie

Rozważ strategię stopniowego wdrażania zaktualizowanej wersji. Udostępnij przeniesioną wersję mniejszej grupie użytkowników lub w kontrolowanym środowisku, zanim udostępnisz ją całej bazie użytkowników.

Stosując się do tych kroków i biorąc pod uwagę najlepsze praktyki, możesz przenieść swoją aplikację z Azure Maps Web SDK Map Control v1 lub v2.0.x do v3. Aby uzyskać więcej informacji, zobacz artykuł Najlepsze praktyki dotyczące pakietu Azure Maps Web SDK.

Następne kroki

Dowiedz się, jak dodawać mapy do aplikacji webowych i mobilnych, korzystając z biblioteki JavaScript po stronie klienta Map Control w Azure Maps: