3.9.2

lpw

2021-01-26 49b8839fda3439edc31581527e84036e58f55f0f

 frameworks/FBSDKCoreKit.framework/Headers/FBSDKAppLinkUtility.h

@@ -16,34 +16,38 @@
// IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
// CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

#import "TargetConditionals.h"

#if !TARGET_OS_TV

#import <Foundation/Foundation.h>

/*!
 @abstract Describes the callback for fetchDeferredAppLink.
NS_ASSUME_NONNULL_BEGIN

/**
  Describes the callback for fetchDeferredAppLink.
 @param url the url representing the deferred App Link
 @param error the error during the request, if any

 @discussion The url may also have a fb_click_time_utc query parameter that

 The url may also have a fb_click_time_utc query parameter that
 represents when the click occurred that caused the deferred App Link to be created.
 */
typedef void (^FBSDKDeferredAppLinkHandler)(NSURL *url, NSError *error);
typedef void (^FBSDKURLBlock)(NSURL *_Nullable url, NSError *_Nullable error)
NS_SWIFT_NAME(URLBlock);


/*!
 @abstract Describes the callback for fetchOrganicDeferredAppLink.
 @param url the url representing the deferred App Link
/**
  Class containing App Links related utility methods.
 */
typedef void (^FBSDKDeferredAppInviteHandler)(NSURL *url);


/*!
 @abstract Class containing App Links related utility methods.
 */
NS_SWIFT_NAME(AppLinkUtility)
@interface FBSDKAppLinkUtility : NSObject

/*!
 @abstract
 Call this method from the main thread to fetch deferred applink data if you use Mobile App
- (instancetype)init NS_UNAVAILABLE;
+ (instancetype)new NS_UNAVAILABLE;

/**
  Call this method from the main thread to fetch deferred applink data if you use Mobile App
 Engagement Ads (https://developers.facebook.com/docs/ads-for-apps/mobile-app-ads-engagement).
 This may require a network round trip. If successful, the handler is invoked  with the link
 data (this will only return a valid URL once, and future calls will result in a nil URL
@@ -51,50 +55,39 @@

 @param handler the handler to be invoked if there is deferred App Link data

 @discussion The handler may contain an NSError instance to capture any errors. In the

 The handler may contain an NSError instance to capture any errors. In the
 common case where there simply was no app link data, the NSError instance will be nil.

 This method should only be called from a location that occurs after any launching URL has
 been processed (e.g., you should call this method from your application delegate's
 applicationDidBecomeActive:).
 */
+ (void)fetchDeferredAppLink:(FBSDKDeferredAppLinkHandler)handler;

/*!
 @abstract Call this method from the main thread to fetch deferred deeplink for App Invites
 Handler is called with deeplink url, if found, nil otherwise.

 @param handler Handler to be called when we fetch deeplink url.

 @return YES if async fetch process was started, NO if it failed to start. Note it returns NO
 for versions < iOS 9.

 @discussion Call this method from the main thread to fetch deferred deeplink if you use App Invites.
 This may require a network round trip. If successful, this will call the handler provided, with
 deferred deeplink that was clicked by the user. If there is a error/timeout, handler will be called
 with nil.
 This method only works on iOS 9+ and returns NO otherwise.
 This method should only be called from a location that occurs after any launching URL has
 been processed (e.g., you should call this method from your application delegate's
 didFinishLaunchingWithOptions:).
 */
+ (BOOL)fetchDeferredAppInvite:(FBSDKDeferredAppInviteHandler)handler;
+ (void)fetchDeferredAppLink:(nullable FBSDKURLBlock)handler;

/*
 @abstract Call this method to fetch promotion code from the url, if it's present. This function
 requires Bolts framework.

 Note: This throws an exception if Bolts.framework is not linked. Add '[BFURL class]' in intialize method
 of your AppDelegate.
  Call this method to fetch promotion code from the url, if it's present.

 @param url App Link url that was passed to the app.

 @return Promotion code string.

 @discussion Call this method to fetch App Invite Promotion Code from applink if present.

 Call this method to fetch App Invite Promotion Code from applink if present.
 This can be used to fetch the promotion code that was associated with the invite when it
 was created. This method should be called with the url from the openURL method.
*/
+ (NSString*)appInvitePromotionCodeFromURL:(NSURL*)url;
+ (nullable NSString *)appInvitePromotionCodeFromURL:(NSURL *)url;

/**
 Check whether the scheme is defined in the app's URL schemes.
 @param scheme the scheme of App Link URL
 @return YES if the scheme is defined, otherwise NO.
*/
+ (BOOL)isMatchURLScheme:(NSString *)scheme;

@end

NS_ASSUME_NONNULL_END

#endif