FBSettings
This class is no longer available in the most recent version of the SDK.
A more recent version of this class is available. Check out the latest version.
Class Methods
clientToken

Retrieve the Client Token that has been set via [FBSettings setClientToken]

+ (NSString *) clientToken;
Declared In: FBSettings.h
defaultAppID

Get the default Facebook App ID used by the SDK. If not explicitly set, the default will be read from the application's plist. The SDK allows the appID to be overridden per instance in certain cases (e.g. per instance of FBSession)

+ (NSString*) defaultAppID;
Declared In: FBSettings.h
defaultDisplayName

Get the default Facebook Display Name used by the SDK. If not explicitly set, the default will be read from the application's plist.

+ (NSString *) defaultDisplayName;
Declared In: FBSettings.h
defaultUrlSchemeSuffix

Get the default url scheme suffix used for sessions. If not explicitly set, the default will be read from the application's plist. The SDK allows the url scheme suffix to be overridden per instance in certain cases (e.g. per instance of FBSession)

+ (NSString*) defaultUrlSchemeSuffix;
Declared In: FBSettings.h
disableBetaFeature:

Disables a beta feature.

ParameterDescription
betaFeature

The beta feature to disable.

+ (void) disableBetaFeature:(FBBetaFeatures)betaFeature;
Declared In: FBSettings.h
enableBetaFeature:

Enables a beta feature. Beta features are for evaluation only, and are therefore only enabled for debug builds. Beta features should not be enabled in release builds.

ParameterDescription
betaFeature

The beta feature to enable.

+ (void) enableBetaFeature:(FBBetaFeatures)betaFeature;
Declared In: FBSettings.h
enableBetaFeatures:

Enables the specified beta features. Beta features are for evaluation only, and are therefore only enabled for debug builds. Beta features should not be enabled in release builds.

ParameterDescription
betaFeatures

The beta features to enable (expects a bitwise OR of FBBetaFeatures)

+ (void) enableBetaFeatures:(NSUInteger)betaFeatures;
Declared In: FBSettings.h
isBetaFeatureEnabled:

Determines whether a beta feature is enabled or not.

ParameterDescription
betaFeature

The beta feature to check.

+ (BOOL) isBetaFeatureEnabled:(FBBetaFeatures)betaFeature;
Declared In: FBSettings.h
loggingBehavior

Retrieve the current Facebook SDK logging behavior.

+ (NSSet *) loggingBehavior;
Declared In: FBSettings.h
publishInstall:

Manually publish an attributed install to the facebook graph. Calling this method will implicitly turn off auto-publish. This method acquires the current attribution id from the facebook application, queries the graph API to determine if the application has install attribution enabled, publishes the id, and records success to avoid reporting more than once.

ParameterDescription
appID

A specific appID to publish an install for. If nil, uses [FBSession defaultAppID].

+ (void) publishInstall:(NSString *)appID;
Declared In: FBSettings.h
publishInstall:withHandler:

Manually publish an attributed install to the Facebook graph, and return the server response back in the supplied handler. Calling this method will implicitly turn off auto-publish. This method acquires the current attribution id from the facebook application, queries the graph API to determine if the application has install attribution enabled, publishes the id, and records success to avoid reporting more than once.

ParameterDescription
appID

A specific appID to publish an install for. If nil, uses [FBSession defaultAppID].

handler

A block to call with the server's response.

+ (void)
publishInstall: (NSString *)appID
withHandler: (FBInstallResponseDataHandler)handler;
Declared In: FBSettings.h
setClientToken:

Sets the Client Token for the Facebook App. This is needed for certain API calls when made anonymously, without a user-based Session. Calls to FBInsights logging events are examples of this, when there may have been no user login established.

ParameterDescription
clientToken

The Facebook App's "client token", which, for a given appid can be found in the Security section of the Advanced tab of the Facebook App settings found at https://developers.facebook.com/apps/[your-app-id]

+ (void) setClientToken:(NSString *)clientToken;
Declared In: FBSettings.h
setDefaultAppID:

Set the default Facebook App ID to use for sessions. The SDK allows the appID to be overridden per instance in certain cases (e.g. per instance of FBSession)

ParameterDescription
appID

The default Facebook App ID to be used by the SDK.

+ (void) setDefaultAppID:(NSString*)appID;
Declared In: FBSettings.h
setDefaultDisplayName:

Set the default Facebook Display Name to be used by the SDK. This should match the Display Name that has been set for the app with the corresponding Facebook App ID, in the Facebook App Dashboard

ParameterDescription
displayName

The default Facebook Display Name to be used by the SDK.

+ (void) setDefaultDisplayName:(NSString *)displayName;
Declared In: FBSettings.h
setDefaultUrlSchemeSuffix:

Set the default url scheme suffix used by the SDK. The SDK allows the url scheme suffix to be overridden per instance in certain cases (e.g. per instance of FBSession)

ParameterDescription
urlSchemeSuffix

The default url scheme suffix to be used by the SDK.

+ (void) setDefaultUrlSchemeSuffix:(NSString*)urlSchemeSuffix;
Declared In: FBSettings.h
setLoggingBehavior:

Set the current Facebook SDK logging behavior. This should consist of strings defined as constants with FBLogBehavior*, and can be constructed with, e.g., [NSSet initWithObjects:].

ParameterDescription
loggingBehavior

A set of strings indicating what information should be logged. If nil is provided, the logging behavior is reset to the default set of enabled behaviors. Set in an empty set in order to disable all logging.

+ (void) setLoggingBehavior:(NSSet *)loggingBehavior;
Declared In: FBSettings.h
setShouldAutoPublishInstall:

Sets whether the SDK will automatically publish an install to Facebook during first FBSession init or on first network request to Facebook.

ParameterDescription
autoPublishInstall

If YES, automatically publish the install; if NO, do not.

+ (void) setShouldAutoPublishInstall:(BOOL)autoPublishInstall;
Declared In: FBSettings.h
shouldAutoPublishInstall

Retreive the current auto publish behavior. Defaults to YES.

+ (BOOL) shouldAutoPublishInstall;
Declared In: FBSettings.h
Constants
FBLoggingBehaviorAccessTokens
extern NSString *const FBLoggingBehaviorAccessTokens;
Discussion:

Include access token in logging.

Declared In: FBSettings.h
FBLoggingBehaviorDeveloperErrors
extern NSString *const FBLoggingBehaviorDeveloperErrors;
Discussion:

Log errors likely to be preventable by the developer. This is in the default set of enabled logging behaviors.

Declared In: FBSettings.h
FBLoggingBehaviorFBRequests
extern NSString *const FBLoggingBehaviorFBRequests;
Discussion:

Log requests from FBRequest* classes

Declared In: FBSettings.h
FBLoggingBehaviorFBURLConnections
extern NSString *const FBLoggingBehaviorFBURLConnections;
Discussion:

Log requests from FBURLConnection* classes

Declared In: FBSettings.h
FBLoggingBehaviorInsights
extern NSString *const FBLoggingBehaviorInsights;
Discussion:

Log Insights interactions

Declared In: FBSettings.h
FBLoggingBehaviorPerformanceCharacteristics
extern NSString *const FBLoggingBehaviorPerformanceCharacteristics;
Discussion:

Log performance characteristics

Declared In: FBSettings.h
FBLoggingBehaviorSessionStateTransitions
extern NSString *const FBLoggingBehaviorSessionStateTransitions;
Discussion:

Log session state transitions.

Declared In: FBSettings.h
Typedefs
FBBetaFeatures

A list of beta features that can be enabled for the SDK. Beta features are for evaluation only, and are therefore only enabled for DEBUG builds. Beta features should not be enabled in release builds.

typedef enum : NSUInteger {
FBBetaFeaturesNone = 0,
#if defined(DEBUG) || defined(FB_BUILD_ONLY)
FBBetaFeaturesShareDialog = 1 << 0,
FBBetaFeaturesOpenGraphShareDialog = 1 << 1,
#endif
} FBBetaFeatures;
Declared In: FBSettings.h
FBInstallResponseDataHandler

Block type used to get install data that is returned by server when publishInstall is called

typedef void (^FBInstallResponseDataHandler)(
FBGraphObject *response,
NSError *error);
Declared In: FBSettings.h