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

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

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

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

dependencies {

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

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

يحتوي مستودع 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".