@ohos-ports/react-native-firebase-dynamic-links 0.0.0-stage → 22.4.0-beta.0

package/ios/RNFBDynamicLinks/RNFBDynamicLinksAppDelegateInterceptor.m

@@ -0,0 +1,132 @@
+/**
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+#import "RNFBDynamicLinksAppDelegateInterceptor.h"
+#import <GoogleUtilities/GULAppDelegateSwizzler.h>
+#import <RNFBApp/RNFBRCTEventEmitter.h>
+
+@implementation RNFBDynamicLinksAppDelegateInterceptor
+
++ (instancetype)sharedInstance {
+  static dispatch_once_t once;
+  static RNFBDynamicLinksAppDelegateInterceptor *sharedInstance;
+  dispatch_once(&once, ^{
+    sharedInstance = [[RNFBDynamicLinksAppDelegateInterceptor alloc] init];
+    sharedInstance.initialLinkUrl = nil;
+    sharedInstance.initialLinkMinimumAppVersion = nil;
+    sharedInstance.initialLinkUtmParametersDictionary = @{};
+    [GULAppDelegateSwizzler proxyOriginalDelegate];
+    [GULAppDelegateSwizzler registerAppDelegateInterceptor:sharedInstance];
+  });
+  return sharedInstance;
+}
+
+- (BOOL)application:(UIApplication *)app
+            openURL:(NSURL *)url
+            options:(NSDictionary<NSString *, id> *)options {
+  FIRDynamicLink *dynamicLink = [[FIRDynamicLinks dynamicLinks] dynamicLinkFromCustomSchemeURL:url];
+
+  if (!dynamicLink) {
+    dynamicLink = [[FIRDynamicLinks dynamicLinks] dynamicLinkFromUniversalLinkURL:url];
+  }
+
+  if (!dynamicLink) {
+    return NO;
+  }
+
+  if (dynamicLink.url) {
+    if (_initialLinkUrl == nil) {
+      _initialLinkUrl = dynamicLink.url.absoluteString;
+      _initialLinkMinimumAppVersion = dynamicLink.minimumAppVersion;
+      _initialLinkUtmParametersDictionary = dynamicLink.utmParametersDictionary;
+    }
+    [[RNFBRCTEventEmitter shared]
+        sendEventWithName:LINK_RECEIVED_EVENT
+                     body:@{
+                       @"url" : dynamicLink.url.absoluteString,
+                       @"minimumAppVersion" : dynamicLink.minimumAppVersion == nil
+                           ? [NSNull null]
+                           : dynamicLink.minimumAppVersion,
+                       @"utmParameters" : dynamicLink.utmParametersDictionary == nil
+                           ? @{}
+                           : dynamicLink.utmParametersDictionary,
+                     }];
+  }
+
+  // results of this are ORed and NO doesn't affect other delegate interceptors' result
+  return NO;
+}
+
+#pragma mark - User Activities overridden handler methods
+
+- (BOOL)application:(UIApplication *)application
+    continueUserActivity:(NSUserActivity *)userActivity
+      restorationHandler:
+          (void (^_Nonnull __strong)(NSArray<id<UIUserActivityRestoring>>
+                                         *_Nullable __strong restorableObjects))restorationHandler {
+  __block BOOL retried = NO;
+
+  id completion = ^(FIRDynamicLink *_Nullable dynamicLink, NSError *_Nullable error) {
+    if (!error && dynamicLink && dynamicLink.url) {
+      if (self->_initialLinkUrl == nil) {
+        self->_initialLinkUrl = dynamicLink.url.absoluteString;
+        self->_initialLinkMinimumAppVersion = dynamicLink.minimumAppVersion;
+        self->_initialLinkUtmParametersDictionary = dynamicLink.utmParametersDictionary;
+      }
+      [[RNFBRCTEventEmitter shared]
+          sendEventWithName:LINK_RECEIVED_EVENT
+                       body:@{
+                         @"url" : dynamicLink.url.absoluteString,
+                         @"minimumAppVersion" : dynamicLink.minimumAppVersion == nil
+                             ? [NSNull null]
+                             : dynamicLink.minimumAppVersion,
+                         @"utmParameters" : dynamicLink.utmParametersDictionary == nil
+                             ? @{}
+                             : dynamicLink.utmParametersDictionary,
+                       }];
+    };
+
+    // Per Apple Tech Support, a network failure could occur when returning from background on
+    // iOS 12. https://github.com/AFNetworking/AFNetworking/issues/4279#issuecomment-447108981 So
+    // we'll retry the request once
+    if (error && !retried && [NSPOSIXErrorDomain isEqualToString:error.domain] &&
+        error.code == 53) {
+      retried = YES;
+      [[FIRDynamicLinks dynamicLinks] handleUniversalLink:userActivity.webpageURL
+                                               completion:completion];
+    }
+
+    // TODO: We could send this to JS and maybe have a onDynamicLinkError listener but there's also
+    // a good chance the
+    // TODO: `userActivity.webpageURL` might not be for a Firebase dynamic link, which needs
+    // consideration - so we'll
+    // TODO: log this for now, logging will get picked up by Crashlytics automatically if its
+    // integrated.
+    if (error)
+      NSLog(@"RNFBDynamicLinks: Unknown error occurred when attempting to handle a universal link: "
+            @"%@",
+            error);
+  };
+
+  [[FIRDynamicLinks dynamicLinks] handleUniversalLink:userActivity.webpageURL
+                                           completion:completion];
+
+  // results of this are ORed and NO doesn't affect other delegate interceptors' result
+  return NO;
+}
+
+@end

package/ios/RNFBDynamicLinks/RNFBDynamicLinksModule.h

@@ -0,0 +1,28 @@
+/**
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+#import <Firebase/Firebase.h>
+#import <Foundation/Foundation.h>
+#import <RNFBApp/RNFBSharedUtils.h>
+#import <React/RCTBridgeModule.h>
+#import <React/RCTEventEmitter.h>
+#import <React/RCTUtils.h>
+
+// can't access self.bridge.launchOptions without RCTEventEmitter
+@interface RNFBDynamicLinksModule : RCTEventEmitter <RCTBridgeModule>
+
+@end

package/ios/RNFBDynamicLinks/RNFBDynamicLinksModule.m

@@ -0,0 +1,443 @@
+/**
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+#import "RNFBDynamicLinksModule.h"
+#import "RNFBDynamicLinksAppDelegateInterceptor.h"
+
+@implementation RNFBDynamicLinksModule
+#pragma mark -
+#pragma mark Module Setup
+
+RCT_EXPORT_MODULE();
+
+@synthesize bridge = _bridge;
+
+#pragma mark -
+#pragma mark Firebase Links Methods
+
+// required to init app delegate interceptor as early as possible
++ (BOOL)requiresMainQueueSetup {
+  return YES;
+}
+
+- (id)init {
+  self = [super init];
+  static dispatch_once_t onceToken;
+  dispatch_once(&onceToken, ^{
+    // access shared instance to initialize app delegate interceptor
+    [RNFBDynamicLinksAppDelegateInterceptor sharedInstance];
+  });
+  return self;
+}
+
+RCT_EXPORT_METHOD(buildLink
+                  : (NSDictionary *)dynamicLinkDict
+                  : (RCTPromiseResolveBlock)resolve
+                  : (RCTPromiseRejectBlock)reject) {
+  FIRDynamicLinkComponents *linkComponents;
+
+  @try {
+    linkComponents = [self createDynamicLinkComponents:dynamicLinkDict];
+  } @catch (NSException *exception) {
+    DLog(@"Building dynamic link failed %@", exception);
+    [RNFBSharedUtils rejectPromiseWithUserInfo:reject
+                                      userInfo:(NSMutableDictionary *)@{
+                                        @"code" : @"build-failed",
+                                        @"message" : [exception description],
+                                      }];
+    return;
+  }
+
+  if (!linkComponents || !linkComponents.url) {
+    [RNFBSharedUtils
+        rejectPromiseWithUserInfo:reject
+                         userInfo:(NSMutableDictionary *)@{
+                           @"code" : @"build-failed",
+                           @"message" : @"Failed to build dynamic link for unknown reason",
+                         }];
+    return;
+  }
+
+  resolve(linkComponents.url.absoluteString);
+}
+
+RCT_EXPORT_METHOD(buildShortLink
+                  : (NSDictionary *)dynamicLinkDict
+                  : (NSString *)shortLinkType
+                  : (RCTPromiseResolveBlock)resolve
+                  : (RCTPromiseRejectBlock)reject) {
+  FIRDynamicLinkComponents *linkComponents;
+
+  @try {
+    linkComponents = [self createDynamicLinkComponents:dynamicLinkDict];
+  } @catch (NSException *exception) {
+    DLog(@"Building short dynamic link failed %@", exception);
+    [RNFBSharedUtils rejectPromiseWithUserInfo:reject
+                                      userInfo:(NSMutableDictionary *)@{
+                                        @"code" : @"build-failed",
+                                        @"message" : [exception description],
+                                      }];
+    return;
+  }
+
+  FIRDynamicLinkComponentsOptions *componentsOptions = [FIRDynamicLinkComponentsOptions options];
+
+  if ([shortLinkType isEqual:@"SHORT"]) {
+    componentsOptions.pathLength = FIRShortDynamicLinkPathLengthShort;
+  } else if ([shortLinkType isEqual:@"UNGUESSABLE"]) {
+    componentsOptions.pathLength = FIRShortDynamicLinkPathLengthUnguessable;
+  } else {
+    componentsOptions.pathLength = FIRShortDynamicLinkPathLengthDefault;
+  }
+  linkComponents.options = componentsOptions;
+
+  [linkComponents shortenWithCompletion:^(NSURL *_Nullable shortURL, NSArray *_Nullable warnings,
+                                          NSError *_Nullable error) {
+    if (error) {
+      DLog(@"Building short dynamic link failed %@", error);
+      [RNFBSharedUtils rejectPromiseWithUserInfo:reject
+                                        userInfo:(NSMutableDictionary *)@{
+                                          @"code" : @"build-failed",
+                                          @"message" : [error localizedDescription],
+                                        }];
+    } else {
+      resolve(shortURL.absoluteString);
+    }
+  }];
+}
+
+// TODO refactor to reduce duplication
+RCT_EXPORT_METHOD(getInitialLink
+                  : (RCTPromiseResolveBlock)resolve
+                  : (RCTPromiseRejectBlock)reject) {
+  NSDictionary *launchOptions = self.bridge.launchOptions;
+
+  if (launchOptions[UIApplicationLaunchOptionsURLKey]) {
+    NSURL *url = (NSURL *)launchOptions[UIApplicationLaunchOptionsURLKey];
+    FIRDynamicLink *dynamicLink =
+        [[FIRDynamicLinks dynamicLinks] dynamicLinkFromCustomSchemeURL:url];
+
+    if (dynamicLink && dynamicLink.url) {
+      resolve(@{
+        @"url" : dynamicLink.url.absoluteString,
+        @"minimumAppVersion" : dynamicLink.minimumAppVersion == nil ? [NSNull null]
+                                                                    : dynamicLink.minimumAppVersion,
+        @"utmParameters" : dynamicLink.utmParametersDictionary == nil
+            ? @{}
+            : dynamicLink.utmParametersDictionary,
+      });
+    } else if ([RNFBDynamicLinksAppDelegateInterceptor sharedInstance].initialLinkUrl != nil) {
+      resolve(@{
+        @"url" : [RNFBDynamicLinksAppDelegateInterceptor sharedInstance].initialLinkUrl,
+        @"minimumAppVersion" : [RNFBDynamicLinksAppDelegateInterceptor sharedInstance]
+                    .initialLinkMinimumAppVersion == nil
+            ? [NSNull null]
+            : [RNFBDynamicLinksAppDelegateInterceptor sharedInstance].initialLinkMinimumAppVersion,
+        @"utmParameters" : [RNFBDynamicLinksAppDelegateInterceptor sharedInstance]
+                    .initialLinkUtmParametersDictionary == nil
+            ? @{}
+            : [RNFBDynamicLinksAppDelegateInterceptor sharedInstance]
+                  .initialLinkUtmParametersDictionary,
+      });
+    } else {
+      resolve([NSNull null]);
+    }
+
+    return;
+  }
+
+  NSDictionary *userActivityDict =
+      launchOptions[UIApplicationLaunchOptionsUserActivityDictionaryKey];
+  if (userActivityDict && [userActivityDict[UIApplicationLaunchOptionsUserActivityTypeKey]
+                              isEqualToString:NSUserActivityTypeBrowsingWeb]) {
+    NSUserActivity *userActivity =
+        (NSUserActivity *)userActivityDict[@"UIApplicationLaunchOptionsUserActivityKey"];
+
+    id completion = ^(FIRDynamicLink *_Nullable dynamicLink, NSError *_Nullable error) {
+      if (!error && dynamicLink && dynamicLink.url) {
+        resolve(@{
+          @"url" : dynamicLink.url.absoluteString,
+          @"minimumAppVersion" : dynamicLink.minimumAppVersion == nil
+              ? [NSNull null]
+              : dynamicLink.minimumAppVersion,
+          @"utmParameters" : dynamicLink.utmParametersDictionary == nil
+              ? @{}
+              : dynamicLink.utmParametersDictionary,
+        });
+      } else if (!error &&
+                 [RNFBDynamicLinksAppDelegateInterceptor sharedInstance].initialLinkUrl != nil) {
+        resolve(@{
+          @"url" : [RNFBDynamicLinksAppDelegateInterceptor sharedInstance].initialLinkUrl,
+          @"minimumAppVersion" : [RNFBDynamicLinksAppDelegateInterceptor sharedInstance]
+                      .initialLinkMinimumAppVersion == nil
+              ? [NSNull null]
+              : [RNFBDynamicLinksAppDelegateInterceptor sharedInstance]
+                    .initialLinkMinimumAppVersion,
+          @"utmParameters" : [RNFBDynamicLinksAppDelegateInterceptor sharedInstance]
+                      .initialLinkUtmParametersDictionary == nil
+              ? @{}
+              : [RNFBDynamicLinksAppDelegateInterceptor sharedInstance]
+                    .initialLinkUtmParametersDictionary,
+        });
+      } else if (error) {
+        [RNFBSharedUtils rejectPromiseWithUserInfo:reject
+                                          userInfo:(NSMutableDictionary *)@{
+                                            @"code" : @"initial-link-error",
+                                            @"message" : [error localizedDescription],
+                                          }];
+      } else {
+        resolve([NSNull null]);
+      }
+    };
+
+    [[FIRDynamicLinks dynamicLinks] handleUniversalLink:userActivity.webpageURL
+                                             completion:completion];
+
+    return;
+  }
+
+  if ([RNFBDynamicLinksAppDelegateInterceptor sharedInstance].initialLinkUrl != nil) {
+    resolve(@{
+      @"url" : [RNFBDynamicLinksAppDelegateInterceptor sharedInstance].initialLinkUrl,
+      @"minimumAppVersion" : [RNFBDynamicLinksAppDelegateInterceptor sharedInstance]
+                  .initialLinkMinimumAppVersion == nil
+          ? [NSNull null]
+          : [RNFBDynamicLinksAppDelegateInterceptor sharedInstance].initialLinkMinimumAppVersion,
+      @"utmParameters" : [RNFBDynamicLinksAppDelegateInterceptor sharedInstance]
+                  .initialLinkUtmParametersDictionary == nil
+          ? @{}
+          : [RNFBDynamicLinksAppDelegateInterceptor sharedInstance]
+                .initialLinkUtmParametersDictionary,
+    });
+  } else {
+    resolve([NSNull null]);
+  }
+}
+
+RCT_EXPORT_METHOD(performDiagnostics) { [FIRDynamicLinks performDiagnosticsWithCompletion:nil]; }
+
+RCT_EXPORT_METHOD(resolveLink
+                  : (NSString *)link
+                  : (RCTPromiseResolveBlock)resolve
+                  : (RCTPromiseRejectBlock)reject) {
+  id completion = ^(FIRDynamicLink *_Nullable dynamicLink, NSError *_Nullable error) {
+    if (!error && dynamicLink && dynamicLink.url) {
+      resolve(@{
+        @"url" : dynamicLink.url.absoluteString,
+        @"minimumAppVersion" : dynamicLink.minimumAppVersion == nil ? [NSNull null]
+                                                                    : dynamicLink.minimumAppVersion,
+        @"utmParameters" : dynamicLink.utmParametersDictionary == nil
+            ? @{}
+            : dynamicLink.utmParametersDictionary,
+      });
+    } else if (!error ||
+               (error && [error.localizedDescription containsString:@"dynamicLinks error 404"])) {
+      [RNFBSharedUtils rejectPromiseWithUserInfo:reject
+                                        userInfo:(NSMutableDictionary *)@{
+                                          @"code" : @"not-found",
+                                          @"message" : @"Dynamic link not found"
+                                        }];
+    } else {
+      [RNFBSharedUtils rejectPromiseWithUserInfo:reject
+                                        userInfo:(NSMutableDictionary *)@{
+                                          @"code" : @"resolve-link-error",
+                                          @"message" : [error localizedDescription]
+                                        }];
+    }
+  };
+
+  [[FIRDynamicLinks dynamicLinks] handleUniversalLink:[NSURL URLWithString:link]
+                                           completion:completion];
+}
+
+- (FIRDynamicLinkComponents *)createDynamicLinkComponents:(NSDictionary *)dynamicLinkDict {
+  NSURL *link = [NSURL URLWithString:dynamicLinkDict[@"link"]];
+  FIRDynamicLinkComponents *linkComponents =
+      [FIRDynamicLinkComponents componentsWithLink:link
+                                   domainURIPrefix:dynamicLinkDict[@"domainUriPrefix"]];
+
+  [self buildAnalyticsParameters:dynamicLinkDict[@"analytics"] components:linkComponents];
+  [self buildAndroidParameters:dynamicLinkDict[@"android"] components:linkComponents];
+  [self buildIosParameters:dynamicLinkDict[@"ios"] components:linkComponents];
+  [self buildItunesParameters:dynamicLinkDict[@"itunes"] components:linkComponents];
+  [self buildNavigationParameters:dynamicLinkDict[@"navigation"] components:linkComponents];
+  [self buildSocialParameters:dynamicLinkDict[@"social"] components:linkComponents];
+  [self buildOtherPlatformParameters:dynamicLinkDict[@"otherPlatform"] components:linkComponents];
+
+  return linkComponents;
+}
+
+- (void)buildAnalyticsParameters:(NSDictionary *)analyticsDict
+                      components:(FIRDynamicLinkComponents *)linkComponents {
+  if (analyticsDict == nil) return;
+
+  FIRDynamicLinkGoogleAnalyticsParameters *analyticsParams =
+      [FIRDynamicLinkGoogleAnalyticsParameters parameters];
+
+  if (analyticsDict[@"campaign"]) {
+    analyticsParams.campaign = analyticsDict[@"campaign"];
+  }
+
+  if (analyticsDict[@"content"]) {
+    analyticsParams.content = analyticsDict[@"content"];
+  }
+
+  if (analyticsDict[@"medium"]) {
+    analyticsParams.medium = analyticsDict[@"medium"];
+  }
+
+  if (analyticsDict[@"source"]) {
+    analyticsParams.source = analyticsDict[@"source"];
+  }
+
+  if (analyticsDict[@"term"]) {
+    analyticsParams.term = analyticsDict[@"term"];
+  }
+
+  linkComponents.analyticsParameters = analyticsParams;
+}
+
+- (void)buildAndroidParameters:(NSDictionary *)androidDict
+                    components:(FIRDynamicLinkComponents *)linkComponents {
+  if (androidDict == nil) return;
+
+  FIRDynamicLinkAndroidParameters *androidParams =
+      [FIRDynamicLinkAndroidParameters parametersWithPackageName:androidDict[@"packageName"]];
+
+  if (androidDict[@"fallbackUrl"]) {
+    androidParams.fallbackURL = [NSURL URLWithString:androidDict[@"fallbackUrl"]];
+  }
+
+  if (androidDict[@"minimumVersion"]) {
+    androidParams.minimumVersion = [androidDict[@"minimumVersion"] integerValue];
+  }
+
+  linkComponents.androidParameters = androidParams;
+}
+
+- (void)buildIosParameters:(NSDictionary *)iosDict
+                components:(FIRDynamicLinkComponents *)linkComponents {
+  if (iosDict == nil) return;
+
+  FIRDynamicLinkIOSParameters *iOSParams =
+      [FIRDynamicLinkIOSParameters parametersWithBundleID:iosDict[@"bundleId"]];
+
+  if (iosDict[@"appStoreId"]) {
+    iOSParams.appStoreID = iosDict[@"appStoreId"];
+  }
+
+  if (iosDict[@"customScheme"]) {
+    iOSParams.customScheme = iosDict[@"customScheme"];
+  }
+
+  if (iosDict[@"fallbackUrl"]) {
+    iOSParams.fallbackURL = [NSURL URLWithString:iosDict[@"fallbackUrl"]];
+  }
+
+  if (iosDict[@"iPadBundleId"]) {
+    iOSParams.iPadBundleID = iosDict[@"iPadBundleId"];
+  }
+
+  if (iosDict[@"iPadFallbackUrl"]) {
+    iOSParams.iPadFallbackURL = [NSURL URLWithString:iosDict[@"iPadFallbackUrl"]];
+  }
+
+  if (iosDict[@"minimumVersion"]) {
+    iOSParams.minimumAppVersion = iosDict[@"minimumVersion"];
+  }
+
+  linkComponents.iOSParameters = iOSParams;
+}
+
+- (void)buildItunesParameters:(NSDictionary *)itunesDict
+                   components:(FIRDynamicLinkComponents *)linkComponents {
+  if (itunesDict == nil) return;
+
+  FIRDynamicLinkItunesConnectAnalyticsParameters *itunesParams =
+      [FIRDynamicLinkItunesConnectAnalyticsParameters parameters];
+
+  if (itunesDict[@"affiliateToken"]) {
+    itunesParams.affiliateToken = itunesDict[@"affiliateToken"];
+  }
+
+  if (itunesDict[@"campaignToken"]) {
+    itunesParams.campaignToken = itunesDict[@"campaignToken"];
+  }
+
+  if (itunesDict[@"providerToken"]) {
+    itunesParams.providerToken = itunesDict[@"providerToken"];
+  }
+
+  linkComponents.iTunesConnectParameters = itunesParams;
+}
+
+- (void)buildNavigationParameters:(NSDictionary *)navigationDict
+                       components:(FIRDynamicLinkComponents *)linkComponents {
+  if (navigationDict == nil) return;
+
+  FIRDynamicLinkNavigationInfoParameters *navigationParams =
+      [FIRDynamicLinkNavigationInfoParameters parameters];
+
+  if (navigationDict[@"forcedRedirectEnabled"]) {
+    navigationParams.forcedRedirectEnabled = [navigationDict[@"forcedRedirectEnabled"] boolValue];
+  }
+
+  linkComponents.navigationInfoParameters = navigationParams;
+}
+
+- (void)buildSocialParameters:(NSDictionary *)socialDict
+                   components:(FIRDynamicLinkComponents *)linkComponents {
+  if (socialDict == nil) return;
+
+  FIRDynamicLinkSocialMetaTagParameters *socialParams =
+      [FIRDynamicLinkSocialMetaTagParameters parameters];
+  if (socialDict[@"descriptionText"]) {
+    socialParams.descriptionText = socialDict[@"descriptionText"];
+  }
+
+  if (socialDict[@"imageUrl"]) {
+    socialParams.imageURL = [NSURL URLWithString:socialDict[@"imageUrl"]];
+  }
+
+  if (socialDict[@"title"]) {
+    socialParams.title = socialDict[@"title"];
+  }
+
+  linkComponents.socialMetaTagParameters = socialParams;
+}
+
+- (void)buildOtherPlatformParameters:(NSDictionary *)otherDict
+                          components:(FIRDynamicLinkComponents *)linkComponents {
+  if (otherDict == nil) return;
+
+  FIRDynamicLinkOtherPlatformParameters *otherParams =
+      [FIRDynamicLinkOtherPlatformParameters parameters];
+  if (otherDict[@"fallbackUrl"]) {
+    otherParams.fallbackUrl = [NSURL URLWithString:otherDict[@"fallbackUrl"]];
+  }
+  linkComponents.otherPlatformParameters = otherParams;
+}
+
+- (NSArray<NSString *> *)supportedEvents {
+  return @[];
+}
+
+// TODO document or add a method to call this:
+//     [FIRDynamicLinks performDiagnosticsWithCompletion:nil];
+//     ref: https://firebase.google.com/docs/dynamic-links/debug#ios_self-diagnostic_tool
+
+@end