iOS

How to add Social Media Integration to your iOS App


Welcome to my new SWIFT tutorial. Today I’ll show you how to implement social media integration for Facebook and Twitter. Additionally I’ll explain Email integration and how to embed a direct  AppStore link to provide a convenient way for players to rate an app.

My latest game in the AppStore contains a sample:

 
The four buttons at the bottom of the screen trigger the social actions:
 
 

1. Create a sample project:

Start XCode and create a new Single View Application:

 
 
 
Open the Main.storyboard file and add four buttons to the ViewController:
For a proper layout on all form factors and orientations add the needed auto layout constraints:
 
  • Select the four buttons
  • Press the Pin button
  • Enter in the spacing to nearest neighbour section 20 to the bottom and 10 to the right
 
 
XCode shows a warning, that the current layout does not match the constraints (the yellow lines). To fix this click the Resolve Auto Layout Issues button and choose Update Frames:
 
 
The result should look like this:
 
Change the background colour of the view to black:
 
 
Add an IBAction method for every button (Select CTRL, press mouse and move the mouse pointer to the view controller file)
 
 
The  ViewController.swift file should look like this:
 
import UIKit
 
class ViewController: UIViewController {
 
    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view, typically from a nib.
    }
 
 
    @IBAction func handleAppStore(sender: AnyObject) {
         
    }
 
    @IBAction func handleFacebook(sender: AnyObject) {
        
    }
 
    @IBAction func handleTwitter(sender: AnyObject) {
         
    }
 
    @IBAction func handleMail(sender: AnyObject) {
         
    }
 
 
}
Add an image to image.assets which can be attached to the tweets, posts ands mail.
 
 
 
 

2. Implement AppStore Integration

 
Implement the handleAppStore method. Show an alert where the user can choose to navigate to the AppStore:
@IBAction func handleAppStore(sender: AnyObject) {
    let alert = UIAlertController(title: „Rate“, message:  „Rate my App“, preferredStyle: UIAlertControllerStyle.Alert)
    alert.addAction(UIAlertAction(title: „Rate“, style: UIAlertActionStyle.Default)  { _ in
        // Open App in AppStore
        let iLink = „https://itunes.apple.com/us/app/yet-another-spaceshooter/id949662362?mt=8“
        UIApplication.sharedApplication().openURL(NSURL(string: iLink)!)
    } )
    alert.addAction(UIAlertAction(title: „Cancel“, style: UIAlertActionStyle.Default, handler: nil))
    self.presentViewController(alert, animated: true, completion: nil)
}

3. Implement Mail Integration

 
Import MessageUI and add the MFMailComposeViewControllerDelegate to the class definition:
import MessageUI
 
class ViewController: UIViewController, MFMailComposeViewControllerDelegate {

Implement the handleMail and mailComposeController methods:

@IBAction func handleMail(sender: AnyObject) {
    // Check if Mail is available
    if(MFMailComposeViewController.canSendMail()){
        // Create the mail message
        var mail = MFMailComposeViewController()
        mail.mailComposeDelegate = self
        mail.setSubject(„New App“)
        mail.setMessageBody(„I want to share this App: „, isHTML: false)
        // Attach the image
        let imageData = UIImagePNGRepresentation(UIImage(named: „shareImage“))
        mail.addAttachmentData(imageData, mimeType: „image/png“, fileName: „Image“)
        self.presentViewController(mail, animated: true, completion: nil)
    } else {
        // Mail not available. Show a warning
        let alert = UIAlertController(title: „Email“, message: „Email not available“, preferredStyle: UIAlertControllerStyle.Alert)
        alert.addAction(UIAlertAction(title: „OK“, style: UIAlertActionStyle.Default, handler: nil))
        self.presentViewController(alert, animated: true, completion: nil)
    }
}
 
// Required by interface MFMailComposeViewControllerDelegate
func mailComposeController(controller: MFMailComposeViewController!, didFinishWithResult result: MFMailComposeResult, error: NSError!) {
    // Close the mail dialog
    self.dismissViewControllerAnimated(true, completion: nil)
 
}

4. Implement Twitter Integration

Import the Social:

import Social

Implement the handleTwitter method:

@IBAction func handleTwitter(sender: AnyObject) {
    // Check if Twitter is available
    if(SLComposeViewController.isAvailableForServiceType(SLServiceTypeTwitter)) {
        // Create the tweet
        let tweet = SLComposeViewController(forServiceType: SLServiceTypeTwitter)
        tweet.setInitialText(„I want to share this App: „)
        tweet.addImage(UIImage(named: „shareImage“))
        self.presentViewController(tweet, animated: true, completion: nil)
    } else {
        // Twitter not available. Show a warning
        let alert = UIAlertController(title: „Twitter“, message: „Twitter not available“, preferredStyle: UIAlertControllerStyle.Alert)
        alert.addAction(UIAlertAction(title: „OK“, style: UIAlertActionStyle.Default, handler: nil))
        self.presentViewController(alert, animated: true, completion: nil)
    }
}

5. Implement Facebook Integration

Implement the handleFacebook method:

@IBAction func handleFacebook(sender: AnyObject) {
    // Check if Facebook is available
    if (SLComposeViewController.isAvailableForServiceType(SLServiceTypeFacebook))
    {
        // Create the post
        let post = SLComposeViewController(forServiceType: (SLServiceTypeFacebook))
        post.setInitialText(„I want to share this App: „)
        post.addImage(UIImage(named: „shareImage“))
        self.presentViewController(post, animated: true, completion: nil)
    } else {
        // Facebook not available. Show a warning
        let alert = UIAlertController(title: „Facebook“, message: „Facebook not available“, preferredStyle: UIAlertControllerStyle.Alert)
        alert.addAction(UIAlertAction(title: „OK“, style: UIAlertActionStyle.Default, handler: nil))
        self.presentViewController(alert, animated: true, completion: nil)
    }
}

Instead of the text you should show icons. I cannot add them to the SourceCode because of copyright reasons. You can download them from Facebook and Twitter homepage.

That’s all for today. The SourceCode of this tutorial is available at GitHub. For my next post I’m planning something about In App Purchase. To see the social media integration in action you can download my free game in the AppStore:
 

Cheers, 
Stefan

Parallax Effect
Quick Tip: Endless scrolling tutorial with SpriteKit and SWIFT (Part 2 of 2)
Game Development
Game Center Integration
Scrolling
Quick Tip: Endless scrolling with SpriteKit and SWIFT (Part 1 of 2)