این صفحه نحوه راهاندازی کتابخانه ابزار Maps SDK برای اندروید و اجرای برنامه آزمایشی موجود در کتابخانه را شرح میدهد.
پیش نیازها و نکات
کتابخانهی کاربردی Maps SDK for Android از اندروید API سطح ۱۵ و بالاتر پشتیبانی میکند. هنگام تعیین هدف ساخت پروژه، مطمئن شوید که از آخرین سطح API اندروید استفاده میکنید.
مستندات مرجع در گیتهاب موجود است.
مرحله ۱. نصب کتابخانه ابزار Maps SDK برای اندروید
وابستگی زیر را به فایل 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") }
از یکی از ابزارهای کتابخانه، مانند خوشهبندی نشانگر ، نقشههای حرارتی یا سایر ابزارها ، استفاده کنید.
مرحله ۲. (اختیاری) نصب ابزار Maps SDK برای اندروید، کتابخانه KTX
کتابخانهی کاربردی Maps SDK برای اندروید، به همراه یک کتابخانهی افزونههای کاتلین (KTX) مربوطه ارائه میشود. این کتابخانه ویژگیهای زبان کاتلین - مانند توابع افزونه، آرگومانهای نامگذاری شده و پیشفرض - را ارائه میدهد تا شما را قادر به نوشتن کاتلین مختصر و اصطلاحی کند. اگر در کاتلین توسعه نمیدهید، میتوانید از این مرحله صرف نظر کنید.
برای استفاده از این کتابخانه، علاوه بر وابستگی android-maps-utils ، وابستگی زیر را نیز به فایل build.gradle.kts برنامه خود اضافه کنید:
dependencies { // KTX for the Maps SDK for Android Utility Library implementation(libs.maps.utils.ktx) }
برای اطلاعات بیشتر در مورد این کتابخانه، صفحه Maps KTX GitHub را بررسی کنید.
مرحله ۳. مشاهده کد منبع کتابخانه ابزار Maps SDK برای اندروید
از آنجایی که این کتابخانهی کاربردی متنباز است، میتوانید کتابخانهی android-maps-utils را برای سفارشیسازی، مشاهدهی نسخهی آزمایشی برنامه یا اگر فقط میخواهید نحوهی کارکرد کتابخانه را درک کنید، روی دستگاه خود دانلود کنید. میتوانید این کار را با کپی کردن مخزن (توصیه میشود برای دریافت بهروزرسانیهای خودکار) یا دانلود یک فایل زیپ انجام دهید. اگر میخواهید کتابخانه را سفارشی کنید، باید مخزن را فورک کنید .
مخزن شامل موارد زیر است:
- یک برنامه آزمایشی، در پوشه
demo. - کتابخانهی ابزارهای کاربردی، در فهرست
library. - فایلهای مختلفی حاوی مجوز، مشارکتکنندگان و اطلاعات readme.
- پیکربندی ساخت Gradle، برای استفاده با اندروید استودیو.
برنامه آزمایشی کاربردی را اجرا کنید
مخزن گیتهاب برای کتابخانهی ابزارهای کاربردی، یک برنامهی آزمایشی (دمو) ارائه میدهد که شامل پیادهسازیهای نمونه از هر ابزار کاربردی است. برای اجرای برنامهی آزمایشی روی دستگاه اندروید خود، این مراحل را دنبال کنید.
- مخزن را با استفاده از یکی از گزینههای ذکر شده در بالا دانلود کنید.
- در اندروید استودیو، مسیر File -> New -> Import Project را انتخاب کنید.
- به پوشه android-maps-utils که هنگام کلون کردن کتابخانه ابزار ایجاد شده است، بروید و آن را انتخاب کنید (دوبار کلیک کنید). اکنون اندروید استودیو پروژه را میسازد.
- اگر به جای شبیهساز از دستگاه اندروید استفاده میکنید، حتماً حالت توسعهدهنده (developer mode) را فعال کنید . سپس دستگاه اندروید را به رایانه خود وصل کنید.
یک خط به
local.propertiesاضافه کنید که شبیه این باشد:MAPS_API_KEY=YOUR_API_KEY
که YOUR_API_KEY کلید API است که طبق توضیحات بخش «استفاده از کلیدهای API» دریافت کردهاید.
- اپلیکیشن دمو را بسازید و اجرا کنید.
برنامه باید روی دستگاه اندروید باز شود و لیستی از ابزارها از جمله خوشهبندی، چندکاره، نقشه حرارتی و موارد دیگر را نمایش دهد. همچنین میتوانید این برنامه را در لیست برنامههای خود، با نام Maps Utils Demo پیدا کنید.