לפני שמתחילים את התהליכים האלה, חשוב לוודא שהפעלתם את השירותים המתאימים ואת Consumer SDK, כפי שמתואר בסעיפים הקודמים.
כדי להפעיל את Consumer SDK, פועלים לפי השלבים הבאים:
הפונקציה מחזירה את המופע של ConsumerApi
כדי להשתמש ב-Consumer SDK, האפליקציה צריכה להפעיל את הסינגלטון ConsumerApi באופן אסינכרוני. שיטת האיניציאליזציה משתמשת במחלקה AuthTokenFactory כדי ליצור אסימוני JWT חדשים למשתמש לפי הצורך.
providerId הוא מזהה הפרויקט שלכם ב-Google Cloud. מידע נוסף על יצירת פרויקט ב-Fleet Engine זמין במאמר יצירת פרויקט ב-Fleet Engine במדריך של Fleet Engine.
באפליקציה צריך להטמיע את AuthTokenFactory כפי שמתואר במאמר אימות ב-Consumer 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
}
Maps SDK ומנועי רינדור של מפות Google
גרסה 2.0.0 ומעלה של Consumer SDK תומכת בגרסה 18.1.0 ומעלה של SDK של מפות ל-Android. בטבלה הבאה מפורטים מנועי הרינדור שמוגדרים כברירת מחדל לפי גרסת Maps SDK, והתמיכה בשני מנועי הרינדור. אם אפשר, כדאי להשתמש בכלי העיבוד העדכני ביותר.
אם אתם חייבים להשתמש בכלי הרינדור הקודם, ציינו אותו במפורש באמצעות MapsInitializer.initialize().
| גרסת Maps SDK | תמיכה בכלי העיבוד העדכני ביותר | תמיכה בכלי הרינדור הקודם | Renderer שמוגדר כברירת מחדל |
|---|---|---|---|
| גרסה 18.1.0 ומטה | כן | כן | מדור קודם* |
| V18.2.0 | כן | כן | הכי עדכני |
* עם ההשקה של מנוע העיבוד החדש של מפות Google, מנוע העיבוד העדכני יהיה ברירת המחדל.
אם אתם חייבים להשתמש במנוע רינדור מועדף, הפעילו את כל פעולות הרינדור של ממשק המשתמש אחרי ש-OnMapsSdkInitializedCallback מחזיר תוצאה. פעולות רינדור של ממשק המשתמש כוללות את הפעולות הבאות:
ניפוח תצוגה שמכילה את
GoogleMapViewאו אתConsumerMapView.הצבת סמנים ב-
ConsumerMapView.
אם לא תפעילו את הפעולות האלה אחרי קבלת התוצאה OnMapsSdkInitializedCallback, ה-Maps SDK לא יקצה את מנוע הרינדור המועדף עליכם, ותצוגת המפה תרונדר על ידי מנוע הרינדור שמוגדר כברירת מחדל.
אתחול של Maps SDK לפני האתחול של Consumer SDK
במחלקה
Applicationאו במחלקהActivityשל ההפעלה, קוראים ל-MapsInitializer.initialize()צריך להמתין לתוצאה של בקשת הרינדור לפני שמפעילים את Consumer 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
באופן פנימי, ההטמעה של Consumer SDK משתמשת ב-SSL/TLS כדי לתקשר באופן מאובטח עם שירות Fleet Engine. יכול להיות שבגרסאות 23 ומטה של Android API צריך תיקון של SecurityProvider כדי לתקשר עם השרת. למידע נוסף על עבודה עם SSL ב-Android, קראו את המאמר ספק GMS לאבטחה.
המאמר מכיל גם דוגמאות קוד לתיקון ספק האבטחה.