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

שילוב ה-SDK ניווט ל-Android מאפשר לאפליקציה שלך לייעל את תהליך הקישור לתצוגת מפה חיצונית. ניווט במפות Google מאפשר לאפליקציה להציע אפשרויות דינמיות אחזור ודיווח במבט אחד של נתונים לגבי התהליך שעובר המשתמש. המדריך הזה שמסביר איך להריץ אפליקציות הדגמה של Navigation SDK, זמינים ב-GitHub.

הכנה

כדי להתחיל להשתמש ב-Navigation SDK, צריך את הפריטים הבאים.

  • נציג של הפלטפורמה של מפות Google שיש לו גישה לשירותים הבאים:

    • מפתח API שהוקצה לשימוש עם SDK ניווט. עליך לספק את projectID, שנמצא במרכז הבקרה הראשי במסוף Google Cloud, מתחת לשם הפרויקט.
    • פריט המידע שנוצר בתהליך הפיתוח (Artifact) של ה-SDK. צריך לוודא שהפרויקט מוגדר כדי להשתמש ב-Maven ל-SDK לניווט.
    • לפרויקטים בגרסה 4.99.0 ומטה. אם אין לכם אפשרות להשתמש ב-Maven, יכולים להוריד את פריט ה-ZIP מGoogle Drive המשותף. קובץ הספרייה הסטטית הוא קובץ ה- .aar הספרייה libs/ מכילה את ה-SDK לניווט בתור חבילת AAR.
    • אחת או יותר מאפליקציות ההדגמה.
    • Android Studio, סביבת הפיתוח המומלצת לפיתוח אפליקציה עם ה-SDK לניווט.

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

הורדה של אפליקציות ההדגמה

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

החל מ-Navigation SDK ל-Android v4.1, אפליקציות ההדגמה הבאות הן שזמין להורדה ב-GitHub.

  • הדגמה של GoogleNavigation: מציגה את השילוב של התנהגויות API צפיות כפי שהן קשורות לחוויית המשתמש בזמן ניווט מודרך סשן.

  • הדגמה של מפות Google: מציגה התנהגויות של משתמשים ספציפיים בGoogleMap ממשק להתאמה אישית של התחושה וההצגה של מפות.

הערה לגבי השימוש ב-Maven

אפליקציות ההדגמה מוגדרות להורדה של פריט המידע שנוצר בתהליך הפיתוח (Artifact) של ה-SDK מ-Maven מרחוק באמצעות הפלאגין של Artifact Registry שב-Gradle. חשוב לפעול לפי את ההוראות להגדרת הפרויקט כדי לקבל גישה ל-SDK.

ההדגמה של 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 למניפסט.

פועל

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

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

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

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

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

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

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

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

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

החלפת האפשרות MapAndNavActivity

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

ההדגמה של מפות 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 למניפסט.

פועל

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

    • מכשיר Android אפשר למצוא ב הוראות כדי להפעיל אפשרויות למפתחים במכשיר ה-Android ולהגדיר את המערכת לזיהוי המכשיר.
    • Emulator שימוש במכשיר הווירטואלי של Android (AVD) ניהול כדי להגדיר מכשיר וירטואלי. כשבוחרים אמולטור, חשוב לוודא לבחור תמונה שכוללת את Google APIs.
  2. ב-Android Studio, לוחצים על האפשרות הפעלה בתפריט (או על לחצן ההפעלה). icon); ובוחרים יעד פריסה.

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

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

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