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

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

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

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

dependencies {

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

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

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

الشاشة الأولى من نموذج تطبيق الأماكن 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'.