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

שילוב של 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 בנוגע לחוויית המשתמש במהלך סשן ניווט מודרך.

• הדגמה של מפות Google: הדגמה של התנהגויות ספציפיות של הממשק 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 ומגדירים את המערכת לזיהוי המכשיר.
   • מכונה וירטואלית – משתמשים במנהל המכשירים הווירטואליים של Android‏ (AVD) כדי להגדיר מכשיר וירטואלי. כשבוחרים אמולטור, חשוב לבחור קובץ אימג' שכולל את Google APIs.

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

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

האפשרויות NavViewActivity ו-NavFragmentActivity

משתמשים חדשים ב-NavSDK ימצאו את שתי האפשרויות האלה השימושיות ביותר.

אפשרות 1: NavViewActivity מציג התנהגויות באמצעות NavigationView בשילוב עם Navigator.

אפשרות 2: האפשרות השנייה, שנקראת NavFragmentActivity, מציגה התנהגויות באמצעות SupportNavigationFragment לצד Navigator.

כשלוחצים על אחת מהאפשרויות האלה, מוצגים הפרטים הבאים:

• ממשק המשתמש של הניווט
• לחצן 'הגדרת יעד' בתפריט של האפליקציה
• שכבת-על שאפשר לבצע איתה אינטראקציה כדי להפעיל דינמית שיטות ב-API
• תפריט אפשרויות נוספות

כדי להתחיל, לוחצים על הגדרת יעד ובוחרים כתובת. לאחר מכן האפליקציה תדמה נסיעה מהמיקום הנוכחי שלכם לכתובת הזו. אפשר להשתמש בשכבת-העל של לוחות הבקרה כדי לראות מה קורה כשקוראים ל-API. לדוגמה, אפשר ללחוץ על View Methods כדי לנסות לכפות על ה-SDK לעבור למצב לילה ולראות איך הוא נראה.

האפשרות SwappingMapAndNavActivity

ב-SwappingMapAndNavActivity מוצגים הדפוסים הנפוצים הבאים:

• מוצג MapView
• החלפה לNavigationView כשהניווט מתחיל
• חזרה לMapView בסיום הניווט

הדגמה של Google Maps

הדמו האחרון של 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 plugin.

פועל

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

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

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

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

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

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