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