added delayed initialization methods

Author: bklastaitis-branch

Branch-SDK/Branch-SDK/Branch.h

@@ -514,6 +514,35 @@ typedef NS_ENUM(NSUInteger, BranchCreditHistoryOrder) {
 /// @name Push Notification Support
 ///--------------------------------
 
+#pragma mark - Delayed Initialization
+
+/**
+ When certain actions are required to complete prior to Branch initialization, call this method passing in dispatch_block_t,
+ initBlock, which contains the desired initialization of Branch (i.e. any of the initSessionWithLaunchOptions functions) and an int,
+ waitTime, which inidicates the number of seconds Branch should wait for the user to call invokeDelayedInitialization, after this
+ time, the initialization block will be invoked automatically.
+
+ @param initBlock         dispatch_block_t object that contains one of the initSessionWithLaunchOptions functions.
+ @param waitTime           An int inidicating the number of seconds Branch should wait for the user to call
+                     invokeDelayedInitialization before invoke the initBlock itself.
+ @warning            To avoid memory leaks take care to ensure that initBlock object does not capture any resources
+                     that require execution of the block body in order to be released, such as memory allocated with malloc(3)
+                     on which the block body calls free(3).
+ */
+- (void)dispatchInit:(dispatch_block_t)initBlock After:(int)waitTime;
+
+/**
+ Call this method if delayed initilization is no longer desired.
+ 
+ @warning       Does not affect an initialization that is already in progress.
+ */
+- (void)cancelDelayedInitialization;
+
+/**
+ Used together with dispatchInitAfter, call this method after prerequisite tasks for Branch initialization have completed.
+ */
+- (void)invokeDelayedInitialization;
+
 #pragma mark - Push Notification support
 
 /**

Branch-SDK/Branch-SDK/Branch.m

@@ -119,7 +119,9 @@ @interface Branch() <BranchDeepLinkingControllerCompletionDelegate> {
 }
 
 // This isolation queue protects branch initialization and ensures things are processed in order.
-@property (nonatomic, strong, readwrite) dispatch_queue_t isolationQueue;
+@property (nonatomic, strong) dispatch_queue_t isolationQueue;
+// Delayed initialization block to be used when other tasks are required to complete before initializing
+@property (nonatomic, strong) dispatch_block_t delayedInitBlock;
 
 @property (strong, nonatomic) BNCServerInterface *serverInterface;
 @property (strong, nonatomic) BNCServerRequestQueue *requestQueue;
@@ -917,6 +919,27 @@ - (void)checkAppleSearchAdsAttribution {
     });
 }
 
+#pragma mark - Delayed initialization
+
+- (void) dispatchInit:(dispatch_block_t) initBlock After:(int)waitTime {
+    self.delayedInitBlock = initBlock;
+    dispatch_time_t time = dispatch_time(DISPATCH_TIME_NOW, (int64_t)(waitTime * NSEC_PER_SEC));
+    dispatch_after(time, dispatch_get_main_queue(), self.delayedInitBlock);
+}
+
+- (void)cancelDelayedInitialization {
+    // does not affect execution of the block object that is already in progress,
+    // but it does prevent future invocation of the same block
+    dispatch_block_cancel(self.delayedInitBlock);
+    NSLog(@"BranchSDK: cancelDelayedInitialization %@", @"success");
+}
+
+- (void)invokeDelayedInitialization {
+    self.delayedInitBlock();
+    [self cancelDelayedInitialization];
+    NSLog(@"BranchSDK: invokeDelayedInitialization %@", @"success");
+}
+
 #pragma mark - Facebook App Link Check
 
 - (void)registerFacebookDeepLinkingClass:(id)FBSDKAppLinkUtility {
@@ -1775,12 +1798,12 @@ - (void)registerViewWithParams:(NSDictionary *)params andCallback:(callbackWithP
 #pragma mark - Application State Change methods
 
 - (void)applicationDidBecomeActive {
-    if (!Branch.trackingDisabled) {
-        if ((self.initializationStatus != BNCInitStatusInitialized) &&
-            ![self.requestQueue containsInstallOrOpen]) {
-            [self initUserSessionAndCallCallback:YES];
-        }
-    }
+//    if (!Branch.trackingDisabled) {
+//        if ((self.initializationStatus != BNCInitStatusInitialized) &&
+//            ![self.requestQueue containsInstallOrOpen]) {
+//            [self initUserSessionAndCallCallback:YES];
+//        }
+//    }
 }
 
 - (void)applicationWillResignActive {

Branch-TestBed/Branch-TestBed/AppDelegate.m

@@ -45,11 +45,21 @@ - (BOOL)application:(UIApplication *)application
      */
 
     // [branch setIdentity:@"Bobby Branch"];
-    [branch initSessionWithLaunchOptions:launchOptions
-        andRegisterDeepLinkHandlerUsingBranchUniversalObject:
-        ^ (BranchUniversalObject * _Nullable universalObject, BranchLinkProperties * _Nullable linkProperties, NSError * _Nullable error) {
-            [self handleDeepLinkObject:universalObject linkProperties:linkProperties error:error];
-    }];
+    dispatch_block_t initBlock = dispatch_block_create(DISPATCH_BLOCK_ASSIGN_CURRENT, ^{
+        [branch initSessionWithLaunchOptions:launchOptions
+            andRegisterDeepLinkHandlerUsingBranchUniversalObject:
+            ^ (BranchUniversalObject * _Nullable universalObject, BranchLinkProperties * _Nullable linkProperties, NSError * _Nullable error) {
+                [self handleDeepLinkObject:universalObject linkProperties:linkProperties error:error];
+        }];
+        NSLog(@"BranchSDK: initBlock has been invoked %@", @"success");
+    });
+    [branch dispatchInit:initBlock After:5];
+
+    // pretend that something prerequisite task completed in 2 seconds
+    dispatch_time_t twoSecFromNow = dispatch_time(DISPATCH_TIME_NOW, (int64_t)(2 * NSEC_PER_SEC));
+    dispatch_after(twoSecFromNow, dispatch_get_main_queue(), ^{
+        [branch invokeDelayedInitialization];
+    });
 
     // Push notification support (Optional)
     [self registerForPushNotifications:application];