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

الأماكن Android KTX عبارة عن مجموعة من إضافات Kotlin لحزمة SDK للأماكن لنظام التشغيل Android. توفر هذه الإضافات ميزات لغة Kotlin التي تمكّنك من كتابة لغة Kotlin موجزة ومفهومة عند تطوير حزمة تطوير برامج الأماكن لنظام التشغيل 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.2.0'
}

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

يحتوي مستودع GitHub لهذه المكتبة أيضًا على تطبيق تجريبي يوضح كيفية استخدام مكتبة 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-places-ktx.
5. اختَر تشغيل 'app-place-ktx'.