Facebook iOS SDK 3.14

Summary:
    see https://developers.facebook.com/ios/change-log-3.x/

Upgrading:
    https://developers.facebook.com/docs/ios/upgrading/

.gitmodules

@@ -10,3 +10,6 @@
 [submodule "vendor/appledoc"]
 	path = vendor/appledoc
 	url = git://github.com/tomaz/appledoc.git
+[submodule "Bolts-IOS"]
+	path = Bolts-IOS
+	url = git://github.com/BoltsFramework/Bolts-iOS.git

samples/FriendPickerSample/FriendPickerSample/FPViewController.m

@@ -53,7 +53,7 @@ - (IBAction)pickFriendsButtonClick:(id)sender {
     // if the session is open, then load the data for our view controller
     if (!FBSession.activeSession.isOpen) {
         // if the session is closed, then we open it here, and establish a handler for state changes
-        [FBSession openActiveSessionWithReadPermissions:nil
+        [FBSession openActiveSessionWithReadPermissions:@[@"public_profile", @"user_friends"]
                                            allowLoginUI:YES
                                       completionHandler:^(FBSession *session,
                                                              FBSessionState state,

samples/HelloFacebookSample/HelloFacebookSample/HFViewController.m

@@ -117,16 +117,14 @@ - (void)loginViewFetchedUserInfo:(FBLoginView *)loginView
 
 - (void)loginViewShowingLoggedOutUser:(FBLoginView *)loginView {
     // test to see if we can use the share dialog built into the Facebook application
-    FBShareDialogParams *p = [[FBShareDialogParams alloc] init];
+    FBLinkShareParams *p = [[FBLinkShareParams alloc] init];
     p.link = [NSURL URLWithString:@"http://developers.facebook.com/ios"];
-#ifdef DEBUG
-    [FBSettings enableBetaFeatures:FBBetaFeaturesShareDialog];
-#endif
     BOOL canShareFB = [FBDialogs canPresentShareDialogWithParams:p];
     BOOL canShareiOS6 = [FBDialogs canPresentOSIntegratedShareDialogWithSession:nil];
+    BOOL canShareFBPhoto = [FBDialogs canPresentShareDialogWithPhotos];
 
     self.buttonPostStatus.enabled = canShareFB || canShareiOS6;
-    self.buttonPostPhoto.enabled = NO;
+    self.buttonPostPhoto.enabled = canShareFBPhoto;
     self.buttonPickFriends.enabled = NO;
     self.buttonPickPlace.enabled = NO;
 
@@ -192,19 +190,20 @@ - (IBAction)postStatusUpdateClick:(UIButton *)sender {
     // allows the app to publish without any user interaction.
 
     // If it is available, we will first try to post using the share dialog in the Facebook app
-    FBAppCall *appCall = [FBDialogs presentShareDialogWithLink:urlToShare
-                                                          name:@"Hello Facebook"
-                                                       caption:nil
-                                                   description:@"The 'Hello Facebook' sample application showcases simple Facebook integration."
-                                                       picture:nil
-                                                   clientState:nil
-                                                       handler:^(FBAppCall *call, NSDictionary *results, NSError *error) {
-                                                           if (error) {
-                                                               NSLog(@"Error: %@", error.description);
-                                                           } else {
-                                                               NSLog(@"Success!");
-                                                           }
-                                                       }];
+    FBLinkShareParams *params = [[FBLinkShareParams alloc] initWithLink:urlToShare
+                                                                   name:@"Hello Facebook"
+                                                                caption:nil
+                                                            description:@"The 'Hello Facebook' sample application showcases simple Facebook integration."
+                                                                picture:nil];
+    FBAppCall *appCall = [FBDialogs presentShareDialogWithParams:params
+                                                     clientState:nil
+                                                         handler:^(FBAppCall *call, NSDictionary *results, NSError *error) {
+                                                             if (error) {
+                                                                 NSLog(@"Error: %@", error.description);
+                                                             } else {
+                                                                 NSLog(@"Success!");
+                                                             }
+                                                         }];
 
     if (!appCall) {
         // Next try to post using Facebook's iOS6 integration
@@ -243,12 +242,10 @@ - (IBAction)postPhotoClick:(UIButton *)sender {
   // Just use the icon image from the application itself.  A real app would have a more
   // useful way to get an image.
   UIImage *img = [UIImage imageNamed:@"Icon-72@2x.png"];
-
-
-    BOOL canPresent = [FBDialogs canPresentShareDialogWithPhotos];
-    NSLog(@"canPresent: %d", canPresent);
+  BOOL canPresent = [FBDialogs canPresentShareDialogWithPhotos];
+  NSLog(@"canPresent: %d", canPresent);
 
-  FBShareDialogPhotoParams *params = [[FBShareDialogPhotoParams alloc] init];
+  FBPhotoParams *params = [[FBPhotoParams alloc] init];
   params.photos = @[img];
 
   FBAppCall *appCall = [FBDialogs presentShareDialogWithPhotoParams:params

samples/RPSSample/RPSSample/RPSGameViewController.m

@@ -396,7 +396,7 @@ - (BOOL)shareGameActivity {
     action[@"gesture"] = builtInOpenGraphObjects[_lastPlayerCall]; // set action's gesture property
     action[@"opposing_gesture"] = builtInOpenGraphObjects[_lastComputerCall]; // set action's opposing_gesture property
 
-    FBOpenGraphActionShareDialogParams *params = [[FBOpenGraphActionShareDialogParams alloc] init];
+    FBOpenGraphActionParams *params = [[FBOpenGraphActionParams alloc] init];
     params.action = action;
     params.actionType = @"fb_sample_rps:throw";
     params.previewPropertyName = @"gesture";
@@ -407,7 +407,7 @@ - (BOOL)shareGameActivity {
 }
 
 - (BOOL)shareGameLink {
-    FBShareDialogParams *params = [[FBShareDialogParams alloc] init];
+    FBLinkShareParams *params = [[FBLinkShareParams alloc] init];
     params.link = [NSURL URLWithString:@"https://developers.facebook.com/"];
     params.name = @"Rock, Papers, Scissors Sample Application";
 

samples/Scrumptious/ReadMe.txt

@@ -9,8 +9,8 @@ The example utilizes several controls for the Facebook SDK including:
  FBLoginView - used on the landing page for authenticating the user.
  FBFriendPickerViewController - presented from the main UI to pick friends.
  FBPlacePickerViewController - presented from the main UI to pick a location.
- FBuserSettingsViewController - used to log the user out.
- 
+ FBUserSettingsViewController - used to log the user out.
+
 Furthermore, the sample demonstrates usage of Open Graph objects and actions. While the functionality is 
 quite constrained in order to be of reasonable size for a sample, the Facebook integration could serve
 as the basis for more full-featured applications. In particular, look for the text "Facebook SDK" to identify