Встраиваем аналитику от Huawei в Android приложение

В прошлой статье мы создавали аккаунт разработчика для использования Huawei Mobile Services и подготавливали проект к их использованию. Теперь пора приступить к встраиванию конкретных сервисов.

Вот полный список статей из цикла:

1. Создаём аккаунт разработчика, подключаем зависимости, подготавливаем код к внедрению. тык
2. Встраиваем Huawei Analytics. ← вы тут
3. Используем геолокацию от Huawei.
4. Huawei maps. Используем вместо Google maps для AppGallery.

Как должен выглядеть код в уже готовом проекте

Начнём с аналитики. И исходить будем из того, что она у вас спрятана за примерно такой абстракцией:

interface Analytics {     fun send(event: AnalyticsEvent) }  interface AnalyticsEvent {      val key: String      val data: Map<String, Any>  }  fun Map<String, Any>.toBundle() =     Bundle().apply {         forEach { (key, value) ->             when (value) {                 is String -> putString(key, value)                 is Int -> putInt(key, value)                 is Boolean -> putBoolean(key, value)                 is Double -> putDouble(key, value)                 is Float -> putFloat(key, value)                 else -> throw IllegalArgumentException("Unknown data type: ${value::class.simpleName}")             }         }     }  open class SimpleEvent(override val key: String) : AnalyticsEvent {      override val data: Map<String, Any> = hashMapOf()      override fun toString(): String = "AnalyticsEvent { key = $key, data = $data }" }  open class ParamsEvent(key: String, vararg params: Pair<String, Any>): SimpleEvent(key) {     override val data = params.toMap() }  class EventOpenSomeScreen : SimpleEvent("screen_some_screen")

Соответственно, где требуется какое-то событие отправить, вы делаете что-то такое:

@Inject lateinit var analytics: Analytics  ...  analytics.send(EventOpenSomeScreen())

Используем разные реализации аналитики

Если всё вышеописанное верно, то подставлять разные реализации аналитики в разных сборках проще простого.

1. Указываем, что для huawei flavor-а мы используем одну библиотеку, а для google — другую:

dependencies {   huaweiImplementation 'com.huawei.agconnect:agconnect-core:1.3.1.300'   huaweiImplementation 'com.huawei.hms:hianalytics:5.0.0.301'    googleImplementation 'com.google.firebase:firebase-analytics:17.2.3' }

1. В DI биндим для типа Analytics экземпляр класса AnalyticsImpl. Сам же AnalyticsImpl у нас будет в двух вариантах. Один — в папке src/huawei/kotlin/com/example и выглядеть так:

class AnalyticsImpl(context: Context) : Analytics {      private val analytics = HiAnalytics.getInstance(context)      override fun send(event: AnalyticsEvent) {         analytics.onEvent(event.key, event.data.toBundle())     } }

Другой в папке src/google/kotlin/com/example:

class AnalyticsImpl(context: Context) : Analytics {   private val firebaseAnalytics = FirebaseAnalytics.getInstance(context)    override fun send(event: AnalyticsEvent) {       firebaseAnalytics.logEvent(event.key, event.data.toBundle())   } }

Вот собственно и всё с аналитикой. API библиотек очень похожи и никаких проблем не возникает.

Проверяем, что всё работает

Также, очень удобно можно проверить, что Huawei аналитика работает. Для этого надо:

1. Подсоединить девайс к компьютеру.
2. Выполнить в консоли adb shell setprop debug.huawei.hms.analytics.app ТУТ_APPLICATION_ID_ВАШЕГО_ПРИЛОЖЕНИЯ
3. Открыть консоль разработчика в браузере, перейти в AppGallery Connect -> Мои приложения -> Выбрать приложение -> Раздел "Разработка" -> Управление -> Отладка приложения.
4. Теперь отправленные из приложения события вы будете видеть в реальном времени прямо на сайте.
5. Чтобы отключить режим отладки выполните adb shell setprop debug.huawei.hms.analytics.app .none.

Вот так режим отладки выглядит в браузере:

Дальше — геолокация

С аналитикой мы разобрались, в следующей статье покажем как встроить определение геолокации от Huawei в приложение, которое уже использует аналог от Google.

Весь код, который есть в этом цикле статей вы можете посмотреть в репозитории на GitHub. Вот ссылка: https://github.com/MobileUpLLC/huawei_and_google_services.