IOS SDK [Beta]

Подключение SDK
Swift Package Manager
CocoaPods
Carthage
Прямое подключение
Добавьте модуль через Swift Package Manager:
Для этого в Xcode выберите свой проект и перейдите на вкладку Package Dependencies.
Нажмите на "+" для добавления нового пакета и укажите URL репозитория: https://github.com/top-100-writer/top100-tracker-ios в нем находится Package.swift.
Выберете версию пакета и настройте правило обновления. Добавьте пакет в свой проект.
После добавления, пакет должен появиться в Package Dependencies, а также в левой панели.
Добавьте модуль через CocoaPods:
Добавьте пакет TrackerTop100SDK в Podfile в своем проекте
platform :ios, '11.0'
​
target 'MyApp' do
  use_frameworks!
  pod 'TrackerTop100SDK', '1.5.1'
  ...
end
Обновите зависимости c помощью команды pod install
После этого, откройте созданный файл проекта .xcworkspace, там должен отобразиться подключенный пакет с фреймворком
Добавьте модуль через Carthage:
Для подключения добавьте зависимость в Cartfile
binary "https://raw.githubusercontent.com/top-100-writer/top100-tracker-ios/main/TrackerTop100SDK.json" ~> 1.5.1
Обновите зависимости с помощью команды carthage update --use-xcframeworks
Откройте вкладку General settings вашего приложения и найдите раздел Frameworks, Libraries, and Embedded Content 
Выберете пакет TrackerTop100SDK.xcframework из папки Carthage/Build на диске или просто перетяните его.
После сборки проекта пакет в виде фреймворка должен отобразиться левой панели.
Если вы не используете системы управления зависимостями, то можете подключить фреймворк с пакетом напрямую в свое приложение.
Для подключения напрямую:
​Загрузите архив с пакетом​
Откройте вкладку General settings вашего приложения и найдите раздел Frameworks, Libraries, and Embedded Content 
Выберете пакет TrackerTop100SDK.xcframework из папки Carthage/Build на диске или просто перетяните его
После сборки проекта пакет в виде фреймворка должен отобразиться левой панели.
Базовая инициализация
Swift
Objective-C
Инициализируйте библиотеку в методе application(_:didFinishLaunchingWithOptions:) вашего AppDelegate:
//  AppDelegate.swift
import TrackerTop100SDK
​
@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        let settings = TrackerTop100Settings(projectId: "PROJECT_ID")!
            // ... установка параметров sdk
            .build()
        TrackerTop100.activate(settings: settings)
    }
}
Инициализируйте библиотеку в методе - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions вашего AppDelegate :
// AppDelegate.m
@import TrackerTop100SDK;
​
@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    TrackerTop100Settings *settings = [[TrackerTop100Settings alloc] initWithProjectId: @"PROJECT_ID"];
    // ... установка параметров sdk
    [TrackerTop100 activateWithSettings: [settings build]];
}
PROJECT_ID (обязательный) — идентификатор проекта (строка с цифрами), аналогичный JS-счётчику. В случае некорректного значения, TrackerTop100Settings не будет создан.
Методы по работе с sdk
Параметры SDK
Last modified 2mo ago