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/FBSDKProfile.h | 141 +++++++++++++++++++++++++++------------------- 1 files changed, 83 insertions(+), 58 deletions(-) diff --git a/frameworks/FBSDKCoreKit.framework/Headers/FBSDKProfile.h b/frameworks/FBSDKCoreKit.framework/Headers/FBSDKProfile.h index 1f33f16..af8095d 100644 --- a/frameworks/FBSDKCoreKit.framework/Headers/FBSDKProfile.h +++ b/frameworks/FBSDKCoreKit.framework/Headers/FBSDKProfile.h @@ -14,10 +14,15 @@ // 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. +// CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE." -#import "FBSDKMacros.h" #import "FBSDKProfilePictureView.h" + +@class FBSDKProfile; + +NS_ASSUME_NONNULL_BEGIN + +#if __IPHONE_OS_VERSION_MAX_ALLOWED >= __IPHONE_10_0 /** Notification indicating that the `currentProfile` has changed. @@ -26,19 +31,45 @@ `FBSDKProfileChangeOldKey` and `FBSDKProfileChangeNewKey`. */ -FBSDK_EXTERN NSString *const FBSDKProfileDidChangeNotification; +FOUNDATION_EXPORT NSNotificationName const FBSDKProfileDidChangeNotification +NS_SWIFT_NAME(ProfileDidChange); + +#else + +/** + Notification indicating that the `currentProfile` has changed. + + the userInfo dictionary of the notification will contain keys + `FBSDKProfileChangeOldKey` and + `FBSDKProfileChangeNewKey`. + */ +FOUNDATION_EXPORT NSString *const FBSDKProfileDidChangeNotification +NS_SWIFT_NAME(ProfileDidChangeNotification); + +#endif /* key in notification's userInfo object for getting the old profile. If there was no old profile, the key will not be present. */ -FBSDK_EXTERN NSString *const FBSDKProfileChangeOldKey; +FOUNDATION_EXPORT NSString *const FBSDKProfileChangeOldKey +NS_SWIFT_NAME(ProfileChangeOldKey); /* key in notification's userInfo object for getting the new profile. If there is no new profile, the key will not be present. */ -FBSDK_EXTERN NSString *const FBSDKProfileChangeNewKey; +FOUNDATION_EXPORT NSString *const FBSDKProfileChangeNewKey +NS_SWIFT_NAME(ProfileChangeNewKey); + +/** + Describes the callback for loadCurrentProfileWithCompletion. + @param profile the FBSDKProfile + @param error the error during the request, if any + + */ +typedef void (^FBSDKProfileBlock)(FBSDKProfile *_Nullable profile, NSError *_Nullable error) +NS_SWIFT_NAME(ProfileBlock); /** Represents an immutable Facebook profile @@ -52,25 +83,41 @@ You can use this class to build your own `FBSDKProfilePictureView` or in place of typical requests to "/me". */ +NS_SWIFT_NAME(Profile) @interface FBSDKProfile : NSObject<NSCopying, NSSecureCoding> + +- (instancetype)init NS_UNAVAILABLE; ++ (instancetype)new NS_UNAVAILABLE; /** 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 - middleName:(NSString *)middleName - lastName:(NSString *)lastName - name:(NSString *)name - linkURL:(NSURL *)linkURL - refreshDate:(NSDate *)refreshDate NS_DESIGNATED_INITIALIZER; + firstName:(nullable NSString *)firstName + middleName:(nullable NSString *)middleName + lastName:(nullable NSString *)lastName + name:(nullable NSString *)name + linkURL:(nullable NSURL *)linkURL + refreshDate:(nullable NSDate *)refreshDate NS_DESIGNATED_INITIALIZER; + +/** + The current profile instance and posts the appropriate notification + if the profile parameter is different than the receiver. + + This persists the profile to NSUserDefaults. + */ + +/// The current profile +@property (class, nonatomic, strong, nullable) FBSDKProfile *currentProfile +NS_SWIFT_NAME(current); + /** The user id */ @@ -78,26 +125,26 @@ /** The user's first name */ -@property (nonatomic, copy, readonly) NSString *firstName; +@property (nonatomic, copy, readonly, nullable) NSString *firstName; /** The user's middle name */ -@property (nonatomic, copy, readonly) NSString *middleName; +@property (nonatomic, copy, readonly, nullable) NSString *middleName; /** The user's last name */ -@property (nonatomic, copy, readonly) NSString *lastName; +@property (nonatomic, copy, readonly, nullable) NSString *lastName; /** The user's complete name */ -@property (nonatomic, copy, readonly) NSString *name; +@property (nonatomic, copy, readonly, nullable) NSString *name; /** A URL to the user's profile. - Consider using Bolts and `FBSDKAppLinkResolver` to resolve this + Consider using `FBSDKAppLinkResolver` to resolve this to an app link to link directly to the user's profile in the Facebook app. */ -@property (nonatomic, readonly) NSURL *linkURL; +@property (nonatomic, readonly, nullable) NSURL *linkURL; /** The last time the profile data was fetched. @@ -105,22 +152,8 @@ @property (nonatomic, readonly) NSDate *refreshDate; /** - Gets the current FBSDKProfile instance. - */ -+ (FBSDKProfile *)currentProfile; - -/** - Sets the current instance and posts the appropriate notification if the profile parameter is different - than the receiver. - - Parameter profile: the profile to set - - This persists the profile to NSUserDefaults. - */ -+ (void)setCurrentProfile:(FBSDKProfile *)profile; - -/** 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. @@ -128,39 +161,31 @@ Note that if `[FBSDKAccessToken currentAccessToken]` is unset, the `currentProfile` instance remains. It's also possible for `currentProfile` to return nil until the data is fetched. */ -+ (void)enableUpdatesOnAccessTokenChange:(BOOL)enable; ++ (void)enableUpdatesOnAccessTokenChange:(BOOL)enable +NS_SWIFT_NAME(enableUpdatesOnAccessTokenChange(_:)); /** 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. */ -+ (void)loadCurrentProfileWithCompletion:(void(^)(FBSDKProfile *profile, NSError *error))completion; ++ (void)loadCurrentProfileWithCompletion:(nullable FBSDKProfileBlock)completion; /** 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 - - 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. - */ -- (NSString *)imagePathForPictureMode:(FBSDKProfilePictureMode)mode size:(CGSize)size -__attribute__ ((deprecated("use imageURLForPictureMode:size: instead"))); +- (nullable NSURL *)imageURLForPictureMode:(FBSDKProfilePictureMode)mode size:(CGSize)size +NS_SWIFT_NAME(imageURL(forMode:size:)); /** 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 + +NS_ASSUME_NONNULL_END -- Gitblit v1.8.0