שילוב ה-SDK לניווט ל-Android יכול לעזור לכם לא רק לקשר את האפליקציה לתצוגת מפה חיצונית. באמצעות הניווט במפות Google, האפליקציה יכולה להציע אחזור דינמי ודיווח אחד של הנתונים לגבי התהליך שעובר המשתמש. המדריך הזה מסביר איך להריץ את אפליקציות ההדגמה של Navigation SDK, שזמינות ב-GitHub.
הכנה
כדי להתחיל להשתמש ב-Navigation SDK, חשוב לוודא שאתם כוללים את הפריטים הבאים.
נציג של הפלטפורמה של מפות Google שיש לו גישה לשירותים הבאים:
- מפתח API שהוקצה לשימוש עם Navigation SDK. עליכם לספק את מזהה הפרויקט, שמופיע במרכז הבקרה הראשי במסוף Google Cloud, מתחת לשם הפרויקט.
- פריט המידע שנוצר בתהליך הפיתוח (Artifact) של ה-SDK. צריך לוודא שהפרויקט מוגדר לשימוש ב-Maven ל-API לניווט.
- לפרויקטים בגרסה 4.99.0 ומטה. אם אתם לא יכולים להשתמש ב-Maven, תוכלו להוריד את פריט המידע הדחוס מ-Google Drive המשותף. קובץ הספרייה הסטטית הוא קובץ ה-aar בספרייה
libs/שמכילה את Navigation SDK כחבילת AAR. - אחת או יותר מאפליקציות ההדגמה.
- Android Studio, סביבת הפיתוח המומלצת לפיתוח אפליקציה עם ה-Navigation SDK.
מאמרי העזרה האלה מיועדים לאנשים שמכירים את מושגי הפיתוח של Android ותכנות מוכוון אובייקט. חשוב גם להכיר את מפות Google מנקודת המבט של המשתמש.
הורדה של אפליקציות ההדגמה
Google מציעה שתי אפליקציות שיעזרו לכם להבין מה ה-Navigation SDK מציע בנוסף לממשקי ה-API של מפות Google, בהתאם לרמת החוויה שלכם. מפתחים שמכירים את ממשקי ה-API של מפות Google יכולים להתמקד בהדגמה של ניווט Google. מפתחים חדשים בשני הפרויקטים יפיקו תועלת משניהם.
החל מ-Navigation SDK ל-Android v4.1, אפליקציות ההדגמה הבאות זמינות להורדה ב-GitHub.
הדגמה של GoogleNavigation: מציג את השילוב של תצוגות והתנהגויות API שקשורות לחוויית המשתמש במהלך סשן של ניווט מודרך.
הדגמה של מפות Google: מציגה התנהגויות שונות של ממשק
GoogleMapכדי להתאים אישית את התחושה וההצגה של המפות.
הערה לגבי השימוש ב-Maven
באפליקציות ההדגמה מוגדרת הורדה של ארטיפקט ה-SDK ממאגר Maven המרוחק באמצעות הפלאגין Artifact Registry ב-Gradle. כדי לקבל גישה ל-SDK, חשוב לפעול לפי ההוראות להגדרה של הפרויקט.
ההדגמה של GoogleNavigation
ההדגמה האחרונה של GoogleNavigation זמינה ב-GitHub.
בניין
ב-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 ולהגדיר את המערכת לזיהוי המכשיר.
- Emulatormdash;יש להשתמש במנהל המכשירים הווירטואליים של Android (AVD) כדי להגדיר מכשיר וירטואלי. כשבוחרים אמולטור, חשוב לבחור תמונה שכוללת את 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 זמינה ב-GitHub.
בניין
ב-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 ולהגדיר את המערכת לזיהוי המכשיר.
- אמולטור: שימוש במנהל המכשיר הווירטואלי (AVD) של Android כדי להגדיר מכשיר וירטואלי. כשבוחרים אמולטור, חשוב לבחור תמונה שכוללת את Google APIs.
ב-Android Studio, לוחצים על האפשרות Run בתפריט (או על סמל לחצן ההפעלה). ואז בוחרים יעד פריסה.
כשהיא נוצרה ומושקת, האפליקציה מציגה למשתמש דף נחיתה עם רשימת הדגמות.
דפוס המצגת הזה והמבנה התואם של קוד המקור צריכים להיות מוכרים למשתמשים בהדגמות של ה-SDK של מפות Google. הסיבה לכך היא שההדגמה של GoogleMap מתוכננת להיות דומה לאפליקציית ההדגמה של API של מפות Google. ההבדל העיקרי הוא שההדגמה של Navigation SDK מאפשרת למשתמש לבחור את שיעור התצוגה שעליו הוא רוצה לבדוק להריץ הדגמה: NavigationView או MapView, היכן שרלוונטי.
Google בדרך כלל ממליצה למשתמשים להשתמש ב-NavigationView.
ההדגמה הזו נותנת לכם את הגמישות לנסות את ההתנהגויות האלה בשתי הגרסאות באפליקציית ההדגמה ולבחור את הגרסה שהכי מתאימה לכם. לדוגמה, יכול להיות שעדיין יהיה צורך להשתמש ב-MapView במצבים שבהם משתמשים בספרייה של צד שלישי שמצפה לאינטראקציה עם הכיתה הזו.