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

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

ملاحظة: اعتبارًا من الإصدار 4.0.0، تتضمّن حزمة SDK لتطبيق "الأماكن" لنظام التشغيل Android واجهات برمجة تطبيقات Kotlin الأصلية التي يمكن استخدامها بدلاً من إضافات KTX لتطبيق "الأماكن" على Android. لمزيد من المعلومات، اطّلِع على نظرة عامة على المرجع لـ "حزمة تطوير البرامج بالاستناد إلى بيانات الأماكن" لأجهزة Android.

تثبيت حزمة 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")
}

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

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