Я — Денис, KMP-разработчик в «Black Bricks». В этой статье я коротко расскажу как реализовал функционал Firebase Dynamic Links своими силами в KMP.

Сразу оговорюсь, что:

не претендую, что это хорошее решение;
предполагаю, что вы знакомы с Dynamic Links.

Firebase Dynamic Links deprecated

Популярный сервис для работы с Dynamic Links от Firebase – deprecated. Теперь его больше невозможно добавить в существующий проект. По этому случаю, Firebase в документации предлагает ряд альтернативных сервисов и нативных решений.

Современные расценки на сервисы отбивают всякое желание их использовать. Я придумал объединить несколько решений в одно.

Доверенный источник ссылок

Начнём с создания «доверенного источника» ссылок. Это может быть ваш сервер, Firebase, Github Pages или любой другой ресурс, обеспечивающий круглосуточный доступ.

Независимо от того, что вы выбрали – для хранения файла, создадим директорию, так чтобы путь до неё выглядел так: /.well-known/assetlinks.json.

Можно воспользоваться App Links Assistant в Android Studio. Она автоматически создаст файл assetlinks.json.

[
  {
    "relation": [
      "delegate_permission/common.handle_all_urls"
    ],
    "target": {
      "namespace": "android_app",
      "package_name": "имя пакета",
      "sha256_cert_fingerprints": [
        "ключ"
      ]
    }
  }
]

Для iOS это — apple-app-site-association. Обратите внимание, что расширение у файла нет. В нём помимо appId, важно указать как вы будете работать с параметрами ссылки.

{
  "applinks": {
    "details": [
      {
        "appIDs": [
          "appID ios",
          "appID macOS",
        ],
        "components": [
          {
            "/": "/параметр_отправки*",
            "comment": ""
          },
          {
            "?": { "первый_параметр": "*", "второй_параметр": "*" },
            "comment": ""
          }
        ]
      }
    ]
  },
  "webcredentials": {
    "apps": [
      "appID ios",
      "appID macOS",
    ]
  }
}

Считывание ссылок в Android Manifest

Указываем имя хоста и параметры, которые хотим передать в ссылке.

<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" />
  <data android:scheme="https" />
  <data android:host="ваш хост" />
  <data android:pathPattern="параметр" />
</intent-filter>

Считывание ссылок в iOS

<key>com.apple.developer.associated-domains</key>
<array>
  <string>applinks:имя хоста</string>
<string>webcredentials:имя хоста</string>
</array>

Редирект

Нужно организовать флоу редиректа в Google Play и AppStore в случае, если приложение не установлено. После таймаута, если переход из ссылки не произошел, то перекидываем пользователя в стор.

app.get('/параметр', (req, res) => {
  const linkToGooglePlay = "";
  const linkToAppStore = "";
  const linkToWindows = "";
  const linkToMacOS = "";
  const userAgent = req.headers['user-agent'] || '';

  setTimeout(() => {
    if (/android/i.test(userAgent)) {
      res.redirect(linkToGooglePlay);
    } else if (/iphone|ipad/i.test(userAgent)) {
      res.redirect(linkToAppStore);
    }
  }, 1000);
});

Реализация на Desktop

Ситуация здесь немного сложнее из-за специфики ОС. У нас есть со-программа, которая слушает сокет. Когда пользователь нажимает на ссылку, программа записывает специальный файл в локальную БД. Если приложение закрыто, со-программа пробуждает его. После файл парсится и параметры извлекаются из ссылки, а сам файл удаляется.

Спасибо за чтение!

Денис Попков

KMP разработчик в «Black Bricks»

Если вы нашли неточности/ошибки в статье или просто хотите дополнить её своим мнением — то прошу в комментарии! Или можете написать мне в Telegram.

Альтернатива Firebase Dynamic Links на KMP