[Update] WAFbImpl (3.8.0)

hank

2019-01-22 bf63695cd124ba0c3127f4cc8aa99c737729dd1d

 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;