Was this article helpful?

Change Log

Last modified 12:56, 22 Jun 2014

Version 3.0.3 - 30 May 2014

  • Bug fixes

Version 3.0.2 - 13 May 2014

  • Bug fixes

Version 3.0 - 16 Feb 2014

  • Gigya UI Plugins can now be displayed and used through the iOS SDK, using the GSPluginView class.
  • GSSessionDelegate has been deprecated and replaced by GSSocializeDelegate and GSAccountsDelegate.
  • Added support for applications that can't run in the background. Setting the GigyaLoginDontLeaveApp parameter to YES in your plist will now authenticate the user in a web view dialog.
  • Enhanced Facebook SDK integration:
    • Permissions no longer need to be specified in the login method. Facebook Native Login now uses the permissions configured for your site in the Gigya management platform.
    • Facebook Native Login behavior can now be controlled by passing a facebookLoginBehavior parameter to login methods.
    • Added referral tracking to Facebook deep links.
    • Facebook login is now enabled only via Facebook Native Login, following Facebook's policy change.
  • Fixed a bug that happened if the user has quit the login process after switching to Safari.
 

Version 2.17.1 - 26 Jan 2014

  • Fixed a bug that caused Facebook native login to fail after the user has removed permissions for the app.​ 

 

Version 2.17 - 10 Nov 2013

  • Added popover behavior to the login providers dialog on iPad
  • Changed login providers dialog design to iOS7 
  • Added JSONString method to GSRequest and GSUser classes
  • Changed login to use Safari (fast app switch) instead of a webview
  • Added support for 64bit applications
  • Bugfixes
 

Version 2.16.1 - 12 Sep 2013

  • Full iOS 7 support
  • Tested with Facebook SDK 3.7.1
  • Bug fixes:
    • [Gigya logoutWithCompletionHandler:] will now invoke the handler even if the user isn't logged in.
    • Fixed a bug when that caused a crash when accounts.resetPassword returns an error.​
    • [Gigya isLoggedIn] was removed, use [[Gigya session] isValid] instead.
 

Version 2.16 - 15 Aug 2013

  • New and improved version - full restructuring and optimization of the SDK code
  • Support for iOS7
  • Setup and usage of the SDK has completely changed
  • Optional loading of network-specific SDKs
  • Removal of webviews when Facebook and Twitter SSO are used
  • Added the ability to cancel a request after it has already been sent
If you want to upgrade an app that was developed with a version earlier than 2.16, use the Upgrading to 2.16 Guide to migrate your code.

 

Version 2.15.8.1 - 2 July 2013

  • Bug fix - added basic_info to default Facebook permissions.

 

Version 2.15.8 - 12 June 2013

Note: this version is not backwards compatible, changes in code are needed.

  • Gigya SDK is now provided as a static framework.
  • Usage of Facebook SDK 3.5.1 and latest Google+ SDK.
  • Gigya's SDK now provides easy implementation for Facebook's SDK native login. 
  • Gigya's SDK now provides easy implementation for Google+ SDK native login.
  • GSAPI: 
    • Removed facebookAppId and facebookSSOFallback parameters. Facebook app ID should be specified in plist for native login, or in the Gigya platform console for web login.
    • Added googlePlusExtraPermissions for Google+ native login.
  • Bug fixes:
    • Fixed several memory leaks.
    • Fixed enabledProviders parameter in showLoginUI.
       

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: Note: this parameter is not documented in the API reference.

 

Note: this version is not backwards compatible. If you are upgrading from a former version, you should make the following minor changes:
  1. Add the SDK as a binary framework (instead of the "GSSDK" folder of sources). Read more: Add Gigya iOS Client Library to your Xcode project
  2. You need to Re-configure Your Xcode Project
  3. If you are using facebookExtendedPermissions parameter, change it to facebookReadPermissions.

 

Version 2.15.6.1 - 25 Feb 2013

 

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 showLoginUIshowAddConnectionsUIloginaddConnection 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

 

Version 2.15.0 - 09 Apr 2012

 

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

Note: this version is not backwards compatible. You may need to make minor changes in your code, if you are upgrading from a former version. Please follow the migration instruction below. Upgrading to this version is required, if you wish to integrate Gigya's Game Mechanics or the Gigya Cloud Storage platform.
  • 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.

Migration Instruction

Search for all instances of GSDictionary class in your code. Replace each GSDictionary instance with GSObject. For example:

Old Code (using GSDictionary):
// 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];

New Code (using GSObject and GSArray):
// 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.
Was this article helpful?
Pages that link here
Page statistics
2479 view(s) and 22 edit(s)
Social share
Share this page?

Tags

This page has no custom tags set.

Comments

You must to post a comment.

Attachments