دليل ترحيل خرائط Azure Web SDK

نشكرك على اختيار خرائط Azure Web SDK لاحتياجات التعيين الخاصة بك. يساعدك دليل الترحيل هذا على الانتقال من v1 وv2 إلى v3، ما يسمح لك بالاستفادة من أحدث الميزات والتحسينات.

فهم التغييرات

قبل بدء عملية الترحيل، من المهم التعرف على التغييرات والتحسينات الرئيسية المقدمة في Web SDK v3. راجع ملاحظات الإصدار لفهم نطاق الميزات الجديدة.

تحديث إصدار Web SDK

شبكة تسليم المحتوى

إذا كنت تستخدم CDN (شبكة تسليم المحتوى)، فقم بتحديث المراجع إلى ورقة الأنماط v3 وJavaScript في head عنصر ملفات HTML.

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>

v2

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

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

إذا كنت تستخدم npm، فقم بالتحديث إلى أحدث عنصر تحكم خرائط Azure عن طريق تشغيل الأمر التالي:

npm install azure-maps-control@latest

مراجعة أساليب المصادقة (اختياري)

لتحسين الأمان، يتم تضمين المزيد من أساليب المصادقة في Web SDK بدءا من الإصدار 2. تتضمن الطرق الجديدة مصادقة Microsoft Entra ومصادقة المفتاح المشترك. لمزيد من المعلومات حول أمان تطبيق الويب خرائط Azure، راجع إدارة المصادقة في خرائط Azure.

الاختبار

الاختبار الشامل ضروري أثناء الترحيل. إجراء اختبار شامل لوظائف التطبيق وأدائه وتجربة المستخدم في متصفحات وأجهزة مختلفة.

الإطلاق التدريجي

ضع في اعتبارك استراتيجية الإطلاق التدريجي للإصدار المحدث. حرر الإصدار الذي تم ترحيله إلى مجموعة أصغر من المستخدمين أو في بيئة خاضعة للرقابة قبل إتاحته لقاعدة المستخدمين بأكملها.

باتباع هذه الخطوات والنظر في أفضل الممارسات، يمكنك ترحيل التطبيق الخاص بك بنجاح من خرائط Azure Web SDK v1 وv2 إلى v3. احتضن الإمكانات والتحسينات الجديدة التي يقدمها أحدث إصدار مع ضمان انتقال سلس وسلس للمستخدمين. لمزيد من المعلومات، راجع أفضل ممارسات خرائط Azure Web SDK.

الخطوات التالية

تعرف على كيفية إضافة خرائط إلى تطبيقات الويب والأجهزة المحمولة باستخدام مكتبة JavaScript من جانب العميل ل Map Control في خرائط Azure: