Maps Android Kotlin extensions (KTX) هي مجموعة من إضافات Kotlin لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android ومكتبة أدوات "حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android". تقدّم هذه الإضافات هي ميزات بلغة Kotlin التي تتيح لك كتابة لغة Kotlin بشكل موجز وغامض. عند التطوير لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android إنّ حزمة KTX في "خرائط Google" مفتوحة المصدر و متوفرة على GitHub مع مزيد من المثال.
تثبيت
لتثبيت حزمة KTX لحزمة تطوير البرامج (SDK) بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android، واختياريًا لحزمة تطوير البرامج (SDK) بالاستناد إلى بيانات "خرائط Google"
لمكتبة أدوات Android، أضِف الملحقات التالية إلى ملف build.gradle.kts
.
dependencies {
// KTX for the Maps SDK for Android library
implementation("com.google.maps.android:maps-ktx:5.1.1")
}
أمثلة على الاستخدامات
من خلال مكتبة KTX، يمكنك الاستفادة من العديد من خلفيات مثل دوال الإضافات والمعلمات المسماة والوسيطات الافتراضية، والتصريحات التدميرية، والكوروتين.
استرداد خريطة Google باستخدام الكوروتينات
يمكن استرداد إذن الوصول إلى GoogleMap
باستخدام الكوروتين.
lifecycleScope.launch {
lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) {
val mapFragment: SupportMapFragment? =
supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment
val googleMap: GoogleMap? = mapFragment?.awaitMap()
}
}
إضافة علامة
يمكن إضافة علامة باستخدام طريقة نمط DSL addMarker().
val sydney = LatLng(-33.852, 151.211)
val marker = googleMap.addMarker {
position(sydney)
title("Marker in Sydney")
}
جمع أحداث الكاميرا
يمكن جمع الأحداث، مثل حركات الكاميرا، من خلال Kotlin Flow.
lifecycleScope.launch {
lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) {
googleMap.cameraMoveEvents().collect {
print("Received camera move event")
}
}
}
يمكنك الاطّلاع على قائمة كاملة بالميزات المتوافقة من خلال قراءة المستندات المرجعية.
تجربة نموذج التطبيق
يحتوي مستودع GitHub لهذه المكتبة أيضًا على تطبيق تجريبي التي توضح كيفية استخدام مكتبة KTX في "خرائط Google" في تطبيقك.
لتجربة التطبيق التجريبي، اتّبِع الخطوات التالية:
- من GitHub، استنسِخ ملف ZIP أو نزِّله.
- في "استوديو Android"، انقر على ملف -> افتح وانتقِل إلى الدليل وافتح المجلد الذي استنسخته أو نزّلته للتو.
- أضِف مفتاح واجهة برمجة التطبيقات إلى التطبيق التجريبي.
- احصل على حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لمفتاح Android.
- في الدليل الجذر، أنشئ ملفًا باسم
secrets.properties. يجب ألا يكون هذا الملف خاضعًا للتحكم في الإصدار لحماية مفتاح واجهة برمجة التطبيقات الخاص بك. - إضافة هذا السطر الفردي إلى
secrets.properties
MAPS_API_KEY="YOUR_API_KEY"
حيثYOUR_API_KEYهو مفتاح واجهة برمجة التطبيقات الفعلي الذي حصلت عليه في الخطوة الأولى. يمكنك إلقاء نظرة علىsecrets.defaults.propertiesكمثال. - ضِمن إعدادات التشغيل، اختَر الوحدة app-ktx.
- اختَر تشغيل 'app-ktx'.
الخطوات التالية
قد تكون مهتمًا أيضًا بمكتبات إضافات Kotlin الأخرى لخرائط Google النظام الأساسي: