Communicado

The first thing to know is can share from any UIViewController that conforms to SharingCapableViewController. Once you add this, you will get a share function on UIViewController which supports many built in sharing types.

You can share to:

• Messages
• Mail
• Pasteboard
• Photos
• UIActivityController
• Twitter (iOS 10.3 and lower)
• Facebook (iOS 10.3 and lower)
• Sina Weibo (iOS 10.3 and lower)
• Tencent Weibo (iOS 10.3 and lower)

Each sharing destination takes in parameters. Let's try a simple example.

let heartImageData = UIImagePNGRepresentation(myHeartImage)
let attachment = Attachment(attachmentType: AttachmentType.png, filename: "heart.png", data: heartImageData)
let messageParameters = MessageShareParameters(message: "I ❤️ Communicado", attachments: [ attachment ])

Now let's call the ONLY method that's even available to you.

self.share(messageParameters)

And when you're done, you'll get one unified callback with the information of how the share attempt went.

self.sharingCompleted = { shareResult in
    print("Was successful? \(shareResult.success)")
    print("Sharing service: \(shareResult.sharingService)")
}

You can do the same for the other sharing destinations as well.

self.share(MailShareParameters)
self.share(SocialShareParameters)
self.share(ActivityShareParameters)
self.share(PhotosShareParameters)
self.share(PasteboardShareParameters)

You can also use Communicado to style the MFMailComposeViewController and MFMessageComposeViewController with just a few lines of code. This works around all of the hoops Apple makes you jump through to style the built in sharing controllers.

All you have to do is:

self.sharingTitleTextAttributes = [
    NSAttributedString.Key.foregroundColor : UIColor.white,
    NSAttributedString.Key.font : UIFont.systemFont(ofSize: 21.0)
]

self.sharingBarButtonItemAttributes = [
    NSAttributedString.Key.foregroundColor : UIColor.purple,
    NSAttributedString.Key.font : UIFont.systemFont(ofSize: 16.0)
]

self.sharingBackgroundColor = UIColor.blue

And get something that looks like this:

Beautiful, isn't it?

• iOS 9.0+
• Xcode 8.0+

For Swift 3 support, use version 2.0.2.
For Swift 4 support, you can use version 3.0.
For Swift 4.2 support, you can use version 3.1 or above.
For Swift 5.1 support, you can use version 3.2.0 or above.

You can use SPM to install Communicado.

You can also use CocoaPods to install Communicado by adding it to your Podfile:

platform :ios, '9.0'
use_frameworks!

pod 'Communicado'

Or install it manually by downloading all the files in the Source folder and dropping them into your project.

Hi, I'm Joe everywhere on the web, but especially on Twitter.

See the license for more information about how you can use Communicado. I promise it's not GPL, because I am not "that guy".

Yes, this is the end. Hopefully Communicado makes your life easier. It probably won't help you pay your rent, but it might make it easier to share in your app.