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
appVersion

Gets the application version to the provided string. FBAppEvents, for instance, attaches the app version to events that it logs, which are then available in App Insights.

+ (NSString *) appVersion;
Declared In: FBSettings.h
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 value for 'FacebookUrlSchemeSuffix'.

+ (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
facebookDomainPart

Get the Facebook domain part

+ (NSString*) facebookDomainPart;
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
limitEventAndDataUsage

Gets whether data such as that generated through FBAppEvents and sent to Facebook should be restricted from being used for other than analytics and conversions. Defaults to NO. This value is stored on the device and persists across app launches.

+ (BOOL) limitEventAndDataUsage;
Declared In: FBSettings.h
loggingBehavior

Retrieve the current Facebook SDK logging behavior.

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

This method has been replaced by [FBAppEvents activateApp]

+ (void) publishInstall:(NSString *)appID __attribute__((deprecated("use [FBAppEvents activateApp] instead")));
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
__attribute__((deprecated));
Declared In: FBSettings.h
resourceBundleName

Get the name of the bundle to override the SDK images and text

+ (NSString*) resourceBundleName;
Declared In: FBSettings.h
sdkVersion

Retrieve the current iOS SDK version.

+ (NSString *) sdkVersion;
Declared In: FBSettings.h
setAppVersion:

Sets the application version to the provided string. FBAppEvents, for instance, attaches the app version to events that it logs, which are then available in App Insights.

ParameterDescription
appVersion

The version identifier of the iOS app.

+ (void) setAppVersion:(NSString *)appVersion;
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.

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.

ParameterDescription
urlSchemeSuffix

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

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

Set the subpart of the facebook domain (e.g. @"beta") so that requests will be sent to graph.beta.facebook.com

ParameterDescription
facebookDomainPart

The domain part to be inserted into facebook.com

+ (void) setFacebookDomainPart:(NSString*)facebookDomainPart;
Declared In: FBSettings.h
setLimitEventAndDataUsage:

Sets whether data such as that generated through FBAppEvents and sent to Facebook should be restricted from being used for other than analytics and conversions. Defaults to NO. This value is stored on the device and persists across app launches.

ParameterDescription
limitEventAndDataUsage

The desired value.

+ (void) setLimitEventAndDataUsage:(BOOL)limitEventAndDataUsage;
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
setResourceBundleName:

Set the bundle name from the SDK will try and load overrides of images and text

ParameterDescription
bundleName

The name of the bundle (MyFBBundle).

+ (void) setResourceBundleName:(NSString*)bundleName;
Declared In: FBSettings.h
setShouldAutoPublishInstall:

Deprecated method

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

Deprecated method

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

Include access token in logging.

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

Log FBAppEvents interactions

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
FBLoggingBehaviorInformational
extern NSString *const FBLoggingBehaviorInformational;
Discussion:

Log Informational occurrences

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
NS_ENUM

Indicates if this app should be restricted

typedef NS_ENUM(NSUInteger, FBRestrictedTreatment) {
FBRestrictedTreatmentNO = 0,
FBRestrictedTreatmentYES = 1
};
ConstantDescription
FBRestrictedTreatmentNO

The default treatment indicating the app is not restricted.

FBRestrictedTreatmentYES

Indicates the app is restricted.

Declared In: FBSettings.h