diff --git a/src/ios/Bolts.framework/Bolts b/src/ios/Bolts.framework/Bolts index 7925a9e1d..87a3d9b7c 100644 Binary files a/src/ios/Bolts.framework/Bolts and b/src/ios/Bolts.framework/Bolts differ diff --git a/src/ios/Bolts.framework/Headers/BFAppLinkNavigation.h b/src/ios/Bolts.framework/Headers/BFAppLinkNavigation.h index 886b888c8..4b8a71e02 100644 --- a/src/ios/Bolts.framework/Headers/BFAppLinkNavigation.h +++ b/src/ios/Bolts.framework/Headers/BFAppLinkNavigation.h @@ -33,6 +33,7 @@ typedef NS_ENUM(NSInteger, BFAppLinkNavigationType) { custom requests with additional navigation and app data attached to them by creating BFAppLinkNavigations themselves. */ +NS_EXTENSION_UNAVAILABLE_IOS("Not available in app extension") @interface BFAppLinkNavigation : NSObject /*! diff --git a/src/ios/Bolts.framework/Headers/BFAppLinkResolving.h b/src/ios/Bolts.framework/Headers/BFAppLinkResolving.h index b67bdba11..5c78bff45 100644 --- a/src/ios/Bolts.framework/Headers/BFAppLinkResolving.h +++ b/src/ios/Bolts.framework/Headers/BFAppLinkResolving.h @@ -25,6 +25,6 @@ @param url The URL to resolve into an App Link. @returns A BFTask that will return a BFAppLink for the given URL. */ -- (BFTask *)appLinkFromURLInBackground:(NSURL *)url; +- (BFTask *)appLinkFromURLInBackground:(NSURL *)url NS_EXTENSION_UNAVAILABLE_IOS("Not available in app extension"); @end diff --git a/src/ios/Bolts.framework/Headers/BFAppLinkReturnToRefererController.h b/src/ios/Bolts.framework/Headers/BFAppLinkReturnToRefererController.h index d19465ee9..436c52806 100644 --- a/src/ios/Bolts.framework/Headers/BFAppLinkReturnToRefererController.h +++ b/src/ios/Bolts.framework/Headers/BFAppLinkReturnToRefererController.h @@ -40,6 +40,7 @@ A controller class that implements default behavior for a BFAppLinkReturnToRefererView, including the ability to display the view above the navigation bar for navigation-based apps. */ +NS_EXTENSION_UNAVAILABLE_IOS("Not available in app extension") @interface BFAppLinkReturnToRefererController : NSObject /*! diff --git a/src/ios/Bolts.framework/Headers/BFAppLinkReturnToRefererView.h b/src/ios/Bolts.framework/Headers/BFAppLinkReturnToRefererView.h index d20f73a2d..f62bc66f6 100644 --- a/src/ios/Bolts.framework/Headers/BFAppLinkReturnToRefererView.h +++ b/src/ios/Bolts.framework/Headers/BFAppLinkReturnToRefererView.h @@ -48,6 +48,7 @@ typedef NS_ENUM(NSUInteger, BFIncludeStatusBarInSize) { rather than navigating away. If the view is provided an App Link that does not contain referer data, it will have zero size and no UI will be displayed. */ +NS_EXTENSION_UNAVAILABLE_IOS("Not available in app extension") @interface BFAppLinkReturnToRefererView : UIView /*! diff --git a/src/ios/Bolts.framework/Headers/BFCancellationToken.h b/src/ios/Bolts.framework/Headers/BFCancellationToken.h index 4d7dec0ed..bda32ee80 100644 --- a/src/ios/Bolts.framework/Headers/BFCancellationToken.h +++ b/src/ios/Bolts.framework/Headers/BFCancellationToken.h @@ -17,7 +17,7 @@ NS_ASSUME_NONNULL_BEGIN /*! A block that will be called when a token is cancelled. */ -typedef void(^BFCancellationBlock)(); +typedef void(^BFCancellationBlock)(void); /*! The consumer view of a CancellationToken. diff --git a/src/ios/Bolts.framework/Headers/BFExecutor.h b/src/ios/Bolts.framework/Headers/BFExecutor.h index afa4f3d2f..694c8a5fc 100644 --- a/src/ios/Bolts.framework/Headers/BFExecutor.h +++ b/src/ios/Bolts.framework/Headers/BFExecutor.h @@ -37,7 +37,7 @@ NS_ASSUME_NONNULL_BEGIN Returns a new executor that uses the given block to execute continuations. @param block The block to use. */ -+ (instancetype)executorWithBlock:(void(^)(void(^block)()))block; ++ (instancetype)executorWithBlock:(void(^)(void(^block)(void)))block; /*! Returns a new executor that runs continuations on the given queue. @@ -55,7 +55,7 @@ NS_ASSUME_NONNULL_BEGIN Runs the given block using this executor's particular strategy. @param block The block to execute. */ -- (void)execute:(void(^)())block; +- (void)execute:(void(^)(void))block; @end diff --git a/src/ios/Bolts.framework/Headers/BFGeneric.h b/src/ios/Bolts.framework/Headers/BFGeneric.h new file mode 100644 index 000000000..99b2cf7de --- /dev/null +++ b/src/ios/Bolts.framework/Headers/BFGeneric.h @@ -0,0 +1,25 @@ +/* + * Copyright (c) 2014, Facebook, Inc. + * All rights reserved. + * + * This source code is licensed under the BSD-style license found in the + * LICENSE file in the root directory of this source tree. An additional grant + * of patent rights can be found in the PATENTS file in the same directory. + * + */ + +#import + +#pragma once + +/** + This exists to use along with `BFTask` and `BFTaskCompletionSource`. + + Instead of returning a `BFTask` with no generic type, or a generic type of 'NSNull' + when there is no usable result from a task, we use the type 'BFVoid', which will always have a value of `nil`. + + This allows you to provide a more enforced API contract to the caller, + as sending any message to `BFVoid` will result in a compile time error. + */ +@class _BFVoid_Nonexistant; +typedef _BFVoid_Nonexistant *BFVoid; diff --git a/src/ios/Bolts.framework/Headers/BFTask+Exceptions.h b/src/ios/Bolts.framework/Headers/BFTask+Exceptions.h deleted file mode 100644 index 41b633c65..000000000 --- a/src/ios/Bolts.framework/Headers/BFTask+Exceptions.h +++ /dev/null @@ -1,32 +0,0 @@ -/* - * Copyright (c) 2016, Facebook, Inc. - * All rights reserved. - * - * This source code is licensed under the BSD-style license found in the - * LICENSE file in the root directory of this source tree. An additional grant - * of patent rights can be found in the PATENTS file in the same directory. - */ - -#pragma once - -#import - -NS_ASSUME_NONNULL_BEGIN - -/** - Returns whether all instances of `BFTask` should automatically @try/@catch exceptions in continuation blocks. Default: `YES`. - - @return Boolean value indicating whether exceptions are being caught. - */ -extern BOOL BFTaskCatchesExceptions(void) -__attribute__((deprecated("This is temporary API and will be removed in a future release."))); - -/** - Set whether all instances of `BFTask` should automatically @try/@catch exceptions in continuation blocks. Default: `YES`. - - @param catchExceptions Boolean value indicating whether exceptions shoudl be caught. - */ -extern void BFTaskSetCatchesExceptions(BOOL catchExceptions) -__attribute__((deprecated("This is a temporary API and will be removed in a future release."))); - -NS_ASSUME_NONNULL_END diff --git a/src/ios/Bolts.framework/Headers/BFTask.h b/src/ios/Bolts.framework/Headers/BFTask.h index 071f994d5..074c182de 100644 --- a/src/ios/Bolts.framework/Headers/BFTask.h +++ b/src/ios/Bolts.framework/Headers/BFTask.h @@ -11,6 +11,7 @@ #import #import +#import NS_ASSUME_NONNULL_BEGIN @@ -24,29 +25,12 @@ extern NSString *const BFTaskErrorDomain; */ extern NSInteger const kBFMultipleErrorsError; -/*! - An exception that is thrown if there was multiple exceptions on . - - @deprecated `BFTask` exception handling is deprecated and will be removed in a future release. - */ -extern NSString *const BFTaskMultipleExceptionsException -__attribute__((deprecated("`BFTask` exception handling is deprecated and will be removed in a future release."))); - /*! An error userInfo key used if there were multiple errors on . Value type is `NSArray *`. */ extern NSString *const BFTaskMultipleErrorsUserInfoKey; -/*! - An error userInfo key used if there were multiple exceptions on . - Value type is `NSArray *`. - - @deprecated `BFTask` exception handling is deprecated and will be removed in a future release. - */ -extern NSString *const BFTaskMultipleExceptionsUserInfoKey -__attribute__((deprecated("`BFTask` exception handling is deprecated and will be removed in a future release."))); - @class BFExecutor; @class BFTask; @@ -74,15 +58,6 @@ typedef __nullable id(^BFContinuationBlock)(BFTask *t); */ + (instancetype)taskWithError:(NSError *)error; -/*! - Creates a task that is already completed with the given exception. - @param exception The exception for the task. - - @deprecated `BFTask` exception handling is deprecated and will be removed in a future release. - */ -+ (instancetype)taskWithException:(NSException *)exception -__attribute__((deprecated("`BFTask` exception handling is deprecated and will be removed in a future release."))); - /*! Creates a task that is already cancelled. */ @@ -105,7 +80,7 @@ __attribute__((deprecated("`BFTask` exception handling is deprecated and will be /*! Returns a task that will be completed once there is at least one successful task. - The first task to successuly complete will set the result, all other tasks results are + The first task to successuly complete will set the result, all other tasks results are ignored. @param tasks An `NSArray` of the tasks to use as an input. */ @@ -116,7 +91,7 @@ __attribute__((deprecated("`BFTask` exception handling is deprecated and will be @param millis The approximate number of milliseconds to wait before the task will be finished (with result == nil). */ -+ (instancetype)taskWithDelay:(int)millis; ++ (BFTask *)taskWithDelay:(int)millis; /*! Returns a task that will be completed a certain amount of time in the future. @@ -124,7 +99,7 @@ __attribute__((deprecated("`BFTask` exception handling is deprecated and will be task will be finished (with result == nil). @param token The cancellation token (optional). */ -+ (instancetype)taskWithDelay:(int)millis cancellationToken:(nullable BFCancellationToken *)token; ++ (BFTask *)taskWithDelay:(int)millis cancellationToken:(nullable BFCancellationToken *)token; /*! Returns a task that will be completed after the given block completes with @@ -136,7 +111,7 @@ __attribute__((deprecated("`BFTask` exception handling is deprecated and will be If block returns a BFTask, then the task returned from this method will not be completed until that task is completed. */ -+ (instancetype)taskFromExecutor:(BFExecutor *)executor withBlock:(nullable id (^)())block; ++ (instancetype)taskFromExecutor:(BFExecutor *)executor withBlock:(nullable id (^)(void))block; // Properties that will be set on the task once it is completed. @@ -150,21 +125,13 @@ __attribute__((deprecated("`BFTask` exception handling is deprecated and will be */ @property (nullable, nonatomic, strong, readonly) NSError *error; -/*! - The exception of a failed task. - - @deprecated `BFTask` exception handling is deprecated and will be removed in a future release. - */ -@property (nullable, nonatomic, strong, readonly) NSException *exception -__attribute__((deprecated("`BFTask` exception handling is deprecated and will be removed in a future release."))); - /*! Whether this task has been cancelled. */ @property (nonatomic, assign, readonly, getter=isCancelled) BOOL cancelled; /*! - Whether this task has completed due to an error or exception. + Whether this task has completed due to an error. */ @property (nonatomic, assign, readonly, getter=isFaulted) BOOL faulted; @@ -184,7 +151,7 @@ __attribute__((deprecated("`BFTask` exception handling is deprecated and will be If block returns a BFTask, then the task returned from this method will not be completed until that task is completed. */ -- (BFTask *)continueWithBlock:(BFContinuationBlock)block; +- (BFTask *)continueWithBlock:(BFContinuationBlock)block NS_SWIFT_NAME(continueWith(block:)); /*! Enqueues the given block to be run once this task is complete. @@ -198,7 +165,8 @@ __attribute__((deprecated("`BFTask` exception handling is deprecated and will be If block returns a BFTask, then the task returned from this method will not be completed until that task is completed. */ -- (BFTask *)continueWithBlock:(BFContinuationBlock)block cancellationToken:(nullable BFCancellationToken *)cancellationToken; +- (BFTask *)continueWithBlock:(BFContinuationBlock)block + cancellationToken:(nullable BFCancellationToken *)cancellationToken NS_SWIFT_NAME(continueWith(block:cancellationToken:)); /*! Enqueues the given block to be run once this task is complete. @@ -209,7 +177,9 @@ __attribute__((deprecated("`BFTask` exception handling is deprecated and will be If block returns a BFTask, then the task returned from this method will not be completed until that task is completed. */ -- (BFTask *)continueWithExecutor:(BFExecutor *)executor withBlock:(BFContinuationBlock)block; +- (BFTask *)continueWithExecutor:(BFExecutor *)executor + withBlock:(BFContinuationBlock)block NS_SWIFT_NAME(continueWith(executor:block:)); + /*! Enqueues the given block to be run once this task is complete. @param executor A BFExecutor responsible for determining how the @@ -222,11 +192,12 @@ __attribute__((deprecated("`BFTask` exception handling is deprecated and will be */ - (BFTask *)continueWithExecutor:(BFExecutor *)executor block:(BFContinuationBlock)block - cancellationToken:(nullable BFCancellationToken *)cancellationToken; + cancellationToken:(nullable BFCancellationToken *)cancellationToken +NS_SWIFT_NAME(continueWith(executor:block:cancellationToken:)); /*! Identical to continueWithBlock:, except that the block is only run - if this task did not produce a cancellation, error, or exception. + if this task did not produce a cancellation or an error. If it did, then the failure will be propagated to the returned task. @param block The block to be run once this task is complete. @@ -234,11 +205,11 @@ __attribute__((deprecated("`BFTask` exception handling is deprecated and will be If block returns a BFTask, then the task returned from this method will not be completed until that task is completed. */ -- (BFTask *)continueWithSuccessBlock:(BFContinuationBlock)block; +- (BFTask *)continueWithSuccessBlock:(BFContinuationBlock)block NS_SWIFT_NAME(continueOnSuccessWith(block:)); /*! Identical to continueWithBlock:, except that the block is only run - if this task did not produce a cancellation, error, or exception. + if this task did not produce a cancellation or an error. If it did, then the failure will be propagated to the returned task. @param block The block to be run once this task is complete. @@ -247,13 +218,14 @@ __attribute__((deprecated("`BFTask` exception handling is deprecated and will be If block returns a BFTask, then the task returned from this method will not be completed until that task is completed. */ -- (BFTask *)continueWithSuccessBlock:(BFContinuationBlock)block cancellationToken:(nullable BFCancellationToken *)cancellationToken; +- (BFTask *)continueWithSuccessBlock:(BFContinuationBlock)block + cancellationToken:(nullable BFCancellationToken *)cancellationToken +NS_SWIFT_NAME(continueOnSuccessWith(block:cancellationToken:)); /*! Identical to continueWithExecutor:withBlock:, except that the block - is only run if this task did not produce a cancellation, error, or - exception. If it did, then the failure will be propagated to the - returned task. + is only run if this task did not produce a cancellation, error, or an error. + If it did, then the failure will be propagated to the returned task. @param executor A BFExecutor responsible for determining how the continuation block will be run. @param block The block to be run once this task is complete. @@ -261,13 +233,13 @@ __attribute__((deprecated("`BFTask` exception handling is deprecated and will be If block returns a BFTask, then the task returned from this method will not be completed until that task is completed. */ -- (BFTask *)continueWithExecutor:(BFExecutor *)executor withSuccessBlock:(BFContinuationBlock)block; +- (BFTask *)continueWithExecutor:(BFExecutor *)executor + withSuccessBlock:(BFContinuationBlock)block NS_SWIFT_NAME(continueOnSuccessWith(executor:block:)); /*! Identical to continueWithExecutor:withBlock:, except that the block - is only run if this task did not produce a cancellation, error, or - exception. If it did, then the failure will be propagated to the - returned task. + is only run if this task did not produce a cancellation or an error. + If it did, then the failure will be propagated to the returned task. @param executor A BFExecutor responsible for determining how the continuation block will be run. @param block The block to be run once this task is complete. @@ -278,7 +250,8 @@ __attribute__((deprecated("`BFTask` exception handling is deprecated and will be */ - (BFTask *)continueWithExecutor:(BFExecutor *)executor successBlock:(BFContinuationBlock)block - cancellationToken:(nullable BFCancellationToken *)cancellationToken; + cancellationToken:(nullable BFCancellationToken *)cancellationToken +NS_SWIFT_NAME(continueOnSuccessWith(executor:block:cancellationToken:)); /*! Waits until this operation is completed. diff --git a/src/ios/Bolts.framework/Headers/BFTaskCompletionSource.h b/src/ios/Bolts.framework/Headers/BFTaskCompletionSource.h index 18810bc83..f94c18fdb 100644 --- a/src/ios/Bolts.framework/Headers/BFTaskCompletionSource.h +++ b/src/ios/Bolts.framework/Headers/BFTaskCompletionSource.h @@ -12,7 +12,7 @@ NS_ASSUME_NONNULL_BEGIN -@class BFTask; +@class BFTask<__covariant ResultType>; /*! A BFTaskCompletionSource represents the producer side of tasks. @@ -36,24 +36,14 @@ NS_ASSUME_NONNULL_BEGIN Attempting to set this for a completed task will raise an exception. @param result The result of the task. */ -- (void)setResult:(nullable ResultType)result; +- (void)setResult:(nullable ResultType)result NS_SWIFT_NAME(set(result:)); /*! Completes the task by setting the error. Attempting to set this for a completed task will raise an exception. @param error The error for the task. */ -- (void)setError:(NSError *)error; - -/*! - Completes the task by setting an exception. - Attempting to set this for a completed task will raise an exception. - @param exception The exception for the task. - - @deprecated `BFTask` exception handling is deprecated and will be removed in a future release. - */ -- (void)setException:(NSException *)exception -__attribute__((deprecated("`BFTask` exception handling is deprecated and will be removed in a future release."))); +- (void)setError:(NSError *)error NS_SWIFT_NAME(set(error:)); /*! Completes the task by marking it as cancelled. @@ -65,24 +55,14 @@ __attribute__((deprecated("`BFTask` exception handling is deprecated and will be Sets the result of the task if it wasn't already completed. @returns whether the new value was set. */ -- (BOOL)trySetResult:(nullable ResultType)result; +- (BOOL)trySetResult:(nullable ResultType)result NS_SWIFT_NAME(trySet(result:)); /*! Sets the error of the task if it wasn't already completed. @param error The error for the task. @returns whether the new value was set. */ -- (BOOL)trySetError:(NSError *)error; - -/*! - Sets the exception of the task if it wasn't already completed. - @param exception The exception for the task. - @returns whether the new value was set. - - @deprecated `BFTask` exception handling is deprecated and will be removed in a future release. - */ -- (BOOL)trySetException:(NSException *)exception -__attribute__((deprecated("`BFTask` exception handling is deprecated and will be removed in a future release."))); +- (BOOL)trySetError:(NSError *)error NS_SWIFT_NAME(trySet(error:)); /*! Sets the cancellation state of the task if it wasn't already completed. diff --git a/src/ios/Bolts.framework/Headers/Bolts.h b/src/ios/Bolts.framework/Headers/Bolts.h index 907e4a2b6..a3f2bd6f2 100644 --- a/src/ios/Bolts.framework/Headers/Bolts.h +++ b/src/ios/Bolts.framework/Headers/Bolts.h @@ -12,8 +12,8 @@ #import #import #import +#import #import -#import #import #if __has_include() && TARGET_OS_IPHONE && !TARGET_OS_WATCH && !TARGET_OS_TV diff --git a/src/ios/Bolts.framework/Info.plist b/src/ios/Bolts.framework/Info.plist index 9a79ce74b..27add4fbd 100644 Binary files a/src/ios/Bolts.framework/Info.plist and b/src/ios/Bolts.framework/Info.plist differ diff --git a/src/ios/FBSDKCoreKit.framework/FBSDKCoreKit b/src/ios/FBSDKCoreKit.framework/FBSDKCoreKit index 3432c358b..a936844ec 100644 Binary files a/src/ios/FBSDKCoreKit.framework/FBSDKCoreKit and b/src/ios/FBSDKCoreKit.framework/FBSDKCoreKit differ diff --git a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKAccessToken.h b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKAccessToken.h index c71241628..7bf908831 100644 --- a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKAccessToken.h +++ b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKAccessToken.h @@ -117,15 +117,15 @@ FBSDK_EXTERN NSString *const FBSDKAccessTokenDidExpire; /** Initializes a new instance. - - Parameter tokenString: the opaque token string. - - Parameter permissions: the granted permissions. Note this is converted to NSSet and is only + @param tokenString the opaque token string. + @param permissions the granted permissions. Note this is converted to NSSet and is only an NSArray for the convenience of literal syntax. - - Parameter declinedPermissions: the declined permissions. Note this is converted to NSSet and is only + @param declinedPermissions the declined permissions. Note this is converted to NSSet and is only an NSArray for the convenience of literal syntax. - - Parameter appID: the app ID. - - Parameter userID: the user ID. - - Parameter expirationDate: the optional expiration date (defaults to distantFuture). - - Parameter refreshDate: the optional date the token was last refreshed (defaults to today). + @param appID the app ID. + @param userID the user ID. + @param expirationDate the optional expiration date (defaults to distantFuture). + @param refreshDate the optional date the token was last refreshed (defaults to today). This initializer should only be used for advanced apps that manage tokens explicitly. Typical login flows only need to use `FBSDKLoginManager` @@ -142,14 +142,14 @@ NS_DESIGNATED_INITIALIZER; /** Convenience getter to determine if a permission has been granted - - Parameter permission: The permission to check. + @param permission The permission to check. */ - (BOOL)hasGranted:(NSString *)permission; /** Compares the receiver to another FBSDKAccessToken - - Parameter token: The other token - - Returns: YES if the receiver's values are equal to the other token's values; otherwise NO + @param token The other token + @return YES if the receiver's values are equal to the other token's values; otherwise NO */ - (BOOL)isEqualToAccessToken:(FBSDKAccessToken *)token; @@ -169,7 +169,7 @@ NS_DESIGNATED_INITIALIZER; /** Sets the "global" access token that represents the currently logged in user. - - Parameter token: The access token to set. + @param token The access token to set. This will broadcast a notification and save the token to the app keychain. */ @@ -178,7 +178,7 @@ NS_DESIGNATED_INITIALIZER; /** Refresh the current access token's permission state and extend the token's expiration date, if possible. - - Parameter completionHandler: an optional callback handler that can surface any errors related to permission refreshing. + @param completionHandler an optional callback handler that can surface any errors related to permission refreshing. On a successful refresh, the currentAccessToken will be updated so you typically only need to observe the `FBSDKAccessTokenDidChangeNotification` notification. diff --git a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKAppEvents.h b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKAppEvents.h index 549c13b0c..69b844b75 100644 --- a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKAppEvents.h +++ b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKAppEvents.h @@ -55,6 +55,45 @@ typedef NS_ENUM(NSUInteger, FBSDKAppEventsFlushBehavior) }; +/** + NS_ENUM(NSUInteger, FBSDKProductAvailability) + Specifies product availability for Product Catalog product item update + */ +typedef NS_ENUM(NSUInteger, FBSDKProductAvailability) +{ + /** + * Item ships immediately + */ + FBSDKProductAvailabilityInStock = 0, + /** + * No plan to restock + */ + FBSDKProductAvailabilityOutOfStock, + /** + * Available in future + */ + FBSDKProductAvailabilityPreOrder, + /** + * Ships in 1-2 weeks + */ + FBSDKProductAvailabilityAvailableForOrder, + /** + * Discontinued + */ + FBSDKProductAvailabilityDiscontinued, +}; + +/** + NS_ENUM(NSUInteger, FBSDKProductCondition) + Specifies product condition for Product Catalog product item update + */ +typedef NS_ENUM(NSUInteger, FBSDKProductCondition) +{ + FBSDKProductConditionNew = 0, + FBSDKProductConditionRefurbished, + FBSDKProductConditionUsed, +}; + /** @methodgroup Predefined event names for logging events common to many apps. Logging occurs through the `logEvent` family of methods on `FBSDKAppEvents`. Common event parameters are provided in the `FBSDKAppEventsParameterNames*` constants. @@ -96,6 +135,36 @@ FBSDK_EXTERN NSString *const FBSDKAppEventNameUnlockedAchievement; /** Log this event when a user has viewed a form of content in the app. */ FBSDK_EXTERN NSString *const FBSDKAppEventNameViewedContent; +/** A telephone/SMS, email, chat or other type of contact between a customer and your business. */ +FBSDK_EXTERN NSString *const FBSDKAppEventNameContact; + +/** The customization of products through a configuration tool or other application your business owns. */ +FBSDK_EXTERN NSString *const FBSDKAppEventNameCustomizeProduct; + +/** The donation of funds to your organization or cause. */ +FBSDK_EXTERN NSString *const FBSDKAppEventNameDonate; + +/** When a person finds one of your locations via web or application, with an intention to visit (example: find product at a local store). */ +FBSDK_EXTERN NSString *const FBSDKAppEventNameFindLocation; + +/** The booking of an appointment to visit one of your locations. */ +FBSDK_EXTERN NSString *const FBSDKAppEventNameSchedule; + +/** The start of a free trial of a product or service you offer (example: trial subscription). */ +FBSDK_EXTERN NSString *const FBSDKAppEventNameStartTrial; + +/** The submission of an application for a product, service or program you offer (example: credit card, educational program or job).. */ +FBSDK_EXTERN NSString *const FBSDKAppEventNameSubmitApplication; + +/** The start of a paid subscription for a product or service you offer. */ +FBSDK_EXTERN NSString *const FBSDKAppEventNameSubscribe; + +/** Log this event when the user views an ad. */ +FBSDK_EXTERN NSString *const FBSDKAppEventNameAdImpression; + +/** Log this event when the user clicks an ad. */ +FBSDK_EXTERN NSString *const FBSDKAppEventNameAdClick; + /** @methodgroup Predefined event name parameters for common additional information to accompany events logged through the `logEvent` family of methods on `FBSDKAppEvents`. Common event names are provided in the `FBAppEventName*` constants. @@ -153,6 +222,14 @@ FBSDK_EXTERN NSString *const FBSDKAppEventParameterValueYes; /** No-valued parameter value to be used with parameter keys that need a Yes/No value */ FBSDK_EXTERN NSString *const FBSDKAppEventParameterValueNo; +/** Parameter key used to specify the type of ad in an FBSDKAppEventNameAdImpression + * or FBSDKAppEventNameAdClick event. + * E.g. "banner", "interstitial", "rewarded_video", "native" */ +FBSDK_EXTERN NSString *const FBSDKAppEventParameterNameAdType; + +/** Parameter key used to specify the unique ID for all events within a subscription + * in an FBSDKAppEventNameSubscribe or FBSDKAppEventNameStartTrial event. */ +FBSDK_EXTERN NSString *const FBSDKAppEventParameterNameOrderID; /** @@ -213,7 +290,7 @@ FBSDK_EXTERN NSString *const FBSDKAppEventParameterValueNo; Log an event with just an eventName. - - Parameter eventName: The name of the event to record. Limitations on number of events and name length + @param eventName The name of the event to record. Limitations on number of events and name length are given in the `FBSDKAppEvents` documentation. */ @@ -223,10 +300,10 @@ FBSDK_EXTERN NSString *const FBSDKAppEventParameterValueNo; Log an event with an eventName and a numeric value to be aggregated with other events of this name. - - Parameter eventName: The name of the event to record. Limitations on number of events and name length + @param eventName The name of the event to record. Limitations on number of events and name length are given in the `FBSDKAppEvents` documentation. Common event names are provided in `FBAppEventName*` constants. - - Parameter valueToSum: Amount to be aggregated into all events of this eventName, and App Insights will report + @param valueToSum Amount to be aggregated into all events of this eventName, and App Insights will report the cumulative and average value of this amount. */ + (void)logEvent:(NSString *)eventName @@ -238,10 +315,10 @@ FBSDK_EXTERN NSString *const FBSDKAppEventParameterValueNo; Log an event with an eventName and a set of key/value pairs in the parameters dictionary. Parameter limitations are described above. - - Parameter eventName: The name of the event to record. Limitations on number of events and name construction + @param eventName The name of the event to record. Limitations on number of events and name construction are given in the `FBSDKAppEvents` documentation. Common event names are provided in `FBAppEventName*` constants. - - Parameter parameters: Arbitrary parameter dictionary of characteristics. The keys to this dictionary must + @param parameters Arbitrary parameter dictionary of characteristics. The keys to this dictionary must be NSString's, and the values are expected to be NSString or NSNumber. Limitations on the number of parameters and name construction are given in the `FBSDKAppEvents` documentation. Commonly used parameter names are provided in `FBSDKAppEventParameterName*` constants. @@ -254,13 +331,13 @@ FBSDK_EXTERN NSString *const FBSDKAppEventParameterValueNo; Log an event with an eventName, a numeric value to be aggregated with other events of this name, and a set of key/value pairs in the parameters dictionary. - - Parameter eventName: The name of the event to record. Limitations on number of events and name construction + @param eventName The name of the event to record. Limitations on number of events and name construction are given in the `FBSDKAppEvents` documentation. Common event names are provided in `FBAppEventName*` constants. - - Parameter valueToSum: Amount to be aggregated into all events of this eventName, and App Insights will report + @param valueToSum Amount to be aggregated into all events of this eventName, and App Insights will report the cumulative and average value of this amount. - - Parameter parameters: Arbitrary parameter dictionary of characteristics. The keys to this dictionary must + @param parameters Arbitrary parameter dictionary of characteristics. The keys to this dictionary must be NSString's, and the values are expected to be NSString or NSNumber. Limitations on the number of parameters and name construction are given in the `FBSDKAppEvents` documentation. Commonly used parameter names are provided in `FBSDKAppEventParameterName*` constants. @@ -277,19 +354,19 @@ FBSDK_EXTERN NSString *const FBSDKAppEventParameterValueNo; and a set of key/value pairs in the parameters dictionary. Providing session lets the developer target a particular . If nil is provided, then `[FBSession activeSession]` will be used. - - Parameter eventName: The name of the event to record. Limitations on number of events and name construction + @param eventName The name of the event to record. Limitations on number of events and name construction are given in the `FBSDKAppEvents` documentation. Common event names are provided in `FBAppEventName*` constants. - - Parameter valueToSum: Amount to be aggregated into all events of this eventName, and App Insights will report + @param valueToSum Amount to be aggregated into all events of this eventName, and App Insights will report the cumulative and average value of this amount. Note that this is an NSNumber, and a value of `nil` denotes that this event doesn't have a value associated with it for summation. - - Parameter parameters: Arbitrary parameter dictionary of characteristics. The keys to this dictionary must + @param parameters Arbitrary parameter dictionary of characteristics. The keys to this dictionary must be NSString's, and the values are expected to be NSString or NSNumber. Limitations on the number of parameters and name construction are given in the `FBSDKAppEvents` documentation. Commonly used parameter names are provided in `FBSDKAppEventParameterName*` constants. - - Parameter accessToken: The optional access token to log the event as. + @param accessToken The optional access token to log the event as. */ + (void)logEvent:(NSString *)eventName valueToSum:(NSNumber *)valueToSum @@ -304,10 +381,10 @@ FBSDK_EXTERN NSString *const FBSDKAppEventParameterValueNo; Log a purchase of the specified amount, in the specified currency. - - Parameter purchaseAmount: Purchase amount to be logged, as expressed in the specified currency. This value + @param purchaseAmount Purchase amount to be logged, as expressed in the specified currency. This value will be rounded to the thousandths place (e.g., 12.34567 becomes 12.346). - - Parameter currency: Currency, is denoted as, e.g. "USD", "EUR", "GBP". See ISO-4217 for + @param currency Currency, is denoted as, e.g. "USD", "EUR", "GBP". See ISO-4217 for specific values. One reference for these is . @@ -323,13 +400,13 @@ FBSDK_EXTERN NSString *const FBSDKAppEventParameterValueNo; Log a purchase of the specified amount, in the specified currency, also providing a set of additional characteristics describing the purchase. - - Parameter purchaseAmount: Purchase amount to be logged, as expressed in the specified currency.This value + @param purchaseAmount Purchase amount to be logged, as expressed in the specified currency.This value will be rounded to the thousandths place (e.g., 12.34567 becomes 12.346). - - Parameter currency: Currency, is denoted as, e.g. "USD", "EUR", "GBP". See ISO-4217 for + @param currency Currency, is denoted as, e.g. "USD", "EUR", "GBP". See ISO-4217 for specific values. One reference for these is . - - Parameter parameters: Arbitrary parameter dictionary of characteristics. The keys to this dictionary must + @param parameters Arbitrary parameter dictionary of characteristics. The keys to this dictionary must be NSString's, and the values are expected to be NSString or NSNumber. Limitations on the number of parameters and name construction are given in the `FBSDKAppEvents` documentation. Commonly used parameter names are provided in `FBSDKAppEventParameterName*` constants. @@ -348,18 +425,18 @@ FBSDK_EXTERN NSString *const FBSDKAppEventParameterValueNo; Log a purchase of the specified amount, in the specified currency, also providing a set of additional characteristics describing the purchase, as well as an to log to. - - Parameter purchaseAmount: Purchase amount to be logged, as expressed in the specified currency.This value + @param purchaseAmount Purchase amount to be logged, as expressed in the specified currency.This value will be rounded to the thousandths place (e.g., 12.34567 becomes 12.346). - - Parameter currency: Currency, is denoted as, e.g. "USD", "EUR", "GBP". See ISO-4217 for + @param currency Currency, is denoted as, e.g. "USD", "EUR", "GBP". See ISO-4217 for specific values. One reference for these is . - - Parameter parameters: Arbitrary parameter dictionary of characteristics. The keys to this dictionary must + @param parameters Arbitrary parameter dictionary of characteristics. The keys to this dictionary must be NSString's, and the values are expected to be NSString or NSNumber. Limitations on the number of parameters and name construction are given in the `FBSDKAppEvents` documentation. Commonly used parameter names are provided in `FBSDKAppEventParameterName*` constants. - - Parameter accessToken: The optional access token to log the event as. + @param accessToken The optional access token to log the event as. This event immediately triggers a flush of the `FBSDKAppEvents` event queue, unless the `flushBehavior` is set @@ -379,18 +456,58 @@ FBSDK_EXTERN NSString *const FBSDKAppEventParameterValueNo; /** Log an app event that tracks that the application was open via Push Notification. - - Parameter payload: Notification payload received via `UIApplicationDelegate`. + @param payload Notification payload received via `UIApplicationDelegate`. */ + (void)logPushNotificationOpen:(NSDictionary *)payload; /** Log an app event that tracks that a custom action was taken from a push notification. - - Parameter payload: Notification payload received via `UIApplicationDelegate`. - - Parameter action: Name of the action that was taken. + @param payload Notification payload received via `UIApplicationDelegate`. + @param action Name of the action that was taken. */ + (void)logPushNotificationOpen:(NSDictionary *)payload action:(NSString *)action; +/** + Uploads product catalog product item as an app event + @param itemID Unique ID for the item. Can be a variant for a product. + Max size is 100. + @param availability If item is in stock. Accepted values are: + in stock - Item ships immediately + out of stock - No plan to restock + preorder - Available in future + available for order - Ships in 1-2 weeks + discontinued - Discontinued + @param condition Product condition: new, refurbished or used. + @param description Short text describing product. Max size is 5000. + @param imageLink Link to item image used in ad. + @param link Link to merchant's site where someone can buy the item. + @param title Title of item. + @param priceAmount Amount of purchase, in the currency specified by the 'currency' + parameter. This value will be rounded to the thousandths place + (e.g., 12.34567 becomes 12.346). + @param currency Currency used to specify the amount. + E.g. "USD", "EUR", "GBP". See ISO-4217 for specific values. One reference for these is + @param gtin Global Trade Item Number including UPC, EAN, JAN and ISBN + @param mpn Unique manufacture ID for product + @param brand Name of the brand + Note: Either gtin, mpn or brand is required. + @param parameters Optional fields for deep link specification. + */ ++ (void)logProductItem:(NSString *)itemID + availability:(FBSDKProductAvailability)availability + condition:(FBSDKProductCondition)condition + description:(NSString *)description + imageLink:(NSString *)imageLink + link:(NSString *)link + title:(NSString *)title + priceAmount:(double)priceAmount + currency:(NSString *)currency + gtin:(NSString *)gtin + mpn:(NSString *)mpn + brand:(NSString *)brand + parameters:(NSDictionary *)parameters; + /** Notifies the events system that the app has launched and, when appropriate, logs an "activated app" event. @@ -423,7 +540,7 @@ FBSDK_EXTERN NSString *const FBSDKAppEventParameterValueNo; Sets and sends a device token from `NSData` representation that you get from `UIApplicationDelegate.-application:didRegisterForRemoteNotificationsWithDeviceToken:`. - - Parameter deviceToken: Device token data. + @param deviceToken Device token data. */ + (void)setPushNotificationsDeviceToken:(NSData *)deviceToken; @@ -441,7 +558,7 @@ FBSDK_EXTERN NSString *const FBSDKAppEventParameterValueNo; Set the current event flushing behavior specifying when events are sent back to Facebook servers. - - Parameter flushBehavior: The desired `FBSDKAppEventsFlushBehavior` to be used. + @param flushBehavior The desired `FBSDKAppEventsFlushBehavior` to be used. */ + (void)setFlushBehavior:(FBSDKAppEventsFlushBehavior)flushBehavior; @@ -458,7 +575,7 @@ FBSDK_EXTERN NSString *const FBSDKAppEventParameterValueNo; This should be set before any other calls are made to `FBSDKAppEvents`. Thus, you should set it in your application delegate's `application:didFinishLaunchingWithOptions:` delegate. - - Parameter appID: The Facebook App ID to be used for App Event logging. + @param appID The Facebook App ID to be used for App Event logging. */ + (void)setLoggingOverrideAppID:(NSString *)appID; @@ -466,7 +583,7 @@ FBSDK_EXTERN NSString *const FBSDKAppEventParameterValueNo; Get the 'override' App ID for App Event logging. -- See:setLoggingOverrideAppID: +@see setLoggingOverrideAppID: */ + (NSString *)loggingOverrideAppID; @@ -483,7 +600,7 @@ FBSDK_EXTERN NSString *const FBSDKAppEventParameterValueNo; Callers will send this ID back to their own servers, collect up a set to create a Facebook Custom Audience with, and then use the resultant Custom Audience to target ads. - - Parameter accessToken: The access token to use to establish the user's identity for users logged into Facebook through this app. + @param accessToken The access token to use to establish the user's identity for users logged into Facebook through this app. If `nil`, then the `[FBSDKAccessToken currentAccessToken]` is used. @@ -520,12 +637,44 @@ FBSDK_EXTERN NSString *const FBSDKAppEventParameterValueNo; */ + (NSString *)userID; +/* + Sets custom user data to associate with all app events. All user data are hashed + and used to match Facebook user from this instance of an application. + + The user data will be persisted between application instances. + + @param userData user data to identify the user. User data should be formated as + a NSDictionary of data type name and value. + Supported data types and names are: + Email: em + First Name: fn + Last Name: ln + Phone: ph + Date of Birth: db + Gender: ge + City: ct + State: st + Zip: zp + Country: country + */ ++ (void) setUserData:(NSDictionary*)userData; + +/* + Returns the set user data else nil +*/ ++ (NSString*) getUserData; + +/* + Clears the current user data +*/ ++ (void) clearUserData; + /* Sends a request to update the properties for the current user, set by `setUserID:` You must call `FBSDKAppEvents setUserID:` before making this call. - - Parameter properties: the custom user properties - - Parameter handler: the optional completion handler + @param properties the custom user properties + @param handler the optional completion handler */ + (void)updateUserProperties:(NSDictionary *)properties handler:(FBSDKGraphRequestHandler)handler; @@ -537,7 +686,7 @@ FBSDK_EXTERN NSString *const FBSDKAppEventParameterValueNo; then it will detect the presence of this injected JavaScript object and pass Pixel events back to the FB SDK for logging using the AppEvents framework. - - Parameter webView: The webview to augment with the additional JavaScript behaviour + @param webView The webview to augment with the additional JavaScript behaviour */ + (void)augmentHybridWKWebView:(WKWebView *)webView; #endif diff --git a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKAppLinkResolver.h b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKAppLinkResolver.h index c97b6b35d..eee2f5815 100644 --- a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKAppLinkResolver.h +++ b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKAppLinkResolver.h @@ -39,8 +39,8 @@ /** Asynchronously resolves App Link data for a given URL. - - Parameter url: The URL to resolve into an App Link. - - Returns: A BFTask that will return a BFAppLink for the given URL. + @param url The URL to resolve into an App Link. + @return A BFTask that will return a BFAppLink for the given URL. */ - (BFTask *)appLinkFromURLInBackground:(NSURL *)url; @@ -64,8 +64,8 @@ /** Asynchronously resolves App Link data for multiple URLs. - - Parameter urls: An array of NSURLs to resolve into App Links. - - Returns: A BFTask that will return dictionary mapping input NSURLs to their + @param urls An array of NSURLs to resolve into App Links. + @return A BFTask that will return dictionary mapping input NSURLs to their corresponding BFAppLink. diff --git a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKAppLinkUtility.h b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKAppLinkUtility.h index 1cc549a19..c242f290d 100644 --- a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKAppLinkUtility.h +++ b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKAppLinkUtility.h @@ -20,8 +20,8 @@ /** Describes the callback for fetchDeferredAppLink. - - Parameter url: the url representing the deferred App Link - - Parameter error: the error during the request, if any + @param url the url representing the deferred App Link + @param error the error during the request, if any The url may also have a fb_click_time_utc query parameter that @@ -32,7 +32,7 @@ typedef void (^FBSDKDeferredAppLinkHandler)(NSURL *url, NSError *error); /** Describes the callback for fetchOrganicDeferredAppLink. - - Parameter url: the url representing the deferred App Link + @param url the url representing the deferred App Link */ typedef void (^FBSDKDeferredAppInviteHandler)(NSURL *url); @@ -49,7 +49,7 @@ typedef void (^FBSDKDeferredAppInviteHandler)(NSURL *url); data (this will only return a valid URL once, and future calls will result in a nil URL value in the callback). - - Parameter handler: the handler to be invoked if there is deferred App Link data + @param handler the handler to be invoked if there is deferred App Link data The handler may contain an NSError instance to capture any errors. In the @@ -63,7 +63,7 @@ typedef void (^FBSDKDeferredAppInviteHandler)(NSURL *url); /** -- Warning:This method is no longer available and will always return NO. +@warning This method is no longer available and will always return NO. */ + (BOOL)fetchDeferredAppInvite:(FBSDKDeferredAppInviteHandler)handler __attribute__((deprecated("This method is no longer available.")));; @@ -75,9 +75,9 @@ __attribute__((deprecated("This method is no longer available.")));; Note: This throws an exception if Bolts.framework is not linked. Add '[BFURL class]' in intialize method of your AppDelegate. - - Parameter url: App Link url that was passed to the app. + @param url App Link url that was passed to the app. - - Returns: Promotion code string. + @return Promotion code string. Call this method to fetch App Invite Promotion Code from applink if present. diff --git a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKApplicationDelegate.h b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKApplicationDelegate.h index ebaef4d38..c1eca10f7 100644 --- a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKApplicationDelegate.h +++ b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKApplicationDelegate.h @@ -41,15 +41,15 @@ of the AppDelegate for your app. It should be invoked for the proper processing of responses during interaction with the native Facebook app or Safari as part of SSO authorization flow or Facebook dialogs. - - Parameter application: The application as passed to [UIApplicationDelegate application:openURL:sourceApplication:annotation:]. + @param application The application as passed to [UIApplicationDelegate application:openURL:sourceApplication:annotation:]. - - Parameter url: The URL as passed to [UIApplicationDelegate application:openURL:sourceApplication:annotation:]. + @param url The URL as passed to [UIApplicationDelegate application:openURL:sourceApplication:annotation:]. - - Parameter sourceApplication: The sourceApplication as passed to [UIApplicationDelegate application:openURL:sourceApplication:annotation:]. + @param sourceApplication The sourceApplication as passed to [UIApplicationDelegate application:openURL:sourceApplication:annotation:]. - - Parameter annotation: The annotation as passed to [UIApplicationDelegate application:openURL:sourceApplication:annotation:]. + @param annotation The annotation as passed to [UIApplicationDelegate application:openURL:sourceApplication:annotation:]. - - Returns: YES if the url was intended for the Facebook SDK, NO if not. + @return YES if the url was intended for the Facebook SDK, NO if not. */ - (BOOL)application:(UIApplication *)application openURL:(NSURL *)url @@ -62,13 +62,13 @@ of the AppDelegate for your app. It should be invoked for the proper processing of responses during interaction with the native Facebook app or Safari as part of SSO authorization flow or Facebook dialogs. - - Parameter application: The application as passed to [UIApplicationDelegate application:openURL:options:]. + @param application The application as passed to [UIApplicationDelegate application:openURL:options:]. - - Parameter url: The URL as passed to [UIApplicationDelegate application:openURL:options:]. + @param url The URL as passed to [UIApplicationDelegate application:openURL:options:]. - - Parameter options: The options dictionary as passed to [UIApplicationDelegate application:openURL:options:]. + @param options The options dictionary as passed to [UIApplicationDelegate application:openURL:options:]. - - Returns: YES if the url was intended for the Facebook SDK, NO if not. + @return YES if the url was intended for the Facebook SDK, NO if not. */ - (BOOL)application:(UIApplication *)application openURL:(NSURL *)url @@ -81,11 +81,11 @@ As part of SDK initialization basic auto logging of app events will occur, this can be controlled via 'FacebookAutoLogAppEventsEnabled' key in the project info plist file. - - Parameter application: The application as passed to [UIApplicationDelegate application:didFinishLaunchingWithOptions:]. + @param application The application as passed to [UIApplicationDelegate application:didFinishLaunchingWithOptions:]. - - Parameter launchOptions: The launchOptions as passed to [UIApplicationDelegate application:didFinishLaunchingWithOptions:]. + @param launchOptions The launchOptions as passed to [UIApplicationDelegate application:didFinishLaunchingWithOptions:]. - - Returns: YES if the url was intended for the Facebook SDK, NO if not. + @return YES if the url was intended for the Facebook SDK, NO if not. */ - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions; diff --git a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKConstants.h b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKConstants.h index 98cfd73c3..fc2779f95 100644 --- a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKConstants.h +++ b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKConstants.h @@ -111,7 +111,7 @@ typedef NS_ENUM(NSInteger, FBSDKErrorCode) /** -- Warning:use FBSDKBrowserUnavailableErrorCode instead +@warning use FBSDKBrowserUnavailableErrorCode instead */ FBSDKBrowswerUnavailableErrorCode __attribute__ ((deprecated("use FBSDKBrowserUnavailableErrorCode instead"))) = FBSDKBrowserUnavailableErrorCode, }; @@ -207,11 +207,11 @@ FBSDK_EXTERN NSString *const FBSDKGraphRequestErrorParsedJSONResponseKey; /** attempt the recovery - - Parameter error: the error - - Parameter recoveryOptionIndex: the selected option index - - Parameter delegate: the delegate - - Parameter didRecoverSelector: the callback selector, see discussion. - - Parameter contextInfo: context info to pass back to callback selector, see discussion. + @param error the error + @param recoveryOptionIndex the selected option index + @param delegate the delegate + @param didRecoverSelector the callback selector, see discussion. + @param contextInfo context info to pass back to callback selector, see discussion. Given that an error alert has been presented document-modally to the user, and the user has chosen one of the error's recovery options, attempt recovery from the error, and send the selected message to the specified delegate. The option index is an index into the error's array of localized recovery options. The method selected by didRecoverSelector must have the same signature as: diff --git a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKCopying.h b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKCopying.h index c84975ca4..039302bcc 100644 --- a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKCopying.h +++ b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKCopying.h @@ -27,7 +27,7 @@ /** Implemented by NSObject as a convenience to copyWithZone:. - - Returns: A copy of the receiver. + @return A copy of the receiver. */ - (id)copy; diff --git a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKCoreKit.h b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKCoreKit.h index 1a6b94b3f..449a541bd 100644 --- a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKCoreKit.h +++ b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKCoreKit.h @@ -44,5 +44,5 @@ #import #endif -#define FBSDK_VERSION_STRING @"4.35.0" +#define FBSDK_VERSION_STRING @"4.36.0" #define FBSDK_TARGET_PLATFORM_VERSION @"v3.1" diff --git a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKGraphErrorRecoveryProcessor.h b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKGraphErrorRecoveryProcessor.h index 658bc46ee..1fb560e83 100644 --- a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKGraphErrorRecoveryProcessor.h +++ b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKGraphErrorRecoveryProcessor.h @@ -30,17 +30,17 @@ /** Indicates the error recovery has been attempted. - - Parameter processor: the processor instance. - - Parameter didRecover: YES if the recovery was successful. - - Parameter error: the error that that was attempted to be recovered from. + @param processor the processor instance. + @param didRecover YES if the recovery was successful. + @param error the error that that was attempted to be recovered from. */ - (void)processorDidAttemptRecovery:(FBSDKGraphErrorRecoveryProcessor *)processor didRecover:(BOOL)didRecover error:(NSError *)error; @optional /** Indicates the processor is about to process the error. - - Parameter processor: the processor instance. - - Parameter error: the error is about to be processed. + @param processor the processor instance. + @param error the error is about to be processed. return NO if the processor should not process the error. For example, if you want to prevent alerts of localized messages but otherwise perform retries and recoveries, @@ -83,16 +83,16 @@ /** Attempts to process the error, return YES if the error can be processed. - - Parameter error: the error to process. - - Parameter request: the related request that may be reissued. - - Parameter delegate: the delegate that will be retained until recovery is complete. + @param error the error to process. + @param request the related request that may be reissued. + @param delegate the delegate that will be retained until recovery is complete. */ - (BOOL)processError:(NSError *)error request:(FBSDKGraphRequest *)request delegate:(id) delegate; /** The callback for FBSDKErrorRecoveryAttempting - - Parameter didRecover: if the recovery succeeded - - Parameter contextInfo: unused + @param didRecover if the recovery succeeded + @param contextInfo unused */ - (void)didPresentErrorWithRecovery:(BOOL)didRecover contextInfo:(void *)contextInfo; diff --git a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKGraphRequest.h b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKGraphRequest.h index 2743ec3ad..99b1de384 100644 --- a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKGraphRequest.h +++ b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKGraphRequest.h @@ -39,23 +39,23 @@ By default, FBSDKGraphRequest will attempt to recover any errors returned from Facebook. You can disable this via `disableErrorRecovery:`. -- See:FBSDKGraphErrorRecoveryProcessor + @see FBSDKGraphErrorRecoveryProcessor */ @interface FBSDKGraphRequest : NSObject /** Initializes a new instance that use use `[FBSDKAccessToken currentAccessToken]`. - - Parameter graphPath: the graph path (e.g., @"me"). - - Parameter parameters: the optional parameters dictionary. + @param graphPath the graph path (e.g., @"me"). + @param parameters the optional parameters dictionary. */ - (instancetype)initWithGraphPath:(NSString *)graphPath parameters:(NSDictionary *)parameters; /** Initializes a new instance that use use `[FBSDKAccessToken currentAccessToken]`. - - Parameter graphPath: the graph path (e.g., @"me"). - - Parameter parameters: the optional parameters dictionary. - - Parameter HTTPMethod: the optional HTTP method. nil defaults to @"GET". + @param graphPath the graph path (e.g., @"me"). + @param parameters the optional parameters dictionary. + @param HTTPMethod the optional HTTP method. nil defaults to @"GET". */ - (instancetype)initWithGraphPath:(NSString *)graphPath parameters:(NSDictionary *)parameters @@ -63,11 +63,11 @@ /** Initializes a new instance. - - Parameter graphPath: the graph path (e.g., @"me"). - - Parameter parameters: the optional parameters dictionary. - - Parameter tokenString: the token string to use. Specifying nil will cause no token to be used. - - Parameter version: the optional Graph API version (e.g., @"v2.0"). nil defaults to `[FBSDKSettings graphAPIVersion]`. - - Parameter HTTPMethod: the optional HTTP method (e.g., @"POST"). nil defaults to @"GET". + @param graphPath the graph path (e.g., @"me"). + @param parameters the optional parameters dictionary. + @param tokenString the token string to use. Specifying nil will cause no token to be used. + @param version the optional Graph API version (e.g., @"v2.0"). nil defaults to `[FBSDKSettings graphAPIVersion]`. + @param HTTPMethod the optional HTTP method (e.g., @"POST"). nil defaults to @"GET". */ - (instancetype)initWithGraphPath:(NSString *)graphPath parameters:(NSDictionary *)parameters @@ -103,7 +103,7 @@ NS_DESIGNATED_INITIALIZER; /** If set, disables the automatic error recovery mechanism. - - Parameter disable: whether to disable the automatic error recovery mechanism + @param disable whether to disable the automatic error recovery mechanism By default, non-batched FBSDKGraphRequest instances will automatically try to recover from errors by constructing a `FBSDKGraphErrorRecoveryProcessor` instance that @@ -116,7 +116,7 @@ NS_DESIGNATED_INITIALIZER; /** Starts a connection to the Graph API. - - Parameter handler: The handler block to call when the request completes. + @param handler The handler block to call when the request completes. */ - (FBSDKGraphRequestConnection *)startWithCompletionHandler:(FBSDKGraphRequestHandler)handler; diff --git a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKGraphRequestConnection.h b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKGraphRequestConnection.h index 3eca5840f..b8cc0f3b7 100644 --- a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKGraphRequestConnection.h +++ b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKGraphRequestConnection.h @@ -34,13 +34,13 @@ Pass a block of this type when calling addRequest. This will be called once the request completes. The call occurs on the UI thread. - - Parameter connection: The `FBSDKGraphRequestConnection` that sent the request. + @param connection The `FBSDKGraphRequestConnection` that sent the request. - - Parameter result: The result of the request. This is a translation of + @param result The result of the request. This is a translation of JSON data to `NSDictionary` and `NSArray` objects. This is nil if there was an error. - - Parameter error: The `NSError` representing any error that occurred. + @param error The `NSError` representing any error that occurred. */ typedef void (^FBSDKGraphRequestHandler)(FBSDKGraphRequestConnection *connection, @@ -68,7 +68,7 @@ typedef void (^FBSDKGraphRequestHandler)(FBSDKGraphRequestConnection *connection start, the object returned from the convenience method has already begun loading and this method will not be called when the delegate is set. - - Parameter connection: The request connection that is starting a network request + @param connection The request connection that is starting a network request */ - (void)requestConnectionWillBeginLoading:(FBSDKGraphRequestConnection *)connection; @@ -86,7 +86,7 @@ typedef void (^FBSDKGraphRequestHandler)(FBSDKGraphRequestConnection *connection This method is invoked after the completion handler for each . - - Parameter connection: The request connection that successfully completed a network request + @param connection The request connection that successfully completed a network request */ - (void)requestConnectionDidFinishLoading:(FBSDKGraphRequestConnection *)connection; @@ -101,8 +101,8 @@ typedef void (^FBSDKGraphRequestHandler)(FBSDKGraphRequestConnection *connection argument specifies why the network connection failed. The `NSError` object passed to the FBSDKGraphRequestHandler block may contain additional information. - - Parameter connection: The request connection that successfully completed a network request - - Parameter error: The `NSError` representing the network error that occurred, if any. May be nil + @param connection The request connection that successfully completed a network request + @param error The `NSError` representing the network error that occurred, if any. May be nil in some circumstances. Consult the `NSError` for the for reliable failure information. */ @@ -120,10 +120,10 @@ typedef void (^FBSDKGraphRequestHandler)(FBSDKGraphRequestConnection *connection Like `NSURLConnection`, the values may change in unexpected ways if data needs to be resent. - - Parameter connection: The request connection transmitting data to a remote host - - Parameter bytesWritten: The number of bytes sent in the last transmission - - Parameter totalBytesWritten: The total number of bytes sent to the remote host - - Parameter totalBytesExpectedToWrite: The total number of bytes expected to send to the remote host + @param connection The request connection transmitting data to a remote host + @param bytesWritten The number of bytes sent in the last transmission + @param totalBytesWritten The total number of bytes sent to the remote host + @param totalBytesExpectedToWrite The total number of bytes expected to send to the remote host */ - (void)requestConnection:(FBSDKGraphRequestConnection *)connection didSendBodyData:(NSInteger)bytesWritten @@ -177,7 +177,7 @@ totalBytesExpectedToWrite:(NSInteger)totalBytesExpectedToWrite; This method sets the default timeout on all FBSDKGraphRequestConnection instances. Defaults to 60 seconds. - - Parameter defaultConnectionTimeout: The timeout interval. + @param defaultConnectionTimeout The timeout interval. */ + (void)setDefaultConnectionTimeout:(NSTimeInterval)defaultConnectionTimeout; @@ -190,8 +190,8 @@ totalBytesExpectedToWrite:(NSInteger)totalBytesExpectedToWrite; This method adds an object to this connection. - - Parameter request: A request to be included in the round-trip when start is called. - - Parameter handler: A handler to call back when the round-trip completes or times out. + @param request A request to be included in the round-trip when start is called. + @param handler A handler to call back when the round-trip completes or times out. @@ -206,12 +206,12 @@ totalBytesExpectedToWrite:(NSInteger)totalBytesExpectedToWrite; This method adds an object to this connection. - - Parameter request: A request to be included in the round-trip when start is called. + @param request A request to be included in the round-trip when start is called. - - Parameter handler: A handler to call back when the round-trip completes or times out. + @param handler A handler to call back when the round-trip completes or times out. The handler will be invoked on the main thread. - - Parameter name: An optional name for this request. This can be used to feed + @param name An optional name for this request. This can be used to feed the results of one request to the input of another in the same `FBSDKGraphRequestConnection` as described in [Graph API Batch Requests]( https://developers.facebook.com/docs/reference/api/batch/ ). @@ -231,11 +231,11 @@ totalBytesExpectedToWrite:(NSInteger)totalBytesExpectedToWrite; This method adds an object to this connection. - - Parameter request: A request to be included in the round-trip when start is called. + @param request A request to be included in the round-trip when start is called. - - Parameter handler: A handler to call back when the round-trip completes or times out. + @param handler A handler to call back when the round-trip completes or times out. - - Parameter batchParameters: The optional dictionary of parameters to include for this request + @param batchParameters The optional dictionary of parameters to include for this request as described in [Graph API Batch Requests]( https://developers.facebook.com/docs/reference/api/batch/ ). Examples include "depends_on", "name", or "omit_response_on_success". @@ -285,7 +285,7 @@ totalBytesExpectedToWrite:(NSInteger)totalBytesExpectedToWrite; /** Determines the operation queue that is used to call methods on the connection's delegate. - - Parameter queue: The operation queue to use when calling delegate methods. + @param queue The operation queue to use when calling delegate methods. By default, a connection is scheduled on the current thread in the default mode when it is created. You cannot reschedule a connection after it has started. @@ -305,7 +305,7 @@ totalBytesExpectedToWrite:(NSInteger)totalBytesExpectedToWrite; for applications. If you want to override the version part while using batch requests on the connection, call this method to set the version for the batch request. - - Parameter version: This is a string in the form @"v2.0" which will be used for the version part of an API path + @param version This is a string in the form @"v2.0" which will be used for the version part of an API path */ - (void)overrideVersionPartWith:(NSString *)version; diff --git a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKGraphRequestDataAttachment.h b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKGraphRequestDataAttachment.h index edf0f7815..17a10dfff 100644 --- a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKGraphRequestDataAttachment.h +++ b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKGraphRequestDataAttachment.h @@ -25,9 +25,9 @@ /** Initializes the receiver with the attachment data and metadata. - - Parameter data: The attachment data (retained, not copied) - - Parameter filename: The filename for the attachment - - Parameter contentType: The content type for the attachment + @param data The attachment data (retained, not copied) + @param filename The filename for the attachment + @param contentType The content type for the attachment */ - (instancetype)initWithData:(NSData *)data filename:(NSString *)filename diff --git a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKMutableCopying.h b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKMutableCopying.h index 1b351dbdf..3fada941d 100644 --- a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKMutableCopying.h +++ b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKMutableCopying.h @@ -29,7 +29,7 @@ /** Implemented by NSObject as a convenience to mutableCopyWithZone:. - - Returns: A mutable copy of the receiver. + @return A mutable copy of the receiver. */ - (id)mutableCopy; diff --git a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKProfile.h b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKProfile.h index 1f33f1689..2c1ec263f 100644 --- a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKProfile.h +++ b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKProfile.h @@ -56,13 +56,13 @@ FBSDK_EXTERN NSString *const FBSDKProfileChangeNewKey; /** initializes a new instance. - - Parameter userID: the user ID - - Parameter firstName: the user's first name - - Parameter middleName: the user's middle name - - Parameter lastName: the user's last name - - Parameter name: the user's complete name - - Parameter linkURL: the link for this profile - - Parameter refreshDate: the optional date this profile was fetched. Defaults to [NSDate date]. + @param userID the user ID + @param firstName the user's first name + @param middleName the user's middle name + @param lastName the user's last name + @param name the user's complete name + @param linkURL the link for this profile + @param refreshDate the optional date this profile was fetched. Defaults to [NSDate date]. */ - (instancetype)initWithUserID:(NSString *)userID firstName:(NSString *)firstName @@ -112,7 +112,7 @@ FBSDK_EXTERN NSString *const FBSDKProfileChangeNewKey; /** Sets the current instance and posts the appropriate notification if the profile parameter is different than the receiver. - - Parameter profile: the profile to set + @param profile the profile to set This persists the profile to NSUserDefaults. */ @@ -120,7 +120,7 @@ FBSDK_EXTERN NSString *const FBSDKProfileChangeNewKey; /** Indicates if `currentProfile` will automatically observe `FBSDKAccessTokenDidChangeNotification` notifications - - Parameter enable: YES is observing + @param enable YES is observing If observing, this class will issue a graph request for public profile data when the current token's userID differs from the current profile. You can observe `FBSDKProfileDidChangeNotification` for when the profile is updated. @@ -132,7 +132,7 @@ FBSDK_EXTERN NSString *const FBSDKProfileChangeNewKey; /** Loads the current profile and passes it to the completion block. - - Parameter completion: The block to be executed once the profile is loaded + @param completion The block to be executed once the profile is loaded If the profile is already loaded, this method will call the completion block synchronously, otherwise it will begin a graph request to update `currentProfile` and then call the completion block when finished. @@ -141,26 +141,26 @@ FBSDK_EXTERN NSString *const FBSDKProfileChangeNewKey; /** A convenience method for returning a complete `NSURL` for retrieving the user's profile image. - - Parameter mode: The picture mode - - Parameter size: The height and width. This will be rounded to integer precision. + @param mode The picture mode + @param size The height and width. This will be rounded to integer precision. */ - (NSURL *)imageURLForPictureMode:(FBSDKProfilePictureMode)mode size:(CGSize)size; /** A convenience method for returning a Graph API path for retrieving the user's profile image. -- Warning:use `imageURLForPictureMode:size:` instead +@warning use `imageURLForPictureMode:size:` instead You can pass this to a `FBSDKGraphRequest` instance to download the image. - - Parameter mode: The picture mode - - Parameter size: The height and width. This will be rounded to integer precision. + @param mode The picture mode + @param size The height and width. This will be rounded to integer precision. */ - (NSString *)imagePathForPictureMode:(FBSDKProfilePictureMode)mode size:(CGSize)size __attribute__ ((deprecated("use imageURLForPictureMode:size: instead"))); /** Returns YES if the profile is equivalent to the receiver. - - Parameter profile: the profile to compare to. + @param profile the profile to compare to. */ - (BOOL)isEqualToProfile:(FBSDKProfile *)profile; @end diff --git a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKSettings.h b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKSettings.h index c4e072eea..f854710b7 100644 --- a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKSettings.h +++ b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKSettings.h @@ -67,7 +67,7 @@ FBSDK_EXTERN NSString *const FBSDKLoggingBehaviorDeveloperErrors; /** Set the Facebook App ID to be used by the SDK. - - Parameter appID: The Facebook App ID to be used by the SDK. + @param appID The Facebook App ID to be used by the SDK. */ + (void)setAppID:(NSString *)appID; @@ -80,7 +80,7 @@ FBSDK_EXTERN NSString *const FBSDKLoggingBehaviorDeveloperErrors; /** Set the app url scheme suffix used by the SDK. - - Parameter appURLSchemeSuffix: The url scheme suffix to be used by the SDK. + @param appURLSchemeSuffix The url scheme suffix to be used by the SDK. */ + (void)setAppURLSchemeSuffix:(NSString *)appURLSchemeSuffix; @@ -95,14 +95,14 @@ FBSDK_EXTERN NSString *const FBSDKLoggingBehaviorDeveloperErrors; Sets the Client Token for the Facebook App. This is needed for certain API calls when made anonymously, without a user-based access token. - - Parameter clientToken: The Facebook App's "client token", which, for a given appid can be found in the Security + @param clientToken The Facebook App's "client token", which, for a given appid can be found in the Security section of the Advanced tab of the Facebook App settings found at */ + (void)setClientToken:(NSString *)clientToken; /** A convenient way to toggle error recovery for all FBSDKGraphRequest instances created after this is set. - - Parameter disableGraphErrorRecovery: YES or NO. + @param disableGraphErrorRecovery YES or NO. */ + (void)setGraphErrorRecoveryDisabled:(BOOL)disableGraphErrorRecovery; @@ -118,7 +118,7 @@ FBSDK_EXTERN NSString *const FBSDKLoggingBehaviorDeveloperErrors; This should match the Display Name that has been set for the app with the corresponding Facebook App ID, in the Facebook App Dashboard. - - Parameter displayName: The Facebook Display Name to be used by the SDK. + @param displayName The Facebook Display Name to be used by the SDK. */ + (void)setDisplayName:(NSString *)displayName; @@ -134,7 +134,7 @@ FBSDK_EXTERN NSString *const FBSDKLoggingBehaviorDeveloperErrors; This can be used to change the Facebook domain (e.g. @"beta") so that requests will be sent to graph.beta.facebook.com - - Parameter facebookDomainPart: The domain part to be inserted into facebook.com. + @param facebookDomainPart The domain part to be inserted into facebook.com. */ + (void)setFacebookDomainPart:(NSString *)facebookDomainPart; @@ -143,14 +143,14 @@ FBSDK_EXTERN NSString *const FBSDKLoggingBehaviorDeveloperErrors; If not explicitly set, the default is 0.9. -- See:[UIImageJPEGRepresentation](https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIKitFunctionReference/#//apple_ref/c/func/UIImageJPEGRepresentation) */ + @see [UIImageJPEGRepresentation](https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIKitFunctionReference/#//apple_ref/c/func/UIImageJPEGRepresentation) */ + (CGFloat)JPEGCompressionQuality; /** Set the quality of JPEG images sent to Facebook from the SDK. - - Parameter JPEGCompressionQuality: The quality for JPEG images, expressed as a value from 0.0 to 1.0. + @param JPEGCompressionQuality The quality for JPEG images, expressed as a value from 0.0 to 1.0. -- See:[UIImageJPEGRepresentation](https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIKitFunctionReference/#//apple_ref/c/func/UIImageJPEGRepresentation) */ + @see [UIImageJPEGRepresentation](https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIKitFunctionReference/#//apple_ref/c/func/UIImageJPEGRepresentation) */ + (void)setJPEGCompressionQuality:(CGFloat)JPEGCompressionQuality; /** @@ -161,7 +161,7 @@ FBSDK_EXTERN NSString *const FBSDKLoggingBehaviorDeveloperErrors; /** Set the flag which controls the auto logging of basic app events, such as activateApp and deactivateApp. - - Parameter AutoLogAppEventsEnabled: Flag value, expressed as a value from 0 - false or 1 - true. + @param AutoLogAppEventsEnabled Flag value, expressed as a value from 0 - false or 1 - true. */ + (void)setAutoLogAppEventsEnabled:(NSNumber *)AutoLogAppEventsEnabled; @@ -173,7 +173,7 @@ FBSDK_EXTERN NSString *const FBSDKLoggingBehaviorDeveloperErrors; /** Set the flag which controls the fb_codeless_debug logging event - - Parameter CodelessDebugEnabled: Flag value, expressed as a value from 0 - false or 1 - true. + @param CodelessDebugLogEnabled Flag value, expressed as a value from 0 - false or 1 - true. */ + (void)setCodelessDebugLogEnabled:(NSNumber *)CodelessDebugLogEnabled; @@ -185,7 +185,7 @@ FBSDK_EXTERN NSString *const FBSDKLoggingBehaviorDeveloperErrors; /** Sets whether data such as that generated through FBSDKAppEvents and sent to Facebook should be restricted from being used for other than analytics and conversions. Defaults to NO. This value is stored on the device and persists across app launches. - - Parameter limitEventAndDataUsage: The desired value. + @param limitEventAndDataUsage The desired value. */ + (void)setLimitEventAndDataUsage:(BOOL)limitEventAndDataUsage; @@ -203,7 +203,7 @@ FBSDK_EXTERN NSString *const FBSDKLoggingBehaviorDeveloperErrors; Set the current Facebook SDK logging behavior. This should consist of strings defined as constants with FBSDKLoggingBehavior*. - - Parameter loggingBehavior: A set of strings indicating what information should be logged. If nil is provided, the logging + @param loggingBehavior A set of strings indicating what information should be logged. If nil is provided, the logging behavior is reset to the default set of enabled behaviors. Set to an empty set in order to disable all logging. @@ -214,21 +214,21 @@ FBSDK_EXTERN NSString *const FBSDKLoggingBehaviorDeveloperErrors; /** Enable a particular Facebook SDK logging behavior. - - Parameter loggingBehavior: The LoggingBehavior to enable. This should be a string defined as a constant with FBSDKLoggingBehavior*. + @param loggingBehavior The LoggingBehavior to enable. This should be a string defined as a constant with FBSDKLoggingBehavior*. */ + (void)enableLoggingBehavior:(NSString *)loggingBehavior; /** Disable a particular Facebook SDK logging behavior. - - Parameter loggingBehavior: The LoggingBehavior to disable. This should be a string defined as a constant with FBSDKLoggingBehavior*. + @param loggingBehavior The LoggingBehavior to disable. This should be a string defined as a constant with FBSDKLoggingBehavior*. */ + (void)disableLoggingBehavior:(NSString *)loggingBehavior; /** Set the user defaults key used by legacy token caches. - - Parameter tokenInformationKeyName: the key used by legacy token caches. + @param tokenInformationKeyName the key used by legacy token caches. Use this only if you customized FBSessionTokenCachingStrategy in v3.x of diff --git a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKTestUsersManager.h b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKTestUsersManager.h index 3be95297e..17a5ea538 100644 --- a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKTestUsersManager.h +++ b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKTestUsersManager.h @@ -50,20 +50,20 @@ typedef void (^FBSDKTestUsersManagerRemoveTestAccountHandler)(NSError *error) ; /** construct or return the shared instance - - Parameter appID: the Facebook app id - - Parameter appSecret: the Facebook app secret + @param appID the Facebook app id + @param appSecret the Facebook app secret */ + (instancetype)sharedInstanceForAppID:(NSString *)appID appSecret:(NSString *)appSecret; /** retrieve FBSDKAccessToken instances for test accounts with the specific permissions. - - Parameter arraysOfPermissions: an array of permissions sets, such as @[ [NSSet setWithObject:@"email"], [NSSet setWithObject:@"user_birthday"]] + @param arraysOfPermissions an array of permissions sets, such as @[ [NSSet setWithObject:@"email"], [NSSet setWithObject:@"user_birthday"]] if you needed two test accounts with email and birthday permissions, respectively. You can pass in empty nested sets if you need two arbitrary test accounts. For convenience, passing nil is treated as @[ [NSSet set] ] for fetching a single test user. - - Parameter createIfNotFound: if YES, new test accounts are created if no test accounts existed that fit the permissions + @param createIfNotFound if YES, new test accounts are created if no test accounts existed that fit the permissions requirement - - Parameter handler: the callback to invoke which will return an array of `FBAccessTokenData` instances or an `NSError`. + @param handler the callback to invoke which will return an array of `FBAccessTokenData` instances or an `NSError`. If param `createIfNotFound` is NO, the array may contain `[NSNull null]` instances. @@ -77,24 +77,24 @@ typedef void (^FBSDKTestUsersManagerRemoveTestAccountHandler)(NSError *error) ; /** add a test account with the specified permissions - - Parameter permissions: the set of permissions, e.g., [NSSet setWithObjects:@"email", @"user_friends"] - - Parameter handler: the callback handler + @param permissions the set of permissions, e.g., [NSSet setWithObjects:@"email", @"user_friends"] + @param handler the callback handler */ - (void)addTestAccountWithPermissions:(NSSet *)permissions completionHandler:(FBSDKTestUsersManagerRetrieveTestAccountTokensHandler)handler; /** remove a test account for the given user id - - Parameter userId: the user id - - Parameter handler: the callback handler + @param userId the user id + @param handler the callback handler */ - (void)removeTestAccount:(NSString *)userId completionHandler:(FBSDKTestUsersManagerRemoveTestAccountHandler)handler; /** Make two test users friends with each other. - - Parameter first: the token of the first user - - Parameter second: the token of the second user - - Parameter callback: the callback handler + @param first the token of the first user + @param second the token of the second user + @param callback the callback handler */ - (void)makeFriendsWithFirst:(FBSDKAccessToken *)first second:(FBSDKAccessToken *)second callback:(void (^)(NSError *))callback; diff --git a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKUtility.h b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKUtility.h index abd0efa9d..5a7fdff61 100644 --- a/src/ios/FBSDKCoreKit.framework/Headers/FBSDKUtility.h +++ b/src/ios/FBSDKCoreKit.framework/Headers/FBSDKUtility.h @@ -25,45 +25,52 @@ /** Parses a query string into a dictionary. - - Parameter queryString: The query string value. - - Returns: A dictionary with the key/value pairs. + @param queryString The query string value. + @return A dictionary with the key/value pairs. */ + (NSDictionary *)dictionaryWithQueryString:(NSString *)queryString; /** Constructs a query string from a dictionary. - - Parameter dictionary: The dictionary with key/value pairs for the query string. - - Parameter errorRef: If an error occurs, upon return contains an NSError object that describes the problem. - - Returns: Query string representation of the parameters. + @param dictionary The dictionary with key/value pairs for the query string. + @param errorRef If an error occurs, upon return contains an NSError object that describes the problem. + @return Query string representation of the parameters. */ + (NSString *)queryStringWithDictionary:(NSDictionary *)dictionary error:(NSError *__autoreleasing *)errorRef; /** Decodes a value from an URL. - - Parameter value: The value to decode. - - Returns: The decoded value. + @param value The value to decode. + @return The decoded value. */ + (NSString *)URLDecode:(NSString *)value; /** Encodes a value for an URL. - - Parameter value: The value to encode. - - Returns: The encoded value. + @param value The value to encode. + @return The encoded value. */ + (NSString *)URLEncode:(NSString *)value; /** Creates a timer using Grand Central Dispatch. - - Parameter interval: The interval to fire the timer, in seconds. - - Parameter block: The code block to execute when timer is fired. - - Returns: The dispatch handle. + @param interval The interval to fire the timer, in seconds. + @param block The code block to execute when timer is fired. + @return The dispatch handle. */ + (dispatch_source_t)startGCDTimerWithInterval:(double)interval block:(dispatch_block_t)block; /** Stop a timer that was started by startGCDTimerWithInterval. - - Parameter timer: The dispatch handle received from startGCDTimerWithInterval. + @param timer The dispatch handle received from startGCDTimerWithInterval. */ + (void)stopGCDTimer:(dispatch_source_t)timer; +/** + Get SHA256 hased string of NSString/NSData + + @param input The data that needs to be hashed, it could be NSString or NSData. + */ ++ (NSString *)SHA256Hash:(NSObject *)input; + @end diff --git a/src/ios/FBSDKCoreKit.framework/Info.plist b/src/ios/FBSDKCoreKit.framework/Info.plist index 5b8569722..2237cc96f 100644 Binary files a/src/ios/FBSDKCoreKit.framework/Info.plist and b/src/ios/FBSDKCoreKit.framework/Info.plist differ diff --git a/src/ios/FBSDKLoginKit.framework/FBSDKLoginKit b/src/ios/FBSDKLoginKit.framework/FBSDKLoginKit index b93752e77..f37c8e41c 100644 Binary files a/src/ios/FBSDKLoginKit.framework/FBSDKLoginKit and b/src/ios/FBSDKLoginKit.framework/FBSDKLoginKit differ diff --git a/src/ios/FBSDKLoginKit.framework/Headers/FBSDKLoginButton.h b/src/ios/FBSDKLoginKit.framework/Headers/FBSDKLoginButton.h index adc7b9b09..1b8ed2985 100644 --- a/src/ios/FBSDKLoginKit.framework/Headers/FBSDKLoginButton.h +++ b/src/ios/FBSDKLoginKit.framework/Headers/FBSDKLoginButton.h @@ -106,9 +106,9 @@ typedef NS_ENUM(NSUInteger, FBSDKLoginButtonTooltipBehavior) @required /** Sent to the delegate when the button was used to login. - - Parameter loginButton: the sender - - Parameter result: The results of the login - - Parameter error: The error (if any) from the login + @param loginButton the sender + @param result The results of the login + @param error The error (if any) from the login */ - (void)loginButton:(FBSDKLoginButton *)loginButton didCompleteWithResult:(FBSDKLoginManagerLoginResult *)result @@ -116,15 +116,15 @@ didCompleteWithResult:(FBSDKLoginManagerLoginResult *)result /** Sent to the delegate when the button was used to logout. - - Parameter loginButton: The button that was clicked. + @param loginButton The button that was clicked. */ - (void)loginButtonDidLogOut:(FBSDKLoginButton *)loginButton; @optional /** Sent to the delegate when the button is about to login. - - Parameter loginButton: the sender - - Returns: YES if the login should be allowed to proceed, NO otherwise + @param loginButton the sender + @return YES if the login should be allowed to proceed, NO otherwise */ - (BOOL) loginButtonWillLogin:(FBSDKLoginButton *)loginButton; diff --git a/src/ios/FBSDKLoginKit.framework/Headers/FBSDKLoginManager.h b/src/ios/FBSDKLoginKit.framework/Headers/FBSDKLoginManager.h index 258303e8a..c33ffcb0e 100644 --- a/src/ios/FBSDKLoginKit.framework/Headers/FBSDKLoginManager.h +++ b/src/ios/FBSDKLoginKit.framework/Headers/FBSDKLoginManager.h @@ -24,8 +24,8 @@ /** Describes the call back to the FBSDKLoginManager - - Parameter result: the result of the authorization - - Parameter error: the authorization error, if any. + @param result the result of the authorization + @param error the authorization error, if any. */ typedef void (^FBSDKLoginManagerRequestTokenHandler)(FBSDKLoginManagerLoginResult *result, NSError *error); @@ -128,25 +128,25 @@ typedef NS_ENUM(NSUInteger, FBSDKLoginBehavior) /** -- Warning:use logInWithReadPermissions:fromViewController:handler: instead +@warning use logInWithReadPermissions:fromViewController:handler: instead */ - (void)logInWithReadPermissions:(NSArray *)permissions handler:(FBSDKLoginManagerRequestTokenHandler)handler __attribute__ ((deprecated("use logInWithReadPermissions:fromViewController:handler: instead"))); /** -- Warning:use logInWithPublishPermissions:fromViewController:handler: instead +@warning use logInWithPublishPermissions:fromViewController:handler: instead */ - (void)logInWithPublishPermissions:(NSArray *)permissions handler:(FBSDKLoginManagerRequestTokenHandler)handler __attribute__ ((deprecated("use logInWithPublishPermissions:fromViewController:handler: instead"))); /** Logs the user in or authorizes additional permissions. - - Parameter permissions: the optional array of permissions. Note this is converted to NSSet and is only + @param permissions the optional array of permissions. Note this is converted to NSSet and is only an NSArray for the convenience of literal syntax. - - Parameter fromViewController: the view controller to present from. If nil, the topmost view controller will be + @param fromViewController the view controller to present from. If nil, the topmost view controller will be automatically determined as best as possible. - - Parameter handler: the callback. + @param handler the callback. Use this method when asking for read permissions. You should only ask for permissions when they are needed and explain the value to the user. You can inspect the result.declinedPermissions to also @@ -164,11 +164,11 @@ __attribute__ ((deprecated("use logInWithPublishPermissions:fromViewController:h /** Logs the user in or authorizes additional permissions. - - Parameter permissions: the optional array of permissions. Note this is converted to NSSet and is only + @param permissions the optional array of permissions. Note this is converted to NSSet and is only an NSArray for the convenience of literal syntax. - - Parameter fromViewController: the view controller to present from. If nil, the topmost view controller will be + @param fromViewController the view controller to present from. If nil, the topmost view controller will be automatically determined as best as possible. - - Parameter handler: the callback. + @param handler the callback. Use this method when asking for publish permissions. You should only ask for permissions when they are needed and explain the value to the user. You can inspect the result.declinedPermissions to also @@ -196,7 +196,7 @@ __attribute__ ((deprecated("use logInWithPublishPermissions:fromViewController:h Issues an asynchronous renewCredentialsForAccount call to the device's Facebook account store. - - Parameter handler: The completion handler to call when the renewal is completed. This can be invoked on an arbitrary thread. + @param handler The completion handler to call when the renewal is completed. This can be invoked on an arbitrary thread. This can be used to explicitly renew account credentials and is provided as a convenience wrapper around diff --git a/src/ios/FBSDKLoginKit.framework/Headers/FBSDKLoginManagerLoginResult.h b/src/ios/FBSDKLoginKit.framework/Headers/FBSDKLoginManagerLoginResult.h index 6148a0754..edd7be6e4 100644 --- a/src/ios/FBSDKLoginKit.framework/Headers/FBSDKLoginManagerLoginResult.h +++ b/src/ios/FBSDKLoginKit.framework/Headers/FBSDKLoginManagerLoginResult.h @@ -51,10 +51,10 @@ /** Initializes a new instance. - - Parameter token: the access token - - Parameter isCancelled: whether the login was cancelled by the user - - Parameter grantedPermissions: the set of granted permissions - - Parameter declinedPermissions: the set of declined permissions + @param token the access token + @param isCancelled whether the login was cancelled by the user + @param grantedPermissions the set of granted permissions + @param declinedPermissions the set of declined permissions */ - (instancetype)initWithToken:(FBSDKAccessToken *)token isCancelled:(BOOL)isCancelled diff --git a/src/ios/FBSDKLoginKit.framework/Headers/FBSDKLoginTooltipView.h b/src/ios/FBSDKLoginKit.framework/Headers/FBSDKLoginTooltipView.h index ad2c9d504..179219710 100644 --- a/src/ios/FBSDKLoginKit.framework/Headers/FBSDKLoginTooltipView.h +++ b/src/ios/FBSDKLoginKit.framework/Headers/FBSDKLoginTooltipView.h @@ -61,8 +61,8 @@ /** Asks the delegate if the tooltip view should appear - - Parameter view: The tooltip view. - - Parameter appIsEligible: The value fetched from the server identifying if the app + @param view The tooltip view. + @param appIsEligible The value fetched from the server identifying if the app is eligible for the new login experience. @@ -74,7 +74,7 @@ Tells the delegate the tooltip view will appear, specifically after it's been added to the super view but before the fade in animation. - - Parameter view: The tooltip view. + @param view The tooltip view. */ - (void)loginTooltipViewWillAppear:(FBSDKLoginTooltipView *)view; @@ -82,7 +82,7 @@ Tells the delegate the tooltip view will not appear (i.e., was not added to the super view). - - Parameter view: The tooltip view. + @param view The tooltip view. */ - (void)loginTooltipViewWillNotAppear:(FBSDKLoginTooltipView *)view; diff --git a/src/ios/FBSDKLoginKit.framework/Headers/FBSDKTooltipView.h b/src/ios/FBSDKLoginKit.framework/Headers/FBSDKTooltipView.h index 604c840c8..d77392cfd 100644 --- a/src/ios/FBSDKLoginKit.framework/Headers/FBSDKTooltipView.h +++ b/src/ios/FBSDKLoginKit.framework/Headers/FBSDKTooltipView.h @@ -81,18 +81,18 @@ typedef NS_ENUM(NSUInteger, FBSDKTooltipColorStyle) /** Designated initializer. - - Parameter tagline: First part of the label, that will be highlighted with different color. Can be nil. + @param tagline First part of the label, that will be highlighted with different color. Can be nil. - - Parameter message: Main message to display. + @param message Main message to display. - - Parameter colorStyle: Color style to use for tooltip. + @param colorStyle Color style to use for tooltip. If you need to show a tooltip for login, consider using the `FBSDKLoginTooltipView` view. -- See:FBSDKLoginTooltipView + @see FBSDKLoginTooltipView */ - (instancetype)initWithTagline:(NSString *)tagline message:(NSString *)message colorStyle:(FBSDKTooltipColorStyle)colorStyle; @@ -100,7 +100,7 @@ typedef NS_ENUM(NSUInteger, FBSDKTooltipColorStyle) Show tooltip at the top or at the bottom of given view. Tooltip will be added to anchorView.window.rootViewController.view - - Parameter anchorView: view to show at, must be already added to window view hierarchy, in order to decide + @param anchorView view to show at, must be already added to window view hierarchy, in order to decide where tooltip will be shown. (If there's not enough space at the top of the anchorView in window bounds - tooltip will be shown at the bottom of it) @@ -115,11 +115,11 @@ typedef NS_ENUM(NSUInteger, FBSDKTooltipColorStyle) /** Adds tooltip to given view, with given position and arrow direction. - - Parameter view: View to be used as superview. + @param view View to be used as superview. - - Parameter arrowPosition: Point in view's cordinates, where arrow will be pointing + @param arrowPosition Point in view's cordinates, where arrow will be pointing - - Parameter arrowDirection: whenever arrow should be pointing up (message bubble is below the arrow) or + @param arrowDirection whenever arrow should be pointing up (message bubble is below the arrow) or down (message bubble is above the arrow). */ - (void)presentInView:(UIView *)view withArrowPosition:(CGPoint)arrowPosition direction:(FBSDKTooltipViewArrowDirection)arrowDirection; diff --git a/src/ios/FBSDKLoginKit.framework/Info.plist b/src/ios/FBSDKLoginKit.framework/Info.plist index f6e38c1b9..9f46a08c4 100644 Binary files a/src/ios/FBSDKLoginKit.framework/Info.plist and b/src/ios/FBSDKLoginKit.framework/Info.plist differ diff --git a/src/ios/FBSDKMessengerShareKit.framework/FBSDKMessengerShareKit b/src/ios/FBSDKMessengerShareKit.framework/FBSDKMessengerShareKit index 6982b53cc..bfdbf28f3 100644 Binary files a/src/ios/FBSDKMessengerShareKit.framework/FBSDKMessengerShareKit and b/src/ios/FBSDKMessengerShareKit.framework/FBSDKMessengerShareKit differ diff --git a/src/ios/FBSDKMessengerShareKit.framework/Headers/FBSDKMessengerButton.h b/src/ios/FBSDKMessengerShareKit.framework/Headers/FBSDKMessengerButton.h index 59d545bd4..d4db6ba46 100644 --- a/src/ios/FBSDKMessengerShareKit.framework/Headers/FBSDKMessengerButton.h +++ b/src/ios/FBSDKMessengerShareKit.framework/Headers/FBSDKMessengerButton.h @@ -36,7 +36,7 @@ typedef NS_ENUM(NSUInteger, FBSDKMessengerShareButtonStyle) { /** Returns a rounded rectangular UIButton customized for sharing to Messenger - - Parameter style: Specifies how the button should look + @param style Specifies how the button should look @@ -53,8 +53,8 @@ typedef NS_ENUM(NSUInteger, FBSDKMessengerShareButtonStyle) { /** Returns a circular UIButton customized for sharing to Messenger - - Parameter style: Specifies how the button should look - - Parameter width: The desired frame width (and height) of this button. + @param style Specifies how the button should look + @param width The desired frame width (and height) of this button. @@ -67,7 +67,7 @@ typedef NS_ENUM(NSUInteger, FBSDKMessengerShareButtonStyle) { /** Returns a circular UIButton customized for sharing to Messenger of default size - - Parameter style: Specifies how the button should look + @param style Specifies how the button should look */ + (UIButton *)circularButtonWithStyle:(FBSDKMessengerShareButtonStyle)style; diff --git a/src/ios/FBSDKMessengerShareKit.framework/Headers/FBSDKMessengerSharer.h b/src/ios/FBSDKMessengerShareKit.framework/Headers/FBSDKMessengerSharer.h index 753159281..f7fc11e20 100644 --- a/src/ios/FBSDKMessengerShareKit.framework/Headers/FBSDKMessengerSharer.h +++ b/src/ios/FBSDKMessengerShareKit.framework/Headers/FBSDKMessengerSharer.h @@ -65,9 +65,9 @@ typedef NS_OPTIONS(NSUInteger, FBSDKMessengerPlatformCapability) Before sharing any media, first use this bitmask to check to see if it can be shared to Messenger -- Warning: This method is deprecated as of iOS 9 +@warning This method is deprecated as of iOS 9 - - Returns: bitmask of the Messenger capabilities + @return bitmask of the Messenger capabilities */ + (FBSDKMessengerPlatformCapability)messengerPlatformCapabilities __attribute__ ((deprecated("This is deprecated as of iOS 9. If you use this, you must configure your plist as described in https://developers.facebook.com/docs/ios/ios9"))); @@ -80,12 +80,12 @@ typedef NS_OPTIONS(NSUInteger, FBSDKMessengerPlatformCapability) Call this method to open Messenger and share an image. -- Warning: use shareImage:withOptions: instead +@warning use shareImage:withOptions: instead - - Parameter image: The image to be shared in Messenger - - Parameter metadata: Additional optional information to be sent to Messenger which is sent back to + @param image The image to be shared in Messenger + @param metadata Additional optional information to be sent to Messenger which is sent back to the user's app when they reply to an attributed message. This may be nil. - - Parameter context: The way the content is to be shared in Messenger. If nil, a standard share will take place. + @param context The way the content is to be shared in Messenger. If nil, a standard share will take place. If there is not an installed version of Messenger on the device that supports the share, an alert will be presented to notify the user. @@ -97,8 +97,8 @@ typedef NS_OPTIONS(NSUInteger, FBSDKMessengerPlatformCapability) /** Call this method to open Messenger and share an image. - - Parameter image: The image to be shared in Messenger - - Parameter options: Additional optional parameters that affect the way the content is shared + @param image The image to be shared in Messenger + @param options Additional optional parameters that affect the way the content is shared If there is not an installed version of Messenger on the device that supports the share, an alert will be presented to notify the user. @@ -109,12 +109,12 @@ typedef NS_OPTIONS(NSUInteger, FBSDKMessengerPlatformCapability) Call this method to open Messenger and share an animated GIF. -- Warning: use shareAnimatedGIF:withOptions: instead +@warning use shareAnimatedGIF:withOptions: instead - - Parameter animatedGIFData: The animated GIF to be shared in Messenger - - Parameter metadata: Additional optional information to be sent to Messenger which is sent back to + @param animatedGIFData The animated GIF to be shared in Messenger + @param metadata Additional optional information to be sent to Messenger which is sent back to the user's app when they reply to an attributed message. This may be nil. - - Parameter context: The way the content is to be shared in Messenger. If nil, a standard share will take place. + @param context The way the content is to be shared in Messenger. If nil, a standard share will take place. If there is not an installed version of Messenger on the device that supports the share, an alert will be presented to notify the user. @@ -126,8 +126,8 @@ typedef NS_OPTIONS(NSUInteger, FBSDKMessengerPlatformCapability) /** Call this method to open Messenger and share an animated GIF. - - Parameter animatedGIFData: The animated GIF to be shared in Messenger - - Parameter options: Additional optional parameters that affect the way the content is shared + @param animatedGIFData The animated GIF to be shared in Messenger + @param options Additional optional parameters that affect the way the content is shared If there is not an installed version of Messenger on the device that supports the share, an alert will be presented to notify the user. @@ -138,12 +138,12 @@ typedef NS_OPTIONS(NSUInteger, FBSDKMessengerPlatformCapability) Call this method to open Messenger and share an animated GIF. -- Warning: use shareAnimatedWebP:withOptions: instead +@warning use shareAnimatedWebP:withOptions: instead - - Parameter animatedWebPData: The animated WebP image to be shared in Messenger - - Parameter metadata: Additional optional information to be sent to Messenger which is sent back to + @param animatedWebPData The animated WebP image to be shared in Messenger + @param metadata Additional optional information to be sent to Messenger which is sent back to the user's app when they reply to an attributed message. This may be nil. - - Parameter context: The way the content is to be shared in Messenger. If nil, a standard share will take place. + @param context The way the content is to be shared in Messenger. If nil, a standard share will take place. If there is not an installed version of Messenger on the device that supports the share, an alert will be presented to notify the user. @@ -155,8 +155,8 @@ typedef NS_OPTIONS(NSUInteger, FBSDKMessengerPlatformCapability) /** Call this method to open Messenger and share an animated GIF. - - Parameter animatedWebPData: The animated WebP image to be shared in Messenger - - Parameter options: Additional optional parameters that affect the way the content is shared + @param animatedWebPData The animated WebP image to be shared in Messenger + @param options Additional optional parameters that affect the way the content is shared If there is not an installed version of Messenger on the device that supports the share, an alert will be presented to notify the user. @@ -167,7 +167,7 @@ typedef NS_OPTIONS(NSUInteger, FBSDKMessengerPlatformCapability) Call this method to open Messenger and share a video. -- Warning: use shareVideo:withOptions: instead +@warning use shareVideo:withOptions: instead @@ -175,10 +175,10 @@ typedef NS_OPTIONS(NSUInteger, FBSDKMessengerPlatformCapability) serialize your AVAsset to a file, and get an NSData representation of the video via [NSData dataWithContentsOfFile:filepath]; - - Parameter videoData: The image to be shared in Messenger - - Parameter metadata: Additional optional information to be sent to Messenger which is sent back to + @param videoData The image to be shared in Messenger + @param metadata Additional optional information to be sent to Messenger which is sent back to the user's app when they reply to an attributed message. This may be nil. - - Parameter context: The way the content is to be shared in Messenger. If nil, a standard share will take place. + @param context The way the content is to be shared in Messenger. If nil, a standard share will take place. If there is not an installed version of Messenger on the device that supports the share, an alert will be presented to notify the user. @@ -196,8 +196,8 @@ typedef NS_OPTIONS(NSUInteger, FBSDKMessengerPlatformCapability) serialize your AVAsset to a file, and get an NSData representation of the video via [NSData dataWithContentsOfFile:filepath]; - - Parameter videoData: The image to be shared in Messenger - - Parameter options: Additional optional parameters that affect the way the content is shared + @param videoData The image to be shared in Messenger + @param options Additional optional parameters that affect the way the content is shared If there is not an installed version of Messenger on the device that supports the share, an alert will be presented to notify the user. @@ -208,7 +208,7 @@ typedef NS_OPTIONS(NSUInteger, FBSDKMessengerPlatformCapability) Call this method to open Messenger and share an audio file. -- Warning: use shareAudio:withOptions: instead +@warning use shareAudio:withOptions: instead @@ -216,8 +216,8 @@ typedef NS_OPTIONS(NSUInteger, FBSDKMessengerPlatformCapability) serialize your AVAsset to a file, and get an NSData representation of the video via [NSData dataWithContentsOfFile:filepath]; - - Parameter audioData: The audio to be shared in Messenger - - Parameter metadata: Additional optional information to be sent to Messenger + @param audioData The audio to be shared in Messenger + @param metadata Additional optional information to be sent to Messenger If there is not an installed version of Messenger on the device that supports the share, an alert will be presented to notify the user. @@ -235,8 +235,8 @@ typedef NS_OPTIONS(NSUInteger, FBSDKMessengerPlatformCapability) serialize your AVAsset to a file, and get an NSData representation of the video via [NSData dataWithContentsOfFile:filepath]; - - Parameter audioData: The audio to be shared in Messenger - - Parameter options: Additional optional parameters that affect the way the content is shared + @param audioData The audio to be shared in Messenger + @param options Additional optional parameters that affect the way the content is shared If there is not an installed version of Messenger on the device that supports the share, an alert will be presented to notify the user. diff --git a/src/ios/FBSDKMessengerShareKit.framework/Headers/FBSDKMessengerURLHandler.h b/src/ios/FBSDKMessengerShareKit.framework/Headers/FBSDKMessengerURLHandler.h index 1775364f7..38e1b22fe 100644 --- a/src/ios/FBSDKMessengerShareKit.framework/Headers/FBSDKMessengerURLHandler.h +++ b/src/ios/FBSDKMessengerShareKit.framework/Headers/FBSDKMessengerURLHandler.h @@ -30,8 +30,8 @@ FBSDKMessengerURLHandlerCancelContext; /** This is called after FBSDKMessengerURLHandler has received a reply from messenger - - Parameter messengerURLHandler: The handler that handled the URL - - Parameter context: The data passed from Messenger + @param messengerURLHandler The handler that handled the URL + @param context The data passed from Messenger */ - (void)messengerURLHandler:(FBSDKMessengerURLHandler *)messengerURLHandler didHandleReplyWithContext:(FBSDKMessengerURLHandlerReplyContext *)context; @@ -39,8 +39,8 @@ FBSDKMessengerURLHandlerCancelContext; /** This is called after a user tapped this app from the composer in Messenger - - Parameter messengerURLHandler: The handler that handled the URL - - Parameter context: The data passed from Messenger + @param messengerURLHandler The handler that handled the URL + @param context The data passed from Messenger */ - (void) messengerURLHandler:(FBSDKMessengerURLHandler *)messengerURLHandler didHandleOpenFromComposerWithContext:(FBSDKMessengerURLHandlerOpenFromComposerContext *)context; @@ -48,8 +48,8 @@ FBSDKMessengerURLHandlerCancelContext; /** This is called after a user canceled a share and Messenger redirected here - - Parameter messengerURLHandler: The handler that handled the URL - - Parameter context: The data passed from Messenger + @param messengerURLHandler The handler that handled the URL + @param context The data passed from Messenger */ - (void)messengerURLHandler:(FBSDKMessengerURLHandler *)messengerURLHandler didHandleCancelWithContext:(FBSDKMessengerURLHandlerCancelContext *)context; @@ -65,10 +65,10 @@ FBSDKMessengerURLHandlerCancelContext; /** Determines whether an incoming URL can be handled by this class - - Parameter url: The URL passed in from the source application - - Parameter sourceApplication: The bundle id representing the source application + @param url The URL passed in from the source application + @param sourceApplication The bundle id representing the source application - - Returns: YES if this URL can be handled + @return YES if this URL can be handled */ - (BOOL)canOpenURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication; @@ -76,10 +76,10 @@ FBSDKMessengerURLHandlerCancelContext; Attempts to handle the Messenger URL and returns YES if and only if successful. This should be called from the AppDelegate's -openURL: method - - Parameter url: The URL passed in from the source application - - Parameter sourceApplication: The bundle id representing the source application + @param url The URL passed in from the source application + @param sourceApplication The bundle id representing the source application - - Returns: YES if this successfully handled the URL + @return YES if this successfully handled the URL */ - (BOOL)openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication; diff --git a/src/ios/FBSDKMessengerShareKit.framework/Info.plist b/src/ios/FBSDKMessengerShareKit.framework/Info.plist index 218a76924..aeb189c64 100644 Binary files a/src/ios/FBSDKMessengerShareKit.framework/Info.plist and b/src/ios/FBSDKMessengerShareKit.framework/Info.plist differ diff --git a/src/ios/FBSDKShareKit.framework/FBSDKShareKit b/src/ios/FBSDKShareKit.framework/FBSDKShareKit index 1fbee15e7..5d99215a5 100644 Binary files a/src/ios/FBSDKShareKit.framework/FBSDKShareKit and b/src/ios/FBSDKShareKit.framework/FBSDKShareKit differ diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKAppGroupAddDialog.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKAppGroupAddDialog.h index 460ac2887..a0ee6341c 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKAppGroupAddDialog.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKAppGroupAddDialog.h @@ -24,45 +24,45 @@ /** -- Warning:App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. +@warning App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. */ __attribute__ ((deprecated)) @interface FBSDKAppGroupAddDialog : NSObject /** -- Warning:App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. +@warning App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. */ + (instancetype)showWithContent:(FBSDKAppGroupContent *)content delegate:(id)delegate __attribute__ ((deprecated)); /** -- Warning:App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. +@warning App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. */ @property (nonatomic, weak) id delegate __attribute__ ((deprecated)); /** -- Warning:App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. +@warning App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. */ @property (nonatomic, copy) FBSDKAppGroupContent *content __attribute__ ((deprecated)); /** -- Warning:App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. +@warning App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. */ - (BOOL)canShow __attribute__ ((deprecated)); /** -- Warning:App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. +@warning App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. */ - (BOOL)show __attribute__ ((deprecated)); /** -- Warning:App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. +@warning App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. */ - (BOOL)validateWithError:(NSError *__autoreleasing *)errorRef __attribute__ ((deprecated)); @@ -70,26 +70,26 @@ __attribute__ ((deprecated)) /** -- Warning:App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. +@warning App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. */ __attribute__ ((deprecated)) @protocol FBSDKAppGroupAddDialogDelegate /** -- Warning:App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. +@warning App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. */ - (void)appGroupAddDialog:(FBSDKAppGroupAddDialog *)appGroupAddDialog didCompleteWithResults:(NSDictionary *)results __attribute__ ((deprecated)); /** -- Warning:App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. +@warning App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. */ - (void)appGroupAddDialog:(FBSDKAppGroupAddDialog *)appGroupAddDialog didFailWithError:(NSError *)error __attribute__ ((deprecated)); /** -- Warning:App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. +@warning App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. */ - (void)appGroupAddDialogDidCancel:(FBSDKAppGroupAddDialog *)appGroupAddDialog __attribute__ ((deprecated)); diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKAppGroupContent.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKAppGroupContent.h index e5722ef56..abf91aa72 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKAppGroupContent.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKAppGroupContent.h @@ -60,8 +60,8 @@ FBSDK_EXTERN NSString *NSStringFromFBSDKAppGroupPrivacy(FBSDKAppGroupPrivacy pri /** Compares the receiver to another app group content. - - Parameter content: The other content - - Returns: YES if the receiver's values are equal to the other content's values; otherwise NO + @param content The other content + @return YES if the receiver's values are equal to the other content's values; otherwise NO */ - (BOOL)isEqualToAppGroupContent:(FBSDKAppGroupContent *)content; diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKAppGroupJoinDialog.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKAppGroupJoinDialog.h index 371e5cc6f..ecb6d046e 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKAppGroupJoinDialog.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKAppGroupJoinDialog.h @@ -22,43 +22,43 @@ /** -- Warning:App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. +@warning App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. */ __attribute__ ((deprecated)) @interface FBSDKAppGroupJoinDialog : NSObject /** -- Warning:App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. +@warning App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. */ + (instancetype)showWithGroupID:(NSString *)groupID delegate:(id)delegate __attribute__ ((deprecated)); /** -- Warning:App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. */ +@warning App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. */ @property (nonatomic, weak) id delegate __attribute__ ((deprecated)); /** -- Warning:App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. */ +@warning App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. */ @property (nonatomic, copy) NSString *groupID __attribute__ ((deprecated)); /** -- Warning:App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. +@warning App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. */ - (BOOL)canShow __attribute__ ((deprecated)); /** -- Warning:App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. +@warning App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. */ - (BOOL)show __attribute__ ((deprecated)); /** -- Warning:App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. +@warning App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. */ - (BOOL)validateWithError:(NSError *__autoreleasing *)errorRef __attribute__ ((deprecated)); @@ -66,26 +66,26 @@ __attribute__ ((deprecated)) /** -- Warning:App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. +@warning App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. */ __attribute__ ((deprecated)) @protocol FBSDKAppGroupJoinDialogDelegate /** -- Warning:App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. +@warning App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. */ - (void)appGroupJoinDialog:(FBSDKAppGroupJoinDialog *)appGroupJoinDialog didCompleteWithResults:(NSDictionary *)results __attribute__ ((deprecated)); /** -- Warning:App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. +@warning App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. */ - (void)appGroupJoinDialog:(FBSDKAppGroupJoinDialog *)appGroupJoinDialog didFailWithError:(NSError *)error __attribute__ ((deprecated)); /** -- Warning:App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. +@warning App and game groups are being deprecated. See https://developers.facebook.com/docs/games/services/game-groups for more information. */ - (void)appGroupJoinDialogDidCancel:(FBSDKAppGroupJoinDialog *)appGroupJoinDialog __attribute__ ((deprecated)); diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKAppInviteContent.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKAppInviteContent.h index fe911420c..b57d923d5 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKAppInviteContent.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKAppInviteContent.h @@ -19,6 +19,7 @@ #import #import +#import /** NS_ENUM(NSUInteger, FBSDKAppInviteDestination) @@ -35,7 +36,7 @@ typedef NS_ENUM(NSUInteger, FBSDKAppInviteDestination) /** A model for app invite. */ -@interface FBSDKAppInviteContent : NSObject +@interface FBSDKAppInviteContent : NSObject /** A URL to a preview image that will be displayed with the app invite @@ -55,7 +56,7 @@ typedef NS_ENUM(NSUInteger, FBSDKAppInviteDestination) /** -- Warning:Use `appInvitePreviewImageURL` instead. +@warning Use `appInvitePreviewImageURL` instead. */ @property (nonatomic, copy) NSURL *previewImageURL __attribute__ ((deprecated("use appInvitePreviewImageURL instead"))); @@ -87,8 +88,8 @@ typedef NS_ENUM(NSUInteger, FBSDKAppInviteDestination) /** Compares the receiver to another app invite content. - - Parameter content: The other content - - Returns: YES if the receiver's values are equal to the other content's values; otherwise NO + @param content The other content + @return YES if the receiver's values are equal to the other content's values; otherwise NO */ - (BOOL)isEqualToAppInviteContent:(FBSDKAppInviteContent *)content; diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKAppInviteDialog.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKAppInviteDialog.h index 9994ff92c..c340ec8b9 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKAppInviteDialog.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKAppInviteDialog.h @@ -30,10 +30,10 @@ /** Convenience method to show a FBSDKAppInviteDialog - - Parameter viewController: A UIViewController to present the dialog from. - - Parameter content: The content for the app invite. - - Parameter delegate: The receiver's delegate. - - Warning: This method is deprecated. + @param viewController A UIViewController to present the dialog from. + @param content The content for the app invite. + @param delegate The receiver's delegate. + @warning This method is deprecated. */ + (instancetype)showFromViewController:(UIViewController *)viewController withContent:(FBSDKAppInviteContent *)content @@ -43,7 +43,7 @@ __attribute__ ((deprecated("App Invites no longer supported"))); /** - - Warning:use showFromViewController:withContent:delegate: instead + @warning use showFromViewController:withContent:delegate: instead */ + (instancetype)showWithContent:(FBSDKAppInviteContent *)content delegate:(id)delegate __attribute__ ((deprecated("use showFromViewController:withContent:delegate: instead"))); @@ -72,21 +72,21 @@ __attribute__ ((deprecated("use showFromViewController:withContent:delegate: ins required but not available. This method does not validate the content on the receiver, so this can be checked before building up the content. - - See:validateWithError: - - Returns: YES if the receiver can show the dialog, otherwise NO. + @see validateWithError: + @return YES if the receiver can show the dialog, otherwise NO. */ - (BOOL)canShow; /** Begins the app invite from the receiver. - - Returns: YES if the receiver was able to show the dialog, otherwise NO. + @return YES if the receiver was able to show the dialog, otherwise NO. */ - (BOOL)show; /** Validates the content on the receiver. - - Parameter errorRef: If an error occurs, upon return contains an NSError object that describes the problem. - - Returns: YES if the content is valid, otherwise NO. + @param errorRef If an error occurs, upon return contains an NSError object that describes the problem. + @return YES if the content is valid, otherwise NO. */ - (BOOL)validateWithError:(NSError *__autoreleasing *)errorRef; @@ -103,15 +103,15 @@ __attribute__ ((deprecated("use showFromViewController:withContent:delegate: ins /** Sent to the delegate when the app invite completes without error. - - Parameter appInviteDialog: The FBSDKAppInviteDialog that completed. - - Parameter results: The results from the dialog. This may be nil or empty. + @param appInviteDialog The FBSDKAppInviteDialog that completed. + @param results The results from the dialog. This may be nil or empty. */ - (void)appInviteDialog:(FBSDKAppInviteDialog *)appInviteDialog didCompleteWithResults:(NSDictionary *)results; /** Sent to the delegate when the app invite encounters an error. - - Parameter appInviteDialog: The FBSDKAppInviteDialog that completed. - - Parameter error: The error. + @param appInviteDialog The FBSDKAppInviteDialog that completed. + @param error The error. */ - (void)appInviteDialog:(FBSDKAppInviteDialog *)appInviteDialog didFailWithError:(NSError *)error; diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKCameraEffectArguments.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKCameraEffectArguments.h index 6f67f0a54..6306f47fe 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKCameraEffectArguments.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKCameraEffectArguments.h @@ -28,29 +28,29 @@ /** Sets a string argument in the container. - - Parameter string: The argument - - Parameter key: The key for the argument + @param string The argument + @param key The key for the argument */ - (void)setString:(NSString *)string forKey:(NSString *)key; /** Gets a string argument from the container. - - Parameter key: The key for the argument - - Returns: The string value or nil + @param key The key for the argument + @return The string value or nil */ - (NSString *)stringForKey:(NSString *)key; /** Sets a string array argument in the container. - - Parameter array: The array argument - - Parameter key: The key for the argument + @param array The array argument + @param key The key for the argument */ - (void)setArray:(NSArray *)array forKey:(NSString *)key; /** Gets an array argument from the container. - - Parameter key: The key for the argument - - Returns: The array argument + @param key The key for the argument + @return The array argument */ - (NSArray *)arrayForKey:(NSString *)key; diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKCameraEffectTextures.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKCameraEffectTextures.h index 37aeff37d..9639b5094 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKCameraEffectTextures.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKCameraEffectTextures.h @@ -28,15 +28,15 @@ /** Sets the image for a texture key. - - Parameter image: The UIImage for the texture - - Parameter name: The key for the texture + @param image The UIImage for the texture + @param key The key for the texture */ - (void)setImage:(UIImage *)image forKey:(NSString *)key; /** Gets the image for a texture key. - - Parameter name: The key for the texture - - Returns: The texture UIImage or nil + @param key The key for the texture + @return The texture UIImage or nil */ - (UIImage *)imageForKey:(NSString *)key; diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKGameRequestContent.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKGameRequestContent.h index a7428268d..01d948008 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKGameRequestContent.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKGameRequestContent.h @@ -19,6 +19,7 @@ #import #import +#import /** NS_ENUM(NSUInteger, FBSDKGameRequestActionType) @@ -53,7 +54,7 @@ typedef NS_ENUM(NSUInteger, FBSDKGameRequestFilter) /** A model for a game request. */ -@interface FBSDKGameRequestContent : NSObject +@interface FBSDKGameRequestContent : NSObject /** Used when defining additional context about the nature of the request. @@ -67,8 +68,8 @@ typedef NS_ENUM(NSUInteger, FBSDKGameRequestFilter) /** Compares the receiver to another game request content. - - Parameter content: The other content - - Returns: YES if the receiver's values are equal to the other content's values; otherwise NO + @param content The other content + @return YES if the receiver's values are equal to the other content's values; otherwise NO */ - (BOOL)isEqualToGameRequestContent:(FBSDKGameRequestContent *)content; @@ -121,7 +122,7 @@ typedef NS_ENUM(NSUInteger, FBSDKGameRequestFilter) /** -- Warning:Use `recipientSuggestions` instead. +@warning Use `recipientSuggestions` instead. */ @property (nonatomic, copy) NSArray *suggestions __attribute__ ((deprecated("use recipientSuggestions instead"))); @@ -132,7 +133,7 @@ typedef NS_ENUM(NSUInteger, FBSDKGameRequestFilter) /** -- Warning:Use `recipients` instead. +@warning Use `recipients` instead. */ @property (nonatomic, copy) NSArray *to __attribute__ ((deprecated("use recipients instead"))); diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKGameRequestDialog.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKGameRequestDialog.h index 0cca01645..0a48afa47 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKGameRequestDialog.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKGameRequestDialog.h @@ -29,8 +29,8 @@ /** Convenience method to build up a game request with content and a delegate. - - Parameter content: The content for the game request. - - Parameter delegate: The receiver's delegate. + @param content The content for the game request. + @param delegate The receiver's delegate. */ + (instancetype)showWithContent:(FBSDKGameRequestContent *)content delegate:(id)delegate; @@ -56,21 +56,21 @@ required but not available. This method does not validate the content on the receiver, so this can be checked before building up the content. -- See:validateWithError: - - Returns: YES if the receiver can share, otherwise NO. + @see validateWithError: + @return YES if the receiver can share, otherwise NO. */ - (BOOL)canShow; /** Begins the game request from the receiver. - - Returns: YES if the receiver was able to show the dialog, otherwise NO. + @return YES if the receiver was able to show the dialog, otherwise NO. */ - (BOOL)show; /** Validates the content on the receiver. - - Parameter errorRef: If an error occurs, upon return contains an NSError object that describes the problem. - - Returns: YES if the content is valid, otherwise NO. + @param errorRef If an error occurs, upon return contains an NSError object that describes the problem. + @return YES if the content is valid, otherwise NO. */ - (BOOL)validateWithError:(NSError *__autoreleasing *)errorRef; @@ -87,21 +87,21 @@ /** Sent to the delegate when the game request completes without error. - - Parameter gameRequestDialog: The FBSDKGameRequestDialog that completed. - - Parameter results: The results from the dialog. This may be nil or empty. + @param gameRequestDialog The FBSDKGameRequestDialog that completed. + @param results The results from the dialog. This may be nil or empty. */ - (void)gameRequestDialog:(FBSDKGameRequestDialog *)gameRequestDialog didCompleteWithResults:(NSDictionary *)results; /** Sent to the delegate when the game request encounters an error. - - Parameter gameRequestDialog: The FBSDKGameRequestDialog that completed. - - Parameter error: The error. + @param gameRequestDialog The FBSDKGameRequestDialog that completed. + @param error The error. */ - (void)gameRequestDialog:(FBSDKGameRequestDialog *)gameRequestDialog didFailWithError:(NSError *)error; /** Sent to the delegate when the game request dialog is cancelled. - - Parameter gameRequestDialog: The FBSDKGameRequestDialog that completed. + @param gameRequestDialog The FBSDKGameRequestDialog that completed. */ - (void)gameRequestDialogDidCancel:(FBSDKGameRequestDialog *)gameRequestDialog; diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKHashtag.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKHashtag.h index 438b664d1..552880cb3 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKHashtag.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKHashtag.h @@ -28,7 +28,7 @@ /** Convenience method to build a new hashtag with a string identifier. Equivalent to setting the `stringRepresentation` property. - - Parameter hashtagString: The hashtag string. + @param hashtagString The hashtag string. */ + (instancetype)hashtagWithString:(NSString *)hashtagString; @@ -38,7 +38,7 @@ You are responsible for making sure that `stringRepresentation` is a valid hashtag (a single '#' followed by one or more word characters). Invalid hashtags are ignored when sharing content. You can check validity with the `valid` property. - - Returns: The hashtag string. + @return The hashtag string. */ @property (nonatomic, readwrite, copy) NSString *stringRepresentation; @@ -47,14 +47,14 @@ A valid hashtag matches the regular expression "#\w+": A single '#' followed by one or more word characters. - - Returns: YES if the hashtag is valid, NO otherwise. + @return YES if the hashtag is valid, NO otherwise. */ @property (nonatomic, readonly, assign, getter=isValid) BOOL valid; /** Compares the receiver to another hashtag. - - Parameter hashtag: The other hashtag - - Returns: YES if the receiver is equal to the other hashtag; otherwise NO + @param hashtag The other hashtag + @return YES if the receiver is equal to the other hashtag; otherwise NO */ - (BOOL)isEqualToHashtag:(FBSDKHashtag *)hashtag; diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKLikeControl.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKLikeControl.h index 6ce351de2..ea942e86d 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKLikeControl.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKLikeControl.h @@ -103,7 +103,7 @@ __attribute__ ((deprecated)) The position for the auxiliary view for the receiver. -- See:FBSDKLikeControlAuxiliaryPosition + @see FBSDKLikeControlAuxiliaryPosition */ @property (nonatomic, assign) FBSDKLikeControlAuxiliaryPosition likeControlAuxiliaryPosition; @@ -120,7 +120,7 @@ __attribute__ ((deprecated)) The style to use for the receiver. -- See:FBSDKLikeControlStyle + @see FBSDKLikeControlStyle */ @property (nonatomic, assign) FBSDKLikeControlStyle likeControlStyle; diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKLiking.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKLiking.h index 78855be84..57fbd22a7 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKLiking.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKLiking.h @@ -21,9 +21,9 @@ /** The common interface for components that initiate liking. -- See:FBSDKLikeButton + @see FBSDKLikeButton -- See:FBSDKLikeControl + @see FBSDKLikeControl */ @protocol FBSDKLiking diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKMessageDialog.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKMessageDialog.h index ed71874ec..1604f80e8 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKMessageDialog.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKMessageDialog.h @@ -23,32 +23,24 @@ /** A dialog for sharing content through Messenger. - DEPRECATION WARNING: AS OF THE JULY 2018 RELEASE, FBSDKMessageDialog WILL STOP SUPPORTING - SOME OF THE EXISTING FBSDKSharingContent TYPES. validateWithError WILL RETURN NO WITH AN - ERROR FOR UNSUPPORTED TYPES, AND TRYING TO show UNSUPPOTED CONTENT WILL CALL - sharer: didFailWithError: ON THE DELEGATE. THE FOLLOWING SHARE TYPES WILL CONTINUE TO BE - SUPPORTED ON AND AFTER JULY 2018: + SUPPORTED SHARE TYPES - FBSDKShareLinkContent - FBSDKShareMessengerOpenGraphMusicTemplateContent - FBSDKShareMessengerMediaTemplateContent - FBSDKShareMessengerGenericTemplateContent - THE FOLLOWING WILL NO LONGER BE SUPPORTED AS OF JULY 2018: + UNSUPPORTED SHARE TYPES (DEPRECATED AUGUST 2018) - FBSDKShareOpenGraphContent - FBSDKSharePhotoContent - FBSDKShareVideoContent - Any other types that are not one of the four supported types listed above - - FBSDKShareMessengerMediaTemplateContent and FBSDKShareMessengerGenericTemplateContent - SHOULD BE ABLE TO REPLACE THE FUNCTIONALITY OF FBSDKSharePhotoContent AND - FBSDKShareVideoContent, SO CONSIDER MIGRATING TO THESE NEW SHARE TYPES. */ @interface FBSDKMessageDialog : NSObject /** Convenience method to show a Message Share Dialog with content and a delegate. - - Parameter content: The content to be shared. - - Parameter delegate: The receiver's delegate. + @param content The content to be shared. + @param delegate The receiver's delegate. */ + (instancetype)showWithContent:(id)content delegate:(id)delegate; diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareAPI.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareAPI.h index bf53883b5..5886fdb58 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareAPI.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareAPI.h @@ -35,8 +35,8 @@ /** Convenience method to build up a share API with content and a delegate. - - Parameter content: The content to be shared. - - Parameter delegate: The receiver's delegate. + @param content The content to be shared. + @param delegate The receiver's delegate. */ + (instancetype)shareWithContent:(id)content delegate:(id)delegate; @@ -66,14 +66,14 @@ required but not available. This method does not validate the content on the receiver, so this can be checked before building up the content. -- See:[FBSDKSharing validateWithError:] - - Returns: YES if the receiver can send, otherwise NO. + @see [FBSDKSharing validateWithError:] + @return YES if the receiver can send, otherwise NO. */ - (BOOL)canShare; /** Creates an User Owned Open Graph object without an action. - - Parameter openGraphObject: The open graph object to create. + @param openGraphObject The open graph object to create. Use this method to create an object alone, when an action is not going to be posted with the object. If the object will be used within an action, just put the object in the action and share that as the shareContent and the @@ -81,13 +81,13 @@ Also see https://developers.facebook.com/docs/sharing/opengraph/object-api#objectapi-creatinguser - - Returns: YES if the receiver was able to send the request to create the object, otherwise NO. + @return YES if the receiver was able to send the request to create the object, otherwise NO. */ - (BOOL)createOpenGraphObject:(FBSDKShareOpenGraphObject *)openGraphObject; /** Begins the send from the receiver. - - Returns: YES if the receiver was able to send the share, otherwise NO. + @return YES if the receiver was able to send the share, otherwise NO. */ - (BOOL)share; diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareCameraEffectContent.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareCameraEffectContent.h index 65e2f6bdc..1309c8df6 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareCameraEffectContent.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareCameraEffectContent.h @@ -21,11 +21,12 @@ #import #import #import +#import /** A model for content to share with a Facebook camera effect. */ -@interface FBSDKShareCameraEffectContent : NSObject +@interface FBSDKShareCameraEffectContent : NSObject /** ID of the camera effect to use. @@ -44,8 +45,8 @@ /** Compares the receiver to another camera effect content. - - Parameter content: The other content - - Returns: YES if the receiver's values are equal to the other content's values; otherwise NO + @param content The other content + @return YES if the receiver's values are equal to the other content's values; otherwise NO */ - (BOOL)isEqualToShareCameraEffectContent:(FBSDKShareCameraEffectContent *)content; diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareDialog.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareDialog.h index 849859050..18c4d3ea2 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareDialog.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareDialog.h @@ -29,9 +29,9 @@ /** Convenience method to show an FBSDKShareDialog with a fromViewController, content and a delegate. - - Parameter viewController: A UIViewController to present the dialog from, if appropriate. - - Parameter content: The content to be shared. - - Parameter delegate: The receiver's delegate. + @param viewController A UIViewController to present the dialog from, if appropriate. + @param content The content to be shared. + @param delegate The receiver's delegate. */ + (instancetype)showFromViewController:(UIViewController *)viewController withContent:(id)content diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareDialogMode.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareDialogMode.h index c756802de..e7dfabcf9 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareDialogMode.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareDialogMode.h @@ -60,6 +60,6 @@ typedef NS_ENUM(NSUInteger, FBSDKShareDialogMode) }; /** - Converts an FBLikeControlObjectType to an NSString. + Converts an FBSDKShareDialogMode to an NSString. */ FBSDK_EXTERN NSString *NSStringFromFBSDKShareDialogMode(FBSDKShareDialogMode dialogMode); diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareLinkContent.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareLinkContent.h index b4290d16c..0a283775c 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareLinkContent.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareLinkContent.h @@ -30,7 +30,7 @@ If not specified, this field is automatically populated by information scraped from the contentURL, typically the title of the page. This value may be discarded for specially handled links (ex: iTunes URLs). - - Returns: The description of the link + @return The description of the link @deprecated `contentDescription` is deprecated from Graph API 2.9. For more information, see https://developers.facebook.com/docs/apps/changelog#v2_9_deprecations. @@ -42,7 +42,7 @@ The title to display for this link. This value may be discarded for specially handled links (ex: iTunes URLs). - - Returns: The link title + @return The link title @deprecated `contentTitle` is deprecated from Graph API 2.9. For more information, see https://developers.facebook.com/docs/apps/changelog#v2_9_deprecations @@ -52,7 +52,7 @@ /** The URL of a picture to attach to this content. - - Returns: The network URL of an image + @return The network URL of an image @deprecated `imageURL` is deprecated from Graph API 2.9. For more information, see https://developers.facebook.com/docs/apps/changelog#v2_9_deprecations @@ -64,14 +64,14 @@ Some quote text of the link. If specified, the quote text will render with custom styling on top of the link. - - Returns: The quote text of a link + @return The quote text of a link */ @property (nonatomic, copy) NSString *quote; /** Compares the receiver to another link content. - - Parameter content: The other content - - Returns: YES if the receiver's values are equal to the other content's values; otherwise NO + @param content The other content + @return YES if the receiver's values are equal to the other content's values; otherwise NO */ - (BOOL)isEqualToShareLinkContent:(FBSDKShareLinkContent *)content; diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareMediaContent.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareMediaContent.h index 2029422ff..ab9d895d5 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareMediaContent.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareMediaContent.h @@ -27,14 +27,14 @@ /** Media to be shared. - - Returns: Array of the media (FBSDKSharePhoto or FBSDKShareVideo) + @return Array of the media (FBSDKSharePhoto or FBSDKShareVideo) */ @property (nonatomic, copy) NSArray *media; /** Compares the receiver to another media content. - - Parameter content: The other content - - Returns: YES if the receiver's values are equal to the other content's values; otherwise NO + @param content The other content + @return YES if the receiver's values are equal to the other content's values; otherwise NO */ - (BOOL)isEqualToShareMediaContent:(FBSDKShareMediaContent *)content; diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareMessengerActionButton.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareMessengerActionButton.h index ad970f570..8b18d07c5 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareMessengerActionButton.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareMessengerActionButton.h @@ -27,7 +27,7 @@ /** The title displayed to the user for the button. - - Returns: The title for the button. + @return The title for the button. */ @property (nonatomic, copy) NSString *title; diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareOpenGraphAction.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareOpenGraphAction.h index d30ebad5e..83e888315 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareOpenGraphAction.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareOpenGraphAction.h @@ -32,38 +32,38 @@ /** Convenience method to build a new action and set the object for the specified key. - - Parameter actionType: The action type of the receiver - - Parameter object: The Open Graph object represented by this action - - Parameter key: The key for the object + @param actionType The action type of the receiver + @param object The Open Graph object represented by this action + @param key The key for the object */ + (instancetype)actionWithType:(NSString *)actionType object:(FBSDKShareOpenGraphObject *)object key:(NSString *)key; /** Convenience method to build a new action and set the object for the specified key. - - Parameter actionType: The action type of the receiver - - Parameter objectID: The ID of an existing Open Graph object - - Parameter key: The key for the object + @param actionType The action type of the receiver + @param objectID The ID of an existing Open Graph object + @param key The key for the object */ + (instancetype)actionWithType:(NSString *)actionType objectID:(NSString *)objectID key:(NSString *)key; /** Convenience method to build a new action and set the object for the specified key. - - Parameter actionType: The action type of the receiver - - Parameter objectURL: The URL to a page that defines the Open Graph object with meta tags - - Parameter key: The key for the object + @param actionType The action type of the receiver + @param objectURL The URL to a page that defines the Open Graph object with meta tags + @param key The key for the object */ + (instancetype)actionWithType:(NSString *)actionType objectURL:(NSURL *)objectURL key:(NSString *)key; /** Gets the action type. - - Returns: The action type + @return The action type */ @property (nonatomic, copy) NSString *actionType; /** Compares the receiver to another Open Graph Action. - - Parameter action: The other action - - Returns: YES if the receiver's values are equal to the other action's values; otherwise NO + @param action The other action + @return YES if the receiver's values are equal to the other action's values; otherwise NO */ - (BOOL)isEqualToShareOpenGraphAction:(FBSDKShareOpenGraphAction *)action; diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareOpenGraphContent.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareOpenGraphContent.h index 43286dcfa..faed0ba44 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareOpenGraphContent.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareOpenGraphContent.h @@ -28,7 +28,7 @@ /** Open Graph Action to be shared. - - Returns: The action + @return The action */ @property (nonatomic, copy) FBSDKShareOpenGraphAction *action; @@ -36,14 +36,14 @@ Property name that points to the primary Open Graph Object in the action. The value that this action points to will be use for rendering the preview for the share. - - Returns: The property name for the Open Graph Object in the action + @return The property name for the Open Graph Object in the action */ @property (nonatomic, copy) NSString *previewPropertyName; /** Compares the receiver to another Open Graph content. - - Parameter content: The other content - - Returns: YES if the receiver's values are equal to the other content's values; otherwise NO + @param content The other content + @return YES if the receiver's values are equal to the other content's values; otherwise NO */ - (BOOL)isEqualToShareOpenGraphContent:(FBSDKShareOpenGraphContent *)content; diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareOpenGraphObject.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareOpenGraphObject.h index 22745cdcd..ef34e2805 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareOpenGraphObject.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareOpenGraphObject.h @@ -45,14 +45,14 @@ /** Convenience method to build a new action and set the object for the specified key. - - Parameter properties: Properties for the Open Graph object, which will be parsed into the proper models + @param properties Properties for the Open Graph object, which will be parsed into the proper models */ + (instancetype)objectWithProperties:(NSDictionary *)properties; /** Compares the receiver to another Open Graph Object. - - Parameter object: The other object - - Returns: YES if the receiver's values are equal to the other object's values; otherwise NO + @param object The other object + @return YES if the receiver's values are equal to the other object's values; otherwise NO */ - (BOOL)isEqualToShareOpenGraphObject:(FBSDKShareOpenGraphObject *)object; diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareOpenGraphValueContainer.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareOpenGraphValueContainer.h index ddef60f82..59b16994c 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareOpenGraphValueContainer.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareOpenGraphValueContainer.h @@ -30,66 +30,66 @@ /** Gets an NSArray out of the receiver. - - Parameter key: The key for the value - - Returns: The NSArray value or nil + @param key The key for the value + @return The NSArray value or nil */ - (NSArray *)arrayForKey:(NSString *)key; /** Applies a given block object to the entries of the receiver. - - Parameter block: A block object to operate on entries in the receiver + @param block A block object to operate on entries in the receiver */ - (void)enumerateKeysAndObjectsUsingBlock:(void (^)(NSString *key, id object, BOOL *stop))block; /** Returns an enumerator object that lets you access each key in the receiver. - - Returns: An enumerator object that lets you access each key in the receiver + @return An enumerator object that lets you access each key in the receiver */ - (NSEnumerator *)keyEnumerator; /** Gets an NSNumber out of the receiver. - - Parameter key: The key for the value - - Returns: The NSNumber value or nil + @param key The key for the value + @return The NSNumber value or nil */ - (NSNumber *)numberForKey:(NSString *)key; /** Returns an enumerator object that lets you access each value in the receiver. - - Returns: An enumerator object that lets you access each value in the receiver + @return An enumerator object that lets you access each value in the receiver */ - (NSEnumerator *)objectEnumerator; /** Gets an FBSDKShareOpenGraphObject out of the receiver. - - Parameter key: The key for the value - - Returns: The FBSDKShareOpenGraphObject value or nil + @param key The key for the value + @return The FBSDKShareOpenGraphObject value or nil */ - (FBSDKShareOpenGraphObject *)objectForKey:(NSString *)key; /** Enables subscript access to the values in the receiver. - - Parameter key: The key for the value - - Returns: The value + @param key The key for the value + @return The value */ - (id)objectForKeyedSubscript:(NSString *)key; /** Parses properties out of a dictionary into the receiver. - - Parameter properties: The properties to parse. + @param properties The properties to parse. */ - (void)parseProperties:(NSDictionary *)properties; /** Gets an FBSDKSharePhoto out of the receiver. - - Parameter key: The key for the value - - Returns: The FBSDKSharePhoto value or nil + @param key The key for the value + @return The FBSDKSharePhoto value or nil */ - (FBSDKSharePhoto *)photoForKey:(NSString *)key; /** Removes a value from the receiver for the specified key. - - Parameter key: The key for the value + @param key The key for the value */ - (void)removeObjectForKey:(NSString *)key; @@ -98,57 +98,57 @@ This method will throw if the array contains any values that is not an NSNumber, NSString, NSURL, FBSDKSharePhoto or FBSDKShareOpenGraphObject. - - Parameter array: The NSArray value - - Parameter key: The key for the value + @param array The NSArray value + @param key The key for the value */ - (void)setArray:(NSArray *)array forKey:(NSString *)key; /** Sets an NSNumber on the receiver. - - Parameter number: The NSNumber value - - Parameter key: The key for the value + @param number The NSNumber value + @param key The key for the value */ - (void)setNumber:(NSNumber *)number forKey:(NSString *)key; /** Sets an FBSDKShareOpenGraphObject on the receiver. - - Parameter object: The FBSDKShareOpenGraphObject value - - Parameter key: The key for the value + @param object The FBSDKShareOpenGraphObject value + @param key The key for the value */ - (void)setObject:(FBSDKShareOpenGraphObject *)object forKey:(NSString *)key; /** Sets an FBSDKSharePhoto on the receiver. - - Parameter photo: The FBSDKSharePhoto value - - Parameter key: The key for the value + @param photo The FBSDKSharePhoto value + @param key The key for the value */ - (void)setPhoto:(FBSDKSharePhoto *)photo forKey:(NSString *)key; /** Sets an NSString on the receiver. - - Parameter string: The NSString value - - Parameter key: The key for the value + @param string The NSString value + @param key The key for the value */ - (void)setString:(NSString *)string forKey:(NSString *)key; /** Sets an NSURL on the receiver. - - Parameter URL: The NSURL value - - Parameter key: The key for the value + @param URL The NSURL value + @param key The key for the value */ - (void)setURL:(NSURL *)URL forKey:(NSString *)key; /** Gets an NSString out of the receiver. - - Parameter key: The key for the value - - Returns: The NSString value or nil + @param key The key for the value + @return The NSString value or nil */ - (NSString *)stringForKey:(NSString *)key; /** Gets an NSURL out of the receiver. - - Parameter key: The key for the value - - Returns: The NSURL value or nil + @param key The key for the value + @return The NSURL value or nil */ - (NSURL *)URLForKey:(NSString *)key; diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharePhoto.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharePhoto.h index 7926e2a91..7f8c2e419 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharePhoto.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharePhoto.h @@ -19,24 +19,27 @@ #import #import +#import + +@class PHAsset; /** A photo for sharing. */ -@interface FBSDKSharePhoto : NSObject +@interface FBSDKSharePhoto : NSObject /** Convenience method to build a new photo object with an image. - - Parameter image: If the photo is resident in memory, this method supplies the data - - Parameter userGenerated: Specifies whether the photo represented by the receiver was generated by the user or by the + @param image If the photo is resident in memory, this method supplies the data + @param userGenerated Specifies whether the photo represented by the receiver was generated by the user or by the application */ + (instancetype)photoWithImage:(UIImage *)image userGenerated:(BOOL)userGenerated; /** Convenience method to build a new photo object with an imageURL. - - Parameter imageURL: The URL to the photo - - Parameter userGenerated: Specifies whether the photo represented by the receiver was generated by the user or by the + @param imageURL The URL to the photo + @param userGenerated Specifies whether the photo represented by the receiver was generated by the user or by the application This method should only be used when adding photo content to open graph stories. @@ -45,35 +48,49 @@ */ + (instancetype)photoWithImageURL:(NSURL *)imageURL userGenerated:(BOOL)userGenerated; +/** + Convenience method to build a new photo object with a PHAsset. + - Parameter photoAsset: The PHAsset that represents the photo in the Photos library. + - Parameter userGenerated: Specifies whether the photo represented by the receiver was generated by the user or by the + application + */ ++ (instancetype)photoWithPhotoAsset:(PHAsset *)photoAsset userGenerated:(BOOL)userGenerated; + /** If the photo is resident in memory, this method supplies the data. - - Returns: UIImage representation of the photo + @return UIImage representation of the photo */ @property (nonatomic, strong) UIImage *image; /** The URL to the photo. - - Returns: URL that points to a network location or the location of the photo on disk + @return URL that points to a network location or the location of the photo on disk */ @property (nonatomic, copy) NSURL *imageURL; +/** + The representation of the photo in the Photos library. + - Returns: PHAsset that represents the photo in the Photos library. + */ +@property (nonatomic, copy) PHAsset *photoAsset; + /** Specifies whether the photo represented by the receiver was generated by the user or by the application. - - Returns: YES if the photo is user-generated, otherwise NO + @return YES if the photo is user-generated, otherwise NO */ @property (nonatomic, assign, getter=isUserGenerated) BOOL userGenerated; /** Compares the receiver to another photo. - - Parameter photo: The other photo - - Returns: YES if the receiver's values are equal to the other photo's values; otherwise NO + @param photo The other photo + @return YES if the receiver's values are equal to the other photo's values; otherwise NO */ - (BOOL)isEqualToSharePhoto:(FBSDKSharePhoto *)photo; /** The user generated caption for the photo. Note that the 'caption' must come from * the user, as pre-filled content is forbidden by the Platform Policies (2.3). - - Returns: the Photo's caption if exists else returns null. + @return the Photo's caption if exists else returns null. */ @property (nonatomic, copy) NSString *caption; diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharePhotoContent.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharePhotoContent.h index 3043268f2..427c31572 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharePhotoContent.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharePhotoContent.h @@ -27,14 +27,14 @@ /** Photos to be shared. - - Returns: Array of the photos (FBSDKSharePhoto) + @return Array of the photos (FBSDKSharePhoto) */ @property (nonatomic, copy) NSArray *photos; /** Compares the receiver to another photo content. - - Parameter content: The other content - - Returns: YES if the receiver's values are equal to the other content's values; otherwise NO + @param content The other content + @return YES if the receiver's values are equal to the other content's values; otherwise NO */ - (BOOL)isEqualToSharePhotoContent:(FBSDKSharePhotoContent *)content; diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareVideo.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareVideo.h index b2a49cb04..a609860fe 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareVideo.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareVideo.h @@ -19,6 +19,7 @@ #import #import +#import @class FBSDKSharePhoto; @class PHAsset; @@ -26,56 +27,75 @@ /** A video for sharing. */ -@interface FBSDKShareVideo : NSObject +@interface FBSDKShareVideo : NSObject + +/** + Convenience method to build a new video object from raw data. + - Parameter data: The NSData object that holds the raw video data. + */ ++ (instancetype)videoWithData:(NSData *)data; + +/** + Convenience method to build a new video object with NSData and a previewPhoto. + - Parameter data: The NSData object that holds the raw video data. + - Parameter previewPhoto: The photo that represents the video. + */ ++ (instancetype)videoWithData:(NSData *)data previewPhoto:(FBSDKSharePhoto *)previewPhoto; /** Convenience method to build a new video object with a PHAsset. - - Parameter videoAsset: The PHAsset that represents the video in the Photos library. + @param videoAsset The PHAsset that represents the video in the Photos library. */ + (instancetype)videoWithVideoAsset:(PHAsset *)videoAsset; /** Convenience method to build a new video object with a PHAsset and a previewPhoto. - - Parameter videoAsset: The PHAsset that represents the video in the Photos library. - - Parameter previewPhoto: The photo that represents the video. + @param videoAsset The PHAsset that represents the video in the Photos library. + @param previewPhoto The photo that represents the video. */ + (instancetype)videoWithVideoAsset:(PHAsset *)videoAsset previewPhoto:(FBSDKSharePhoto *)previewPhoto; /** Convenience method to build a new video object with a videoURL. - - Parameter videoURL: The URL to the video. + @param videoURL The URL to the video. */ + (instancetype)videoWithVideoURL:(NSURL *)videoURL; /** Convenience method to build a new video object with a videoURL and a previewPhoto. - - Parameter videoURL: The URL to the video. - - Parameter previewPhoto: The photo that represents the video. + @param videoURL The URL to the video. + @param previewPhoto The photo that represents the video. */ + (instancetype)videoWithVideoURL:(NSURL *)videoURL previewPhoto:(FBSDKSharePhoto *)previewPhoto; +/** + The raw video data. + - Returns: The video data. + */ +@property (nonatomic, strong) NSData *data; + /** The representation of the video in the Photos library. - - Returns: PHAsset that represents the video in the Photos library. + @return PHAsset that represents the video in the Photos library. */ @property (nonatomic, copy) PHAsset *videoAsset; /** The file URL to the video. - - Returns: URL that points to the location of the video on disk + @return URL that points to the location of the video on disk */ @property (nonatomic, copy) NSURL *videoURL; /** The photo that represents the video. - - Returns: The photo + @return The photo */ @property (nonatomic, copy) FBSDKSharePhoto *previewPhoto; /** Compares the receiver to another video. - - Parameter video: The other video - - Returns: YES if the receiver's values are equal to the other video's values; otherwise NO + @param video The other video + @return YES if the receiver's values are equal to the other video's values; otherwise NO */ - (BOOL)isEqualToShareVideo:(FBSDKShareVideo *)video; diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareVideoContent.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareVideoContent.h index 726459116..cfbc9cbcc 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareVideoContent.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKShareVideoContent.h @@ -29,20 +29,20 @@ /** The photo that represents the video. - - Returns: The photo + @return The photo */ @property (nonatomic, copy) FBSDKSharePhoto *previewPhoto; /** The video to be shared. - - Returns: The video + @return The video */ @property (nonatomic, copy) FBSDKShareVideo *video; /** Compares the receiver to another video content. - - Parameter content: The other content - - Returns: YES if the receiver's values are equal to the other content's values; otherwise NO + @param content The other content + @return YES if the receiver's values are equal to the other content's values; otherwise NO */ - (BOOL)isEqualToShareVideoContent:(FBSDKShareVideoContent *)content; diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharing.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharing.h index 7a297ddd8..6174b928b 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharing.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharing.h @@ -25,11 +25,11 @@ /** The common interface for components that initiate sharing. -- See:FBSDKShareDialog + @see FBSDKShareDialog -- See:FBSDKMessageDialog + @see FBSDKMessageDialog -- See:FBSDKShareAPI + @see FBSDKShareAPI */ @protocol FBSDKSharing @@ -53,8 +53,8 @@ /** Validates the content on the receiver. - - Parameter errorRef: If an error occurs, upon return contains an NSError object that describes the problem. - - Returns: YES if the content is valid, otherwise NO. + @param errorRef If an error occurs, upon return contains an NSError object that describes the problem. + @return YES if the content is valid, otherwise NO. */ - (BOOL)validateWithError:(NSError **)errorRef; @@ -72,14 +72,14 @@ required but not available. This method does not validate the content on the receiver, so this can be checked before building up the content. -- See:[FBSDKSharing validateWithError:] - - Returns: YES if the receiver can share, otherwise NO. + @see [FBSDKSharing validateWithError:] + @return YES if the receiver can share, otherwise NO. */ - (BOOL)canShow; /** Shows the dialog. - - Returns: YES if the receiver was able to begin sharing, otherwise NO. + @return YES if the receiver was able to begin sharing, otherwise NO. */ - (BOOL)show; @@ -96,21 +96,21 @@ /** Sent to the delegate when the share completes without error or cancellation. - - Parameter sharer: The FBSDKSharing that completed. - - Parameter results: The results from the sharer. This may be nil or empty. + @param sharer The FBSDKSharing that completed. + @param results The results from the sharer. This may be nil or empty. */ - (void)sharer:(id)sharer didCompleteWithResults:(NSDictionary *)results; /** Sent to the delegate when the sharer encounters an error. - - Parameter sharer: The FBSDKSharing that completed. - - Parameter error: The error. + @param sharer The FBSDKSharing that completed. + @param error The error. */ - (void)sharer:(id)sharer didFailWithError:(NSError *)error; /** Sent to the delegate when the sharer is cancelled. - - Parameter sharer: The FBSDKSharing that completed. + @param sharer The FBSDKSharing that completed. */ - (void)sharerDidCancel:(id)sharer; diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharingButton.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharingButton.h index 5192de470..13cfc1f50 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharingButton.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharingButton.h @@ -23,9 +23,9 @@ /** The common interface for sharing buttons. -- See:FBSDKSendButton + @see FBSDKSendButton -- See:FBSDKShareButton + @see FBSDKShareButton */ @protocol FBSDKSharingButton diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharingContent.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharingContent.h index 0e0e06d25..7806f27cd 100644 --- a/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharingContent.h +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharingContent.h @@ -19,26 +19,27 @@ #import #import +#import @class FBSDKHashtag; /** A base interface for content to be shared. */ -@protocol FBSDKSharingContent +@protocol FBSDKSharingContent /** URL for the content being shared. This URL will be checked for all link meta tags for linking in platform specific ways. See documentation for App Links (https://developers.facebook.com/docs/applinks/) - - Returns: URL representation of the content link + @return URL representation of the content link */ @property (nonatomic, copy) NSURL *contentURL; /** Hashtag for the content being shared. - - Returns: The hashtag for the content being shared. + @return The hashtag for the content being shared. */ @property (nonatomic, copy) FBSDKHashtag *hashtag; @@ -46,32 +47,39 @@ List of IDs for taggable people to tag with this content. See documentation for Taggable Friends (https://developers.facebook.com/docs/graph-api/reference/user/taggable_friends) - - Returns: Array of IDs for people to tag (NSString) + @return Array of IDs for people to tag (NSString) */ @property (nonatomic, copy) NSArray *peopleIDs; /** The ID for a place to tag with this content. - - Returns: The ID for the place to tag + @return The ID for the place to tag */ @property (nonatomic, copy) NSString *placeID; /** A value to be added to the referrer URL when a person follows a link from this shared content on feed. - - Returns: The ref for the content. + @return The ref for the content. */ @property (nonatomic, copy) NSString *ref; /** For shares into Messenger, this pageID will be used to map the app to page and attach attribution to the share. - - Returns: The ID of the Facebok page this share is associated with. + @return The ID of the Facebok page this share is associated with. */ @property (nonatomic, copy) NSString *pageID; /** A unique identifier for a share involving this content, useful for tracking purposes. - - Returns: A unique string identifying this share data. + @return A unique string identifying this share data. */ @property (nonatomic, copy, readonly) NSString *shareUUID; +/** + Adds content to a dictionary as key/value pairs. + - Parameter parameters: A mutable dictionary that may be appended with key/value pairs of content. + */ +- (void)addToParameters:(NSMutableDictionary *)parameters + bridgeOptions:(FBSDKShareBridgeOptions)bridgeOptions; + @end diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharingScheme.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharingScheme.h new file mode 100644 index 000000000..1d81771d1 --- /dev/null +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharingScheme.h @@ -0,0 +1,33 @@ +// Copyright (c) 2014-present, Facebook, Inc. All rights reserved. +// +// You are hereby granted a non-exclusive, worldwide, royalty-free license to use, +// copy, modify, and distribute this software in source code or binary form for use +// in connection with the web services and APIs provided by Facebook. +// +// As with any software that integrates with the Facebook platform, your use of +// this software is subject to the Facebook Developer Principles and Policies +// [http://developers.facebook.com/policy/]. This copyright notice shall be +// included in all copies or substantial portions of the software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS +// FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR +// COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER +// 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 "FBSDKShareDialogMode.h" + +/** + A base interface for indicating a custom URL scheme + */ +@protocol FBSDKSharingScheme + +/** + Asks the receiver to provide a custom scheme. + - Parameter mode: The intended dialog mode for sharing the content. + - Returns: A custom URL scheme to use for the specified mode, or nil. + */ +- (nullable NSString *)schemeForMode:(FBSDKShareDialogMode)mode; + +@end diff --git a/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharingValidation.h b/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharingValidation.h new file mode 100644 index 000000000..b16454a35 --- /dev/null +++ b/src/ios/FBSDKShareKit.framework/Headers/FBSDKSharingValidation.h @@ -0,0 +1,46 @@ +// Copyright (c) 2014-present, Facebook, Inc. All rights reserved. +// +// You are hereby granted a non-exclusive, worldwide, royalty-free license to use, +// copy, modify, and distribute this software in source code or binary form for use +// in connection with the web services and APIs provided by Facebook. +// +// As with any software that integrates with the Facebook platform, your use of +// this software is subject to the Facebook Developer Principles and Policies +// [http://developers.facebook.com/policy/]. This copyright notice shall be +// included in all copies or substantial portions of the software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS +// FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR +// COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER +// 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 + +/** + Flags to indicate support for newer bridge options beyond the initial 20130410 implementation. + */ +typedef NS_OPTIONS(NSUInteger, FBSDKShareBridgeOptions) +{ + FBSDKShareBridgeOptionsDefault = 0, + FBSDKShareBridgeOptionsPhotoAsset = 1 << 0, + FBSDKShareBridgeOptionsPhotoImageURL = 1 << 1, // if set, a web-based URL is required; asset, image, and imageURL.isFileURL not allowed + FBSDKShareBridgeOptionsVideoAsset = 1 << 2, + FBSDKShareBridgeOptionsVideoData = 1 << 3, + FBSDKShareBridgeOptionsWebHashtag = 1 << 4, // if set, pass the hashtag as a string value, not an array of one string +}; + +/** + A base interface for validation of content and media. + */ +@protocol FBSDKSharingValidation + +/** + Asks the receiver to validate that its content or media values are valid. + - Parameter errorRef: Optional, will receive an FBSDKShareError if the values are not valid. + - Returns: YES if the receiver's values are valid; otherwise NO + */ +- (BOOL)validateWithOptions:(FBSDKShareBridgeOptions)bridgeOptions error:(NSError *__autoreleasing *)errorRef; + +@end diff --git a/src/ios/FBSDKShareKit.framework/Info.plist b/src/ios/FBSDKShareKit.framework/Info.plist index d526701db..8ae39fe50 100644 Binary files a/src/ios/FBSDKShareKit.framework/Info.plist and b/src/ios/FBSDKShareKit.framework/Info.plist differ