Документация SDK DK Builder

SDK DK Builder

Локальная сборка Android с нативным клиентом DK Push.

SDK DK Builder · Android

Используйте локальный SDK DK Builder для Windows, чтобы собрать готовую HTML5-игру. Push по умолчанию выключен и настраивается отдельно для приложения и магазина.

Открыть инструкцию SDK DK Builder →

1. Зарегистрируйте приложение

Создайте проект ANDROID, укажите имя пакета Android из Builder и создайте клиентский ключ только с правами devices:write и events:write.

2. Настройте Firebase

В Firebase Console откройте Project settings → Service accounts → Generate new private key. Скачайте service-account JSON того же Firebase project, в котором зарегистрировано Android-приложение.

В «Настройках проекта» DK Push найдите Firebase и нажмите «Добавить учётные данные FCM» (или «Подключить Firebase», если настройки ещё нет). Вставьте полный объект в «JSON сервисного аккаунта», укажите «Название» и нажмите «Добавить учётные данные». Проверьте статус «Подключён» и нажмите «Проверить подключение». Для проверки отправки нужен тестовый push.

google-services.json настраивает Android-приложение. Service account JSON позволяет серверу DK Push отправлять FCM-уведомления. Это разные файлы. Не добавляйте приватный ключ сервисного аккаунта в Construct или APK.

3. Настройте локальную сборку

В Builder включите DK Push, укажите HTTPS-адрес API, Project ID и клиентский ключ, выберите google-services.json для точного имени пакета. Включайте только магазины и устройства с сервисами Google Play. Серверный ключ сервисного аккаунта остаётся в DK Push.

4. Регистрация устройства и разрешение

Нативный клиент создаёт личный секрет установки, регистрирует и обновляет FCM-токен, создаёт канал уведомлений и по действию пользователя запрашивает разрешение Android 13+. Установка может отключить push и удалить свои токены.

5. Проверьте доставку на устройстве

После отдельно разрешённой Android-сборки установите приложение на совместимое устройство, разрешите уведомления, выберите устройство в DK Push и отправьте один тестовый push. Проверьте получение в фоне, нажатие при закрытом приложении и нужный экран. Принятие провайдером не подтверждает показ. Для Huawei без Google Play нужен отдельный нативный адаптер доставки.

Существующие Android-интеграции

Для подключения к восстановленной чистой базе существующие экспорты должны использовать обновлённый нативный SDK и проверку секрета установки. В старых архивах этих изменений нет. Протокол браузерного Web Push сохранён.

Android Studio: Kotlin/Java и WebView →