Remote Command: Branch

1. In your Xcode project, select File > Add Packages… > Add Package Dependency.
2. Enter the repository URL: https://github.com/tealium/tealium-ios-branch-remote-command.
3. Configure the version rules. Typically, Up to next major is recommended. If the current TealiumBranch version does not appear in the list, then reset your Swift package cache.
4. Select the TealiumBranch module to install, and select the app target you want the module to be installed in.

If your project has more than one app target and needs TealiumBranch module in more app targets, you have to manually add them in the Frameworks, Libraries, and Embedded Content section.

To install TealiumBranch in additional app targets:

1. Select your Xcode project in the Project Navigator.
2. In your Xcode project, select the app target under the TARGETS section.
3. Navigate to General > Frameworks, Libraries & Embedded Content and select the TealiumBranch module to add it to your app target.

To add additional modules from the Tealium Swift library, follow the Swift Package Manager instructions.

1. Remove tealium-swift and pod "Branch" if they already exist your Podfile. The dependency for tealium-swift is already included in the TealiumBranch framework.

2. Add the following dependency to your Podfile:

   pod "TealiumBranch"
   

   The TealiumBranch pod includes the following TealiumSwift dependencies:

   'tealium-swift/Core'
   'tealium-swift/RemoteCommands'
   'tealium-swift/TagManagement'
   

3. Import the modules TealiumSwift and TealiumBranch in your TealiumHelper file, and any other files that access the Tealium class, or the Branch Remote Command.

1. Remove tealium-swift from your Cartfile. The dependency for tealium-swift is already included in the TealiumBranch framework.

2. Add the following dependency to your Cartfile:

   github "tealium/tealium-ios-branch-remote-command"
   

Tealium for Swift SDK (version 1.6.5+) requires the TealiumDelegate module to be included with your installation.

1. Install Tealium for Android (Kotlin) or Tealium for Android (Java), if you haven’t done so already.

2. Add the Tealium Maven URL to your project’s top-level build.gradle file:

   allprojects {
     repositories {
       mavenCentral()
       maven {
         url "https://maven.tealiumiq.com/android/releases/"
       }
     }
   }
   

3. Import both the Branch SDK and Tealium-Branch remote commands by adding the following dependencies in your app project’s build.gradle file:

   dependencies {
         implementation 'com.tealium.remotecommands:branch:1.0.0'
   }
   

The manual installation for Branch remote commands requires the Tealium for Swift library to be installed. To install the Branch remote commands for your iOS project:

1. Install the Branch SDK, if you haven’t already done so.

2. Clone the Tealium iOS Branch remote command repo and drag the files within the Sources folder into your project.
   GitHub repo: https://github.com/tealium/tealium-ios-branch-remote-command

3. Set the remoteAPIEnabled configuration flag to true.

The manual installation for Branch remote commands requires Tealium for Android (Kotlin) or Tealium for Android (Java) to be installed.

To install the Branch remote commands for your Android project:

1. Add flatDir to your project root build.gradle file:

   allprojects {
         repositories {
           mavenCentral()
           flatDir {
               dirs 'libs'
           }
         }
   }
   

2. Add tealium-branch.aar to <PROJECT_ROOT>/<MODULE>/libs.

3. Add the Tealium library dependency to your build.gradle file:

   dependencies {
         implementation(name:'tealium-branch', ext:'aar')
   }
   

Initialize remote commands with a JSON configuration file or the Remote Command tag for Tealium’s iOS (Swift) library:

var tealium : Tealium?
let config = TealiumConfig(account: "ACCOUNT",
                           profile: "PROFILE",
                           environment: "ENVIRONMENT",
                           dataSource: "DATASOURCE")
config.dispatchers = [Dispatchers.TagManagement, Dispatchers.RemoteCommands]
config.remoteAPIEnabled = true // Required to use Remote Commands

tealium = Tealium(config: config) { _ in
    guard let remoteCommands = self.tealium?.remoteCommands else {
        return
    }

    // Webview Tag
    let branch = BranchRemoteCommand() 

    // Local JSON
    //let branch = BranchRemoteCommand(type: .local(file: "branch")) 

    // Remote JSON
    //let branch = BranchRemoteCommand(type: .remote(url: "https://some.domain.com/branch.json")) 

    remoteCommands.add(branch)
}

Initialize remote commands with a JSON configuration file or the Remote Command tag for Tealium’s Kotlin library:

val config = TealiumConfig(application,
        "ACCOUNT",
        "PROFILE",
        Environment.DEV,
        dispatchers = mutableSetOf(Dispatchers.RemoteCommands, Dispatchers.TagManagement));
val branch = BranchRemoteCommand(application);

var tealium = Tealium.create(TEALIUM_MAIN, config) {

    // Webview Tag
    remoteCommands?.add(branch); 

    // Local JSON
    //remoteCommands?.add(branch, filename = "branch.json"); 

    // Remote JSON
    //remoteCommands?.add(branch, remoteUrl = "https://some.domain.com/branch.json"); 
}

Initialize remote commands with the Remote Command tag for Tealium’s Android (Java) library:

RemoteCommand branch = new BranchRemoteCommand(application);
teal.addRemoteCommand(branch);