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