From b19a78b27247f5f0761c35b5b3e8a41876eabb05 Mon Sep 17 00:00:00 2001
From: lpw <pengwei.li@gamehollywood.com>
Date: Tue, 20 Apr 2021 17:18:32 +0800
Subject: [PATCH] no message
---
frameworks/FBSDKCoreKit.framework/Headers/FBSDKProfile.h | 286 ++++++++++++++++++++++++++++++++++++++++++++++----------
1 files changed, 233 insertions(+), 53 deletions(-)
diff --git a/frameworks/FBSDKCoreKit.framework/Headers/FBSDKProfile.h b/frameworks/FBSDKCoreKit.framework/Headers/FBSDKProfile.h
index 1f33f16..9f0dc04 100644
--- a/frameworks/FBSDKCoreKit.framework/Headers/FBSDKProfile.h
+++ b/frameworks/FBSDKCoreKit.framework/Headers/FBSDKProfile.h
@@ -14,10 +14,21 @@
// 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 "TargetConditionals.h"
+
+#if !TARGET_OS_TV
+
#import "FBSDKProfilePictureView.h"
+
+@class FBSDKAuthenticationTokenClaims;
+@class FBSDKProfile;
+@class FBSDKUserAgeRange;
+
+NS_ASSUME_NONNULL_BEGIN
+
+#if __IPHONE_OS_VERSION_MAX_ALLOWED >= __IPHONE_10_0
/**
Notification indicating that the `currentProfile` has changed.
@@ -26,19 +37,51 @@
`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 the unique identifier for an end user
+ */
+typedef NSString FBSDKUserIdentifier
+NS_SWIFT_NAME(UserIdentifier);
/**
Represents an immutable Facebook profile
@@ -52,75 +95,218 @@
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;
+- (instancetype)initWithUserID:(FBSDKUserIdentifier *)userID
+ firstName:(nullable NSString *)firstName
+ middleName:(nullable NSString *)middleName
+ lastName:(nullable NSString *)lastName
+ name:(nullable NSString *)name
+ linkURL:(nullable NSURL *)linkURL
+ refreshDate:(nullable NSDate *)refreshDate;
+
+/**
+ initializes a new instance.
+ @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].
+ @param imageURL an optional URL to use for fetching a user's profile image
+ @param email the user's email
+ */
+- (instancetype)initWithUserID:(FBSDKUserIdentifier *)userID
+ firstName:(nullable NSString *)firstName
+ middleName:(nullable NSString *)middleName
+ lastName:(nullable NSString *)lastName
+ name:(nullable NSString *)name
+ linkURL:(nullable NSURL *)linkURL
+ refreshDate:(nullable NSDate *)refreshDate
+ imageURL:(nullable NSURL *)imageURL
+ email:(nullable NSString *)email
+DEPRECATED_MSG_ATTRIBUTE("This constructor will be removed in the next major release.");
+
+/**
+ @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].
+ @param imageURL an optional URL to use for fetching a user's profile image
+ @param email the user's email
+ @param friendIDs a list of identifiers for the user's friends
+ @param birthday the user's birthday
+ @param ageRange the user's age range
+ @param isLimited indicates if the information provided is incomplete in some way.
+ When true, `loadCurrentProfileWithCompletion:` will assume the profile is
+ incomplete and disregard any cached profile. Defaults to false.
+ */
+- (instancetype)initWithUserID:(FBSDKUserIdentifier *)userID
+ firstName:(nullable NSString *)firstName
+ middleName:(nullable NSString *)middleName
+ lastName:(nullable NSString *)lastName
+ name:(nullable NSString *)name
+ linkURL:(nullable NSURL *)linkURL
+ refreshDate:(nullable NSDate *)refreshDate
+ imageURL:(nullable NSURL *)imageURL
+ email:(nullable NSString *)email
+ friendIDs:(nullable NSArray<FBSDKUserIdentifier *> *)friendIDs
+ birthday:(nullable NSDate *)birthday
+ ageRange:(nullable FBSDKUserAgeRange *)ageRange
+ isLimited:(BOOL)isLimited;
+
+/**
+ initializes a new instance.
+ @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].
+ @param imageURL an optional URL to use for fetching a user's profile image
+ @param email the user's email
+ @param friendIDs a list of identifiers for the user's friends
+ */
+- (instancetype)initWithUserID:(FBSDKUserIdentifier *)userID
+ firstName:(nullable NSString *)firstName
+ middleName:(nullable NSString *)middleName
+ lastName:(nullable NSString *)lastName
+ name:(nullable NSString *)name
+ linkURL:(nullable NSURL *)linkURL
+ refreshDate:(nullable NSDate *)refreshDate
+ imageURL:(nullable NSURL *)imageURL
+ email:(nullable NSString *)email
+ friendIDs:(nullable NSArray<FBSDKUserIdentifier *> *)friendIDs
+DEPRECATED_MSG_ATTRIBUTE("This constructor will be removed in the next major release.");;
+
+/**
+ initializes a new instance.
+ @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].
+ @param imageURL an optional URL to use for fetching a user's profile image
+ @param email the user's email
+ @param friendIDs a list of identifiers for the user's friends
+ @param birthday the user's birthday
+ @param ageRange the user's age range
+ */
+- (instancetype)initWithUserID:(FBSDKUserIdentifier *)userID
+ firstName:(nullable NSString *)firstName
+ middleName:(nullable NSString *)middleName
+ lastName:(nullable NSString *)lastName
+ name:(nullable NSString *)name
+ linkURL:(nullable NSURL *)linkURL
+ refreshDate:(nullable NSDate *)refreshDate
+ imageURL:(nullable NSURL *)imageURL
+ email:(nullable NSString *)email
+ friendIDs:(nullable NSArray<FBSDKUserIdentifier *> *)friendIDs
+ birthday:(nullable NSDate *)birthday
+ ageRange:(nullable FBSDKUserAgeRange *)ageRange
+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
*/
-@property (nonatomic, copy, readonly) NSString *userID;
+@property (nonatomic, copy, readonly) FBSDKUserIdentifier *userID;
/**
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
+ IMPORTANT: This field will only be populated if your user has granted your application the 'user_link' permission
+
+ 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.
*/
@property (nonatomic, readonly) NSDate *refreshDate;
+/**
+ A URL to use for fetching a user's profile image.
+ */
+@property (nonatomic, readonly, nullable) NSURL *imageURL;
+/**
+ The user's email.
+
+ IMPORTANT: This field will only be populated if your user has granted your application the 'email' permission.
+ */
+@property (nonatomic, copy, readonly, nullable) NSString *email;
+/**
+ A list of identifiers of the user's friends.
+
+ IMPORTANT: This field will only be populated if your user has granted your application the 'user_friends' permission.
+ We are building out this field in Limited Login with the intention to roll it out in early spring.
+ */
+@property (nonatomic, copy, readonly, nullable) NSArray<FBSDKUserIdentifier *> *friendIDs;
/**
- Gets the current FBSDKProfile instance.
+ The user's birthday.
+
+ IMPORTANT: This field will only be populated if your user has granted your application the 'user_birthday' permission.
*/
-+ (FBSDKProfile *)currentProfile;
+@property (nonatomic, copy, readonly, nullable) NSDate *birthday;
/**
- Sets the current instance and posts the appropriate notification if the profile parameter is different
- than the receiver.
- - Parameter profile: the profile to set
+ The user's age range
- This persists the profile to NSUserDefaults.
+ IMPORTANT: This field will only be populated if your user has granted your application the 'user_age_range' permission.
*/
-+ (void)setCurrentProfile:(FBSDKProfile *)profile;
+@property (nonatomic, copy, readonly, nullable) FBSDKUserAgeRange *ageRange;
/**
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 +314,33 @@
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
+
+#endif
--
Gitblit v1.8.0