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

الأماكن في 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.2.0")
}

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

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

الشاشة الأولى في نموذج تطبيق Places 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-place-ktx.
  5. اختَر تشغيل 'app-place-ktx'.