توضّح هذه الصفحة كيفية إعداد مكتبة برامج الخدمات الخاصة بحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android، وكيفية تشغيل التطبيق التجريبي المضمّن في المكتبة.
المتطلّبات الأساسية والملاحظات
تتوافق مكتبة برامج الخدمات الخاصة بحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android مع المستوى 15 من واجهة برمجة التطبيقات والإصدارات الأحدث. عند ضبط هدف إنشاء مشروعك، تأكَّد من استخدام أحدث مستوى لواجهة برمجة تطبيقات Android.
تتوفّر المستندات المرجعية على GitHub.
الخطوة 1: تثبيت مكتبة برامج الخدمات الخاصة بحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android
أضِف التبعية التالية إلى ملف build.gradle.kts في تطبيقك:
dependencies { // Utility Library for Maps SDK for Android // You do not need to add a separate dependency for the Maps SDK for Android // since this library builds in the compatible version of the Maps SDK. implementation("com.google.maps.android:android-maps-utils:3.19.0") }
استخدِم إحدى الأدوات المساعدة من المكتبة، مثل تجميع العلامات أو الخرائط الحرارية أو الأدوات المساعدة الأخرى.
الخطوة 2: (اختياري) تثبيت مكتبة KTX الخاصة بأدوات حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android
تتضمّن مكتبة برامج الخدمات الخاصة بحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android مكتبة إضافات بلغة Kotlin (KTX) مقابلة لها. توفّر هذه المكتبة ميزات لغة Kotlin، مثل دوال الإضافة والوسيطات المسماة والوسيطات التلقائية، لتتيح لك كتابة رمز Kotlin موجز وسليم. إذا كنت لا تستخدم Kotlin في عملية التطوير، يمكنك تخطّي هذه الخطوة.
لاستخدام هذه المكتبة، أضِف التبعية التالية، بالإضافة إلى التبعية android-maps-utils، إلى ملف build.gradle.kts في تطبيقك:
dependencies { // KTX for the Maps SDK for Android Utility Library implementation(libs.maps.utils.ktx) }
يمكنك الاطّلاع على صفحة GitHub الخاصة بمكتبة Maps KTX للحصول على معلومات إضافية حول هذه المكتبة.
الخطوة 3: عرض رمز المصدر لمكتبة برامج الخدمات الخاصة بحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android
بما أنّ مكتبة الأدوات المساعدة هي مكتبة مفتوحة المصدر، يمكنك تنزيل مكتبة android-maps-utils على جهازك لتخصيصها أو عرض التطبيق التجريبي أو إذا كنت تريد فقط فهم طريقة عمل المكتبة. ويمكنك إجراء ذلك من خلال استنساخ المستودع (ننصحك بذلك لتلقّي التحديثات التلقائية) أو تنزيل ملف مضغوط. إذا أردت تخصيص المكتبة، عليك إنشاء نسخة من المستودع.
يتضمّن المستودع ما يلي:
- تطبيق تجريبي في الدليل
demo - مكتبة الأدوات المساعدة، في الدليل
library - ملفات متنوعة تحتوي على معلومات الترخيص والمساهمين وملف readme
- إعدادات التصميم في Gradle، لاستخدامها مع "استوديو Android"
تشغيل التطبيق التجريبي للأداة
يتم شحن مستودع GitHub الخاص بمكتبة الأدوات المساعدة مع تطبيق تجريبي يتضمّن عيّنات لعمليات تنفيذ كل أداة مساعدة. اتّبِع الخطوات التالية لتشغيل التطبيق التجريبي على جهاز Android.
- نزِّل المستودع باستخدام أحد الخيارات المذكورة أعلاه.
- في "استوديو Android"، اختَر ملف (File) -> جديد (New) -> استيراد مشروع (Import Project).
- انتقِل إلى دليل android-maps-utils الذي تم إنشاؤه عند استنساخ مكتبة الأدوات المساعدة واختَر الدليل (انقر نقرًا مزدوجًا عليه). يبني "استوديو Android" المشروع الآن.
- إذا كنت تستخدم جهاز Android بدلاً من محاكي، احرص على تفعيل وضع مطور البرامج، ثم اربط جهاز Android بجهاز الكمبيوتر.
أضِف سطرًا واحدًا إلى
local.propertiesبالشكل التالي:MAPS_API_KEY=YOUR_API_KEY
حيث YOUR_API_KEY هو مفتاح واجهة برمجة التطبيقات الذي حصلت عليه كما هو موضّح في استخدام مفاتيح واجهة برمجة التطبيقات.
- أنشئ تطبيق العرض التوضيحي وشغِّله.
يجب أن يفتح التطبيق على جهاز Android، ويعرض قائمة ببرامج الخدمات، بما في ذلك التجميع وPolyutil وخريطة التمثيل اللوني وغير ذلك. ويمكنك أيضًا العثور على التطبيق في قائمة التطبيقات باسم Maps Utils Demo.