Как адаптировать Android-приложение под Huawei

Всем привет! Меня зовут Миша Вассер, я Head of Android в AGIMA. Мы занимаемся разработкой Digital-продуктов для больших и маленьких компаний, в том числе пилим мобильные приложения.

Не так давно — по сравнению со всей историей Android — Huawei выкатил собственную операционную систему и сказал: «Ребята, вот вам новая система, кайфуйте». Многие отнеслись к новой ОС скептически. Остальным пришлось адаптировать под нее свои Android-приложения.

Мы оказались во второй группе. К нам время от времени обращаются с просьбой помочь с адаптацией под Huawei. И мы неплохо в этом вопросе прокачались. Поэтому сейчас расскажу, что надо сделать, чтобы стало хорошо. А покажу всё это на примере крупного ретейлера, с которым мы работаем.

Что сделать, чтобы было хорошо

1. Зависимости build.gradle.

Чтобы начать работать с библиотеками Huawei, первым делом добавим нужные зависимости в наш Gradle (модуля app):

dependencies {
	implementation 'com.huawei.hms:push:6.3.0.304'
	implementation 'com.huawei.hms:maps:6.4.1.300'
	implementation 'com.huawei.hms:location:6.4.0.300'
	implementation 'com.huawei.hms:hianalytics:6.4.1.302'
	implementation 'com.huawei.agconnect:agconnect-crash:1.6.5.300'
	implementation 'com.huawei.agconnect:agconnect-remoteconfig:1.6.5.300'
}

В самый верх файла добавим:

apply plugin: 'com.huawei.agconnect'

А теперь добавим в Gradle-файл проекта еще такую зависимость:

dependencies {
		classpath 'com.huawei.agconnect:agcp:1.6.0.300'
}

2. Добавление agconnect-services.json.

В Android с Google-сервисами мы используем файл из Firebase, который называется google-services.json. В Huawei нам потребуется такой же конфигурационный файл. Без него не получится использовать фичи, которые предоставляет вендор (например, push-уведомления, аналитика и т. д.).

Чтобы добавить этот файл, заходим в AppGalleryConnect. Затем в «Мои проекты», выбираем нужный проект, идем в «Настройки проекта» в левом боковом меню. Листаем до раздела «Данные приложения».

Теперь скачиваем файл agconnect-services и кладем его в папку App нашего проекта в Android Studio.

3. Правила Proguard.

Чтобы не заобфусцировать ничего лишнего, попросим Proguard не трогать Huawei-библиотеки. Для этого добавим в proguard-rules.pro строки из документации для разработчиков:

-ignorewarnings
-keepattributes *Annotation*
-keepattributes Exceptions
-keepattributes InnerClasses
-keepattributes Signature
-keepattributes SourceFile,LineNumberTable
-keep class com.huawei.hianalytics.**{*;}
-keep class com.huawei.updatesdk.**{*;}
-keep class com.huawei.hms.**{*;}

4. Проверим, доступны ли Google-сервисы.

Важная часть работы с Huawei — это проверка, точно ли у юзера на устройстве нет Google-сервисов. Полезно оставлять в коде возможность запустить Android-версию приложения. Причина банальна: APK из AppGallery кто-то может запостить в другое место, и юзеры скачают его на свои нехуавейные смартфоны.

Чтобы проверить, делаем вот такую Extension-функцию для контекста:

fun Context.areGoogleServicesAvailable(): Boolean {
    val availability = GoogleApiAvailability.getInstance().isGooglePlayServicesAvailable(this)
    return availability == com.google.android.gms.common.ConnectionResult.SUCCESS
}

Теперь можно вызывать ее откуда угодно и строить логику платформозависимых функций, опираясь на неё.

5. Определяем местоположение юзера.

Часто в приложении нужно определять местоположение юзера, чтобы, например, показать ближайший магазин. Для этого мы пользуемся FusedLocationClient. В Huawei больших изменений нет, надо просто импортировать HMS клиента вот так:

import com.huawei.hms.location.FusedLocationProviderClient

Тогда код получения Location клиента у нас получится вот таким:

if (context.areGoogleServicesAvailable()) {
    GoogleFusedLocation(
com.google.android.gms.location.LocationServices.getFusedLocationProviderClient(context)
    )
} else {
    HuaweiFusedLocation(
        com.huawei.hms.location.LocationServices.getFusedLocationProviderClient(context)
    )
}

В самих классах FusedLocation для обеих платформ все стандартно — локацию юзера получаем, вешая слушатели на Success и Failure:

providerClient.lastLocation
  .addOnSuccessListener{ //Получили location }
  .addOnFailureListener{ //Что-то упало }

6. Меняем все Google Play на AppGallery.

Почти на всех проектах пользователей нужно перевести на страницу приложения в Google Play. Так как у Huawei свой стор AppStoreConnect, пользователя лучше вести туда. Для этого меняем URI и Package в интенте.

Вот как мы открываем магазин в Android:

val uri = Uri.parse("market://details?id=" + applicationId)
val intent = Intent().apply {
		action = Intent.ACTION_VIEW
		data = uri
		setPackage("com.android.vending")
}

А вот как открыть его в Huawei:

val uri = Uri.parse("appmarket://details?id=" + applicationId)
val intent = Intent().apply {
		action = Intent.ACTION_VIEW
		data = uri
		setPackage("com.huawei.appmarket")
}

Дальше, уже используя написанный нами ранее Checker, можем вести пользователя в тот или иной магазин

7. Меняем number на phone во всех Layout с android:inputType.

Один из хаков, который вам пригодится.

Если в Android у EditText мы проставляем android:inputtype="number" — например, на экране ввода кода из смс при авторизации, то пользователь Huawei всё равно увидит клавиатуру QWERTY, а не клавиатуру с цифрами, как в Android. Чтобы это пофиксить, просто поменяйте inputType на “phone”.

Добавление SHA-256-ключа

Чтобы полноценно использовать SDK Huawei, нужно добавить отпечаток сертификата SHA-256 в консоль AppGalleryConnect. Если вы добавляете его в первый раз, это можно сделать по инструкции.

А я тем временем расскажу, что делать, если приложение пришло на доработку после того, как кто-то его релизил и уже прописывал свои ключи в консоли.

1. Первым делом нужно узнать ваш SHA-256, который зашит в APK-шках, которые вы собираете у себя на компьютере или CI. Можно сделать несколькими способами, вот один из них:

• собираем APK;

• копируем путь до вашего APK;

• идем в консоль и вводим следующее (не забудьте вставить свой путь):

keytool -printcert -jarfile .../app-debug.apk

• консоль выведет наши ключи SHA-1 и SHA-256.

2. Копируем ключ SHA-256. Он выглядит примерно так: 00:F3:61:A7:AD:6B:13:11:27:02:09:8C:F5:12:FF…… Затем идем в AppGalleryConnect.

3. Теперь нужно зайти в «Мои проекты», выбрать нужный проект, открыть в левом боковом меню «Настройки проекта» и пролистать до раздела «Данные приложения».

4. Тут нажимаем «Добавить» и вводим наш полученный ранее ключ SHA-256. Теперь можем скачать файл agconnect-services.json — и всё.

А если не добавить ваш ключ в консоль? Не будут доходить пуши, не сработают In-App-Purchases, AppLinking и другие фишки AppGalleryConnect. Да и в целом нельзя будет залить приложение в стор. Поэтому не пропускайте и не игнорируйте этот момент.

Universal APK

При загрузке APK на некоторые Huawei-девайсы, в том числе и на эмулятор внутри AppGalleryConnect, важно сделать universal-сборку для всех типов процессоров. Иначе мы можем получить ошибку вроде This app is no longer compatible with your device.

Чтобы решить эту проблему, соберем универсальный APK. Добавим в Gradle (модуля app) следующие строчки:

android {
......
......
	  splits {
        abi {
            enable true
            reset()
            include 'x86', 'x86_64', 'armeabi', 'armeabi-v7a', 'mips', 'mips64', 'arm64-v8a'
            universalApk true
        }
    }
}

Теперь каждый раз при сборке APK у нас в папке build/outputs будут лежать несколько APK-файлов. Нам нужен тот, что называется app-universal-debug.apk. Смело загружайте его в эмуляторы AppGalleryConnect и отдавайте тестерам.

Push Kit и тестирование пушей

Отправка и удаление Push-токена

Зачастую крупные продукты рассылают пуши через Backend. Если вы не используете разные SDK (OneSignal, например), вам, скорее всего, нужно отдавать на свой бэк пуш-токен пользователя. Рассмотрим, как токен получить и как удалить.

В Android мы получаем пуш-токен Firebase как-то так:

suspend fun getTokenAndSendGoogle() {
     val token = FirebaseMessaging.getInstance().token.await()
     sendTokenToServer(token)
}

Huawei же тут решил немного намудрить. Когда-то пуш-токен в Huawei можно было получить синхронным запросом, но сейчас такое не прокатывает. В итоге токен надо получать в отдельном потоке. Делается это вот так:

private fun getTokenAndSendHuawei() {
        HmsInstanceId.getInstance(context).run {

            //Получаем id AppGallery приложения из конфига
            val appId = AGConnectServicesConfig.fromContext(context).getString("client/app_id")

            object : Thread() {
                override fun run() {
                    try {
                        //Получаем HMS пуш-токен по id, который достали ранее
                        val pushToken = getToken(appId, HmsMessaging.DEFAULT_TOKEN_SCOPE)

                        if (!pushToken.isNullOrBlank()) {
                            //Отправляем токен на ваш сервак
                            sendTokenToServer(pushToken)
                        }
                    } catch (e: ApiException) {

                    }
                }

            }.start()
        }
}

Используя проверку из предыдущего раздела, получаем такое условие:

supervisorScope {
   launch {
        if (getGMSAvailable()) {
	       getTokenAndSendGoogle()
        } else {
           getTokenAndSendHuawei()
		}
    }
}

С удалением токена всё так же просто. Например, при разлогине пользователя из приложения вам надо удалить токен. Получаем токен из HMS, удаляем с вашего сервера. В идеале надо провести еще одну операцию — удалить инстанс не только у вас, а ещё и из Firebase/HMS. На девайсах с гугл-сервисами делаем так:

FirebaseInstallations.getInstance().delete()

В HMS тоже никаких сложностей:

HmsInstanceId.getInstance(context).deleteAAID()

Тестирование пушей внутри эмулятора App Gallery Console

Ребята из Huawei сделали очень крутую тему. Они добавили эмулятор прямо в свою консоль. Объясняю, как протестить пуши с его помощью.

1. Чтобы попасть в эмулятор, нужно зайти в «Мои проекты», выбрать нужный проект. Затем в левом меню в разделе «Качество» выбрать «Облачная отладка».

2. Нажимаем и видим страницу с моделями доступных девайсов. Можно навести на каждый и либо начать отладку, если девайс свободен, либо зарезервировать симулятор на какой-то определенный тайм-слот.

3. Когда мы запустим эмулятор, увидим вот такой экран:

Справа видим Logcat, список доступных APK и прочие штуки, помогающие нам в отладке.

4. Устанавливаем приложение на симулятор, получаем Push-токен. Можем вывести получение токена из предыдущего раздела в логи и скопировать его.

5. Теперь идем в раздел Push Kit, он находится во вкладке «Рост» в левом боковом меню. Попав на страницу Push Kit, можем нажать на кнопку «Добавить уведомление».

6. Заполняем стандартные поля «Имя», «Заголовок», «Тело» и другие. Когда это готово, скроллим ниже, находим блок «Диапазон отправки». Тут нужно выбрать «Указанное устройство». Появится еще одно поле — «Токен устройства». Вставим туда токен, который мы скопировали пару пунктов назад.

7. Когда вы заполнили все поля, выбрали время отправки и указали пуш-токен, можно нажимать кнопку «Отправить».

8. Вернувшись в эмулятор, мы увидим пуш — вуаля! Таким образом вы сможете тестировать отображение пушей, диплинки и всё, что вам нужно в пушах.

Карты

Во многих приложениях есть географические карты. Большинство из них нуждаются в минимальном функционале — добавление маркеров, их удаление и нажатие. Если вы используете Яндекс.Карты или другую SDK, которая не гугл-сервис, скорее всего, вам ничего не придется адаптировать.

В этой части статьи постараюсь рассказать, что вам надо поменять, чтобы базовый функционал легко завелся.

Huawei снова сделал всё максимально удобно для нас. С точки зрения разработки, карты очень похожи друг на друга. Убрав лишнюю шелуху с кода, получаем следующее:

1. Начнем с XML. Добавляем карту в наш Layout.

Google:

<com.google.android.gms.maps.MapView
    xmlns:android="<http://schemas.android.com/apk/res/android>"
    xmlns:map="<http://schemas.android.com/apk/res-auto>"
    android:id="@+id/mapView"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

Huawei:

<com.huawei.hms.maps.MapView
    xmlns:android="<http://schemas.android.com/apk/res/android>"
    xmlns:map="<http://schemas.android.com/apk/res-auto>"
    android:id="@+id/mapView"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

2. Перейдем в наше Activity или Fragment. Затаскиваем импорты:

Google:

import com.google.android.gms.maps.CameraUpdateFactory
import com.google.android.gms.maps.GoogleMap
import com.google.android.gms.maps.model.BitmapDescriptorFactory
import com.google.android.gms.maps.model.CameraPosition
import com.google.android.gms.maps.model.LatLng
import com.google.android.gms.maps.model.MarkerOptions

Huawei:

import com.huawei.hms.maps.CameraUpdateFactory
import com.huawei.hms.maps.HuaweiMap
import com.huawei.hms.maps.model.BitmapDescriptorFactory
import com.huawei.hms.maps.model.CameraPosition
import com.huawei.hms.maps.model.LatLng
import com.huawei.hms.maps.model.MarkerOptions

3. Получаем карту и проводим махинации с ней. Для упрощения представим, что у нас все еще Kotlin Synthetics:

mapView.onCreate(null)
mapView.getMapAsync {
		with(it) {
			// Устанавливаем широту и долготу 
			val location = LatLng(latitude, longitude)

			// Указываем тип карты, для Google соответственно GoogleMap.MAP_TYPE_NORMAL
			mapType = HuaweiMap.MAP_TYPE_NORMAL

			// Инициализируем позицию для камеры
            val cameraPosition = CameraUpdateFactory.newCameraPosition(
                CameraPosition.fromLatLngZoom(
                    location,
                    15f
                )
            )

			// Перемещаем камеру
            moveCamera(cameraPosition)
            val icon = BitmapDescriptorFactory.fromResource(R.drawable.marker)
            val markerOptions = MarkerOptions()
                .icon(icon)
                .position(location)

			// Добавляем маркер
            addMarker(markerOptions)
            setOnMapClickListener { clickListener.invoke() }
		}
}

У Huawei подробная документация. Поэтому кучу фичей, которых можно делать с картами, можно найти тут: https://developer.huawei.com/consumer/en/doc/development/HMSCore-Guides/android-sdk-marker-0000001061779995.

Applinking

Диплинки в приложениях — очень важный инструмент для маркетинга, и ваш заказчик точно их захочет. В пуше вы можете вставить такой же диплинк, какой используете на Android. Но когда вы напишете диплинк в заметках и нажмете на него, приложение не откроется.

Как исправить эту историю? На помощь приходит AppLinking.

Доверенные форматы URL

1. Сначала нужно добавить «Доверенные форматы URL» в нашей консоли. Фактически это хуавеевский URL, который будет префиксом перед вашим реальным диплинком. Идем в «Мои проекты», затем выбираем проект и в левом меню находим вкладку «Рост». В ней — «Создание ссылок» или AppLinking. Нажимаем и попадаем на вкладку «Префиксы URL».

2. Нажмем на кнопку «Создать префикс URL» и введем какое-нибудь доменное имя типа testapp.

3. Теперь добавим интент-фильтр в манифест нашего приложения, чтобы мы могли обработать такой линк. Делаем такое:

<intent-filter android:autoVerify="true">
       <action android:name="android.intent.action.VIEW"/>
       <category android:name="android.intent.category.DEFAULT"/>
       <category android:name="android.intent.category.BROWSABLE"/>
       <!-- Set android:host to the prefix of your link to be processed. -->
       <data android:host="testapp.drru.agconnect.link" android:scheme="http"/>
       <!-- Set android:host to the prefix of your link to be processed. -->
       <data android:host="testapp.drru.agconnect.link" android:scheme="https"/>
</intent-filter>

Теперь мы на шаг ближе к корректной обработке внешних диплинков.

Белый список URL-адресов

Наш финальный диплинк будет иметь такой вид:

https://testapp.drru.agconnect.link?deeplink=[наш оригинальный диплинк]

Предположим, что [наш оригинальный диплинк], который мы испальзовали в Android, чтобы открыть историю операций, выглядел так: testapp.link://history. Запомним это и пойдем обратно в консоль.

Диплинки, которые мы хотим обрабатывать, нужно добавить в белый список. Снова проходим этот путь:

«Мои проекты» → «Рост» → «Создание ссылок», AppLinking.

Но в этот раз откроем табик «Белый список URL-адресов».

Нажимаем на кнопку «Создать формат URL-адресов белого списка» и в открывшемся окне заполняем с помощью регулярного выражения [наш оригинальный диплинк].

Наш history отлично обработается, если введем такую штуку: “^testapp.link://.*$”. Нажимаем «Опубликовать».

Отлично, мы добавили наши оригинальные диплинки в белый список, осталось только их обработать в коде.

Обработка линков в коде Android-приложения

1. Добавим зависимость в Gradle “implementation 'com.huawei.agconnect:agconnect-applinking:1.8.0.300'”.

2. Теперь туда, где вы обрабатываете обычный Intent (то есть обычный диплинк Android), вставим вот такой обработчик от HMS:

AGConnectAppLinking.getInstance().getAppLinking(this)
.addOnSuccessListener {
      handleDeeplink(it.deepLink.toString())
}.addOnFailureListener {
      Log.e("Deeplink main","FAIL")
}

Тут все достаточно просто. У нас есть обработчик, который может отлавливать успешный линк и также ловить ошибки. Ошибки могут возникать, например, когда вы не добавили свой оригинальный диплинк в список белых URL.

Теперь наше приложение будет открывать диплинки вида https://testapp.drru.agconnect.link?deeplink=[наш оригинальный диплинк] и обрабатывать их из любого другого приложения или сайта.

На этом адаптация под Huawei не заканчивается. Тут я привел базовые советы. Они точно помогут, если вы ни разу не сталкивались с задачами такого типа. Но внутри этой темы есть еще много особенностей и фишек. Это и продуктовая аналитика (HiAnalyticsInstance), и крашлитика, и встроенные покупки, и Huawei Barcode Detector. Но об этом я расскажу в следующей статье.

Если у вас есть какие-то вопросы, задавайте в комментариях — на все отвечу. Еще задавать вопросы можно в нашем телеграм-чате AGIMA Dev. У нас там активное сообщество, и мы всем рады.

P. S. А еще наши друзья из компании AFFINAGE проводят большое исследование по No- и Low-code. Если у вас есть опыт в этой сфере, пройдите опрос. Они даже бота для этого специального сделали.