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.2.0'
...
end
Обновите зависимости c помощью команды pod install
После этого, откройте созданный файл проекта .xcworkspace, там должен отобразиться подключенный пакет с фреймворком
Добавьте модуль через Carthage:
Для подключения добавьте зависимость в Cartfile
binary "https://raw.githubusercontent.com/top-100-writer/top100-tracker-ios/main/TrackerTop100SDK.json" ~> 1.2.0
Обновите зависимости с помощью команды 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 (обязательный) — id проекта, аналогичный js счетчику