GetSocial Unity SDK  6.21.1
GetSocial Unity SDK Changelog

v6.21.1 - Oct 11, 2018

Fixed:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.21.0 - Oct 3, 2018

New:

Fixed:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.20.7 - Sep 10, 2018

New:

Fixed:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.20.6 - Aug 28, 2018

Fixed:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.20.5 - Aug 14, 2018

New:

Fixed:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.20.4 - Aug 2, 2018

Fixed:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.20.3 - Jul 31, 2018

Fixed:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.20.2 - Jul 19, 2018

Fixed:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.20.1 - Jul 18, 2018

Fixed:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.20.0 - Jul 16, 2018

New:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.19.2 - Jul 8, 2018

New:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.19.1 - Jul 6, 2018

New:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.18.0 - May 21, 2018

New:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.17.1 - May 10, 2018

Improved:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.17.0 - Apr 16, 2018

New:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.16.1 - Mar 28, 2018

New:

Fixed:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.15.4 - Mar 20, 2018

New:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.15.3 - Mar 12, 2018

New:

Fixed:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.15.2 - Mar 5, 2018

New:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.15.1 - Feb 12, 2018

Fixed:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.15.0 - Jan 29, 2018

New:

Upgrading:

GetSocial.SetNotificationActionListener(...) becomes GetSocial.SetNotificationListener(...), NotificationActionListener becomes NotificationListener and changed its signature. Read more in the documentation.


v6.14.0 - Jan 15, 2018

New:

Fixed:

Upgrading:

If you're using FacebookInvitePlugin, replace it with FacebookSharePlugin.


v6.13.1 - Jan 2, 2018

Fixed:

+**Upgrading:**

No special steps required. Please follow default upgrade guide.


v6.13.0 - Dec 19, 2017

Improved:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.12.0 - Dec 6, 2017

New:

Fixed:

Upgrading:

If you were using SetMentionClickListener, keep in mind that starting from SDK v6.12.0 you can receive user id or string "app", which means that mention of the app was clicked. Read more....


v6.11.2 - Nov 20, 2017

Improved:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.11.1 - Nov 9, 2017

Fixed:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.11.0 - Nov 6, 2017

New:

Fixed:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.10.2 - Oct 20, 2017

Fixed:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.10.1 - Oct 19, 2017

Fixed:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.10.0 - Oct 18, 2017

New:

Improved:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.9.1 - Oct 12, 2017

Improved:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.9.0 - Oct 3, 2017

New:

Fixed:

Improved:

Upgrading:

If you were using SDK Security feature on Android, you have to get your hash and upload it to the Dashboard. Documentation. You can leave old hash in the list to keep previous version compatible.


v6.8.0 - Sep 20, 2017

New:

Improved:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.7.0 - Sep 5, 2017

New:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.6.1 - Aug 22, 2017

New:

No special steps required. Please follow default upgrade guide.


v6.6.0 - Aug 1, 2017

New:

Fixed:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.5.0 - Jul 13, 2017

New:

Fixed:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.4.0 - Jun 26, 2017

New:

Improved:

Fixed:

Upgrading:

Default Upgrade Guide was updated, please, check it again.

Before the update:

After updating GetSocial SDK to 6.4.0 you have to select "Replace" mode (not "Append") during iOS build. We've updated the location of GetSocial Framework in generated Xcode project, "Replace" mode will prevent from including framework twice.


v6.3.0 - Jun 12, 2017

New:

Fixed:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.2.0 - May 29, 2017

New:

Fixed:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.1.2 - May 19, 2017

Fixed:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.1.1 - May 18, 2017

Fixed:

Upgrading:

No special steps required. Please follow default upgrade guide.


v6.1.0 - May 15, 2017

New:

Updated:

Removed:

Fixed:

Upgrading:

We don't depend on GSON library anymore in for Android build. To update to GetSocial Unity SDK 6.1.0 follow default upgrade guide. After upgrading ensure that gson-2.6.2.jar was removed from the Assets/Plugins/ folder.


v6.0.2 - May 2, 2017

Updated:

Fixed:

Upgrading:

We don't depend on Picasso library anymore in for Android build. To update to GetSocial Unity SDK 6.0.2 follow default upgrade guide. After upgrading ensure that picasso-2.5.2.jar was removed from the Assets/Plugins/ folder.


v6.0.1 - Apr 24, 2017

New:

Updated:

Fixed:

Upgrading:

Method ActivityFeedViewBuilder.WithButtonActionListener was renamed to SetButtonActionListener. Please follow default upgrade guide and update you code with new method signatures.


v6.0.0 - Apr 13, 2017

GetSocial SDK version 6 is a major update that brings a lot of improvements, new features and breaking changes. Follow the guide below to learn about what changed and how to upgrade to SDK v6.

Important Changes

New:

Updated:

Removed:

Upgrading

GetSocial SDK v6 is not backward compatible. The easiest way to upgrade is to remove GetSocial SDK v5 from your project and start with a fresh integration. Detailed steps below:

  1. Contact us at suppo.nosp@m.rt@g.nosp@m.etsoc.nosp@m.ial..nosp@m.im or via the support channel in our Dashboard to do the manual migration of your app to the new Dashboard.
  1. Remove GetSocial SDK v5 from your project: 2.1. In your Unity project remove Assets/GetSocial/ and Assets/StreamingAssets/getsocial/ folders. 2.2. Comment out all usages of GetSocial SDK in the code to avoid compilation errors.
  1. Follow Getting Started Guide to integrate GetSocial Unity SDK v6.
  1. Update commented GetSocial API method calls according to the mapping below.

Method Mappings

In SDK v6 almost all methods are static and all returned objects immutable. For instance, in SDK v5 to get user name you had to call:

var name = GetSocial.Instance.CurrentUser.DisplayName;

In SDK v6 you have to call static method:

var name = GetSocial.User.DisplayName; 

Initialization

All initialization related methods in the SDK v5 were invoked on the GetSocial instance: GetSocial.Instanse.

SDK v5 Method SDK v6 Method
Init(...) SDK is auto-initialized now, details in Getting Started Guide.
IsInitialized property GetSocial.IsInitialized

User Management

All user management methods in SDK v5 were called on the instance of the CurrentUser object, e.g. GetSocial.Instance.CurrentUser.DisplayName. In SDK v6 it is not possible to get CurrentUser object, instead you can get separate properties via static methods exposed via GetSocial.User. Learn more in Introduction to GetSocial User Management guide.

SDK v5 Method SDK v6 Method
Guid GetSocial.User.Id
IsAnonymous GetSocial.User.IsAnonymous
DisplayName GetSocial.User.AuthIdentities
SetDisplayName(...) GetSocial.User.SetDisplayName(...)
AvatarUrl GetSocial.User.AvatarUrl
SetAvatarUrl(...) GetSocial.User.SetAvatarUrl(...)
Identities GetSocial.User.AuthIdentities
HasIdentityForProvider(providerId) GetSocial.User.AuthIdentities.ContainsKey(providerId)
GetIdForProvider(providerId) GetSocial.User.AuthIdentities[providerId]
AddUserIdentity(...) GetSocial.User.AddAuthIdentity(...)
RemoveUserIdentity(...) GetSocial.User.RemoveAuthIdentity(...)
FollowUser(...) GetSocial.User.AddFriend(...)
UnfollowUser(...) GetSocial.User.RemoveFriend(...)
GetFollowing(...)
GetFollowers(...)
Following and followers become a one concept - friends, e.g. GetSocial.User.GetFriends()
Reset(...) Removed

Smart Invites

In SDK v6 Invite Provides were renamed to Invite Channels. Moreover, in v6 referral data retrieval is implemented in pull mode, that means that you have to ask for data instead of listening when it will arrive. Learn more in Sending and Receiving Referral Data guide.

SDK v5 Method SDK v6 Method
RegisterPlugin(...) GetSocial.RegisterInviteChannelPlugin(...)
GetSupportedInviteProviders() GetSocial.InviteChannels
InviteFriendsUsingProvider(...) and SetOnInviteFriendsListener(...) were merged GetSocial.SendInvite(...)
SetOnReferralDataReceivedListener(...) GetSocial.GetReferralData(...)

Activity Feed

In SDK v6 it is possible to create Activity Feed dynamically from the SDK. If feed does not exist it will be created dynamically. Learn more in Introduction to GetSocial Activity Feeds.

SDK v5 Method SDK v6 Method
PostActivity(...) GetSocial.PostActivityToFeed(...) and GetSocial. PostActivityToGlobalFeed(...)

UI

In SDK v6 UI configuration API from code was removed, use JSON file instead. JSON files from SDK v5 are backward compatible with SDK v6. Learn more about UI Customization.

SDK v5 Method SDK v6 Method
Configuration.SetConfiguration(...) GetSocialUi.LoadConfiguration() and GetSocialUi.LoadDefaultConfiguration(...)
setOnWindowStateChangeListener(...) GetSocialUi.CreateInvitesView().SetViewStateCallbacks(...)
CloseView(...) GetSocialUi.CloseView(...)
RestoreView() GetSocialUi.RestoreView()
CreateSmartInviteView() GetSocialUi.CreateInvitesView()
CreateActivitiesView() GetSocialUi.CreateActivityFeedView()
SetOnActivityActionClickListener() GetSocialUi.CreateActivityFeedView(...).SetButtonActionListener(...)
CreateUserListView() Removed
SetOnInviteButtonClickListener(...) Removed
CreateNotificationsView() Removed
SetOnUserAvatarClickListener(...) Removed
SetOnAppAvatarClickListener(...) Removed
SetOnUnreadNotificationsCountChangeListener(...) Removed
UnreadNotificationsCount property Removed
SetOnUserGeneratedContentListener(...) Removed

Other

SDK v5 Method SDK v6 Method
SetLanguage("uk") GetSocial.SetLanguage(LanguageCodes.Ukrainian)
NativeSdkVersion property GetSocial.NativeSdkVersion
UnitySdkVersion property GetSocial.UnitySdkVersion

!!! tip "Can't figure our correct mapping?"

Feel free to reach us at suppo.nosp@m.rt@g.nosp@m.etsoc.nosp@m.ial..nosp@m.im or via the support channel in our Dashboard if you need any help with the migration.

Older Versions

Changelog for older versions of GetSocial Android SDK is available on GitHub Releases.