Upgrading the Toolkit

Version 3.0 Notes

The main goals driving the release of version 3.0 were:

Provide better doc and samples
Provide support for Silverlight
Provide support for ASP.NET MVC
Provide improved support for WPF
Provide improved support for FBML (FBML Server Controls)
Provide a login control that can be used to replace the BasePage and/or MasterPage for Canvas Development
Improve out of the box support for Extended Permission Prompts
Refactor core source to improve maintainability and design
Fix known bugs

As part of this, we worked closely with the Concept Development Team at Microsoft to help design the Silverlight and WPF support. Also, after discussions with Microsoft it was decided that the namespaces and methods should be updated again to be more consistent with traditional .NET apis. This will cause some breaking changes to everyone as they move to 3.0. But, the main goal is that we wanted to get it right this time so that this could become an officially supported client library. Microsoft is working with Facebook to get the toolkit identified as the officially supported library. The plan is to provide real-time support and updates to keep the toolkit in synch with the Facebook API.

Upgrading from Version 2.0/2.1 to 3.0

Topic	Version 2.1	Version 3.0
Namespace Casing	facebook, facebook.web	Facebook, Facebook.Web
Method Names	get(), getInfo()	Get(), GetInfo()
Async Suffix	get() (sync only)	Get() [Sync], GetAsync() [Async]
Forms & Components	Part of facebook.dll	Part of Facebook.Winforms.dll
ConnectToFacebook method	facebook.API	Desktop only, in Facebook.Winforms Other platforms leverage new Session objects to handle authentication. This was kept for backward compatibility
Schema objects updated & Namespace Casing	facebook.Schema	Facebook.Schema
Method return types	Some incorrect return types were corrected in v3.0. These will break upgraders, but are now correct types.
Public SendRequest methods		Added generic version and 1 overloaded method: public T SendRequest<T>(IDictionary<string, string> parameterDictionary, bool useSession)
API object constructor & Session objects refactored	API was instantiated with default constructor	API now (requires) a FacebookSession subclass in constructor
Session objects & namespace	Didn't exist	In Facebook.dll Used to encapsulate the handshake between various applications
FacebookService	Was in Facebook.dll	Moved to Facebook.Winforms.dll (since this is really a Winform focused component that really just wraps the Api class
JSON Helper methods exposed publicly	Not Exposed	Exposed Publicly

Version History

Version 1.1:

Added methods to FacebookService to wrap the Notifications.get Facebook API call. Added a new data object "Notifications" for wrapping the results.
Added Status and ProfileUpdateDate to the User object. Status contains the user's Facebook Status Message and time when it was updated. ProfileUpdateDate contains the date when the user last updated their Facebook profile.
Added SetFMBL method. Also correct GetRequestURL to correctly encode the format.
Added DirectFQLQuery. As designed on f8 wiki.
Fixed GetFriendsAppUsers. As designed on F8 wiki.
Fixed to add error handling to Country parsing in LocationParser
Added implementations of 2 notifications and 2 feeds apis.
Fixed parameter sorting for feeds apis to work correctly.
Change REST Call from GET to POST.
Add GetLoggedInUser
Fix handling for no returned secret
Add overload to GetUserInfo that takes a Collection of user ids

Version 1.2:

Refactored FacebookService
Added AsyncFacebookService
Refactored Parsers and Entities into their own directory and namespace
Added improved photo api
Added Canvas Base pages to Facebook.WebControls
Added Canvas samples to Facebook.WebControls
Added IFrame Ajax sample
Added IFrame Silverlight Example
Updated to new notifications API **INTERFACE CHANGE**
Updated PublishStory and PublishAction interfaces **INTERFACE CHANGE**
Updated CreateAlbum interface to return created Album **INTERFACE CHANGE**
Added SetFBML override taking in userid
Added small and big picture url and bitmap to photo and user
Added GetFriendsNonAppUsers method

Version 1.3

Made lots of bug fixes
Added Support for .NET Compact Framework
Added Size on photo album
Added Master page versions of Canvas Base pages
Added Support for new request/invitation interface with multi_friend_selector *** INTERFACE CHANGE ***
Added Big/small pictures on group
Added Upload Photo returns a photo id and album id
Added Support for PublishTemplatizedAction

Added GetFBML
Added RefreshRefHandle
Added RefreshImgSrc
Added SetRefHandle
Added Session Timeout handling to IFrame base page.

Version 1.4

(skipped by request)

Version 1.5

Created setup packages and .msi installer

Version 1.6

Updated SetFBML() to support Facebook’s API change applied on 1/17/2008

Profile.SetFBML no longer accepts a single ‘markup’ parameter to hold profile, profile action and mobile profile FBML markup. The new wrapper methods break the call into three parameters, profileFBML, profileActionFBML and mobileFBML.

Version 1.7

Refactored code and fixed bugs.

Version 2.0

Re-architected the API to create a lighter-weight wrapper around the API by using Linq2XSD to auto-generate the parsers and entity objects.
Updated login logic to account for the new profile changes.
Added new samples that work with the new API.
Changed default value for RequireLogin on CanvasFBMLBasePage and CanvasFBMLMasterPage to be false instead of true
Changed parameters for liveMessage.send
Implemented feed.publishUserAction
Made API.sendRequest public
Renamed Api property on CanvasIFrameBasePage to ApiKey to follow conventions and avoid case-sensitivity issues
Various bug fixes

Version 2.1

Added support for missing apis

admin.getRestrictionInfo
admin.setRestrictionInfo
admin.banUsers
admin.unbanUsers
admin.getBannedUsers
auth.revokeExtendedPersmission
commnets.get
fbml.deleteCustomTags
fbml.getCustomTags
fbml.registerCustomTags
links.get
links.post
notes.create
notes.delete
notes.edit
notes.get
status.get
status.set
stream.addComment
stream.addLike
stream.get
stream.getComments
stream.getFilters
stream.publish
stream.remove
stream.removeComment
stream.removeLike
users.getStandardInfo
users.IsVerified
video.getUploadLimits
video.upload

Fixed the following bugs 10512,10705,11009,11215,11410,12026,12351,12386,12446,12590,12592,12593,12742,12818,13231