שילוב של Navigation SDK ל-Android מאפשר לאפליקציה שלכם לעשות יותר מאשר לקשר לתצוגת מפה חיצונית. באמצעות ניווט עם מפות Google, האפליקציה יכולה לאחזר באופן דינמי נתונים על המסלול של המשתמש ולדווח עליהם במבט יחיד. במדריך הזה נסביר איך להריץ את אפליקציות ההדגמה של Navigation SDK, שזמינות ב-GitHub.
הכנה
כדי להתחיל לעבוד עם Navigation SDK, צריך לוודא שיש לכם את הפריטים הבאים.
- מפתח API שהוקצה לשימוש ב-Navigation SDK. מידע נוסף על יצירה והגבלה של מפתחות זמין במאמר שימוש במפתחות API.
- ארטיפקט ה-SDK. מוודאים שהפרויקט מוגדר לשימוש ב-Maven עבור Navigation SDK.
- אחת או יותר מאפליקציות ההדגמה.
- Android Studio, סביבת הפיתוח המומלצת ליצירת אפליקציה באמצעות Navigation SDK.
התיעוד הזה מיועד לאנשים שמכירים את פיתוח Android ואת המושגים של תכנות מונחה-עצמים. כדאי גם להכיר את מפות Google מנקודת המבט של המשתמש.
הורדת אפליקציות הדגמה
Google מספקת שתי אפליקציות שיעזרו לכם להבין מה ה-Navigation SDK מציע בנוסף לממשקי ה-API של מפות Google, בהתאם לרמת הניסיון שלכם. מפתחים שמכירים את ממשקי ה-API של מפות Google יכולים להתמקד בהדגמה של GoogleNavigation. מפתחים שחדשים בשני הפרויקטים ימצאו את שתי האפליקציות מועילות.
החל מגרסה 4.1 של Navigation SDK ל-Android, אפשר להוריד את שתי האפליקציות הבאות להדגמה מ-GitHub.
הדגמה של GoogleNavigation: מציגה את השילוב של התנהגויות ותצוגות של API בהקשר של חוויית המשתמש במהלך סשן של ניווט מודרך.
הדגמה של GoogleMap: מציגה התנהגויות נפרדות של ממשק
GoogleMapכדי להתאים אישית את המראה וההצגה של המפות.
הדגמה של 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 plugin.
ריצה
מחברים מכשיר Android למחשב או משתמשים באמולטור.
- מכשיר Android – אפשר לעיין בהוראות להפעלת האפשרויות למפתחים במכשיר Android ולהגדרת המערכת לזיהוי המכשיר.
- Emulator – אפשר להשתמש ב-Android Virtual Device (AVD) Manager כדי להגדיר מכשיר וירטואלי. כשבוחרים אמולטור, חשוב לוודא שבוחרים תמונה שכוללת את Google APIs.
ב-Android Studio, לוחצים על אפשרות התפריט Run (הפעלה) (או על סמל לחצן ההפעלה) ואז בוחרים יעד פריסה.
כשהאפליקציה נוצרת ומופעלת, מוצג למשתמש דף נחיתה עם רשימה של אפשרויות.
אפשרויות של NavViewActivity ו-NavFragmentActivity
סביר להניח שהאפשרויות האלה יהיו הכי שימושיות למשתמשים חדשים ב-NavSDK.
אפשרות 1: NavViewActivity מציג התנהגויות באמצעות NavigationView
בצירוף Navigator.
אפשרות 2: באפשרות השנייה, שנקראת NavFragmentActivity, מוצגים התנהגויות באמצעות SupportNavigationFragment לצד Navigator.
לחיצה על אחת מהאפשרויות האלה תציג את האפשרויות הבאות:
- ממשק המשתמש של הניווט
- לחצן 'הגדרת יעד' בתפריט של האפליקציה
- שכבת-על שאפשר לקיים איתה אינטראקציה כדי להפעיל באופן דינמי שיטות ב-API
- תפריט אפשרויות נוספות
כדי להתחיל, לוחצים על הגדרת יעד ובוחרים כתובת. האפליקציה תדמה נסיעה מהמיקום הנוכחי שלכם לכתובת הזו. אפשר להשתמש בשכבת העל של לוחות הבקרה כדי לראות מה קורה כשמבצעים קריאה ל-API. לדוגמה, לוחצים על View Methods כדי לנסות להעביר את ה-SDK למצב לילה ולראות איך הוא נראה.
האפשרות SwappingMapAndNavActivity
הפונקציה SwappingMapAndNavActivity מציגה את התבניות הנפוצות הבאות:
- מוצג
MapView - החלפה ל
NavigationViewכשהניווט מתחיל - חזרה ל
MapViewבסיום הניווט
הדגמה של GoogleMap
הדגמה עדכנית של 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 plugin.
ריצה
מחברים מכשיר Android למחשב או משתמשים באמולטור.
- מכשיר Android כדי להפעיל את האפשרויות למפתחים במכשיר Android ולהגדיר את המערכת כך שתזהה את המכשיר, צריך לפעול לפי ההוראות.
- אמולטור אפשר להשתמש בAndroid Virtual Device (AVD) Manager כדי להגדיר מכשיר וירטואלי. כשבוחרים אמולטור, חשוב לוודא שבוחרים תמונה שכוללת את Google APIs.
ב-Android Studio, לוחצים על אפשרות התפריט Run (או על סמל לחצן ההפעלה) ואז בוחרים יעד פריסה.
אחרי שיוצרים את האפליקציה ומשיקים אותה, מוצג למשתמש דף נחיתה עם רשימה של הדגמות.
הפורמט הזה של הצגת הנתונים והמבנה התואם של קוד המקור מוכרים למשתמשים בהדגמות של Google Maps SDK. הסיבה לכך היא שהדמו של GoogleMap נועד להיות דומה לאפליקציית הדמו של Maps API. ההבדל העיקרי הוא שבדמו של Navigation SDK המשתמש יכול לבחור את מחלקת התצוגה שהוא רוצה להריץ עליה דמו: NavigationView או MapView, לפי הצורך.
בדרך כלל, Google ממליצה למשתמשים להשתמש ב-NavigationView.
ההדגמה הזו מאפשרת לנסות את ההתנהגויות האלה בשתי הגרסאות באפליקציית ההדגמה שלנו ולבחור את הגרסה שמתאימה לכם. לדוגמה, יכול להיות שעדיין יהיה צורך להשתמש ב-MapView במצבים שבהם משתמשים בספרייה של צד שלישי שמצפה לאינטראקציה עם המחלקה הזו.