Как установить трекинговый SDK Статистики от SberAds в мобильное приложение

Android

SDK поставляется библиотекой в формате AAR, искать её предлагают в Maven-репозитории по запросу top100-sdk.

1. Добавить в `build.gradle` зависимость: в Kotlin DSL `implementation ("io.github.top-100-writer:tracker-top100-sdk:1.2.0")`, в Groovy `implementation 'io.github.top-100-writer:tracker-top100-sdk:1.2.0'`. 2. Объявить производный от Application класс и переопределить в нём `onCreate()`. В примере на Kotlin базовый класс — `MultiDexApplication`, в примере на Java — `Application`. 3. В `onCreate()` вызвать `Kraken.activate`, передав приложение и список настроек `KrakenSettings`. Настройки собирают через `KrakenSettings.Builder` с `PROJECT_ID` и вызовом `build()`.

Место для параметров SDK в примере обозначено комментарием «установка параметров sdk»; какие параметры бывают, на этих страницах не описано. Примеры даны на Kotlin и на Java.

iOS: Swift Package Manager

1. В Xcode выбрать проект и открыть вкладку Package Dependencies. 2. Нажать «+» и указать URL репозитория `https://github.com/top-100-writer/top100-tracker-ios` (в нём лежит Package.swift). 3. Выбрать версию пакета, настроить правило обновления, добавить пакет в проект. 4. Проверить, что пакет появился в Package Dependencies и в левой панели.

iOS: CocoaPods

1. Добавить пакет в Podfile проекта: `platform :ios, '15.0'`, внутри target с `use_frameworks!` строка `pod 'TrackerTop100SDK', '1.12.0'`. 2. Обновить зависимости командой `pod install`. 3. Открыть созданный файл проекта `.xcworkspace`: подключённый пакет с фреймворком должен отобразиться там.

iOS: Carthage

1. Добавить в Cartfile строку `binary "https://raw.githubusercontent.com/top-100-writer/top100-tracker-ios/main/TrackerTop100SDK.json" ~> 1.5.1`. 2. Выполнить `carthage update --use-xcframeworks`. 3. В General settings приложения найти раздел Frameworks, Libraries, and Embedded Content. 4. Выбрать `TrackerTop100SDK.xcframework` из папки Carthage/Build или перетащить его в раздел. 5. После сборки проекта фреймворк должен отобразиться в левой панели.

iOS: прямое подключение

Способ для проектов без менеджера зависимостей.

1. Скачать архив с пакетом (в справке ссылка на релиз 1.5.1, файл `TrackerTop100SDK.xcframework.zip`). 2. В General settings приложения найти раздел Frameworks, Libraries, and Embedded Content. 3. Выбрать `TrackerTop100SDK.xcframework` или перетащить его в раздел. 4. После сборки проекта фреймворк должен отобразиться в левой панели.

React Native

1. Установить пакет: `npm install react-native-tracker-top-100` или `yarn add react-native-tracker-top-100`. 2. iOS, шаг 1: выполнить `cd ios && bundle install && bundle exec pod install`. 3. iOS, шаг 2: добавить XCFramework. Открыть файл `*.xcodeproj` приложения, в разделе Targets выбрать нужную цель, в разделе Frameworks, Libraries, and Embedded Content нажать «+» (Add Items), выбрать `TrackerTop100SDK.xcframework` в разделе Workspace — Pods и нажать Add Items. 4. Android: отдельных действий нет, библиотека подключается автолинком.