WAFbImpl.git - Gitblit

			@@ -16,18 +16,30 @@
			// 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.

			#import <Accounts/Accounts.h>
			#import <Foundation/Foundation.h>
			#import <UIKit/UIKit.h>

			NS_ASSUME_NONNULL_BEGIN

			@class FBSDKLoginManagerLoginResult;

			/// typedef for FBSDKLoginAuthType
			typedef NSString *const FBSDKLoginAuthType NS_TYPED_EXTENSIBLE_ENUM NS_SWIFT_NAME(LoginAuthType);

			/// Rerequest
			FOUNDATION_EXPORT FBSDKLoginAuthType FBSDKLoginAuthTypeRerequest;

			/// Reauthorize
			FOUNDATION_EXPORT FBSDKLoginAuthType FBSDKLoginAuthTypeReauthorize;

			/**
			Describes the call back to the FBSDKLoginManager
			- Parameter result: the result of the authorization
			- Parameter error: the authorization error, if any.
			@param result the result of the authorization
			@param error the authorization error, if any.
			*/
			typedef void (^FBSDKLoginManagerRequestTokenHandler)(FBSDKLoginManagerLoginResult result, NSError error);
			typedef void (^FBSDKLoginManagerLoginResultBlock)(FBSDKLoginManagerLoginResult *_Nullable result,
			NSError *_Nullable error)
			NS_SWIFT_NAME(LoginManagerLoginResultBlock);


			/**
			@@ -50,7 +62,7 @@
			FBSDKDefaultAudienceOnlyMe,
			/** Indicates that all Facebook users are able to see posts made by the application */
			FBSDKDefaultAudienceEveryone,
			};
			} NS_SWIFT_NAME(DefaultAudience);

			/**
			FBSDKLoginBehavior enum
			@@ -72,29 +84,11 @@
			typedef NS_ENUM(NSUInteger, FBSDKLoginBehavior)
			{
			/**
			This is the default behavior, and indicates logging in through the native
			Facebook app may be used. The SDK may still use Safari instead.
			This is the default behavior, and indicates logging in via ASWebAuthenticationSession (iOS 12+) or SFAuthenticationSession (iOS 11),
			which present specialized SafariViewControllers. Falls back to plain SFSafariViewController (iOS 9 and 10) or Safari (iOS 8).
			*/
			FBSDKLoginBehaviorNative = 0,
			/**
			Attempts log in through the Safari or SFSafariViewController, if available.
			*/
			FBSDKLoginBehaviorBrowser,
			/**
			Attempts log in through the Facebook account currently signed in through
			the device Settings.
			@note If the account is not available to the app (either not configured by user or
			as determined by the SDK) this behavior falls back to \c FBSDKLoginBehaviorNative.
			*/
			FBSDKLoginBehaviorSystemAccount,
			/**
			Attempts log in through a modal \c UIWebView pop up

			@note This behavior is only available to certain types of apps. Please check the Facebook
			Platform Policy to verify your app meets the restrictions.
			*/
			FBSDKLoginBehaviorWeb,
			};
			FBSDKLoginBehaviorBrowser = 0,
			} NS_SWIFT_NAME(LoginBehavior);

			/**
			`FBSDKLoginManager` provides methods for logging the user in and out.
			@@ -108,8 +102,13 @@
			If you are managing your own token instances outside of "currentAccessToken", you will need to set
			"currentAccessToken" before calling logIn* to authorize further permissions on your tokens.
			*/
			NS_SWIFT_NAME(LoginManager)
			@interface FBSDKLoginManager : NSObject

			/**
			Auth type
			*/
			@property (strong, nonatomic) FBSDKLoginAuthType authType;
			/**
			the default audience.

			@@ -123,50 +122,14 @@
			@property (assign, nonatomic) FBSDKLoginBehavior loginBehavior;

			/**

			- Warning:use logInWithReadPermissions:fromViewController:handler: instead
			*/
			- (void)logInWithReadPermissions:(NSArray *)permissions handler:(FBSDKLoginManagerRequestTokenHandler)handler
			__attribute__ ((deprecated("use logInWithReadPermissions:fromViewController:handler: instead")));

			/**

			- Warning:use logInWithPublishPermissions:fromViewController:handler: instead
			*/
			- (void)logInWithPublishPermissions:(NSArray *)permissions handler:(FBSDKLoginManagerRequestTokenHandler)handler
			__attribute__ ((deprecated("use logInWithPublishPermissions:fromViewController:handler: instead")));

			/**
			Logs the user in or authorizes additional permissions.
			- Parameter permissions: the optional array of permissions. Note this is converted to NSSet and is only
			an NSArray for the convenience of literal syntax.
			- Parameter fromViewController: the view controller to present from. If nil, the topmost view controller will be
			automatically determined as best as possible.
			- Parameter handler: the callback.
			Logs the user in or authorizes additional permissions.
			@param permissions the optional array of permissions. Note this is converted to NSSet and is only
			an NSArray for the convenience of literal syntax.
			@param fromViewController the view controller to present from. If nil, the topmost view controller will be
			automatically determined as best as possible.
			@param handler the callback.

			Use this method when asking for read permissions. You should only ask for permissions when they
			are needed and explain the value to the user. You can inspect the result.declinedPermissions to also
			provide more information to the user if they decline permissions.

			This method will present UI the user. You typically should check if `[FBSDKAccessToken currentAccessToken]`
			already contains the permissions you need before asking to reduce unnecessary app switching. For example,
			you could make that check at viewDidLoad.
			You can only do one login call at a time. Calling a login method before the completion handler is called
			on a previous login will return an error.
			*/
			- (void)logInWithReadPermissions:(NSArray *)permissions
			fromViewController:(UIViewController *)fromViewController
			handler:(FBSDKLoginManagerRequestTokenHandler)handler;

			/**
			Logs the user in or authorizes additional permissions.
			- Parameter permissions: the optional array of permissions. Note this is converted to NSSet and is only
			an NSArray for the convenience of literal syntax.
			- Parameter fromViewController: the view controller to present from. If nil, the topmost view controller will be
			automatically determined as best as possible.
			- Parameter handler: the callback.

			Use this method when asking for publish permissions. You should only ask for permissions when they
			are needed and explain the value to the user. You can inspect the result.declinedPermissions to also
			provide more information to the user if they decline permissions.

			@@ -176,9 +139,25 @@
			You can only do one login call at a time. Calling a login method before the completion handler is called
			on a previous login will return an error.
			*/
			- (void)logInWithPublishPermissions:(NSArray *)permissions
			fromViewController:(UIViewController *)fromViewController
			handler:(FBSDKLoginManagerRequestTokenHandler)handler;
			- (void)logInWithPermissions:(NSArray<NSString > )permissions
			fromViewController:(nullable UIViewController *)fromViewController
			handler:(nullable FBSDKLoginManagerLoginResultBlock)handler
			NS_SWIFT_NAME(logIn(permissions:from:handler:));

			/**
			Requests user's permission to reathorize application's data access, after it has expired due to inactivity.
			@param fromViewController the view controller to present from. If nil, the topmost view controller will be
			automatically determined as best as possible.
			@param handler the callback.
			Use this method when you need to reathorize your app's access to user data via Graph API, after such an access has expired.
			You should provide as much context to the user as possible as to why you need to reauthorize the access, the scope of
			access being reathorized, and what added value your app provides when the access is reathorized.
			You can inspect the result.declinedPermissions to also provide more information to the user if they decline permissions.
			This method will present UI the user. You typically should call this if `[FBSDKAccessToken isDataAccessExpired]` returns true.
			*/
			- (void)reauthorizeDataAccess:(UIViewController *)fromViewController
			handler:(FBSDKLoginManagerLoginResultBlock)handler
			NS_SWIFT_NAME(reauthorizeDataAccess(from:handler:));

			/**
			Logs the user out
			@@ -187,22 +166,6 @@
			*/
			- (void)logOut;

			/**
			@method

			Issues an asynchronous renewCredentialsForAccount call to the device's Facebook account store.

			- Parameter handler: The completion handler to call when the renewal is completed. This can be invoked on an arbitrary thread.


			This can be used to explicitly renew account credentials and is provided as a convenience wrapper around
			`[ACAccountStore renewCredentialsForAccount:completion]`. Note the method will not issue the renewal call if the the
			Facebook account has not been set on the device, or if access had not been granted to the account (though the handler
			wil receive an error).

			If the `[FBSDKAccessToken currentAccessToken]` was from the account store, a succesful renewal will also set
			a new "currentAccessToken".
			*/
			+ (void)renewSystemCredentials:(void (^)(ACAccountCredentialRenewResult result, NSError *error))handler;

			@end

			NS_ASSUME_NONNULL_END