مقداردهی اولیه «کیت توسعه نرم‌افزار مصرف‌کننده»

قبل‌از شروع این رویه‌ها، مطمئن شوید که سرویس‌های مناسب و Consumer SDK را همان‌طور که در بخش‌های قبلی توضیح داده شده است فعال کرده‌اید.

برای مقداردهی اولیه Consumer SDK، این مراحل را دنبال کنید:

  1. دریافت نمونه ConsumerAPI
  2. راه‌اندازی کیت توسعه نرم‌افزار Maps برای درخواست پردازنده ترجیحی

دریافت نمونه ConsumerApi

برای استفاده از Consumer SDK، برنامه‌تان باید سینگلتون ConsumerApi را به‌صورت ناهمگام مقداردهی اولیه کند. روش مقداردهی اولیه کلاس AuthTokenFactory را می‌گیرد تا درصورت لزوم، نشان‌های JWT جدیدی برای کاربر تولید کند.

providerId همان شناسه پروژه Google Cloud Project شما است. برای اطلاعات بیشتر درباره ایجاد پروژه Fleet Engine، به ایجاد پروژه Fleet Engine در راهنمای Fleet Engine مراجعه کنید.

برنامه شما باید AuthTokenFactory را همان‌طور که در اصالت‌سنجی کیت توسعه نرم‌افزار مصرف‌کننده شرح داده شده است پیاده‌سازی کند.

جاوا

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 و پردازنده گرافیکی نقشه‌ها

«کیت توسعه نرم‌افزار مصرف‌کننده» نسخه ۲.۰.۰ و جدیدتر از «کیت توسعه نرم‌افزار Maps ویژه Android» نسخه ۱۸.۱.۰ و جدیدتر پشتیبانی می‌کند. جدول زیر خلاصه‌ای از موتور پرداز پیش‌فرض براساس نسخه Maps SDK و پشتیبانی‌پذیری هر دو موتور پرداز را نشان می‌دهد. درصورت امکان، از جدیدترین پردازنده گرافیکی استفاده کنید. اگر باید از پردازنده قدیمی استفاده کنید، آن را به‌طور صریح بااستفاده از MapsInitializer.initialize() مشخص کنید.

نسخه کیت توسعه نرم‌افزار Maps از جدیدترین پردازنده پشتیبانی می‌کند از پردازنده قدیمی پشتیبانی می‌کند پردازنده پیش‌فرض
نسخه ۱۸.۱.۰ و پایین‌تر بله بله قدیمی*
V18.2.0 بله بله جدیدترین

* با عرضه پردازنده جدید Maps، پردازنده «جدیدترین» پیش‌فرض خواهد بود.

اگر باید از پردازنده ترجیحی استفاده کنید، همه عملیات پردازش واسط کاربر را پس‌از اینکه OnMapsSdkInitializedCallback نتیجه‌ای را برگرداند اجرا کنید. عملیات پردازش رابط کاربری شامل عملیات زیر می‌شود:

  • بزرگ کردن نمایی که حاوی GoogleMapView یا ConsumerMapView است.

  • درحال قرار دادن نشانگرها روی ConsumerMapView.

اگر این عملیات را پس‌از دریافت نتیجه OnMapsSdkInitializedCallback اجرا نکنید، Maps SDK پردازنده ترجیحی شما را اختصاص نمی‌دهد و نمای نقشه به‌جای آن توسط پردازنده پیش‌فرض پردازش می‌شود.

پیش‌از مقداردهی اولیه «کیت توسعه نرم‌افزار مصرف‌کننده»، «کیت توسعه نرم‌افزار Maps» را مقداردهی اولیه کنید

  1. در کلاس Application یا راه‌اندازی Activity، MapsInitializer.initialize() را فراخوانی کنید

  2. پیش‌از مقداردهی اولیه «کیت توسعه نرم‌افزار مصرف‌کننده»، منتظر نتیجه درخواست پردازنده بمانید.

برای جزئیات، مثال‌های زیر را ببینید.

جاوا

@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. نسخه‌های ۲۳ یا قدیمی‌تر میانای برنامه‌سازی کاربردی Android ممکن است برای برقراری ارتباط با سرور به وصله SecurityProvider نیاز داشته باشند. برای اطلاعات بیشتر درباره کار با SSL در Android، به ارائه‌دهنده GMS امنیتی مراجعه کنید. این مقاله همچنین حاوی نمونه کدهایی برای وصله کردن ارائه‌دهنده امنیتی است.

قدم بعدی چیست

راه‌اندازی نقشه