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

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

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

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

dependencies {

    // KTX for the Places SDK for Android library
    implementation 'com.google.maps.android:places-ktx:3.0.0'
}

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

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

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

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

  1. من GitHub، استنسِخ ملف ZIP أو نزِّله.
  2. في "استوديو Android"، انقر على ملف -> فتح وانتقِل إلى الدليل، ثم افتح المجلد الذي نسخته أو نزّلته للتو.
  3. أضِف مفتاح واجهة برمجة التطبيقات إلى التطبيق التجريبي.
    1. الحصول على مفتاح واجهة برمجة تطبيقات الأماكن.
    2. في الدليل الجذر، أنشِئ ملفًا باسم secrets.properties. يجب ألا يكون هذا الملف خاضعًا للتحكم في الإصدار لحماية مفتاح واجهة برمجة التطبيقات.
    3. أضِف هذا السطر الواحد إلى secrets.properties
      PLACES_API_KEY="YOUR_API_KEY"
      حيث يكون YOUR_API_KEY هو مفتاح واجهة برمجة التطبيقات الفعلي الذي حصلت عليه في الخطوة الأولى. يمكنك الاطّلاع على local.defaults.properties كمثال.
  4. ضمن إعدادات التشغيل، اختَر الوحدة app-places-ktx.
  5. اختَر تشغيل 'app-place-ktx'.