Merge pull request #1147 from BranchMetrics/CORE-2088

Sync with 1.39.4 maintenance release

Author: echo-branch

Branch-SDK/BNCPasteboard.h

@@ -0,0 +1,30 @@
+//
+//  BNCPasteboard.h
+//  Branch
+//
+//  Created by Ernest Cho on 6/24/21.
+//  Copyright © 2021 Branch, Inc. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface BNCPasteboard : NSObject
+
+/*
+ Indicates if the client wishes to check for Branch links on install. By default, this is NO.
+ 
+ Set via Branch.checkPasteboardOnInstall
+ Checked by BranchInstallRequest.makeRequest before checking the pasteboard for a Branch link.
+ */
+@property (nonatomic, assign) BOOL checkOnInstall;
+
+- (BOOL)isUrlOnPasteboard;
+- (nullable NSURL *)checkForBranchLink;
+
++ (BNCPasteboard *)sharedInstance;
+
+@end
+
+NS_ASSUME_NONNULL_END

Branch-SDK/BNCPasteboard.m

@@ -0,0 +1,56 @@
+//
+//  BNCPasteboard.m
+//  Branch
+//
+//  Created by Ernest Cho on 6/24/21.
+//  Copyright © 2021 Branch, Inc. All rights reserved.
+//
+
+#import "BNCPasteboard.h"
+#import <UIKit/UIKit.h>
+#import "Branch.h"
+
+@implementation BNCPasteboard
+
++ (BNCPasteboard *)sharedInstance {
+    static BNCPasteboard *pasteboard;
+    static dispatch_once_t onceToken;
+    dispatch_once(&onceToken, ^{
+        pasteboard = [BNCPasteboard new];
+    });
+    return pasteboard;
+}
+
+- (instancetype)init {
+    self = [super init];
+    if (self) {
+        self.checkOnInstall = NO;
+    }
+    return self;
+}
+
+- (BOOL)isUrlOnPasteboard {
+    #if !TARGET_OS_TV
+    if (@available(iOS 10.0, *)) {
+        if ([UIPasteboard.generalPasteboard hasURLs]) {
+            return YES;
+        }
+    }
+    #endif
+    return NO;
+}
+
+- (nullable NSURL *)checkForBranchLink {
+    if ([self isUrlOnPasteboard]) {
+        #if !TARGET_OS_TV
+        // triggers the end user toast message
+        NSURL *tmp = UIPasteboard.generalPasteboard.URL;
+        if ([Branch isBranchLink:tmp.absoluteString]) {
+            return tmp;
+        }
+        #endif
+    }
+    return nil;
+}
+
+@end

Branch-SDK/BNCPreferenceHelper.h

@@ -74,8 +74,6 @@ NSURL* /* _Nonnull */ BNCURLForBranchDirectory(void);
 - (NSString *)getAPIURL:(NSString *)endpoint;
 - (NSString *)getEndpointFromURL:(NSString *)url;
 
-- (id)getBranchUniversalLinkDomains;
-
 - (void)setRequestMetadataKey:(NSString *)key value:(NSObject *)value;
 - (NSMutableDictionary *)requestMetadataDictionary;
 

Branch-SDK/BNCPreferenceHelper.m

@@ -39,7 +39,6 @@
 static NSString * const BRANCH_PREFS_KEY_SESSION_PARAMS = @"bnc_session_params";
 static NSString * const BRANCH_PREFS_KEY_INSTALL_PARAMS = @"bnc_install_params";
 static NSString * const BRANCH_PREFS_KEY_USER_URL = @"bnc_user_url";
-static NSString * const BRANCH_PREFS_KEY_BRANCH_UNIVERSAL_LINK_DOMAINS = @"branch_universal_link_domains";
 
 static NSString * const BRANCH_PREFS_KEY_BRANCH_VIEW_USAGE_CNT = @"bnc_branch_view_usage_cnt_";
 static NSString * const BRANCH_PREFS_KEY_ANALYTICAL_DATA = @"bnc_branch_analytical_data";
@@ -472,7 +471,7 @@ - (NSMutableString*) sanitizedMutableBaseURL:(NSString*)baseUrl_ {
     } else
     if ([baseUrl hasSuffix:@"&"] || [baseUrl hasSuffix:@"?"]) {
     } else
-    if ([baseUrl bnc_containsString:@"?"]) {
+    if ([baseUrl containsString:@"?"]) {
         [baseUrl appendString:@"&"];
     }
     else {
@@ -502,10 +501,6 @@ - (void)setCheckedFacebookAppLinks:(BOOL)checked {
     [self writeBoolToDefaults:BRANCH_PREFS_KEY_CHECKED_FACEBOOK_APP_LINKS value:checked];
 }
 
-- (id)getBranchUniversalLinkDomains {
-    return [[[NSBundle mainBundle] infoDictionary] objectForKey:BRANCH_PREFS_KEY_BRANCH_UNIVERSAL_LINK_DOMAINS];
-}
-
 - (NSMutableDictionary *)requestMetadataDictionary {
     if (!_requestMetadataDictionary) {
         _requestMetadataDictionary = [NSMutableDictionary dictionary];

Branch-SDK/BNCServerInterface.m

@@ -275,17 +275,17 @@ - (BOOL)isLinkingRelatedRequest:(NSString *)endpoint {
     BOOL hasIdentifier = (prefs.linkClickIdentifier.length > 0 ) || (prefs.spotlightIdentifier.length > 0 ) || (prefs.universalLinkUrl.length > 0);
 
     // Allow install to resolve a link.
-    if ([endpoint bnc_containsString:@"/v1/install"] && hasIdentifier) {
+    if ([endpoint containsString:@"/v1/install"] && hasIdentifier) {
         return YES;
     }
 
     // Allow open to resolve a link.
-    if ([endpoint bnc_containsString:@"/v1/open"] && hasIdentifier) {
+    if ([endpoint containsString:@"/v1/open"] && hasIdentifier) {
         return YES;
     }
 
     // Allow short url creation requests
-    if ([endpoint bnc_containsString:@"/v1/url"]) {
+    if ([endpoint containsString:@"/v1/url"]) {
         return YES;
     }
 

Branch-SDK/Branch.h

@@ -654,6 +654,27 @@ typedef NS_ENUM(NSUInteger, BranchCreditHistoryOrder) {
  */
 - (void)ignoreAppleSearchAdsTestData;
 
+/**
+ Checks the pasteboard (clipboard) for a Branch Link on App Install.
+ If found, the Branch Link is used to provide deferred deeplink data.
+ 
+ This should be called before initSession
+ 
+ Note, this may display a toast message to the end user.
+ */
+- (void)checkPasteboardOnInstall;
+
+/**
+ Let's client know if the Branch SDK will trigger a pasteboard toast to the end user.
+ 
+ All of the following conditions must be true.
+ 
+ 1. Developer called checkPastboardOnInstall before initSession
+ 2. A URL is on the pasteboard
+ 3. First time app is run with Branch SDK
+ */
+- (BOOL)willShowPasteboardToast;
+
 /**
  Set the AppGroup used to share data between the App Clip and the Full App.
  
@@ -752,6 +773,15 @@ typedef NS_ENUM(NSUInteger, BranchCreditHistoryOrder) {
  */
 - (void)registerPluginName:(NSString *)name version:(NSString *)version;
 
+/**
+ Checks if a url string is a probable Branch link.
+ 
+ Checks against the Info.plist and the standard Branch list.
+ 
+ @param urlString URL as an NSString
+ */
++ (BOOL)isBranchLink:(NSString *)urlString;
+
 /**
  Key-value pairs to be included in the metadata on every request.
 

Branch-SDK/Branch.m

@@ -42,6 +42,7 @@
 #import "BNCAppGroupsData.h"
 #import "BNCPartnerParameters.h"
 #import "BranchEvent.h"
+#import "BNCPasteboard.h"
 
 #if !TARGET_OS_TV
 #import "BNCUserAgentCollector.h"
@@ -222,6 +223,10 @@ - (id)initWithInterface:(BNCServerInterface *)interface
 
     BranchJsonConfig *config = BranchJsonConfig.instance;
 
+    if (config.checkPasteboardOnInstall) {
+        [self checkPasteboardOnInstall];
+    }
+    
     if (config.delayInitToCheckForSearchAds) {
         [self delayInitToCheckForSearchAds];
     }
@@ -783,26 +788,7 @@ - (BOOL)handleUniversalDeepLink_private:(NSString*)urlString sceneIdentifier:(NS
 
     [self initUserSessionAndCallCallback:YES sceneIdentifier:sceneIdentifier];
 
-    id branchUniversalLinkDomains = [self.preferenceHelper getBranchUniversalLinkDomains];
-    if ([branchUniversalLinkDomains isKindOfClass:[NSString class]] && [urlString bnc_containsString:branchUniversalLinkDomains]) {
-        return YES;
-    } else if ([branchUniversalLinkDomains isKindOfClass:[NSArray class]]) {
-        for (id oneDomain in branchUniversalLinkDomains) {
-            if ([oneDomain isKindOfClass:[NSString class]] && [urlString bnc_containsString:oneDomain]) {
-                return YES;
-            }
-        }
-    }
-
-    NSString *userActivityURL = urlString;
-    NSArray *branchDomains = [NSArray arrayWithObjects:@"bnc.lt", @"app.link", @"test-app.link", nil];
-    for (NSString* domain in branchDomains) {
-        if ([userActivityURL bnc_containsString:domain]) {
-            return YES;
-        }
-    }
-
-    return NO;
+    return [Branch isBranchLink:urlString];
 }
 
 - (BOOL)continueUserActivity:(NSUserActivity *)userActivity {
@@ -812,7 +798,7 @@ - (BOOL)continueUserActivity:(NSUserActivity *)userActivity {
 - (BOOL)continueUserActivity:(NSUserActivity *)userActivity sceneIdentifier:(NSString *)sceneIdentifier {
     BNCLogDebugSDK(@"continueUserActivity:");
 
-    if (@available(iOS 11.0, *)) {
+    if (@available(iOS 11.0, tvOS 11.0, *)) {
         if (userActivity.referrerURL) {
             self.preferenceHelper.initialReferrer = userActivity.referrerURL.absoluteString;
         }
@@ -830,9 +816,9 @@ - (BOOL)continueUserActivity:(NSUserActivity *)userActivity sceneIdentifier:(NSS
     spotlightIdentifier = [self.contentDiscoveryManager spotlightIdentifierFromActivity:userActivity];
     NSURL *webURL = userActivity.webpageURL;
 
-    if ([self isBranchLink:userActivity.userInfo[CSSearchableItemActivityIdentifier]]) {
+    if ([Branch isBranchLink:userActivity.userInfo[CSSearchableItemActivityIdentifier]]) {
         return [self handleDeepLink:[NSURL URLWithString:userActivity.userInfo[CSSearchableItemActivityIdentifier]] sceneIdentifier:sceneIdentifier];
-    } else if (webURL != nil && [self isBranchLink:[webURL absoluteString]]) {
+    } else if (webURL != nil && [Branch isBranchLink:[webURL absoluteString]]) {
         return [self handleDeepLink:webURL sceneIdentifier:sceneIdentifier];
     } else if (spotlightIdentifier) {
         self.preferenceHelper.spotlightIdentifier = spotlightIdentifier;
@@ -849,25 +835,28 @@ - (BOOL)continueUserActivity:(NSUserActivity *)userActivity sceneIdentifier:(NSS
     return spotlightIdentifier != nil;
 }
 
-- (BOOL)isBranchLink:(NSString*)urlString {
-    id branchUniversalLinkDomains = [self.preferenceHelper getBranchUniversalLinkDomains];
-    if ([branchUniversalLinkDomains isKindOfClass:[NSString class]] &&
-        [urlString containsString:branchUniversalLinkDomains]) {
+// checks if URL string looks like a branch link
++ (BOOL)isBranchLink:(NSString *)urlString {
+    id branchUniversalLinkDomains = [[[NSBundle mainBundle] infoDictionary] objectForKey:@"branch_universal_link_domains"];
+    
+    // check url list in bundle
+    if ([branchUniversalLinkDomains isKindOfClass:[NSString class]] && [urlString containsString:branchUniversalLinkDomains]) {
         return YES;
-    }
-    else if ([branchUniversalLinkDomains isKindOfClass:[NSArray class]]) {
+    } else if ([branchUniversalLinkDomains isKindOfClass:[NSArray class]]) {
         for (id oneDomain in branchUniversalLinkDomains) {
             if ([oneDomain isKindOfClass:[NSString class]] && [urlString containsString:oneDomain]) {
                 return YES;
             }
         }
     }
 
+    // check default urls
     NSString *userActivityURL = urlString;
     NSArray *branchDomains = [NSArray arrayWithObjects:@"bnc.lt", @"app.link", @"test-app.link", nil];
     for (NSString* domain in branchDomains) {
-        if ([userActivityURL containsString:domain])
+        if ([userActivityURL containsString:domain]) {
             return YES;
+        }
     }
     return NO;
 }
@@ -939,6 +928,19 @@ - (void)ignoreAppleSearchAdsTestData {
     #endif
 }
 
+- (void)checkPasteboardOnInstall {
+    [BNCPasteboard sharedInstance].checkOnInstall = YES;
+}
+
+- (BOOL)willShowPasteboardToast {
+    if (!self.preferenceHelper.randomizedBundleToken &&
+        [BNCPasteboard sharedInstance].checkOnInstall &&
+        [BNCPasteboard sharedInstance].isUrlOnPasteboard) {
+        return YES;
+    }
+    return NO;
+}
+
 - (void)checkAppleSearchAdsAttribution {
     #if !TARGET_OS_TV
     if (![BNCAppleSearchAds sharedInstance].enableAppleSearchAdsCheck) {

Branch-SDK/BranchConstants.h

@@ -59,6 +59,7 @@ extern NSString * const BRANCH_REQUEST_KEY_CHECKED_APPLE_AD_ATTRIBUTION;
 extern NSString * const BRANCH_REQUEST_KEY_LINK_IDENTIFIER;
 extern NSString * const BRANCH_REQUEST_KEY_SPOTLIGHT_IDENTIFIER;
 extern NSString * const BRANCH_REQUEST_KEY_UNIVERSAL_LINK_URL;
+extern NSString * const BRANCH_REQUEST_KEY_LOCAL_URL;
 extern NSString * const BRANCH_REQUEST_KEY_INITIAL_REFERRER;
 extern NSString * const BRANCH_REQUEST_KEY_BRAND;
 extern NSString * const BRANCH_REQUEST_KEY_MODEL;

Branch-SDK/BranchConstants.m

@@ -55,6 +55,7 @@
 NSString * const BRANCH_REQUEST_KEY_CHECKED_APPLE_AD_ATTRIBUTION = @"apple_ad_attribution_checked";
 NSString * const BRANCH_REQUEST_KEY_SPOTLIGHT_IDENTIFIER = @"spotlight_identifier";
 NSString * const BRANCH_REQUEST_KEY_UNIVERSAL_LINK_URL = @"universal_link_url";
+NSString * const BRANCH_REQUEST_KEY_LOCAL_URL = @"local_url";
 NSString * const BRANCH_REQUEST_KEY_INITIAL_REFERRER = @"initial_referrer";
 NSString * const BRANCH_REQUEST_KEY_BRAND = @"brand";
 NSString * const BRANCH_REQUEST_KEY_MODEL = @"model";

Branch-SDK/BranchInstallRequest.m

@@ -15,6 +15,7 @@
 #import "BNCAppleReceipt.h"
 #import "BNCAppGroupsData.h"
 #import "BNCPartnerParameters.h"
+#import "BNCPasteboard.h"
 
 @implementation BranchInstallRequest
 
@@ -67,6 +68,13 @@ - (void)makeRequest:(BNCServerInterface *)serverInterface key:(NSString *)key ca
                     onDict:params];
     }
 
+    if ([BNCPasteboard sharedInstance].checkOnInstall) {
+        NSURL *pasteboardURL = [[BNCPasteboard sharedInstance] checkForBranchLink];
+        if (pasteboardURL) {
+            [self safeSetValue:pasteboardURL.absoluteString forKey:BRANCH_REQUEST_KEY_LOCAL_URL onDict:params];
+        }
+    }
+    
     NSString *appleAttributionToken = [BNCSystemObserver appleAttributionToken];
     if (appleAttributionToken) {
         preferenceHelper.appleAttributionTokenChecked = YES;