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

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

تثبيت KTX لحزمة تطوير البرامج Places SDK

لتثبيت KTX لحزمة Places SDK لنظام التشغيل Android، أضِف التبعيات التالية إلى ملف build.gradle.kts على مستوى التطبيق.

dependencies {

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

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

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

الشاشة الأولى من تطبيق Places KTX التجريبي، تعرض اختياراتك
شاشة تطبيق "عرض توضيحي للبحث عن الأماكن"

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

  1. من GitHub، استنسِخ الملف أو نزِّله كملف ZIP.
  2. في "استوديو Android"، اختَر ملف -> فتح وانتقِل إلى الدليل وافتح المجلد الذي نسخته أو نزّلته للتو.
  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".