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

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

تثبيت KTX لـ "حزمة تطوير البرامج (SDK) للأماكن"

لتثبيت KTX في "حزمة تطوير البرامج بالاستناد إلى الموقع الجغرافي لنظام التشغيل Android"، أضِف التبعيات التالية إلى ملف build.gradle.kts على مستوى التطبيق.

dependencies {

    // Modern Android projects use version catalogs to manage dependencies. To include the Places SDK for Android,
    // first add the following to your gradle/libs.versions.toml file:
    //
    // [versions]
    // places = "5.3.0"
    //
    // [libraries]
    // places = { group = "com.google.android.libraries.places", name = "places", version.ref = "places" }
    //
    // Places SDK for Android (Kotlin extensions and coroutines are built directly into the Places SDK)
    implementation(libs.places)

    // If your project does not use a version catalog, you can use the following dependency instead:
    //
    //    implementation("com.google.android.libraries.places:places:5.3.0")
}

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

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

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