با ادغام کردن Navigation SDK for Android، برنامه‌تان می‌تواند فراتر از پیوند دادن به نمای نقشه خارجی برود. با ناوبری Google Maps، برنامه‌تان می‌تواند بازیابی پویا و گزارش‌دهی تک‌نگاهی از داده‌های سفر کاربر ارائه دهد. این راهنما نحوه اجرای برنامه‌های نمایشی Navigation SDK را که در GitHub دردسترس هستند توضیح می‌دهد.
آماده شدن
برای شروع به کار با Navigation SDK، مطمئن شوید موارد زیر را داشته باشید.
- کلید میانای برنامه‌سازی کاربردی که برای استفاده با «کیت توسعه نرم‌افزار پیمایش» فراهم شده است. برای کسب اطلاعات بیشتر درباره ایجاد و محدود کردن کلیدها، استفاده از کلیدهای API را ببینید.
- ساخته کیت توسعه نرم‌افزار. تأیید کنید که پروژه‌تان پیکربندی شده است تا از Maven برای «کیت توسعه نرم‌افزار پیمایش» استفاده کند.
- یک یا چند برنامه نمایشی.
- Android Studio، محیط توسعه توصیه‌شده برای ساختن برنامه با Navigation SDK.
این مستندات برای افرادی طراحی شده است که با توسعه Android و مفاهیم برنامه‌نویسی شیءگرا آشنا هستند. همچنین باید از دیدگاه کاربر با Google Maps آشنا باشید.
دریافت برنامه‌های نمایشی
Google دو برنامه ارائه می‌دهد تا به شما کمک کند متوجه شوید Navigation SDK علاوه‌بر Google Maps APIs چه چیزهایی ارائه می‌دهد، بسته به سطح تجربه شما. توسعه‌دهندگانی که با Google Maps API آشنا هستند می‌توانند توجه خود را روی نسخه نمایشی GoogleNavigation متمرکز کنند. توسعه‌دهندگانی که با هر دو پروژه آشنا نیستند، هر دو برنامه را مفید خواهند یافت.
از نسخه ۴.۱ «کیت توسعه نرم‌افزار پیمایش برای Android»، هر دو برنامه نمایشی زیر در GitHub برای بارگیری دردسترس هستند.
نمونه GoogleNavigation: ادغام رفتارها و نماهای میانای برنامه‌سازی کاربردی را به‌شکلی که به تجربه کاربر درطول جلسه ناوبری راهنمایی‌شده مربوط می‌شود نمایش می‌دهد.
نمونه نمایشی GoogleMap: رفتارهای فردی واسط
GoogleMapرا برای سفارشی‌سازی حس و ارائه نقشه‌ها نمایش می‌دهد.
نسخه نمایشی GoogleNavigation
جدیدترین نسخه نمایشی GoogleNavigation در GitHub دردسترس است.
ساختن
در استودیو Android، برنامه نمایشی را وارد کنید و اجازه دهید Gradle اجرا شود.
local.defaults.propertiesرا باز کنید و مقدار خصوصیتMAPS_API_KEYرا به‌روز کنید:MAPS_API_KEY=YOUR_API_KEYروی ساخت کلیک کنید و جزئیات پیاده‌سازی کیت توسعه نرم‌افزار را بررسی کنید.
در کلاس Java، به کد پیاده‌سازی توجه کنید.
در XML چیدمان، به طراحی چیدمان و نوشتار توجه کنید.
در فایل
build.gradle، کیت توسعه نرم‌افزار را در وابستگی‌ها یادداشت کنید.
برای کسب اطلاعات بیشتر درباره نحوه افزودن کلید میانای برنامه‌سازی کاربردی به مانیفست، به مستندات افزونه Secrets Gradle مراجعه کنید.
اجرا کردن
دستگاه Android را به رایانه متصل کنید یا از شبیه‌ساز استفاده کنید.
- دستگاه Android—به دستورالعمل‌های فعال کردن گزینه‌های توسعه‌دهندگان در دستگاه Android و پیکربندی سیستم برای شناسایی دستگاه مراجعه کنید.
- شبیه‌ساز—از مدیر دستگاه مجازی Android (AVD) برای پیکربندی دستگاه مجازی استفاده کنید. هنگام انتخاب شبیه‌ساز، مطمئن شوید تصویری را انتخاب کنید که شامل Google APIs باشد.
در Android Studio، روی گزینه منو اجرا (یا نماد دکمه پخش) کلیک کنید؛ سپس هدف استقرار را انتخاب کنید.
وقتی برنامه ساخته و راه‌اندازی می‌شود، صفحه مقصدی با فهرستی از گزینه‌ها به کاربر نشان می‌دهد.
گزینه‌های NavViewActivity و NavFragmentActivity
کاربران جدید NavSDK احتمالاً این دو گزینه را مفیدترین گزینه‌ها خواهند یافت.
گزینه ۱: NavViewActivity رفتارهایی را بااستفاده از NavigationView
در ارتباط با
Navigator نشان می‌دهد.
گزینه ۲: گزینه دوم با عنوان NavFragmentActivity، رفتارهای استفاده از
NavigationFragment
را درکنار
Navigator
نمایش می‌دهد.
وقتی روی یکی از این گزینه‌ها کلیک می‌کنید، موارد زیر به شما ارائه می‌شود:
- میانای کاربر ناوبری
- دکمه «تنظیم مقصد» در منو برنامه
- یک هم‌پوشانی که می‌توانید با آن تعامل داشته باشید تا به‌طور پویا روش‌ها را در API فراخوانی کنید
- منوِ سرریز با گزینه‌های بیشتر
برای شروع، روی تنظیم مقصد کلیک کنید و نشانی‌ای را انتخاب کنید. سپس برنامه سفری را از مکان فعلی‌تان به آن نشانی شبیه‌سازی می‌کند. از رونهاد پانل‌های کنترل استفاده کنید تا ببینید وقتی میانای برنامه‌سازی کاربردی را فراخوانی می‌کنید چه اتفاقی می‌افتد. برای مثال، روی مشاهده روش‌ها کلیک کنید تا «کیت توسعه نرم‌افزار» را مجبور کنید به حالت شب برود و ببینید چگونه به‌نظر می‌رسد.
گزینه SwappingMapAndNavActivity
SwappingMapAndNavActivity الگوهای رایج زیر را نشان می‌دهد:
- نمایش
MapView - وقتی ناوبری شروع می‌شود،
به
NavigationViewجابه‌جا شود - برگشتن به
MapViewوقتی ناوبری پایان می‌یابد
نسخه نمایشی GoogleMap
جدیدترین نسخه نمایشی GoogleNavigation در GitHub دردسترس است.
ساختن
در استودیو Android، برنامه نمایشی را وارد کنید و اجازه دهید Gradle اجرا شود.
local.defaults.propertiesرا باز کنید و مقدار خصوصیتMAPS_API_KEYرا به‌روز کنید:MAPS_API_KEY=YOUR_API_KEYروی ساخت کلیک کنید و جزئیات پیاده‌سازی کیت توسعه نرم‌افزار را بررسی کنید.
در کلاس Java، به کد پیاده‌سازی توجه کنید.
در XML چیدمان، به طراحی چیدمان و نوشتار توجه کنید.
در فایل
build.gradle، کیت توسعه نرم‌افزار را در وابستگی‌ها یادداشت کنید.
برای اطلاعات بیشتر درباره نحوه افزودن کلید API به مانیفست، به افزونه Secrets Gradle مراجعه کنید.
اجرا کردن
دستگاه Android را به رایانه متصل کنید یا از شبیه‌ساز استفاده کنید.
- دستگاه Android برای فعال کردن گزینه‌های توسعه‌دهنده در دستگاه Android و پیکربندی سیستم برای شناسایی دستگاه، به دستورالعمل‌ها مراجعه کنید.
- شبیه‌ساز از مدیر دستگاه مجازی Android (AVD) برای پیکربندی دستگاه مجازی استفاده کنید. هنگام انتخاب شبیه‌ساز، مطمئن شوید تصویری را انتخاب کنید که شامل Google APIs باشد.
در Android Studio، روی گزینه منو اجرا (یا نماد دکمه پخش) کلیک کنید؛ سپس هدف استقرار را انتخاب کنید.
وقتی برنامه ساخته و راه‌اندازی می‌شود، صفحه مقصدی از فهرست نسخه‌های نمایشی به کاربر ارائه می‌دهد.
این الگوی ارائه و ساختار متناظر کد منبع باید برای کاربران نسخه‌های نمایشی Google Maps SDK آشنا باشد. دلیلش این است که نسخه نمایشی GoogleMap به‌گونه‌ای طراحی شده است که شبیه به برنامه نسخه نمایشی Maps API باشد. تفاوت اصلی این است که نسخه نمایشی Navigation SDK به کاربر اجازه می‌دهد انتخاب کند که می‌خواهد نسخه نمایشی را روی کدام کلاس نما آزمایش کند:
NavigationView
یا
MapView،
درصورت لزوم.
Google معمولاً پذیرندگان را تشویق می‌کند از
NavigationView استفاده کنند.
این نسخه نمایشی انعطاف‌پذیری لازم را برای امتحان کردن این رفتارها در هر دو نسخه در
برنامه نمایشی ما فراهم می‌کند و می‌توانید هرکدام را که برایتان مناسب است انتخاب کنید. برای مثال، ممکن است همچنان لازم باشد از MapView در شرایطی استفاده کنید که از کتابخانه شخص ثالثی استفاده می‌کنید که انتظار دارد با آن کلاس تعامل داشته باشد.