Quick Start Guide

1. Download the pre-packaged SDK ZIP file at https://github.com/socialize/socialize-sdk-android/downloads
2. Unzip the SDK.
3. Open the read_me_first.html file located in the root of the ZIP.
4. Integrate Socialize.
5. Retire to a beach because your app is now so darn good.

Release Notes

v2.8.0

• [feature] Socialize is now an Android Library Project
• [feature] Socialize supports Facebook SDK v3.0
• [bug] Multiple comments posted if comment button hit more than once
• [bug] SDK Generates StrictMode violations due to disk access loading embedded images
• [bug] Scrolling slow/laggy on comment list
• [bug] Canceling FB auth when FB app is not installed does not trigger cancel in SDK
• [feature] Socialize verified against Facebook February 2013 Breaking Changes
• [feature] Socialize verified against Facebook March 2013 Breaking Changes
• [feature] Socialize verified against Facebook April 2013 Breaking Changes
• [bug] Facebook auth on Android 2.3.x leaves empty dialog after success
• [bug] Memory leak on screen rotation
• [feature] Developer can learn how to implement updated SDK in docs

v2.7.8

• [bug] ActionBar loading fails and is unrecoverable when network is unavailable

v2.7.7

• [bug] Device does not re-register for SmartAlerts after linking to FB/TW

v2.7.6

• [feature] Developer can configure how the SDK registers devices for notifications

v2.7.5

• [bug] Activity leak in BeanContextCache

v2.7.4

• [bug] Share dialog lingers on Android v2.x

v2.7.3

• [bug] NPE on device rotate
• [bug] Facebook token extension incorrectly triggered when FB no used

v2.7.2

• [bug] Default localization file missing from JAR

v2.7.1

• [bug] NPE in comment view

v2.7.0

• [feature] Socialize supports Google Cloud Messaging, C2DM deprecated
• [bug] Like count increments twice on action bar
• [feature] Developers can customize Strings within the SDK for localization
• [feature] Developer can learn about Localization in docs

v2.6.1

• [feature] Developer can learn how to specify a share dialog listener on the action bar in docs
• [bug] Auto-post to networks not working
• [feature] Developer can add a share dialog listener to the ActionBar

v2.6.0

• [feature] Hyperlinks in comments should be clickable
• [feature] Developer can learn how to disable SmartAlerts in docs
• [bug] Comment entry cleared on rotate

v2.5.7

• [feature] ActionBar reloads can be heard with a listener

v2.5.6

• [bug] ActionBar uses wrong entity if entity is changed rapidly during load

v2.5.5

• [bug] User cannot sign in to both TW and FB when app is compiled with proguard
• [feature] Proguard section in docs includes updated config items for retaining Signatures

v2.5.4

• [feature] Developers can send diagnostic logs via email from the device
• [feature] Developers can enable detailed diagnostic logs for troubleshooting devices in the wild
• [feature] Developer can learn how to enable diagnostic logging in docs

v2.5.3

• [bug] Comment Header does not display
• [bug] NPE on resume during authentication

v2.5.2

• [bug] NPE when user settings is displayed

v2.5.1

• [feature] Developers can programmatically disable the comment list header

v2.5.0

• [feature] Developer can learn how to implement a custom URL scheme in the documentation

for "deep linking" to content in their app

v2.4.4

Developers can remove header on comment list Developers can learn how to disable comment list header in docs

v2.4.3

• [feature] Developer can pre-initialize config prior to Socialize init
• [feature] Socialize checks local storage for socialize.properties file
• [feature] Developer can prevent a 3rd party network share from a listener
• [feature] Developer can see sample of sharing photos from Action Bar in demo app

v2.4.2

Internal release.

v2.4.1

Internal release.

v2.4.0

• [feature] Documentation includes examples of sharing to Google+ in screenshots
• [bug] Crash in onDestroy
• [feature] End users can elect to "remember" that they do not want to auth
• [feature] Developer can control prompting for share in global config
• [feature] Documentation more clearly explains configuration options

v2.3.4

• [bug] App crash when returning from User Settings when accessed from User Profile without an action
• [bug] ActionBar ticker rendering is overlapped on Jelly bean (4.1).

v2.3.3

• [feature] Developer can enable/disable anon. comments
• [bug] Share dialog incorrectly uses allow anon for button enable/disable

v2.3.2

• [bug] ActionBar in webview causes scroll problems
• [feature] Share dialog can be cached to improve performance
• [bug] After linking FB/TW when performing a like/comment the auth'd network is not pre-selected when sharing.
• [feature] Comment list should display more than 2 lines of comment
• [bug] Allow anonymous config option deprecated due to confusion. Added socialize.require.share

v2.3.1

• [bug] Changing the profile pic doesn't work

v2.3.0

• [feature] Developer can make Facebook open graph calls for Like
• [feature] Developer can customize colors for Action Bar
• [feature] Propagations for likes which use FB OG should include and extra param, og_action=like
• [bug] Facebook screenshot in docs should not indicate deep linking enabled
• [feature] Auth decisions from end user should be reported via event tracker
• [feature] Share decisions from end user should be reported via event tracker
• [feature] Users can share to Google+
• [feature] Linking an existing FB token should check to ensure the permissions on the token are sufficient
• [feature] SDK Should re-authenticate the user if their FB token expires
• [feature] Entity objects can nominate a type
• [feature] Developer can override remote path for Social Network posts (e.g. FB OpenGraph)
• [bug] Facebook token not persisting correctly
• [bug] Demo app does not render text fields correctly on Jelly Bean
• [feature] Developer can make custom Facebook open graph calls
• [feature] Developer can learn how to configure Open Graph in documentation
• [feature] Developer can subscribe to an entity (not just new_comments)
• [feature] Developer can get list of entities ordered by activity
• [bug] Unlinking from Facebook does not correctly clear local session data
• [feature] Developer can learn how to retrieve popular content from docs
• [bug] Activity options in documentation for manifest config are wrong
• [bug] Auth dialog does not render correctly when only FB is supported
• [feature] Developer can test popular entities in demo
• [bug] Changing facebook permissions causes re-auth even when permissions are already obtained
• [bug] Opening notification on JB doesn't load entity

v2.2.0

• [feature] Add Entities That Are Not URLs section in documentation
• [feature] Developer can retrieve app-wide actions based on a type (Comment/Share/Like)
• [feature] Socialize UIs should render correctly on tablet (Nexus 7) devices
• [bug] Facebook token reset does not behave correctly on ICS/JB devices
• [feature] ActionBar uses Socialize 2.0 interfaces

v2.1.1

• [bug] SDK should handle failure case for C2DM registration with Socialize API
• [feature] Update FB auth to match offline_access deprecation
• [feature] UI Components gracefully fail on LDPI
• [feature] Developer can enable/disable location sharing at an app level in config
• [bug] Comment view displays unexpected divider when location is not enabled on device
• [bug] User settings screen does not honor app level disabling of location

v2.1.0

• [feature] Socialize internal staff can access pre-built APK for SDK Demo App
• [feature] Documentation has updated screenshots for Facebook app configuration
• [bug] shareViaSocialNetworks does not expose the social networks as a parameter
• [feature] Developer can access internal tools classes used in Socialize
• [feature] Developer can override global settings for allow anonymous and require auth on a per call basis
• [feature] Developers can tweet from client SDK
• [feature] Developer can drop in new like button based on 2.0
• [feature] Developer can learn about like button in docs
• [feature] Developers can learn how to post direct tweets in documentation
• [feature] ActionBar shows numbers higher than 999 in stats ticker
• [feature] Developer can tweet photo from the SDK
• [feature] Developers can learn how to extract the C2DM token from Google in docs
• [feature] Developers can learn how to post photos to Facebook in docs
• [feature] Developers can learn how to post photos to Twitter in docs

v2.0.0

• [feature] Developer can access Socialize 2.0 using User interfaces
• [feature] Developer can access Socialize 2.0 using Comment interfaces
• [feature] Developer can access Socialize 2.0 using Like interfaces
• [feature] Add loading modal to Twitter auth webview
• [bug] Auth mismatch is not reflected correctly on device. Leads to 3rd part propagation failure
• [feature] Developer can access Socialize 2.0 using Share interfaces
• [feature] Developer can access Socialize 2.0 using View interfaces
• [feature] Redesign Auth Dialog to handle multiple selections
• [bug] authenticateKnownUser does not correctly save credentials
• [feature] Developer can access Socialize 2.0 using Facebook interfaces
• [feature] Developer can access Socialize 2.0 using Entity interfaces
• [feature] Developer can access Socialize 2.0 using Activity interfaces
• [feature] Implement new visual design for Auth Dialog (Share Dialog)
• [feature] ActionBar uses new Share dialog
• [feature] Developer can access Socialize 2.0 using Twitter interfaces
• [feature] Developer can access SmartAlertUtils in Socialize 2.0 interfaces
• [feature] Developer can access ActionBarUtils in Socialize 2.0 interfaces
• [feature] Developer can access LocationUtils in Socialize 2.0 interfaces
• [feature] Facebook wall posts should use entity URL as link
• [feature] Share dialog supports landscape orientation
• [bug] Twitter auth fails on ICS due to network access on main thread
• [bug] Landscape orientation does not reflect in socialize display utils after load
• [feature] Developer can add comment dialog to share functions
• [bug] Notification registration initializes static Socialize container at startup with wrong context
• [bug] Launcher system not compatible with Android 4.x
• [bug] ShareType is OTHER even when only one network is selected
• [feature] Developer can launch Auth Dialog
• [feature] Create new sample app for 2.0 interfaces
• [feature] Comment and Like process follows (new) standard auth->share model
• [feature] Developer can post directly to FB using FacebookUtils
• [feature] Developer can access local User settings as separate object to standard (server) User object
• [feature] Developer can nominate CommentOptions for a comment with separate SocialNetwork selections
• [feature] Developer can nominate LikeOptions for a like with separate SocialNetwork selections
• [feature] Developer can nominate arbitrary permissions for Direct Facebook access
• [bug] Not all actions using User's preference for location sharing
• [feature] Developer can learn about new 2.0 interfaces in documentation

v1.7.0

• [bug] SMS sending short link with ")" included in link causing unknown URL error when clicked

v1.6.8

• [bug] Duplicate file (socialize.properties) error on some platforms

v1.6.7

• [bug] Namespace conflict on Google Gdata libraries

v1.6.6

• [bug] Incorrect logic in actionbar causes auth dialog to always show for like
• [bug] Occasional crash caused by empty listener in location manager

v1.6.5

• [bug] Oauth namespace conflicts and causes crashes on some devices
• [bug] Facebook accesses network on main thread
• [bug] Location Services do not stop after location is received
• [feature] Added onPause/onResume calls to Socialize instance

v1.6.4

• [bug] Fixed GSON package naming for HTC Desire users

v1.6.3

• [feature] Add client side settings option to disable location

v1.6.2

• [feature] Remove superfluous gs.com link on propagations
• [feature] prompt authentication on likes
• [feature] developer can hide/show 'id rather not' text on auth screen with parameter
• [feature] Developer can find information about auto-auth in the docs.

v1.6.1

• [feature] Direct URL WebView should not close when user hits back key if there is web history
• [feature] new_comment notification should open directly to comment list
• [feature] Device calls events endpoint on notification open
• [bug] SDK calls /authenticate multiple times on first init.

v1.6

• [feature] Add documentation for getting device token from logs
• [feature] User can receive direct_entity messages from developer as SmartAlert
• [feature] User can receive direct_url messages from developer as SmartAlert
• [feature] Add documentation for registering a C2DM account with google
• [bug] remove duplicate link to app in FB posts

v1.5.6

• [feature] Facebook links are shortened by the server
• [feature] Email links are shortened
• [feature] SMS links are shortened
• [feature] Update Facebook SDK

v1.5.5

• [bug] Facebook sharing fix

v1.5.4

• [bug] Posting to FB and Twitter fails
• [bug] Comment list view crash on Galaxy Nexus
• [bug] Image loading that is unresolved doesn't dequeue
• [bug] Spinner on comment list is distorted on XHDPI

v1.5.3

• [bug] Twitter auth failure (Communication with the service provider failed: null)
• [bug] SmartAlerts failing when not authenticated

v1.5.2

• [feature] Developer notification title should say "A message from..."
• [bug] Auth credentials not saved

v1.5.1

• [bug] SmartAlerts should not conflict with existing C2DM handling
• [bug] device should be re-registered with Socialize if CD2M id changes
• [bug] Developer notifications should not result in "action id not found"
• [bug] Disabling notification in user settings does not disable notifications

v1.5.0

• [feature] Developer can authenticate user with twitter in SDK
• [feature] Share behavior for comment/like should match propagation spec
• [feature] Developer can elect to share via twitter in SDK
• [feature] User can sign in/out of Twitter in settings
• [feature] User can enable/disable auto-tweeting of comments in settings
• [feature] User can enable/disable auto-tweeting of likes in settings
• [feature] User can share via twitter on comment window
• [feature] Developer can learn about twitter integration in the docs
• [bug] Scroll View should not be added if parent view is a ListView
• [feature] User can share via twitter on share window

v1.4.6

• [bug] Error when selecting "other options" from share view
• [bug] UI Lockup when error occurs during FB auth
• [bug] Amazon app store url suffix missing from entity urls

v1.4.5

• [feature] Remove transparency on Action Bar loading view
• [bug] Error when sharing (text not included)
• [bug] LaunchActivity missing from docs

v1.4.4

• [feature] Add app store type to redirect URLS (e.g. Amazon App Store)
• [bug] XHDPI missing location pin image
• [bug] Share options (location and FB) are not enabled on first load of share slider
• [feature] Facebook error should present a dialog
• [bug] EntityLoader does not work from notification

v1.4.3

• [feature] Add proguard conf to docs
• [bug] Notifications broken in SDK (NPE)

v1.4.2

• [bug] Like button does not gracefully handle sign out of fb after like
• [bug] Like button does not update local cache for entity leading to stale data in the action bar

v1.4.1

• [bug] Multiple notifications do not always open the app correctly
• [bug] Like button does not load if entity does not exist

v1.4.0

• [bug] Images on Galaxy Nexus do not render correctly
• [feature] Add like button which can be easily customized with image and name
• [bug] Failed FB auth does not clear session correctly
• [bug] Oauth class fails to load (proguard conf)
• [feature] Add documentation for like button
• [feature] Add documentation for how to use the manual XML layout option (i.e. what does the source code look like)
• [bug] ActionBar does not refresh when loaded using manual XML
• [feature] add debug level warning that FB isn't configured.
• [bug] Loading spinner on XDPI looks distorted
• [bug] Dialog for comment auth does not render correctly on galaxy nexus

v1.3.2

• [feature] Entity Loader should know whether an entity can be loaded
• [feature] Update entity loader documentation

v1.3.1

• [feature] re-added meta data to entity
• [feature] Save/cancel buttons in settings are fixed at screen bottom (don't scroll)
• [bug] ActionBar reload fails if entity does not exist
• [bug] scroll view does not fill width when action bar is inserted
• [bug] NPE on profile save when notifications not enabled

v1.3.0

• [bug] Comment, Share and Like from SDK should post to FB without ActionBar
• [feature] Add redirect url for all share actions
• [feature] Developer can add custom data in entity loader to allow for other information when loading an entity.
• [feature] SDK can receive notifications from C2DM
• [feature] User can access notification in Android notification area
• [feature] Log the signature base string generated by the device
• [feature] Add unsubscribe to comment list view
• [feature] add user subscribe/unsubscribe for the SDK
• [feature] User is taken to aciton detail view when clicking a notification
• [feature] Add subscribe feature to createComment (SDK)
• [bug] Action detail view does not render on Galaxy Nexus
• [feature] ActionBar should load without READ_PHONE_STATE permission
• [feature] User can change auto-posting of likes/comments in user settings
• [feature] Notifications should optionally use app icon
• [bug] Invalid notifications render as nullnull on device
• [bug] Documentation still references old CommentDetailActivity
• [bug] HIGH PRI - comments counter doesn't refresh on action bar after leaving a comment
• [bug] HIGH PRI - make sure to strip blank space from key/secret before sending it to user
• [bug] App icon not always called "icon"
• [feature] HIGH PRI - add link in documentation to "check out dashboard" when they're done with the quickstart guide. [ documentation ]
• [feature] HIGH PRI - add description of an "entity key" in documentation [ documentation ]
• [feature] HIGH PRI - ambigous "they" in introduction for notifications. When a user leaves a comment they can "elect" to subscribe to that comment. [ documentation ]
• [feature] HIGH PRI - Make introduction generic for actions and make subsection for live alerts in threads. [ documentation ]
• [feature] HIGH PRI - line highlight position is wrong in XML for notifications [ documentation ]
• [feature] entity loader section needs full load example [ documentation ]
• [feature] HIGH PRI - on step 1 click notification settings. [ documentation ]
• [feature] check in code to make sure that the device has the google API for sending notifications [ notifications ]

v1.2.0

• [bug] Comments should be HTML encoded when rendering
• [feature] User activity scrolls entire view
• [feature] New ActionView to replace comment view
• [feature] New edit settings view for users
• [feature] End user edits settings from a separate view
• [bug] Comment list does not stop scrolling after loading new items
• [feature] Style of items in comment list matches activity list
• [bug] postShare event on ActionBar doesn't fire on listener

v1.1.0

• [feature] List Comments By User (SDK)
• [bug] Session does not persist user auth data correctly
• [feature] List activity for User
• [feature] Add share location option when posting comments
• [feature] Add location icon to comments with location shared
• [feature] User can select and copy text from a comment
• [feature] User activity in profile view
• [feature] Comment list and entry view renders in landscape
• [feature] SDK user can add entity loader
• [feature] Remove requirement for URL from code and docs

v1.0.4

• [bug] After signing in or out of FB for the first time, the "edit profile" menu option takes you to the wrong user (the old one)
• [bug] Share features should detect when device does not have capability (e.g. SMS)

v1.0.3

• [feature] Add list likes by user (SDK)

v1.0.2

• [bug] Comment list displays cached (incorrect) results when loading a different entity from ActionBar

v1.0.1

Internal release

v1.0.0

• [feature] Add simple sample app to SDK download
• [feature] Camera icon on profile image edit is too small
• [bug] Crash if user attempts to edit profile before profile picture has loaded
• [bug] Share in landscape does not have enough room to display buttons
• [bug] Posting app link to FB doesn't include image icon
• [bug] After signing in or out of FB for the first time, the "edit profile" menu option takes you to the wrong user (the old one)

v0.7.0

• [bug] Images are not scaled correctly for MDPI
• [feature] Socialize action bar (view,comment,like)
• [bug] Images don't always load on MDPI comment view
• [bug] FB Sign in button doesn't work after hitting back from the first time
• [feature] Developer can allow end users to Share entity using Facebook
• [feature] Add spinner to like
• [feature] Posting comments should auto post to FB
• [feature] Likes should auto post to FB wall
• [feature] Add share to ActionBar
• [feature] Developer can create a share (SDK)
• [bug] Comment list enters infinite loop when accessed from Action Bar
• [bug] User Agent is missing trailing semi colon
• [bug] Like button keeps spinning after a few successive hits
• [bug] Share is broken in action bar
• [feature] Add comment to share
• [bug] Facebook button should not appear in share window if FB not available
• [feature] User can change auto-post preferences
• [feature] Add comment screen
• [feature] SDK User can learn about new action bar features in documentation

v0.6.0

• [feature] Prompt for auth on comment
• [bug] Location is sending lon instead of lng
• [feature] Package name included in user agent string
• [bug] can't see access api button after auth , display issue
• [bug] User should see Lat/Long if it exists in Sample App when get comment.
• [feature] Update docs to add instructions for using FB auth
• [feature] Add profile images to comments
• [feature] Add user display name to comments
• [feature] User profile view
• [feature] User profile edit
• [bug] canceling FB auth auto-posts as anonymous
• [feature] Add comment view as distinct from profile view
• [feature] Access profile from comment view
• [bug] Posting comments doesn't work if FB id not provided
• [feature] Add support for disabling SSO in FB auth
• [bug] Edit profile buttons should not appear for anon. user
• [feature] Add approved text to auth dialog popups
• [feature] Update doco for new UI features
• [feature] Rename getting started guide to "read_me_first"
• [feature] Add GetSatisfaction widget to documentation
• [feature] Developer can Get a Socialize User (Profile)

v0.3.0

• [feature] Create entity
• [feature] Add country and/or language to User Agent
• [feature] Developer can Create a "view"
• [feature] Developer can Authenticate their socialize users using Facebook Auth

v0.2.1

• [feature] User can read a quick start Installation guide in the readme.txt file in the repo
• [feature] User can access/read the repo's readme.txt file in GitHub
• [bug] SDK throws NPE when no results returned from POST

v0.2.0

• [bug] Making multiple 'like' requests to the same entity results in new entity objects being created
• [bug] Getting Started Guide missing ');'
• [feature] Get entity
• [feature] Developer gets paginated results
• [bug] Multiple operations as anonymous user creates a new user each time
• [feature] List comments for entity
• [feature] Get like for entity
• [feature] Get comment
• [feature] Create comment on entity
• [feature] List likes for entity

v0.1.0.1

• [bug] API url is incorrect in config

v0.1.0

• [feature] Like an entity
• [feature] Unlike an entity
• [feature] Authenticate user
• [feature] Device will send agent in request