GetSocial Unity SDK Changelog¶
v6.33.0 - Nov 18, 2020¶
New:
- Added new method to initialize the SDK with an existing identity.
v6.32.7 - Sep 2, 2020¶
Fixed:
- Issue when deleting a comment on Comments view when moderation is turned on, on iOS.
- Issue on iOS with incorrect Swift runtime versions.
v6.32.6¶
Fixed:
- Issue with notification view title on iOS.
- Issue with wrong push notification analytics tracking on iOS.
Upgrading:
If you integrated the framework manually or using CocoaPods and your project is in Objective-C, make sure you set Always Embed Swift Standard Libraries
to Yes
in Build Settings
.
v6.32.5¶
Fixed:
- Issue with AppStore submission with latest Unity version.
Upgrading:
If you integrated the framework manually or using CocoaPods and your project is in Objective-C, make sure you set Always Embed Swift Standard Libraries
to Yes
in Build Settings
.
v6.32.4¶
Fixed:
- Reloading iOS files on each build on Windows.
- Broken links in GetSocial Unity Settings.
Upgrading:
If you integrated the framework manually or using CocoaPods and your project is in Objective-C, make sure you set Always Embed Swift Standard Libraries
to Yes
in Build Settings
.
v6.32.3¶
Fixed:
- Localization issue when sending an invite on iOS.
Upgrading:
If you integrated the framework manually or using CocoaPods and your project is in Objective-C, make sure you set Always Embed Swift Standard Libraries
to Yes
in Build Settings
.
v6.32.2 - Feb 26, 2020¶
Fixed:
- Facebook iOS SDK doesn’t pick up the result of login when
application:openURL:options:
is not implemented inAppDelegate.m
.
Upgrading:
If you integrated the framework manually or using CocoaPods and your project is in Objective-C, make sure you set Always Embed Swift Standard Libraries
to Yes
in Build Settings
.
v6.32.1 - Feb 26, 2020¶
New:
- Added more analytics.
- Improve requests speed on iOS.
Upgrading:
If you integrated the framework manually or using CocoaPods and your project is in Objective-C, make sure you set Always Embed Swift Standard Libraries
to Yes
in Build Settings
.
v6.32.0 - Feb 24, 2020¶
New:
- Overall improvements.
Upgrading:
If you integrated the framework manually or using CocoaPods and your project is in Objective-C, make sure you set Always Embed Swift Standard Libraries
to Yes
in Build Settings
.
v6.31.5 - Feb 21, 2020¶
Fixed:
- Issues with missing iOS framework on older Unity versions (< 2018.3).
Upgrading:
If you integrated the framework manually or using CocoaPods and your project is in Objective-C, make sure you set Always Embed Swift Standard Libraries
to Yes
in Build Settings
.
v6.31.4 - Feb 14, 2020¶
Fixed:
- Issue with missing swift binaries in resulting IPA. You don’t need to add
use_frameworks
toPodfile
anymore.
Upgrading:
If you integrated the framework manually or using CocoaPods and your project is in Objective-C, make sure you set Always Embed Swift Standard Libraries
to Yes
in Build Settings
.
v6.31.3 - Feb 13, 2020¶
New:
- Native share plugin on iOS now shares image, if selected provider support it.
Upgrading:
If you integrated the framework manually or using CocoaPods and your project is in Objective-C, make sure you set Always Embed Swift Standard Libraries
to Yes
in Build Settings
.
In case of using CocoaPods make sure use_frameworks!
is added to your podfile
.
v6.31.2 - Feb 4, 2020¶
Fixed:
- Unity 2019.3 compatibility.
Upgrading:
If you integrated the framework manually or using CocoaPods and your project is in Objective-C, make sure you set Always Embed Swift Standard Libraries
to Yes
in Build Settings
.
In case of using CocoaPods make sure use_frameworks!
is added to your podfile
.
v6.31.1 - Jan 10, 2020¶
Fixed:
- Issue with notification listeners when app is killed and listener is set a later point after app is launched.
Upgrading:
If you integrated the framework manually or using CocoaPods and your project is in Objective-C, make sure you set Always Embed Swift Standard Libraries
to Yes
in Build Settings
.
In case of using CocoaPods make sure use_frameworks!
is added to your podfile
.
v6.31.0 - Jan 2, 2020¶
New:
- Methods
GetSocial.Device.isTestDevice()
andGetSocial.Device.getIdentifier()
to check if this device was added to a test device list on the Dashboard and to get your Advertising ID respectively.
Fixed:
- Rare crash on Activity Feed UI in case video was not downloaded on Android.
- Issue with hanging UI for a few seconds in case of bad connection on iOS.
v6.30.2 - Dec 19, 2019¶
Fixed:
- Fixed issue with referral data receiving on iOS 13 when clicking on an invite in Facebook.
Upgrading:
If you integrated the framework manually or using CocoaPods make sure use_frameworks!
is added to your podfile
.
v6.30.1 - Nov 25, 2019¶
Fixed:
- Fixed occasional crash with
EXC_BAD_ACCESS
on iOS.
Upgrading:
If you integrated the framework manually or using CocoaPods make sure use_frameworks!
is added to your podfile
.
v6.30.0 - Nov 20, 2019¶
New:
- Improved referral system, check it out here.
- Added badge and sound support for Push Notifications. Read more….
Fixed:
- Missing invite link issue on iOS with some applications when sending invite using native share plugin.
Upgrading:
If you integrated the framework manually or using CocoaPods make sure use_frameworks!
is added to your podfile
.
v6.29.2 - Nov 5, 2019¶
Fixed:
- Issue with
GetPublicProperty()
method on iOS.
Upgrading:
If you integrated the framework manually or using CocoaPods make sure use_frameworks!
is added to your podfile
.
v6.29.1 - Oct 29, 2019¶
Fixed:
- Fixed potential crash when setting delegate for Push Notifications.
- Fixed crash when calling
GetUsersByAuthIdentities
method.
Upgrading:
If you integrated the framework manually or using CocoaPods make sure use_frameworks!
is added to your podfile
.
v6.29.0 - Oct 17, 2019¶
Fixed:
- Use improved Android and iOS SDKs.
Upgrading:
If you integrated the framework manually or using CocoaPods make sure use_frameworks!
is added to your podfile
.
v6.28.3 - Oct 2, 2019¶
New:
- Added flag to wait until Push Notification Listener is set before processing Push Notification.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.28.2 - Sep 25, 2019¶
Fixed:
- Fixed issue with referral data being not properly cleared.
- Support for older Unity and C# versions.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.28.1 - Sep 10, 2019¶
New:
- Added
RemoveActivities
method to delete multiple activity posts with a single call. - Improved Facebook Share plugin to open Facebook app if it is installed.
Fixed:
- Activity Feed UI issues with iOS 13.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.28.0 - Aug 15, 2019¶
New:
- Added support for push notifications background on Android.
- Added
SetPushNotificationTokenListener
method to get push notification token. - Added support for testing features in Unity Editor.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.27.0 - Jul 2, 2019¶
New:
- Added new Promo Code placeholders.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.26.5 - Jun 25, 2019¶
Fixed:
- Issue with receiving Push Notifications in foreground.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.26.4 - Jun 19, 2019¶
Fixed:
- Display of avatar in Activity Feed UI.
- Issue with registering for Push Notifications if user disable PN.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.26.3 - Jun 18, 2019¶
Fixed:
- Notification Center UI OnOpen/OnClose callbacks.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.26.2 - May 28, 2019¶
New:
- GetSocial SDK now supports Android Q.
Fixed:
- Custom UI configuration file path is reset after upgrading GetSocial SDK.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.26.1 - May 22, 2019¶
New:
- Added build time validation of custom UI configuration setting.
Fixed:
- Fix issue with App Store submission caused by not proper signing.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.26.0 - May 14, 2019¶
New:
- Promo Codes feature. Read more…
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.25.2 - May 9, 2019¶
Fixed:
- Fix issues in Unity 2019.3 and newer.
- Issue with executing button action in Activity Feed on iOS.
- Issue with incorrect return value when trying to load invalid UI configuration on iOS.
- Fixed rare out of memory issue on older devices during authentication on Android.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.25.1 - Apr 4, 2019¶
Fixed:
- Fixed possible crash in NotificationListener caused by missing sender info.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.25.0 - Apr 4, 2019¶
New:
- Introduced prebuilt Notification Center UI.
- Added
Notification.Sender
property to get sender user id, name and avatar URL. - Avatars on the UI are now round by default.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.24.6 - Mar 12, 2019¶
New:
- Added
GetSocial.ClearReferralData()
method to invalidate referral data. - Added
margin-top
andmargin-bottom
properties towindow
object in GetSocial UI configuration. - Added option to disable Facebook Deferred Data fetching by GetSocial in GetSocial Settings.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.24.5 - Feb 14, 2019¶
Fixed:
- GetSocial UI couldn’t be closed if SDK was not initialized on iOS.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.24.4 - Feb 11, 2019¶
Fixed:
- Issue with incorrect old action in the notification entity on iOS.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.24.3 - Feb 6, 2019¶
Fixed:
- Issues with binary symbols on iOS which makes app not running on device.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.24.2 - Jan 30, 2019¶
Fixed:
- Issues with purchase tracking when using Billing Service on Android.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.24.1 - Jan 24, 2019¶
Fixed:
- Issues with new supported languages.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.24.0 - Jan 23, 2019¶
Fixed:
- Added support for App Requests, more info here.
- Added Custom Events tracking feature, more info here.
- Added new supported languages, like Hindi, Thai etc.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.23.4 - Dec 19, 2018¶
Fixed:
- Fix issues in Unity 2018.3 and newer.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.23.3 - Dec 10, 2018¶
Fixed:
- Xcode project generation on Windows.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.23.2 - Dec 5, 2018¶
Fixed:
SetWindowTitle
didn’t work forInvitesViewBuilder
on iOS.- Runtime exceptions when running app with GetSocial SDK on non-mobile platforms.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.23.1 - Nov 22, 2018¶
Fixed:
- Issue with empty bundle id for notification extension.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.23.0 - Nov 20, 2018¶
New:
- You can now send Rich Notifications to your users. More Info.
- Added
MediaAttachment
class. - Added options to attach media to
NotificationContent
.
Fixed:
- Issue with reading Android SHA key value on Windows.
Upgrading:
We suggest to replace SetVideo
/SetImage
/SetVideoUrl
/SetImageUrl
methods in InviteContent.Builder
and ActivityPostContent.Builder
with SetMediaAttachment
or similar.
v6.22.2 - Nov 7, 2018¶
Fixed:
- Overall improvements.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.22.1 - Oct 30, 2018¶
Fixed:
- Crash in Unity Editor for Android platform.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.22.0 - Oct 29, 2018¶
New:
- Send end-to-end Push Notifications directly from SDK to another users. Read more….
- Support full screen mode in GetSocial UI. Read more…
- Support for clickable URL’s for posts created from GetSocial Dashboard.
Fixed:
- Issue with not properly working
fade-and-scale
window animation style. - Issue with incorrect order of fields in Activity Feed.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.21.1 - Oct 11, 2018¶
Fixed:
- Overall improvements.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.21.0 - Oct 3, 2018¶
New:
- Added
GetSocial.SetUserDetails( )
method for bulk update for user details. Read more….
Fixed:
- Issue when Unity player is set to Android or iOS and pressed play button in Unity Editor.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.20.7 - Sep 10, 2018¶
New:
- Sharing on Facebook is now possible without adding Facebook SDK.
Fixed:
- Issue with not correctly placed no network icon on iOS.
- Issue with deleted comments on iOS
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.20.6 - Aug 28, 2018¶
Fixed:
- Some kind of notifications was not automatically marked as read after user clicked on it.
- Few memory leaks on iOS.
- Status bar was sometimes shown on iPads with specific configuration.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.20.5 - Aug 14, 2018¶
New:
- Added
GetSocial.CreateInviteLink()
method for invite link creation.
Fixed:
onComplete
callback ofGetSocial.SendInvite
orGetSocialUi.CreateInvitesView
is now fired when user gets back to the application after sending the invite.- Issue with Android manifest helper, which caused warning messages like
im.getsocial.sdk.invites.MultipleInstallReferrerReceiver is not declared in AndroidManifest.xml
.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.20.4 - Aug 2, 2018¶
Fixed:
- Regression issue on Unity 2018.2 JNI bridge causing app crashes.
- Issue when calling
GetReferredUsers
method.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.20.3 - Jul 31, 2018¶
Fixed:
- Removed error when keys starting with
$
were added toLinkParams
.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.20.2 - Jul 19, 2018¶
Fixed:
- Rare crash on app start if internet connection is bad on Android.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.20.1 - Jul 18, 2018¶
Fixed:
- Crash with
LocaleChangeReceiver
on Android.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.20.0 - Jul 16, 2018¶
New:
- Added support of
targetSdkVersion = 26
for Push Notifications on Android. Read how to have GetSocial notifications in the separate channel. - Fix Associated Domains and APNS settings issues in entitlements file on iOS.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.19.2 - Jul 8, 2018¶
New:
- Fix iOS build caused by missing symbols.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.19.1 - Jul 6, 2018¶
New:
- Share videos in Smart Invites and Activity Feeds
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.18.0 - May 21, 2018¶
New:
- Query all the GetSocial notifications that were sent to user. Read more…
- Add
SetPushNotificationsEnabled
andIsPushNotificationsEnabled
methods.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.17.1 - May 10, 2018¶
Improved:
- Fix issue with old referral data if app was in background on iOS.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.17.0 - Apr 16, 2018¶
New:
- Now GetSocial notifications can be shown even if app is in foreground. Read more….
- Added Push Notification actions to open the Smart Invites View and open URL. Read how to send notifications with new actions from the dashboard here.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.16.1 - Mar 28, 2018¶
New:
- Landing page customization. Read more…
Fixed:
- Fixed
Invalid Bundle - Disallowed LLVM instrumentation
error while submitting to the AppStore.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.15.4 - Mar 20, 2018¶
New:
- Add the
SetCommentId:
method to theActivityDetailsViewBuilder
class.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.15.3 - Mar 12, 2018¶
New:
- Overall application improvements.
- Added support for Viber and Telegram to Smart Invites
Fixed:
- Fixed rare Null Pointer Exception on some old Android devices
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.15.2 - Mar 5, 2018¶
New:
- The
GetSocial Unity SDK
is now automatically updates yourAndroidManifest.xml
file - say “NO!” toRegenerate Manifest
button! And no more bugs when you forget to press it. - Also, we removed GetSocial native libraries from distributed
.unitypackage
. For you it means, that you can removeAssets/GetSocial/Plugins/
from the source control, plugin will ensure automatically that you always have native libs before the build.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.15.1 - Feb 12, 2018¶
Fixed:
- Issue when trying to send a custom invite without image on Android.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.15.0 - Jan 29, 2018¶
New:
- We replaced
NotificationActionListener
withNotificationListener
delegate, it is more flexible and allows you to handle notifications even if app is in foreground.
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:
- Facebook share plugin. Read more….
Fixed:
- Issue calling
ReportActivity
withInappropriateContent
reason.
Upgrading:
If you’re using FacebookInvitePlugin
, replace it with FacebookSharePlugin.
v6.13.1 - Jan 2, 2018¶
Fixed:
- We fixed occasional
EXC_BAD_ACCESS
crash on iOS.
+Upgrading:
No special steps required. Please follow default upgrade guide.
v6.13.0 - Dec 19, 2017¶
Improved:
- Improved GetSocial Unity Editor plugin behaviour when one of the platforms is disabled on the Dashboard.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.12.0 - Dec 6, 2017¶
New:
- App mentions. Now users can mention app in the Activity Feed. Community manager will receive notification on the GetSocial Dashboard.
- New methods to manage social relationships. Read mode….
Fixed:
- Error in
JavaInterfaceProxy
on Unity 2017.1 and above. - Fixed crash on iOS 11 when Smart Invite was shared via Slack.
- Fixed missing annotations package issue on devices running on Android 16 and below.
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:
- Fixed minor issues with video playback in Activity Feed.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.11.1 - Nov 9, 2017¶
Fixed:
- Fixed minor issues in Activity Feeds.
- Fixed interference with other frameworks like Firebase.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.11.0 - Nov 6, 2017¶
New:
- Added mentions feature. Now users can mentions each other with typing
@
symbol while posting Activity Post. To listen for mention click useSetMentionClickListener
inActivityFeedViewBuilder
. Read how to mention user using GetSocial Data SDK. - Now you can initialize GetSocial SDK with dynamic app ID using
GetSocial.Init(string appId)
. - Added method to reset current user and create new anonymous one. Use
GetSocial.User.Reset(Action onSuccess, Action<GetSocialError> onError)
. - Activity Feed now supports videos posted from Dashboard.
Fixed:
- Removed compilation warnings when building for Windows/Max/Linux.
- Fixed status bar visibility issue on iPad.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.10.2 - Oct 20, 2017¶
Fixed:
- Fixed App Links issue on Android.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.10.1 - Oct 19, 2017¶
Fixed:
- We have fixed compile warnings caused by our SDK.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.10.0 - Oct 18, 2017¶
New:
- Added
getReferredUsers()
method to get list of invited users who installed the app. - Expose API to initialize SDK manually. Documentation.
Improved:
- Decreased
getsocial-core
Android library size by ~80 methods. - Decreased
getsocial-ui
Android library size by ~120 methods.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.9.1 - Oct 12, 2017¶
Improved:
- We moved our API from custom ports to common
443
, so if you have some corporate firewall you will be able to use SDK as well.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.9.0 - Oct 3, 2017¶
New:
- Brand new GetSocial Unity Editor Plugin. Now just add your GetSocial App Id in the plugin, we will automatically get your app configuration from the GetSocial Dashboard and update your Unity project.
- Display an activity feed with posts of your friends and your own using
SetShowFriendsFeed(bool showFriendsFeed)
ofActivityFeedViewBuilder
. Documentation. - Get a list of activities of your friends and your own using
FriendsFeed(bool isFriendsFeed)
ofActivitiesQuery
. Documentation.
Fixed:
- We have fixed
SDK Security
feature on Android to generate valid security hash, before it was not the same askeytool
generates.
Improved:
- Decreased
getsocial-core
Android library size by ~80 methods.
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:
- Introduced
gif
andmp4
support for Smart Invites. Check out the supported invite channels in docs.
Improved:
- Android: Decreased underlying
getsocial-core
library size by ~1200 methods to 4300 methods. - Android: Set up additional automated test suits to validate analytics events.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.7.0 - Sep 5, 2017¶
New:
- Android: introduced
MultipleInstallReferrerReceiver
to re-broadcast INSTALL_REFERRER intent to all receivers. No actions required on your side, upgrade will happen automatically.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.6.1 - Aug 22, 2017¶
New:
- Added
IsGuaranteedMatch
flag to theReferralData
to indicate certainty that data correspond to the user.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.6.0 - Aug 1, 2017¶
New:
- Activity Feed view for specific user using
SetFilterByUser(string userId)
ofActivityFeedViewBuilder
. - Read-only Activity Feed view using
SetReadOnly(bool readOnly)
ofActivityFeedViewBuilder
. - Query activity feed posts or comments for specific user using
FilterByUser(string userId)
ofActivitiesQuery
. - Method
GetSocial.User.SetAvatar(Texture2D avatarImage, Action onSuccess, Action<GetSocialError> onFailure)
, so now you can set image directly as user avatar image, not only from URL. - Added dark and white UI themes to the demo app.
- Security improvements: Documentation
Fixed:
- iOS: fixed orientation change issue when app supports only landscape or portrait mode.
- iOS: fixed always failing CommentsForPost activity feed query.
- Android: fixed auto initialization when no visual elements of the app were presented, for instance when push notification arrived. Fixed incorrect DAU numbers on the GetSocial Dashboard.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.5.0 - Jul 13, 2017¶
New:
- Added support for Android App Links.
- Added sample landscape UI configuration to the demo app.
- Content Reporting in Activity Feeds. Documentation
- Smart Links support. Documentation
Fixed:
- iOS: Not used architectures (like x86_64 ) will be removed when building
Release
configuration. - Issue when Push Notifications callback was not invoked on the application cold start.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.4.0 - Jun 26, 2017¶
New:
- Added Suggested Friends functionality. You can use it with
GetSocial.User.GetSuggestedFriends()
method. Read more in documentation. - Added “UI Configuration File” input in GetSocial Settings. Now you can enter path to default UI configuration file instead of loading it dynamically in code. Documentation
- Added Public properties functionality to
PublicUser
entity. Now you can read properties of other users. - Added methods
AllPublicProperties
andAllPrivateProperties
to get all user properties asDictionary
.
Improved:
- Moved native plugins inside
Assets/GetSocial/
folder to simplify SDK update process. - Automatically update meta-data in
AndroidManifest.xml
andinfo.plist
after updates to GetSocial Settings. - Android: reduced
getsocial-core.aar
size from 1.1 Mb to 0.8 Mb. And reduced method count from 5644 to 4510.
Fixed:
- Issues with subject while sending Smart Invite via Native Share.
- Android: collision errors with Json Simple library.
Upgrading:
Default Upgrade Guide was updated, please, check it again.
Before the update:
- Remove
Assets/Plugins/iOS/GetSocial
directory with its content. - Remove
Assets/Plugins/Android/getsocial-library.aar
andAssets/Plugins/Android/getsocial-ui.aar
.
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:
- Now you can disable image attachment to Smart Invites from Dashboard. Useful to avoid charges for sending MMS instead of SMS.
- Method
GetUserById
, you can retrievePublicUser
entity having only user ID.
Fixed:
- Android: Fixed randomly reproducible crashes related to changing UI on non-main threads.
- Android: Fixed possible
OutOfMemoryException
crashes. - Android: Fixed
NullPointerException
in install receiver if no token was passed. - Android: Fixed resource packaging when building Unity from Windows OS.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.2.0 - May 29, 2017¶
New:
- Added
ActivityDetailsView
, now you can open activity comments from code. - Added
WhenInitialized
method to be able to execute any action right after SDK is initialized. - Added
setAvatarClickListener
method toActivityFeedView
andActivityDetailsView
. You can use this method to get notified if a user clicked on a user’s avatar. - Added
Image
property toInviteContent.Builder
to set invite image using binaries. - Facebook and Kakao plugins share image as well in Smart Invites.
Fixed:
- Fixed issues with full screen activity.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.1.2 - May 19, 2017¶
Fixed:
- Fixed name collisions with other SDKs in iOS build.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.1.1 - May 18, 2017¶
Fixed:
- Fixed GetSocial Editor errors while copying native libraries.
Upgrading:
No special steps required. Please follow default upgrade guide.
v6.1.0 - May 15, 2017¶
New:
- Added
User Properties
functionality. Now you can store some custom properties for each user. More info in documentation. - Added
UiActionListener
, you can set it withSetUiActionListener()
method of any ofViewBuilder
children. All possible actions you can find inUiAction
enum. More info in documentation.
Updated:
- Updated underlying native GetSocial Android SDK version to 6.1.0.
- Updated underlying native GetSocial iOS SDK version to 6.1.0.
Removed:
- Removed dependency on
Gson
library on Android. Now SDK adds ~900 methods less.
Fixed:
- Ukrainian and Russian localization for plural nouns.
- Analytics crash on concurent list modification.
- Action buttons background issue in landscape mode.
- GetSocial Views stack is not cleared on iOS 8 devices.
- GetSocial Views title was trimmed on Android in landscape mode.
- Invite text missing in Facebook Messenger on Android.
- No empty view in case there are no activities yet.
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:
- Updated underlying native GetSocial Android SDK version to 6.0.3.
- Updated underlying native GetSocial iOS SDK version to 6.0.3.
Fixed:
- Now
SetWindowTitle()
works for all GetSocial windows.
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:
- Added compatibility with Unity 5.6.0.
- Added
ViewBuilder.SetViewStateCallbacks(Action onOpen, Action onClose)
method to get callbacks when GetSocial View is opened and closed.
Updated:
- Updated underlying native GetSocial Android SDK version to 6.0.2.
- Updated underlying native GetSocial iOS SDK version to 6.0.2.
Fixed:
- Fixed error in GetSocial Editor on Unity version before 5.5.0.
- Cleaned up API compatibility warnings in the Unity Editor.
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:
- Data API. With GetSocial’s Data API developers can now access the data layer of all our features breaking dependency on our UI and giving them more flexibility.
- Dynamic Activity Feeds. Developers can now create activity feeds on the fly. They can have a feed per clan, per fraction, per geo, or even level specific.
- Sticky activities are now Announcements. Developers can now post multiple announcements (announcements are always pinned on top) expiring at different time periods. All their announcements are accessible from one convenient location and can be rescheduled even after they expire.
- Auto-initialization. Integration just got easier, SDK will automatically initialize with your app, no need to take care of that.
Updated:
- Simplified API. We, at GetSocial, strive to provide the best integration experience. To achive this we had to rework our public API from scratch, it become easier to use and understand. It won’t be possible without breaking changes, **GetSocial SDK version 6 is not backward compatible with SDK version 5.
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:
-
Contact us at support@getsocial.im or via the support channel in our Dashboard to do the manual migration of your app to the new Dashboard.
-
Remove GetSocial SDK v5 from your project:
2.1. In your Unity project removeAssets/GetSocial/
andAssets/StreamingAssets/getsocial/
folders.
2.2. Comment out all usages of GetSocial SDK in the code to avoid compilation errors. -
Follow Getting Started Guide to integrate GetSocial Unity SDK v6.
- 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:
1 |
|
In SDK v6 you have to call static method:
1 |
|
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 |
Can’t figure our correct mapping?
Feel free to reach us at support@getsocial.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.