Initialiser le SDK iOS
Avant de commencer
Ce guide suppose que vous êtes familiarisé avec CocoaPod ou Swift Package Manager et que vous savez comment installer les dépendances pour le développement iOS. Pour plus d'informations, consultez les guides d'utilisation de CocoaPod ou de Swift Package Manager.
Guide CocoaPods
Mettez en place un espace de travail en utilisant ce tutoriel CocoaPods.
- Ajoutez le pod
Rokt-Widget
au fichier pod :
pod 'Rokt-Widget'
- Installez le pod :
pod install
Si vous recevez l'erreur DT_TOOLCHAIN_DIR cannot be used to evaluate LIBRARY_SEARCH_PATHS use TOOLCHAIN_DIR instead
, ajoutez le hook post-installation suivant à votre Podfile
post_install do |installer|
installer.pods_project.targets.each do |target|
target.build_configurations.each do |config|
xcconfig_path = config.base_configuration_reference.real_path
xcconfig = File.read(xcconfig_path)
xcconfig_mod = xcconfig.gsub(/DT_TOOLCHAIN_DIR/, "TOOLCHAIN_DIR")
File.open(xcconfig_path, "w") { |file| file << xcconfig_mod }
end
end
end
Guide du gestionnaire de paquets Swift
Dans Xcode :
- Allez dans Fichier > Paquets Swift > Ajouter une dépendance de paquet
- Ajoutez
https://github.com/ROKT/rokt-sdk-ios.git
- Sélectionnez Up to Next Major avec 3.15.7
ou ajoutez le code ci-dessous à la partie dependencies
de Package.swift
.
dependencies: [
.package(url: "https://github.com/ROKT/rokt-sdk-ios.git", .upToNextMajor(from: "3.15.7"))
]
Note sur l'intégration Objective-C : Le SDK Rokt pour iOS est implémenté en Swift. Si vous utilisez Objective-C, vous devez importer le fichier d'en-tête de liaison du framework dans le fichier
.h/.m
.
#import <Rokt_Widget/Rokt_Widget-Swift.h>
Si vous rencontrez des problèmes lors de l'installation et que vous recevez une erreur indiquant que SWIFT_VERSION n'est pas défini, veuillez ajouter une variable définie par l'utilisateur SWIFT_VERSION
. Cette variable doit être définie sur "5" pour les versions du SDK iOS 2.0 et supérieures. Cette variable doit être définie sur "4.2" pour la version du SDK iOS 1.2.1.
Initialiser le SDK Rokt pour iOS
Initialisez le SDK Rokt pour iOS avant de l'utiliser dans n'importe quel ViewController
. Nous recommandons d'appeler la méthode init
depuis le gestionnaire applicationDidFinishLaunching
.
Contactez Rokt pour obtenir l'identifiant de compte Rokt associé à votre compte. Pour tester votre intégration, vous pouvez utiliser l'identifiant de compte Rokt ci-dessous, mais cela doit être remplacé par votre identifiant de compte Rokt unique avant de le lancer en production.
Initialiser le SDK
Le SDK Rokt pour les applications iOS peut être utilisé par les partenaires de Rokt pour afficher des superpositions ou des emplacements intégrés, ou par les annonceurs de Rokt pour enregistrer des conversions pour des campagnes. Le SDK Rokt pour iOS est déployé à l'aide de CocoaPod.
Tous les cas d'utilisation du SDK suivront les mêmes étapes initiales pour intégrer et initialiser le SDK dans votre application. En gros, ces étapes sont les suivantes :
- Configurer un espace de travail en utilisant CocoaPod/Swift Package Manager
- Ajouter le
Rokt-Widget
- Installer le pod/package
- Initialiser le SDK Rokt
En suivant ces étapes, la méthode execute
du SDK peut ensuite être utilisée de différentes manières pour répondre au cas d'utilisation requis.
Identifiant de compte Rokt de test : 222
- Swift
- Objective-C
//fichier => AppDelegate.swift
import Rokt_Widget
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
// Ce qui suit révélera une intégration de démonstration. Pour afficher votre intégration, remplacez l'identifiant de balise de test d'intégration (222) par votre identifiant de balise Rokt unique
Rokt.initWith(roktTagId: "222")
return true
}
//fichier => AppDelegate.m
#import <Rokt_Widget/Rokt_Widget-Swift.h>
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Point de substitution pour la personnalisation après le lancement de l'application.
[Rokt initWithRoktTagId:@"222"];
return YES;
}
Étapes suivantes
Vos prochaines étapes dépendent du cas d'utilisation de votre intégration. Consultez ces ressources pour plus d'informations :