++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
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.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
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
[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
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
[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
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
[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
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
[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
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
[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
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
[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
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
[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
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
[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
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
[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
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
[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
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
[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
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

[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