From 9fdbb77fd2d766c9aa88f6753108354592770058 Mon Sep 17 00:00:00 2001 From: hank <hank.zhang@proficientcity.com> Date: Thu, 20 Jun 2019 09:50:53 +0800 Subject: [PATCH] [Update] WAFbImpl (3.8.2) --- frameworks/FBSDKCoreKit.framework/Headers/FBSDKGraphErrorRecoveryProcessor.h | 67 +++++++++++++++++++++------------ 1 files changed, 42 insertions(+), 25 deletions(-) diff --git a/frameworks/FBSDKCoreKit.framework/Headers/FBSDKGraphErrorRecoveryProcessor.h b/frameworks/FBSDKCoreKit.framework/Headers/FBSDKGraphErrorRecoveryProcessor.h index d2b0313..465c6ab 100644 --- a/frameworks/FBSDKCoreKit.framework/Headers/FBSDKGraphErrorRecoveryProcessor.h +++ b/frameworks/FBSDKCoreKit.framework/Headers/FBSDKGraphErrorRecoveryProcessor.h @@ -20,41 +20,53 @@ #import "FBSDKConstants.h" +NS_ASSUME_NONNULL_BEGIN + @class FBSDKGraphErrorRecoveryProcessor; @class FBSDKGraphRequest; -/*! - @abstract Defines a delegate for `FBSDKGraphErrorRecoveryProcessor`. +/** + Defines a delegate for `FBSDKGraphErrorRecoveryProcessor`. */ +NS_SWIFT_NAME(GraphErrorRecoveryProcessorDelegate) @protocol FBSDKGraphErrorRecoveryProcessorDelegate<NSObject> -/*! - @abstract Indicates the error recovery has been attempted. +/** + Indicates the error recovery has been attempted. @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; +- (void)processorDidAttemptRecovery:(FBSDKGraphErrorRecoveryProcessor *)processor + didRecover:(BOOL)didRecover + error:(nullable NSError *)error; @optional -/*! - @abstract Indicates the processor is about to process the error. +/** + Indicates the processor is about to process the error. @param processor the processor instance. @param error the error is about to be processed. - @discussion return NO if the processor should not process the error. For example, + + 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, - you could return NO for errors where userInfo[FBSDKGraphRequestErrorCategoryKey] equal to FBSDKGraphRequestErrorCategoryOther + you could return NO for errors where userInfo[FBSDKGraphRequestErrorKey] equal to FBSDKGraphRequestErrorOther */ -- (BOOL)processorWillProcessError:(FBSDKGraphErrorRecoveryProcessor *)processor error:(NSError *)error; +- (BOOL)processorWillProcessError:(FBSDKGraphErrorRecoveryProcessor *)processor + error:(nullable NSError *)error; @end -/*! - @abstract Defines a type that can process Facebook NSErrors with best practices. - @discussion Facebook NSErrors can contain FBSDKErrorRecoveryAttempting instances to recover from errors, or +NS_ASSUME_NONNULL_END + +NS_ASSUME_NONNULL_BEGIN + +/** + Defines a type that can process Facebook NSErrors with best practices. + + Facebook NSErrors can contain FBSDKErrorRecoveryAttempting instances to recover from errors, or localized messages to present to the user. This class will process the instances as follows: - 1. If the error is temporary as indicated by FBSDKGraphRequestErrorCategoryKey, assume the recovery succeeded and + 1. If the error is temporary as indicated by FBSDKGraphRequestErrorKey, assume the recovery succeeded and notify the delegate. 2. If a FBSDKErrorRecoveryAttempting instance is available, display an alert (dispatched to main thread) with the recovery options and call the instance's [ attemptRecoveryFromError:optionIndex:...]. @@ -67,31 +79,36 @@ Note that Facebook recovery attempters can present UI or even cause app switches (such as to login). Any such work is dispatched to the main thread (therefore your request handlers may then run on the main thread). - Login recovery requires FBSDKLoginKit. Login will use FBSDKLoginBehaviorNative and will prompt the user + Login recovery requires FBSDKLoginKit. Login will prompt the user for all permissions last granted. If any are declined on the new request, the recovery is not successful but the `[FBSDKAccessToken currentAccessToken]` might still have been updated. . */ +NS_SWIFT_UNAVAILABLE("") @interface FBSDKGraphErrorRecoveryProcessor : NSObject -/*! - @abstract Gets the delegate. Note this is a strong reference, and is nil'ed out after recovery is complete. +/** + Gets the delegate. Note this is a strong reference, and is nil'ed out after recovery is complete. */ -@property (nonatomic, strong, readonly) id<FBSDKGraphErrorRecoveryProcessorDelegate>delegate; +@property (nonatomic, strong, readonly, nullable) id<FBSDKGraphErrorRecoveryProcessorDelegate>delegate; -/*! - @abstract Attempts to process the error, return YES if the error can be processed. +/** + Attempts to process the error, return YES if the error can be processed. @param error the error to process. - @param request the relateed request that may be reissued. + @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<FBSDKGraphErrorRecoveryProcessorDelegate>) delegate; +- (BOOL)processError:(NSError *)error + request:(FBSDKGraphRequest *)request + delegate:(nullable id<FBSDKGraphErrorRecoveryProcessorDelegate>)delegate; -/*! - @abstract The callback for FBSDKErrorRecoveryAttempting +/** + The callback for FBSDKErrorRecoveryAttempting @param didRecover if the recovery succeeded @param contextInfo unused */ -- (void)didPresentErrorWithRecovery:(BOOL)didRecover contextInfo:(void *)contextInfo; +- (void)didPresentErrorWithRecovery:(BOOL)didRecover contextInfo:(nullable void *)contextInfo; @end + +NS_ASSUME_NONNULL_END -- Gitblit v1.8.0