Change Log

Version 2.15.7.1 - 6 May 2013

• Bug fix - warnings while compiling iOS SDK
• Bug fix - the gsDidReceiveResponse is fired after the loginUI has been dismissed

Version 2.15.7 - 14 Apr 2013

• The SDK is now provided as a binary framework: GSSDK.embeddedframework.zip. The source files are also provided, as in previous versions - GSSDK.iOS.zip.
• Usage of Facebook SDK 3.1 (iOS 6 SSO) - Supports native Facebook Single Sign-On (SSO). This means that when a user clicks the Facebook button to login, the applications will access the native device Facebook account to authenticate the user without requiring the user to enter their credentials.
• Class GSAPI
  Facebook permission requests are separated to read permissions and publish permissions.
  • showLoginUI & login - instead of the deprecated facebookExtendedPermissions parameter, the methods now accept the new optional parameter facebookReadPermissions, for requesting Facebook read permissions from the user.
  • requestFacebookPublishPermission - new method that initiates requesting Facebook publish permissions from the user.
  • sendRequest & sendRequest (with HTTPS) - all API methods accept the new optional parameter facebookPublishPermissions, for requesting Facebook publish permissions from the user. By default Gigya sets this parameter:
    • For socialize.publishUserAction, socialize.setStatus methods: to "publish_actions"
    • For socialize.checkin method: to "publish_checkins"
    Note: this parameter is not documented in the API reference.

Version 2.15.6.1 - 25 Feb 2013

• Bug fix - crashed when overloaded with data via accounts.setAccountInfo

Version 2.15.6 - 06 Nov 2012

• GSAPI.setAPIDomain - new method that provides the option to specify a data center to be used for making API calls. For example: "eu1.gigya.com" for Europe data center. 
• The signature of the following event handlers has changed:  GSLoginUIDelegate.gsLoginUIDidFail and GSAddConnectionsUIDelegate.gsAddConnectionsUIDidFail. The methods receive a GSResponse argument (instead of the errorCode and errorMessage arguments). This enables passing more information on error. The new signatures:
  

  (void)    gsLoginUIDidFail:(GSResponse*)response context:(id)context
(void)    gsAddConnectionsUIDidFail:(GSResponse*)response context:(id)context
   

  Note: this version is not backwards compatible. If you are upgrading from a former version and you are listening to the failure events, you should make the following minor changes in your event handler implementation:
  1. Change the signature of the corresponding method to the one mentioned above.
  2. In the method implementation, instead using errorCode and errorMessage parameters, use response.errorCode and response.errorMessage 

   
• The targetEnv parameter (accepted by some of the Accounts API methods) is automatically set to "mobile" in all requests (there is no need to set it manually).

Version 2.15.4 - 28 Aug 2012

Note: this version is not backwards compatible. If you are upgrading from a former version, you will need to make minor changes in your code (see details below).

• Allow setting a viewController for each API separately:
  1. viewController parameter is removed from GSAPI's initialization method - initWithAPIKey.
  2. viewController mandatory parameter is added to the following GSAPI methods: showLoginUI, showAddConnectionsUI, login and addConnection.
  Note: if you are upgrading from a former version, you will need to move the viewController parameter from the initWithAPIKey method call to the showLoginUI, showAddConnectionsUI, login and addConnection method calls.
   
• Support for the new accounts.login API method - the SDK stores the session info returned from the method on the device as GSSession.

Version 2.15.3 - 10 Jun 2012

• Supporting App login - i.e. supporting the case in which a user logs in to your app using your own login system (the app's username and password) instead of Gigya's social login. To support this use case, we added:
  • New method GSAPI.setSession - Sets a new session. The method saves the session in app's storage. 
  • New initialization methods in GSSession, that accept  sessionToken and sessionSecret.

Read Site Login - Synchronizing with Gigya Service to learn how to implement this use case.

• New optional parameters added to showLoginUI, showAddConnectionsUI, login, addConnection methods, to support Facebook Single Sign-on:
  • facebookAppId  - The facebook app ID. This parameter is required if you implement facebook SSO.
  • facebookLocalAppId - Set a local facebook app ID, if you have multiple facebook apps using the same facebook app ID with facebook SSO. 
     

Version 2.15.2 - 06 May 2012

• Every socialize.getUserInfo request that is issued after a successful login, will be using HTTPS.

Version 2.15.0 - 09 Apr 2012

• Twitter Single Sign On support: learn more in Adding Twitter Single Sign-on.
• The GSAPI.logout method now logs out the user from the Social Networks.

Version 2.14.2 - 11 Dec 2011

Some API methods are considered to be global, for they are not associated with a specific user. Few examples of global API methods:

comments.getComments, reports.getSocializeStats, socialize.getFeed, etc.

From this version on you may access the global APIs without having a logged-in user session.

Version 2.14.1 - 17 Oct 2011 

New optional parameter added to showLoginUI, showAddConnectionsUI, login, addConnection methods:

facebookSSOFallback - The parameter accepts two possible values: "webview" (default) or "safari". The parameter determines whether Gigya will open a webview or a Safari instance when trying to do SSO (Single Sign-On) while Facebook application is not installed.

Version 2.14 - 19 Sep 2011

• login, showLoginUI, addConnection, showAddConnectionsUI methods - HTTPS is always used in the login/add-connection process.

Version 2.13.4 - 14 Aug 2011

• GSDictionary class is deprecated, and is replaced by the following new class:
• GSObject - New class, used for passing parameters, for example when issuing requests or receiving response data.
  Note: GSObject's methods are equivalent to GSDictionary's methods. Most methods have the same signature. Few methods have slightly different names, e.g. GSDictionary's dictionaryWithJSONString method is equivalent to GSObject's objectWithJSONString.

// Publish User Action

// 1. Defining request parameters
GSDictionary *userAction = [[GSDictionary new] autorelease];

[userAction putStringValue:@"This is my title" forKey:@"title"]; 
[userAction putStringValue:@"This is my user message" forKey:@"userMessage"]; 
[userAction putStringValue:@"This is my description" forKey:@"description"]; 
[userAction putStringValue:@"http://google.com" forKey:@"linkBack"]; 

GSDictionary *image = [[GSDictionary new] autorelease];   // create a media item of type image to add to the user action
[image putStringValue:@"http://www.f2h.co.il/logo.jpg" forKey:@"src"]; 
[image putStringValue:@"http://www.f2h.co.il" forKey:@"href"]; 
[image putStringValue:@"image" forKey:@"type"]; 

NSArray *mediaItems = [NSArray arrayWithObject:image];  // create media items array and add the image object to it

[userAction putNSArrayValueNSArray:mediamediaItemseforKeydiamediaItems
GSDictionary *pParams = [[GSDictionary new] autorelease];

[pParams putGSDictionaryValue:userAction forKey:@"userAction"];  // set the "userAction" parameter 

// 2. Sending 'socialize.publishUserAction' request
[gsAPI sendRequest:@"socialize.publishUserAction" params:pParams delegate:nil context:nil];

// Publish User Action

// 1. Defining request parameters
GSObject *userAction = [[GSObject new] autorelease];

[userAction putStringValue:@"This is my title" forKey:@"title"]; 
[userAction putStringValue:@"This is my user message" forKey:@"userMessage"]; 
[userAction putStringValue:@"This is my description" forKey:@"description"]; 
[userAction putStringValue:@"http://google.com" forKey:@"linkBack"]; 

GSObject *image = [[GSObject new] autorelease];   // create a media item of type image to add to the user action
[image putStringValue:@"http://www.f2h.co.il/logo.jpg" forKey:@"src"]; 
[image putStringValue:@"http://www.f2h.co.il" forKey:@"href"]; 
[image putStringValue:@"image" forKey:@"type"]; 

NSArray *mediaItems = [NSArray arrayWithObject:image];  // create media items array and add the image object to it

[userAction putNSArrayValueNSArray:mediamediaItemseforKeydiamediaItems
GSObject *pParams = [[GSObject new] autorelease];

[pParams putGSObjectValue:userAction forKey:@"userAction"];  // set the "userAction" parameter 

// 2. Sending 'socialize.publishUserAction' request
[gsAPI sendRequest:@"socialize.publishUserAction" params:pParams delegate:nil context:nil];

Version 2.13.1 - 29 June 2011

• Fix for timestamp correction when device's local is not English
• Automatic logging of response if errorCode != 0
• To request permission for logged-in user, call addConnection, pass the required permission and set getPerms to 1

Version 2.13 - 26 June 2011

• Added a new parameter canceled in the onClose event of showLoginUI and showAddConnectionUI. When the parameter is 'true' it indicates the UI was closed due to user canceling the operation.
• Login and addConnection will return GSResponse with errorCode 200001, when users cancels the operation.
• The SDKs can now automatically compensate for when the mobile device's clock is not synchronized.
• When sending a request, if useHTTPS is set to 'true', the request is not signed and the secret key is passed instead - this saves CPU of calculating signature, since it's secured by HTTPS.
• The SDK parameter sent to the server includes the SDK version: e.g. "iphone_2.13", "android_2.13", etc.
• The iPhone SDK compiles with the LLVM compiler.