שילוב של ה-SDK של הניווט ל-Android מאפשר לא רק לקשר את האפליקציה לתצוגת מפה חיצונית. באמצעות הניווט במפות Google, אפשר להציג באפליקציה גם אחזור דינמי ודיווח על נתונים לגבי הנסיעה של הנהג במבט אחד.
במדריך הזה מוצג פרויקט של Android Studio, נסביר איך לשלב את הניווט SDK ולאחר מכן איך להפעיל את אפליקציות ההדגמה.
ה-SDK של הניווט הוא ספרייה סטטית שבעזרתה אפשר לשלוט במראה ובאודיו של האפליקציה לצורך ניווט באפליקציה. לקבלת פרטים על הספרייה, פתחו את החומר העזר בנושא Navigation SDK (Javadoc) בחלון נפרד.
הכנה
כדי להתחיל להשתמש ב-API של הניווט, חשוב לוודא שיש לכם את הפריטים הבאים.
נציג של הפלטפורמה של מפות Google לקבלת גישה לפריטים הבאים:
- מפתח API שהוקצה לשימוש עם ניווט SDK. אתם צריכים לספק את מזהה הפרויקט, שמופיע במרכז הבקרה הראשי של מסוף Google Cloud, מתחת לשם הפרויקט.
- פריט המידע שנוצר בתהליך הפיתוח (Artifact) של ה-SDK. חשוב לוודא שהפרויקט מוגדר לשימוש ב-Maven ל-API של הניווט.
- לפרויקטים שמשתמשים בגרסה 4.99.0 ובגרסאות קודמות. אם אתם לא יכולים להשתמש ב-Maven, תוכלו להוריד את ארטיפקט הדחוס מGoogle Drive המשותף. קובץ הספרייה הסטטי הוא קובץ ה- .aar בספרייה
libs/שמכילה את ה-SDK של הניווט, בתור חבילה של AAR. - אחת או יותר מאפליקציות ההדגמה.
Android Studio, סביבת הפיתוח המומלצת לבניית אפליקציה עם Navigation SDK.
מסמכי ומאמרי העזרה האלה מיועדים לאנשים שמכירים את מושגי הפיתוח של Android ותכנות מוכוון אובייקטים. חשוב גם להכיר את מפות Google מנקודת המבט של המשתמש.
הורדת אפליקציות ההדגמה
בהתאם לרמת הניסיון שלכם, Google מספקת שתי אפליקציות שיעזרו לכם להבין מה ממשקי ה-SDK של מפות Google מציעים בנוסף לממשקי ה-API של מפות Google. מפתחים שמכירים את ממשקי Google Maps API יכולים למקד את תשומת הלב שלהם בהדגמה של GoogleNavigation. שני הפרויקטים האלה יועילו למפתחים חדשים בשני הפרויקטים.
החל מ-Navigation SDK ל-Android v4.1, שתי אפליקציות ההדגמה הבאות זמינות להורדה בGoogle Drive המשותף.
הדגמת הניווט של Google: מציגה את השילוב של התנהגויות ותצוגות API שקשורות לחוויית המשתמש במהלך סשן של ניווט מודרך.
הדגמה של מפות Google: מציגה התנהגות אישית של ממשק
GoogleMap, כדי להתאים אישית את התחושה ואת ההצגה של מפות.
הערה לגבי השימוש ב-Maven
באפליקציות ההדגמה ניתן להוריד את ארטיפקט ה-SDK ממאגר Maven המרוחק באמצעות הפלאגין Artifact Registry ב-Gradle. כדי לקבל גישה ל-SDK, חשוב לפעול לפי ההוראות להגדרת הפרויקט.
הדגמה של GoogleNavigation
ההדגמה האחרונה של GoogleNavigation זמינה ברמה הבסיסית (root) של Google Drive המשותף. גרסאות קודמות של האפליקציה נמצאות בתיקייה 'ארכיון'. בגרסאות שקודמות ל-4.1, האפליקציה מקובצת לצד ה-AAR באותו קובץ ZIP.
בניין
ב-Android Studio, צריך לייבא את אפליקציית ההדגמה ולאפשר ל-Gradle לפעול.
פותחים את
local.defaults.propertiesומעדכנים את הערך של המאפייןMAPS_API_KEY:MAPS_API_KEY=YOUR_API_KEYלוחצים על build ובודקים את פרטי ההטמעה של ה-SDK.
במחלקה Java, שים לב לקוד ההטמעה.
ב-XML של הפריסה, חשוב לשים לב לעיצוב הפריסה ולטקסט.
בקובץ
build.gradle, חשוב לשים לב ל-SDK של יחסי התלות.
מידע נוסף על אופן ההוספה של מפתח API למניפסט זמין במסמכי התיעוד של הפלאגין של Secrets Gradle.
פועל
מחברים מכשיר Android למחשב או משתמשים באמולטור.
- מכשיר Android – אפשר להיעזר instructions כדי להפעיל אפשרויות למפתחים במכשיר Android ולהגדיר את המערכת כך שתזהה את המכשיר.
- אמולטורmdash; משתמשים במנהל המכשיר הווירטואלי (AVD) של Android כדי להגדיר מכשיר וירטואלי. כשבוחרים אמולטור, חשוב לבחור תמונה שכוללת את Google APIs.
ב-Android Studio, לוחצים על אפשרות התפריט Run (או על סמל לחצן ההפעלה) ובוחרים יעד לפריסה.
כשהיא תוכננה ומופעלת, היא מציגה למשתמש דף נחיתה עם רשימת אפשרויות.
אפשרויות NavViewActivity ו-NavFragmentActivity
משתמשים חדשים ב-NavSDK צפויים לראות ששתי האפשרויות האלה הן השימושיות ביותר.
אפשרות 1: NavViewActivity מציג התנהגויות באמצעות NavigationView בשילוב עם Navigator.
אפשרות 2: האפשרות השנייה, שנקראת NavFragmentActivity, מציגה התנהגויות באמצעות הסמל SupportNavigationFragment לצד Navigator.
כאשר לוחצים על אחת מהאפשרויות האלה, יוצגו לך:
- ממשק המשתמש לניווט
- לחצן 'הגדרת יעד' בתפריט האפליקציה
- שכבת-על שאפשר ליצור איתה אינטראקציה כדי להפעיל שיטות באופן דינמי ב-API
- תפריט אפשרויות נוספות עם אפשרויות נוספות
כדי להתחיל, לוחצים על הגדרת יעד ובוחרים כתובת. לאחר מכן האפליקציה מדמה נסיעה מהמיקום הנוכחי לכתובת הזו. השתמשו בשכבת-העל של לוחות הבקרה כדי לראות מה קורה כשקוראים ל-API. לדוגמה, אפשר ללחוץ על View Methods כדי לנסות לאלץ את ה-SDK לעבור למצב לילה ולראות איך הוא נראה.
החלפת האפשרות MapAndNavActivity
ב-SwappingMapAndNavActivity מוצגים התבניות הנפוצות הבאות:
- הצגה של
MapView - החלפה ל-
NavigationViewכשהניווט מתחיל - חזרה אל
MapViewכשהניווט מסתיים
הדגמה של 'מפות Google'
ההדגמה האחרונה של GoogleNavigation זמינה ברמה הבסיסית (root) של Google Drive המשותף. גרסאות קודמות של האפליקציה נמצאות בתיקייה 'ארכיון'.
בניין
ב-Android Studio, צריך לייבא את אפליקציית ההדגמה ולאפשר ל-Gradle לפעול.
פותחים את
local.defaults.propertiesומעדכנים את הערך של המאפייןMAPS_API_KEY:MAPS_API_KEY=YOUR_API_KEYלוחצים על build ובודקים את פרטי ההטמעה של ה-SDK.
במחלקה Java, שים לב לקוד ההטמעה.
ב-XML של הפריסה, חשוב לשים לב לעיצוב הפריסה ולטקסט.
בקובץ
build.gradle, חשוב לשים לב ל-SDK של יחסי התלות.
מידע נוסף על אופן ההוספה של מפתח API למניפסט זמין במאמר פלאגין של דירוג סודות.
פועל
מחברים מכשיר Android למחשב או משתמשים באמולטור.
- מכשיר Android אפשר להיעזר instructions כדי להפעיל אפשרויות למפתחים במכשיר Android ולהגדיר את המערכת כך שתזהה את המכשיר.
- אמולטור משתמשים בניהול המכשיר הווירטואלי של Android (AVD) כדי להגדיר מכשיר וירטואלי. כשבוחרים אמולטור, חשוב לבחור תמונה שכוללת את Google APIs.
ב-Android Studio, לוחצים על אפשרות התפריט Run (או על סמל לחצן ההפעלה). לאחר מכן בוחרים יעד לפריסה.
כשהיא תוכננה ומופעלת, היא מציגה למשתמש דף נחיתה עם רשימה של הדגמות.
דפוס ההצגה הזה והמבנה התואם של קוד המקור צריכים להיות מוכרים למשתמשי הדגמות ה-SDK של מפות Google. הסיבה לכך היא שההדגמה של Google Map תוכננה להיות דומה לאפליקציית ההדגמה של ה-API של מפות Google. ההבדל העיקרי הוא שההדגמה של ה-SDK לניווט מאפשרת למשתמש לבחור את סוג התצוגה שברצונם להריץ הדגמה על ידי: NavigationView או MapView, במקרים הרלוונטיים.
באופן כללי, Google מעודדת את המשתמשים להשתמש ב-NavigationView.
בהדגמה הזו אפשר לנסות את ההתנהגויות האלה בשתי הגרסאות באפליקציית ההדגמה שלנו, ולבחור את הגרסה שמתאימה לכם. לדוגמה, יכול להיות שעדיין יהיה צריך להשתמש ב-MapView במצבים שבהם אתם משתמשים בספרייה של צד שלישי שמצפה לקיים אינטראקציה עם הכיתה הזו.