לפני שתתחילו בהליכים האלה, חשוב לוודא שהפעלתם את וה-SDK לצרכן, כפי שמתואר בסעיפים הקודמים.
כדי להפעיל את Consumer SDK, צריך לבצע את השלבים הבאים:
אחזור של המופע ConsumerApi
כדי להשתמש ב-SDK לצרכן, האפליקציה שלך צריכה לאתחל את Singleton
ConsumerApi
באופן אסינכרוני. שיטת האתחול לוקחת את
מחלקה AuthTokenFactory
כדי ליצור אסימוני JWT חדשים למשתמש במקרה הצורך.
providerId
הוא מזהה הפרויקט של הפרויקט ב-Google Cloud. לקבלת מידע נוסף
ליצירת פרויקט ב-Fleet Engine, ראו:
יוצרים פרויקט ב-Fleet Engine במדריך של Fleet Engine.
עליך להטמיע את AuthTokenFactory
באפליקציה כפי שמתואר ב-SDK לצרכנים
אימות.
Java
Task<ConsumerApi> consumerApiTask = ConsumerApi.initialize(
this, "myProviderId", authTokenFactory);
consumerApiTask.addOnSuccessListener(
consumerApi -> this.consumerApi = consumerApi);
Kotlin
val consumerApiTask =
ConsumerApi.initialize(this, "myProviderId", authTokenFactory)
consumerApiTask?.addOnSuccessListener { consumerApi: ConsumerApi ->
this@YourActivity.consumerApi = consumerApi
}
SDK של מפות וכלים לעיבוד מפות Google
Consumer SDK גרסה 2.0.0 ואילך תומך ב-SDK של מפות Google ל-Android גרסה 18.1.0 ואילך
מאוחר יותר. בטבלה הבאה מופיע סיכום של כלי הרינדור שמוגדר כברירת מחדל לפי גרסת ה-SDK של מפות Google
ומידת התמיכה של שני כלי הרינדור. אם אפשר, כדאי להשתמש בכלי העדכני ביותר לרינדור.
אם אתם חייבים להשתמש בכלי לרינדור מדור קודם, מציינים אותו במפורש באמצעות
MapsInitializer.initialize()
גרסת SDK של מפות Google | תמיכה בכלי לרינדור העדכני ביותר | תמיכה בכלי לרינדור מדור קודם | כלי לעיבוד שמוגדר כברירת מחדל |
---|---|---|---|
גרסה 18.1.0 ומטה | כן | כן | דור קודם* |
V18.2.0 | כן | כן | פורסמו לאחרונה |
* לאחר השקת כלי הרינדור החדש של מפות Google, הכלי האחרון לעיבוד יהיה כברירת מחדל.
אם אתם חייבים להשתמש בכלי לרינדור מועדף, מריצים את כל פעולות הרינדור של ממשק המשתמש
after OnMapsSdkInitializedCallback
מחזירה תוצאה. רינדור UI
הפעולות האלה כוללות את הפעולות הבאות:
ניפוח של תצוגה שמכילה את
GoogleMapView
אוConsumerMapView
.המערכת ממקמת סמנים בדומיין
ConsumerMapView
.
אם לא תבצעו את הפעולות האלה לאחר קבלת
תוצאה אחת (OnMapsSdkInitializedCallback
), ה-SDK של מפות Google לא מקצה את
ובמקום זאת, עיבוד המפה המועדף ותצוגת המפה עוברת עיבוד כברירת מחדל.
אתחול ה-SDK של מפות Google לפני הפעלת ה-SDK לצרכן
צריך להתקשר לכיתת
Application
או לסטארט-אפActivity
MapsInitializer.initialize()ממתינים לתוצאה של בקשת הרינדור לפני אתחול ה-SDK לצרכנים.
בדוגמאות הבאות יש פרטים נוספים.
Java
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
initViews();
MapsInitializer.initialize(getApplicationContext(), Renderer.LATEST,
new OnMapsSdkInitializedCallback() {
@Override
public void onMapsSdkInitialized(Renderer renderer) {
switch (renderer) {
case LATEST:
Log.i("maps_renderer", "LATEST renderer");
break;
case LEGACY:
Log.i("maps_renderer", "LEGACY renderer");
break;
}
initializeConsumerSdk();
}
});
}
Kotlin
fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.main)
initViews()
MapsInitializer.initialize(
getApplicationContext(), Renderer.LATEST,
object : OnMapsSdkInitializedCallback() {
fun onMapsSdkInitialized(renderer: Renderer?) {
when (renderer) {
LATEST -> Log.i("maps_renderer", "LATEST renderer")
LEGACY -> Log.i("maps_renderer", "LEGACY renderer")
}
initializeConsumerSdk()
}
})
}
הערות לגבי SSL/TLS
באופן פנימי, הטמעת SDK לצרכנים משתמשת ב-SSL או ב-TLS כדי לתקשר באופן מאובטח
עם השירות Fleet Engine. יכול להיות שתצטרכו להשתמש ב-Android API בגרסה 23 ומטה
תיקון SecurityProvider
לתקשורת עם השרת. אפשר לקבל מידע נוסף
למידע על עבודה עם SSL ב-Android, ראו אבטחה GMS
ספק.
המאמר גם מכיל דוגמאות קוד לתיקון ספק האבטחה.