Updated header doc and README for openURL:options: use. (#889)

Author: E-B-Smith

Branch-SDK/Branch-SDK/Branch.h

@@ -462,7 +462,11 @@ typedef NS_ENUM(NSUInteger, BranchCreditHistoryOrder) {
 
 /**
  Call this method from inside your app delegate's `application:openURL:sourceApplication:annotation:`
- method with the so that Branch can open the passed URL.
+ method so that Branch can open the passed URL. This method is for pre-iOS 9 compatibility: If you don't need
+ pre-iOS 9 compatibility, override your app delegate's `application:openURL:options:` method instead and use
+ the Branch `application:openURL:options:` to open the URL.
+
+ @warning Pre-iOS 9 compatibility only.
 
  @param application         The application that was passed to your app delegate.
  @param url                 The URL that was passed to your app delegate.
@@ -476,12 +480,10 @@ typedef NS_ENUM(NSUInteger, BranchCreditHistoryOrder) {
          annotation:(id)annotation;
 
 /**
- Call this method from inside your app delegate's `application:openURL:options:`
- method with the so that Branch can open the passed URL.
+ Call this method from inside your app delegate's `application:openURL:options:` method so that Branch can
+ open the passed URL.
 
- This method is functionally the same as calling the Branch method
- `application:openURL:sourceApplication:annotation:`. This method matches the new Apple appDelegate
- method for convenience.
+ This is the preferred Branch method to call inside your `application:openURL:options:` method.
 
  @param application         The application that was passed to your app delegate.
  @param url                 The URL that was passed to your app delegate.

README.md

@@ -277,15 +277,14 @@ To deep link, Branch must initialize a session to check if the user originated f
     return YES;
 }
 
-- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {
-
+- (BOOL)application:(UIApplication *)application
+            openURL:(NSURL *)url
+            options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
     BOOL branchHandled =
         [[Branch getInstance]
             application:application
                 openURL:url
-      sourceApplication:sourceApplication
-             annotation:annotation];
-
+                options:options];
     if (!branchHandled) {
         // do other deep link routing for the Facebook SDK, Pinterest SDK, etc
     }
@@ -316,13 +315,12 @@ func application(_ application: UIApplication, didFinishLaunchingWithOptions lau
   return true
 }
 
-func application(_ application: UIApplication, open url: URL, sourceApplication: String?, annotation: Any) -> Bool {
-
+func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
     // Pass the url to the handle deep link call
-    let branchHandled = Branch.getInstance().application(application,
+    let branchHandled = Branch.getInstance().application(
+        application,
         open: url,
-        sourceApplication: sourceApplication,
-        annotation: annotation
+        options: options
     )
     if (!branchHandled) {
         // If not handled by Branch, do other deep link routing for the