إنشاء تطبيق iOS (إصدار أولي)

توضح هذه المقالة كيفية إضافة خرائط Azure إلى تطبيق iOS. فهو يرشدك إلى هذه الخطوات الأساسية:

• إعداد بيئة التطوير.
• قم بإنشاء حساب خرائط Azure الخاص بك.
• احصل على مفتاح خرائط Azure الأساسي لاستخدامه في التطبيق.
• الإشارة إلى مكتبات خرائط Azure من المشروع.
• أضف عنصر تحكم خرائط Azure إلى التطبيق.

إشعار

خرائط Azure إيقاف iOS SDK

تم الآن إهمال خرائط Azure Native SDK لنظام التشغيل iOS وسيتم إيقافه في 3/31/25. لتجنب انقطاع الخدمة، قم بالترحيل إلى خرائط Azure Web SDK بحلول 3/31/25. لمزيد من المعلومات، راجع دليل ترحيل خرائط Azure iOS SDK.

المتطلبات الأساسية

في حال لم يكن لديك اشتراك Azure، فأنشئ حساباً مجانيّاً قبل البدء.

• حساب خرائط Azure
• مفتاح اشتراك
• كسكودي

إشعار

ولمزيد من المعلومات حول مصادقة Azure Maps، راجع إدارة المصادقة في Azure Maps.

أنشئ حساب خرائط Azure

إنشاء حساب جديد لخرائط Azure بالخطوات التالية:

1. في الزاوية العلوية اليسرى من مدخل Microsoft Azure، حدد Create a resource.

2. في مربع البحث في السوق ، اكتب خرائط Azure.

3. من Results، حدد Azure Maps، ثم حدد الزر Create الذي يظهر أسفل الخريطة.

4. في الصفحة "إنشاء حساب الخرائط"، أدخِل القيم التالية:

   • الاشتراك الذي تريد استخدامه لهذا الحساب.
   • اسم "مجموعة الموارد" لهذا الحساب. يمكنك اختيار إنشاء مجموعةموارد جديدة أو استخدام الموارد الموجودة.
   • اسم حسابك الجديد.
   • مستوى التسعير لهذا الحساب.
   • اقرأ بيان الترخيصوالخصوصية،ثم حدد خانة الاختيار لقبول الشروط.
   • حدد زر إنشاء.

   

الحصول على مفتاح الاشتراك لحسابك

بمجرد إنشاء حساب الخرائط بنجاح، استرد المفتاح الأساسي الذي يتيح لك الاستعلام عن واجهات برمجة التطبيقات الخرائط APIs.

1. افتح حساب الخرائط الخاص بك في البوابة الإلكترونية.

2. في قسم الإعدادات، حدد "المصادقة".

3. قم بنسخ المفتاح الأساسي إلى الحافظة الخاصة بك. قم بحفظه محليًا لاستخدامه في وقت لاحق في هذا البرنامج التعليمي.

إشعار

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

إنشاء مشروع في Xcode

أولاً، إنشاء مشروع تطبيق iOS جديد. إكمال هذه الخطوات لإنشاء مشروع Xcode:

1. ضمن File، حدّد New ->Project.

2. في علامة التبويب iOS، حدد App، ثم Next.

3. أدخل اسم التطبيق، معرف الحزمة ثم حدد Next.

راجع إنشاء Project Xcode لتطبيق للحصول على مزيد من المساعدة في إنشاء مشروع جديد.

تثبيت Azure Maps iOS SDK

الخطوة التالية في بناء التطبيق هي تثبيت Azure Maps iOS SDK. أكمل هذه الخطوات لتثبيت SDK:

1. مع تحديد مشروع Xcode iOS المطلوب في متصفح Project، حدد + الزر إضافة تبعية الحزمة.

   

2. أدخل القيم التالية في مربع الحوار الناتج:

   • أدخل https://github.com/Azure/azure-maps-ios-sdk-distribution.git في شريط البحث الذي يظهر في الزاوية العلوية اليمنى.
   • حدد Up to Next Major Version في حقل Dependency Rule.
   • 1.0.0-pre.3أدخل في حقل إصدار Dependency Rule.

   

3. بمجرد حل الحزمة إلى جانب التبعيات الخاصة بها، حدد الزر Add Package لإكمال إعداد التبعية.

   

إضافة طريقة عرض MapControl

1. إضافة تخصيص UIView لعرض وحدة التحكم

2. حدد فئة MapControl من وحدة AzureMapsControl

   

3. في ملف AppDelegate.swift :

   • إضافة استيراد لـ Azure Maps SDK
   • تعيين معلومات مصادقة Azure Maps

من خلال تعيين معلومات المصادقة على فئة Azure الخرائط بشكل عام باستخدام AzureMaps.configure(subscriptionKey:) أو AzureMaps.configure(aadClient:aadAppId:aadTenant:)، لا تحتاج إلى إضافة معلومات المصادقة الخاصة بك على كل طريقة عرض.

1. حدد زر run، كما هو موضح في الرسم التالي (أو اضغط CMD + R)، لبناء التطبيق الخاص بك.

   

يستغرق Xcode بضع ثوان لإنشاء التطبيق. بعد اكتمال البناء، يمكنك اختبار التطبيق الخاص بك في جهاز iOS للمحاكاة. يجب أن تشاهد خريطة مثل هذه:

وظيفة خريطة الوصول

يمكنك البدء في تخصيص وظيفة الخريطة عن طريق الحصول على تعليق للمثيل AzureMap في mapView.onReady معالج. MapControl بمجرد إضافة طريقة العرض، يجب أن تبدو العينة ViewController مشابهة للتعليمات البرمجية التالية:

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        let mapView = self.view.subviews.first as? MapControl;
        mapView?.onReady({ map in
            // customize your map here
            // map.sources.add()
            // map.layers.insertLayer()
        })
    }
}

تابع إلى إضافة طبقة مضلع إلى الخريطة في iOS SDK لأحد الأمثلة.

تنظيف الموارد

اتخاذ هذه الخطوات لتنظيف الموارد التي تم إنشاؤها في هذه البداية السريعة:

1. أغلق Xcode واحذف المشروع الذي قمت بإنشائه.

2. إذا قمت باختبار التطبيق على جهاز خارجي، فألغِ تثبيت التطبيق من على هذا الجهاز.

إذا لم تخطط للاستمرار في التطوير باستخدام Azure Maps iOS SDK:

1. انتقل إلى صفحة مدخل Azure. حدد "كافة الموارد" من صفحة المدخل الرئيسية. أو حدد رمز القائمة في الزاوية العلوية اليسرى، ثم All resources.

2. حدد حساب خرائط Azure. في الجزء العلوي من الصفحة، حدد حذف.

3. اختيارياً، إذا كنت لا تخطط لمواصلة تطوير تطبيقات iOS، فقم بإلغاء تثبيت Xcode.

معلومات إضافية

راجع المقالات التالية للحصول على مزيد من أمثلة التعليمات البرمجية:

• إدارة المصادقة في خرائط Azure
• تغيير أنماط الخريطة في خرائط نظام iOS
• إضافة طبقة رمز
• إضافة طبقة خط
• إضافة طبقة مضلعة