From 13e53a03f4d50169d0cf7f72d414753ae6b421ce Mon Sep 17 00:00:00 2001 From: hank <hank.zhang@proficientcity.com> Date: Tue, 22 Jan 2019 11:04:39 +0800 Subject: [PATCH] 添加V3.8.0 --- frameworks/FBSDKCoreKit.framework/Headers/FBSDKProfile.h | 141 ++++++++++++++++++++++++++++------------------- 1 files changed, 84 insertions(+), 57 deletions(-) diff --git a/frameworks/FBSDKCoreKit.framework/Headers/FBSDKProfile.h b/frameworks/FBSDKCoreKit.framework/Headers/FBSDKProfile.h index 0505ac5..d0e245b 100644 --- a/frameworks/FBSDKCoreKit.framework/Headers/FBSDKProfile.h +++ b/frameworks/FBSDKCoreKit.framework/Headers/FBSDKProfile.h @@ -14,32 +14,50 @@ // 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" -/*! - @abstract Notification indicating that the `currentProfile` has changed. - @discussion the userInfo dictionary of the notification will contain keys +#if __IPHONE_OS_VERSION_MAX_ALLOWED >= __IPHONE_10_0 + +/** + Notification indicating that the `currentProfile` has changed. + + the userInfo dictionary of the notification will contain keys `FBSDKProfileChangeOldKey` and `FBSDKProfileChangeNewKey`. */ -FBSDK_EXTERN NSString *const FBSDKProfileDidChangeNotification; +FOUNDATION_EXPORT NSNotificationName const FBSDKProfileDidChangeNotification; -/* @abstract key in notification's userInfo object for getting the old profile. - @discussion If there was no old profile, the key will not be present. +#else + +/** + Notification indicating that the `currentProfile` has changed. + + the userInfo dictionary of the notification will contain keys + `FBSDKProfileChangeOldKey` and + `FBSDKProfileChangeNewKey`. */ -FBSDK_EXTERN NSString *const FBSDKProfileChangeOldKey; +FOUNDATION_EXPORT NSString *const FBSDKProfileDidChangeNotification; -/* @abstract key in notification's userInfo object for getting the new profile. - @discussion If there is no new profile, the key will not be present. +#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 FBSDKProfileChangeNewKey; +FOUNDATION_EXPORT NSString *const FBSDKProfileChangeOldKey; -/*! - @abstract Represents an immutable Facebook profile - @discussion This class provides a global "currentProfile" instance to more easily +/* key in notification's userInfo object for getting the new profile. + + If there is no new profile, the key will not be present. + */ +FOUNDATION_EXPORT NSString *const FBSDKProfileChangeNewKey; + +/** + Represents an immutable Facebook profile + + This class provides a global "currentProfile" instance to more easily add social context to your application. When the profile changes, a notification is posted so that you can update relevant parts of your UI and is persisted to NSUserDefaults. @@ -50,8 +68,11 @@ */ @interface FBSDKProfile : NSObject<NSCopying, NSSecureCoding> -/*! - @abstract initializes a new instance. +- (instancetype)init NS_UNAVAILABLE; ++ (instancetype)new NS_UNAVAILABLE; + +/** + initializes a new instance. @param userID the user ID @param firstName the user's first name @param middleName the user's middle name @@ -67,55 +88,58 @@ name:(NSString *)name linkURL:(NSURL *)linkURL refreshDate:(NSDate *)refreshDate NS_DESIGNATED_INITIALIZER; -/*! - @abstract The user id +/** + The user id */ -@property (nonatomic, readonly) NSString *userID; -/*! - @abstract The user's first name +@property (nonatomic, copy, readonly) NSString *userID; +/** + The user's first name */ -@property (nonatomic, readonly) NSString *firstName; -/*! - @abstract The user's middle name +@property (nonatomic, copy, readonly) NSString *firstName; +/** + The user's middle name */ -@property (nonatomic, readonly) NSString *middleName; -/*! - @abstract The user's last name +@property (nonatomic, copy, readonly) NSString *middleName; +/** + The user's last name */ -@property (nonatomic, readonly) NSString *lastName; -/*! - @abstract The user's complete name +@property (nonatomic, copy, readonly) NSString *lastName; +/** + The user's complete name */ -@property (nonatomic, readonly) NSString *name; -/*! - @abstract A URL to the user's profile. - @discussion Consider using Bolts and `FBSDKAppLinkResolver` to resolve this +@property (nonatomic, copy, readonly) NSString *name; +/** + A URL to the user's profile. + + Consider using Bolts and `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; -/*! - @abstract The last time the profile data was fetched. +/** + The last time the profile data was fetched. */ @property (nonatomic, readonly) NSDate *refreshDate; -/*! - @abstract Gets the current FBSDKProfile instance. +/** + Gets the current FBSDKProfile instance. */ + (FBSDKProfile *)currentProfile; -/*! - @abstract Sets the current instance and posts the appropriate notification if the profile parameter is different +/** + Sets the current instance and posts the appropriate notification if the profile parameter is different than the receiver. @param profile the profile to set - @discussion This persists the profile to NSUserDefaults. + + This persists the profile to NSUserDefaults. */ + (void)setCurrentProfile:(FBSDKProfile *)profile; -/*! - @abstract Indicates if `currentProfile` will automatically observe `FBSDKAccessTokenDidChangeNotification` notifications +/** + Indicates if `currentProfile` will automatically observe `FBSDKAccessTokenDidChangeNotification` notifications @param enable YES is observing - @discussion If observing, this class will issue a graph request for public profile data when the current token's userID + + 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. Note that if `[FBSDKAccessToken currentAccessToken]` is unset, the `currentProfile` instance remains. It's also possible @@ -123,33 +147,36 @@ */ + (void)enableUpdatesOnAccessTokenChange:(BOOL)enable; -/*! - @abstract Loads the current profile and passes it to the completion block. +/** + Loads the current profile and passes it to the completion block. @param completion The block to be executed once the profile is loaded - @discussion If the profile is already loaded, this method will call the completion block synchronously, otherwise it + + 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; -/*! - @abstract A convenience method for returning a complete `NSURL` for retrieving the user's profile image. +/** + A convenience method for returning a complete `NSURL` for retrieving the user's profile image. @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; -/*! - @abstract A convenience method for returning a Graph API path for retrieving the user's profile image. - @deprecated use `imageURLForPictureMode:size:` instead - @discussion You can pass this to a `FBSDKGraphRequest` instance to download the image. +/** + 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. @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"))); +DEPRECATED_MSG_ATTRIBUTE("use imageURLForPictureMode:size: instead"); -/*! - @abstract Returns YES if the profile is equivalent to the receiver. +/** + Returns YES if the profile is equivalent to the receiver. @param profile the profile to compare to. */ - (BOOL)isEqualToProfile:(FBSDKProfile *)profile; -- Gitblit v1.8.0