הפעל את ההדגמה

שילוב ה-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 demo: הדגמה של התנהגויות ספציפיות של הממשק GoogleMap, שמאפשרות להתאים אישית את המראה והסגנון של המפות.

ההדגמה של GoogleNavigation

ההדגמה האחרונה של GoogleNavigation זמינה ב-GitHub.

מבנה

1. ב-Android Studio, מייבאים את אפליקציית הדגמה ומאפשרים ל-Gradle לפעול.

2. פותחים את local.defaults.properties ומעדכנים את הערך של המאפיין MAPS_API_KEY:

     MAPS_API_KEY=YOUR_API_KEY
   

3. לוחצים על build ובודקים את פרטי ההטמעה של ה-SDK.

   • במחלקה Java, שימו לב לקוד ההטמעה.

   • בקובץ ה-XML של הפריסה, שימו לב לעיצוב הפריסה ולטקסט.

   • בקובץ build.gradle, מציינים את ה-SDK ביחסי התלות.

למידע נוסף על הוספת מפתח ה-API למניפסט, אפשר לעיין במסמכי התיעוד של הפלאגין של Secrets ל-Gradle.

פועל

1. מחברים מכשיר Android למחשב או משתמשים במהדמ.

   • מכשיר Android – פועלים לפי ההוראות כדי להפעיל אפשרויות למפתחים במכשיר Android ולהגדיר את המערכת לזיהוי המכשיר.
   • Emulatormdash;יש להשתמש במנהל המכשירים הווירטואליים של Android (AVD) כדי להגדיר מכשיר וירטואלי. כשבוחרים אמולטור, חשוב לבחור תמונה שכוללת את Google APIs.

2. ב-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.

מבנה

1. ב-Android Studio, מייבאים את אפליקציית ההדגמה ומאפשרים ל-Gradle לפעול.

2. פותחים את local.defaults.properties ומעדכנים את הערך של המאפיין MAPS_API_KEY:

     MAPS_API_KEY=YOUR_API_KEY
   

3. לוחצים על build ובודקים את פרטי ההטמעה של ה-SDK.

   • במחלקה Java, שימו לב לקוד ההטמעה.

   • בקובץ ה-XML של הפריסה, שימו לב לעיצוב הפריסה ולטקסט.

   • בקובץ build.gradle, שימו לב ל-SDK בתור יחסי התלות.

מידע נוסף על ההוספה של מפתח API למניפסט זמין במאמר פלאגין של Secrets gradle.

פועל

1. מחברים מכשיר Android למחשב או משתמשים באמולטור.

   • מכשיר Android פועלים לפי ההוראות כדי להפעיל את האפשרויות למפתחים במכשיר Android ולהגדיר את המערכת לזיהוי המכשיר.
   • אמולטור אפשר להשתמש במנהל המכשיר הווירטואלי של Android‏ (AVD) כדי להגדיר מכשיר וירטואלי. כשבוחרים אמולטור, חשוב לבחור קובץ אימג' שכולל את Google APIs.

2. ב-Android Studio, לוחצים על אפשרות התפריט Run (או על סמל לחצן ההפעלה) ובוחרים יעד פריסה.

אחרי יצירת האפליקציה והפעלתה שלה, המשתמש יוצג לו דף נחיתה עם רשימה של הדגמות.

דפוס המצגת הזה והמבנה התואם של קוד המקור צריכים להיות מוכרים למשתמשים בהדגמות של ה-SDK של מפות Google. הסיבה לכך היא שההדגמה של GoogleMap מתוכננת להיות דומה לאפליקציית ההדגמה של API של מפות Google. ההבדל העיקרי הוא שההדגמה של Navigation SDK מאפשרת למשתמש לבחור את שיעור התצוגה שעליו הוא רוצה לבדוק להריץ הדגמה: NavigationView או MapView, היכן שרלוונטי.

Google בדרך כלל ממליצה למשתמשים להשתמש ב-NavigationView. הדגמה הזו מספקת גמישות לנסות את ההתנהגויות האלה בשתי הגרסאות באפליקציית הדגמה שלנו, ולבחור את הגרסה שמתאימה לכם. לדוגמה, יכול להיות שעדיין תצטרכו להשתמש ב-MapView במצבים שבהם אתם משתמשים בספרייה של צד שלישי שצפויה לקיים אינטראקציה עם הכיתה הזו.