نظرة عامة على تطبيق KTX لنظام التشغيل Android وأماكنه

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

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

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

dependencies {
    implementation 'com.google.maps.android:places-ktx:0.4.0'
}

إذا كنت تستخدم مكتبة "الأماكن الثابتة" مع الإصدار التجريبي الإصدار 3 من حزمة تطوير البرامج في "خرائط Google"، أضِف الاعتمادية التالية إلى ملف build.gradle على مستوى التطبيق بدلاً من ذلك.

dependencies {
    implementation 'com.google.maps.android:places-v3-ktx:0.4.0'
}

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

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

الشاشة الأولى لتطبيق "نماذج KTX" لأماكن، تعرض اختياراتك
شاشة تطبيق العرض التجريبي في "الأماكن"

لتجربة التطبيق التجريبي، اتّبِع الخطوات التالية:

  1. من GitHub، استنسِق ملف ZIP أو نزِّله.
  2. في تطبيق "استوديو Android"، اختَر ملف -> فتح وانتقِل إلى الدليل وافتح المجلد الذي تم نسخه أو تنزيله للتو.
  3. أضِف مفتاح واجهة برمجة تطبيقات إلى التطبيق التجريبي.
    1. الحصول على مفتاح واجهة برمجة تطبيقات الأماكن
    2. في الدليل الجذري، أنشِئ ملفًا باسم secure.properties. يجب ألا يخضع هذا الملف للتحكّم في الإصدارات لحماية مفتاح واجهة برمجة التطبيقات.
    3. أضِف هذا السطر الفردي إلى secure.properties
      PLACES_API_KEY=”YOUR_API_KEY”
      حيث يكون YOUR_API_KEY هو مفتاح واجهة برمجة التطبيقات الذي حصلت عليه في الخطوة الأولى. يمكنك الاطّلاع على secure.properties.template كمثال.
  4. ضمن إعدادات الضبط، اختَر الوحدة app.
  5. اختَر تشغيل "التطبيق".