نظرة عامة على نظام Android KTX وإعداده

‫Places Android KTX هي مجموعة من إضافات Kotlin لحِزمة تطوير البرامج (SDK) للأماكن لنظام Android. توفّر هذه الإضافات ميزات لغة Kotlin التي تتيح لك كتابة لغة Kotlin موجزة ومألوفة عند تطوير التطبيقات باستخدام حزمة تطوير برامج "الأماكن" لنظام التشغيل Android. إنّ Places KTX مفتوح المصدر ومتاح على GitHub مع أمثلة.

ملاحظة: اعتبارًا من الإصدار 4.0.0، تتضمّن حزمة SDK لتطبيق "الأماكن" لنظام التشغيل Android واجهات برمجة تطبيقات Kotlin الأصلية التي يمكن استخدامها بدلاً من إضافات KTX لتطبيق "الأماكن" على Android. لمزيد من المعلومات، اطّلِع على نظرة عامة على المرجع لـ "حزمة تطوير البرامج بالاستناد إلى بيانات الأماكن" لأجهزة Android.

تثبيت حزمة KTX لحزمة تطوير البرامج (SDK) لميزة "الأماكن"

لتثبيت حزمة KTX لحزمة تطوير البرامج (SDK) لميزة "الأماكن" على Android، أضِف الملحقات التالية إلى ملف build.gradle.kts على مستوى التطبيق.

dependencies {

    // KTX for the Places SDK for Android library
    implementation("com.google.maps.android:places-ktx:3.2.0")
}

تجربة نموذج الطلب

يحتوي مستودع GitHub لهذه المكتبة أيضًا على تطبيق أداة تجريبية يوضّح كيفية استخدام مكتبة Places KTX في تطبيقك.

لتجربة التطبيق التجريبي، اتّبِع الخطوات التالية:

1. من GitHub، استنسِخ ملف ZIP أو نزِّله.
2. في Android Studio، اختَر ملف -> فتح وانتقِل إلى directory (الدليل) وافتح المجلد الذي نسخته أو نزّلته للتو.
3. أضِف مفتاح واجهة برمجة التطبيقات إلى التطبيق التجريبي.
1. الحصول على مفتاح Places API
2. في الدليل الجذر، أنشئ ملفًا باسم secrets.properties. يجب ألا يكون هذا الملف خاضعًا لأي عملية التحكّم في الإصدار بهدف حماية مفتاح واجهة برمجة التطبيقات.
3. أضِف هذا السطر الفردي إلى secrets.properties
   

   PLACES_API_KEY="YOUR_API_KEY"

   حيث يكون YOUR_API_KEY هو مفتاح واجهة برمجة التطبيقات الفعلي الذي حصلت عليه في الخطوة الأولى. يمكنك الاطّلاع على local.defaults.properties كمثال.
4. ضمن إعدادات التشغيل، اختَر الوحدة app-places-ktx.
5. اختَر تشغيل "app-places-ktx".