iOS

Adding AirDrop File Sharing Feature to Your iOS Apps


AirDrop is Apple’s answer to file and data sharing. Before the debut of iOS 7, users need to rely on 3rd-party apps such as Bump to share files between iOS devices. In iOS 7, Apple introduced a new feature called AirDrop to all iPhone 5 models, the fourth-generation iPad, the iPad mini, and fifth-generation iPod touch models. With AirDrop, you can easily share data with other nearby iOS devices. In brief, the feature allows you to share photos, videos, contacts, URLs, Passbook passes, app listings on the App Store, media listings on iTunes Store, location in Maps, etc.

As a developer, wouldn’t be great to incorporate the AirDrop feature in your app? So your users can easily share photos, text file or any types of document easily with nearby devices. The UIActivityViewController class bundled in the iOS 7 SDK makes it simple for developers to integrate AirDrop feature in their apps. The class shields you from the underlying details of file sharing. What you just need is tell the class the objects you want to share and it handles the rest. In this tutorial, we’ll demonstrate the usage of UIActivityViewController and see how you can use it to share images / documents by using AirDrop.

AirDrop Tutorial

Let’s get started.

AirDrop Overview

Before we step into the implementation, let’s have a quick look at AirDrop. It’s very simple to use AirDrop. Simply bring up Control Center and tap AirDrop to enable it. You can either select “Contact Only” or “Everyone” depending on whom you want to share the data with. If you choose the Contact Only option, your device will only discovered by people listed in your contacts. Obviously, your device can be discovered by anyone for the Everyone option.

Airdrop Overview

AirDrop uses Bluetooth to scan for nearby devices. When a connection is established via Bluetooth, it’ll create an ad-hoc Wi-Fi network to link the two devices together, allowing for faster data transmission. It doesn’t mean you need to connect the devices to a Wi-Fi network in order to use AirDrop. Your WiFi simply needs to be on for the data transfer.

Say you want to share a photo in the Photos app from one iPhone to another. Assuming you’ve enabled AirDrop on both devices, to share the photos with another device, tap the Share button (the one with an arrow pointing up) at the lower-left of the screen.

Airdrop Overview Receiving Side

In the AirDrop area, you should see the name of the devices that are eligible for sharing. AirDrop is not available when the screen is turned off. So make sure the device on the receiving side is switched on. You can then select the device to share the photo. On the other device, you’ll see a preview of the photo and a confirmation request. The recipient can accept or decline to receive the image. If you choose the accept option, the photo is then transferred and automatically saved in the camera roll.

AirDrop doesn’t just work with the Photos app. You can also find the share option in most of the built-in apps such as Contacts, iTunes, App Store, Safari, to name a few. If you’re new to AirDrop, you should now have a better idea.

Let’s move on and see how we can incorporate AirDrop feature in your app to share various types of data.

A Quick Look at UIActivityViewController

You may think it’ll take a lot of efforts to implement the AirDrop feature. Conversely, you just need a few lines of code to add AirDrop support. The UIActivityViewController class available in iOS 7 SDK makes it super easy to integrate the feature. The AirDrop has been built into the class.

The UIActivityViewController class is a standard view controller that provides several standard services, such as copying items to the clipboard, sharing content to social media sites, sending items via Messages, etc. In iOS 7 SDK, the class comes with the AirDrop feature built-in.

Say, you have an array of objects to share using AirDrop. All you need to do is to initiate a UIActivityViewController with the array of objects and present it on screen:

With just two lines of code, you can bring up the activity view with AirDrop option. Whenever there is a nearby device detected, the activity controller automatically shows the device and handles the data transfer if you choose to.

UIActivityViewController AirDrop

Optionally, you can exclude certain types of activities. Say, you can just display the AirDrop activity by excluding all other activities. Use the following code:

The activity view controller now only shows the AirDrop option:

UIActivityViewController AirDrop Only

You can use UIActivityViewController to share different types of data including NSString, UIImage and NSURL. Not only you can use NSURL to share a link, it allows developers to transfer any types of files by using file URL.

On the receiving side, when the other device receives the data, it’ll automatically open an app based on the data type. Say, if an UIImage is transferred, the received image will be displayed in Photos app. When you transfer a PDF file, the other device will open it in Safari. If you just share a NSString object, the data will be presented in Notes app.

A Glance at the AirDrop Demo App

To give you a better idea about UIActivityViewController and AirDrop, we’ll build a AirDrop demo app. The app is very simple. When it is first launched, you’ll see a table view listing a few files including an image file, a PDF file and a text file. You can tap the file and view the content. In the content view, there is an action button on the top-right corner of screen. Tapping it will bring up the AirDrop option and you can share the image or document with nearby device.

AirDrop Demo App Workflow

You’re encouraged to build the demo app from scratch. But to save your time, you can download this project template to start with. When you open Xcode project, you should find the following Storyboard:

AirDrop Demo Storyboard

I have already implemented the ListTableViewController and DocumentViewController for you. If you compile and run the app, you’ll be presented with a list of files. When you tap any of the file, the image or document content will be displayed. But the share button is not yet implemented and that is what we’re going to talk about.

Adding AirDrop Feature

In the project template, the ListTableViewController is used to displayed the list of files in a table view, while the DocumentViewController presents the document content via a web view. The action button in the document view is associated with the share: method of the DocumentViewController class. Edit the method with the following code:

If you’re not forgetful, the above code should be very familiar to you as we’ve discussed it at the very beginning. The above code simply creates a UIActivityViewController, excludes all activities except AirDrop and presents the controller as a modal view. The tricky part is how you define the objects to share. Here we turn the file to share into a NSURL object and pass the file URL as an array to AirDrop.

The first two lines of code are responsible for the file URL conversion. The documentName property stores the current file (e.g. ios-game-kit-sample.pdf) displaying in document view. We simply call up the fileToURL: method with the document name and it returns the corresponding file URL. The fileToURL: method is bundled in the project template and here is the code:

The code is very straightforward. For example, the ios-game-kit-sample.pdf will be transformed to file:///Users/simon/Library/Application%20Support/iPhone%20Simulator/7.0.3/Applications/A5321493-318A-4A3B-8B37-E56B8B4405FC/AirDropDemo.app/ios-game-kit-sample.pdf. The file URL varies depending on the device you’re running. But the URL should begin with the “file://” protocol. With the file URL object, we create the corresponding array and pass it to UIActivityViewController for AirDrop sharing.

Build and Run the AirDrop Demo

You’re done. That’s what you need to implement AirDrop sharing. Compile and run the app on a real iPhone. Yes, you need a real device to test AirDrop sharing. The sharing feature won’t work on the Simulator.

AirDrop Demo App Share PDF

Uniform Type Identifiers (UTIs)

When you share an image to another iOS device, the receiving side automatically opens Photos app and loads the image. If you transfer a PDF file, the receiving device may prompt you to pick an app for opening the file or open it directly in iBooks. How can iOS know which app to use for the type of data?

UTIs (short for Uniform Type Identifiers) is Apple’s answer to identify data handled within the system. In brief, a uniform type identifier is a unique identifier for a particular type of data or file. For instance, com.adobe.pdf represents a PDF document and public.png represents a PNG image. You can find the full list of registered UTIs here. Application that is capable of opening a specific type of file has registered to handle that UTI with the iOS. So whenever that type of file is opened, iOS hands off that file to the specific app.

The system allows multiple apps to register the same UTI. In this case, iOS will prompt user with the list of capable apps for opening the file. For example, when you share a PDF document, you may experience the following screen in the receiving device:

UTIs PDF Apps

Wrap Up

AirDrop is a very cool feature introduced in iOS 7. It offers a great way to share data between devices. Best of all, the built-in UIActivityViewController has made it easy for developers to add AirDrop support in their apps. As you can see from the demo app, it just needs a few lines of code to implement the feature. I highly recommend you to put this sharing feature in your app.

For your complete reference, you can download the full source code of the Xcode project from here.

As always, leave us comment and share your thought about the tutorial. We love to hear your feedback.

Tutorial
The Absolute Guide to Networking in Swift with Alamofire
iOS
Getting Started with Apple’s ResearchKit
SwiftUI
Understanding @FocusState, @FocusedValue and @FocusedObject
  • Harry

    HarryHarry

    Author Reply

    but if I add this feature will it make my app iPhone 5, iPad 4, iPod 5 plus only?


  • Malkit Singh

    good work..thanks for sharing with us.


  • Will Yan

    Will YanWill Yan

    Author Reply

    thanks a lot


  • vikas

    vikasvikas

    Author Reply

    Wow… Thanks for share..!!!


  • Yannick

    YannickYannick

    Author Reply

    Thanks for this tuto!
    And for receive Data?


  • Jeyabalaji

    JeyabalajiJeyabalaji

    Author Reply

    good and simple tutorial.. Thanks..


  • javeedpasha

    very nice tutorial ..
    Could you please provide the info on “How to integrate receiving files via Air drop?”


  • grgmo

    grgmogrgmo

    Author Reply

    Thanks for the tutorial.

    Just one question though, how do I share multiple images like photos app with top view containing images that you can select to share?


  • Guest

    GuestGuest

    Author Reply

    I have iPad 2 with me and I am not able to see any icon except mail…..what I want is I want to share with Google Drive or Box etc…..


  • Jean Chi

    Jean ChiJean Chi

    Author Reply

    I have a question: Is there a way to import this file (which AirDrop to my iPhone) from an APP?


  • Darshan Mothreja

    provide the tutorial to share notes on Dropbox, Facebook and Gmail.
    the tutorial you provide are off easy topics n all ..so please provide something like this which is in demand


  • Renzo Gamero

    is it possible that airdrop open only inside de app.


  • tranhieu

    tranhieutranhieu

    Author Reply

    Hi, thanks for the tutorial.

    So, I have question.

    I want to create 2 UIActivity, with my code is here:

    NSURL *url = [self fileToURL:self.documentName];

    NSArray *objectsToShare = @[url];

    AirDropActivityView *activity123 = [[AirDropActivityView alloc] init];

    activity123.airDropType = 0;

    AirDropActivityView *activity456 = [[AirDropActivityView alloc] init];

    activity456.airDropType = 1;

    NSArray *uiActivitys = @[activity123,activity456];

    UIActivityViewController *controller = [[UIActivityViewController alloc] initWithActivityItems:objectsToShare applicationActivities:uiActivitys];

    // Exclude all activities except AirDrop.

    NSArray *excludedActivities = @[UIActivityTypePostToTwitter, UIActivityTypePostToFacebook,

    UIActivityTypePostToWeibo,

    UIActivityTypeMessage, UIActivityTypeMail,

    UIActivityTypePrint, UIActivityTypeCopyToPasteboard,

    UIActivityTypeAssignToContact, UIActivityTypeSaveToCameraRoll,

    UIActivityTypeAddToReadingList, UIActivityTypePostToFlickr,

    UIActivityTypePostToVimeo, UIActivityTypePostToTencentWeibo];

    controller.excludedActivityTypes = excludedActivities;

    // Present the controller

    [self presentViewController:controller animated:YES completion:nil];

    OK, done, display 2 activity, is (activity123, activity456).

    So, when I click More Button, and then, change order of UIActivity (activity123, activity456).

    Result is, I have lost activity456, only display activity123? Why? Is it bug of iOS system?


  • Rahul

    RahulRahul

    Author Reply

    I have written those excluded types but how to exclude other 3rd party apps such as google drive, drop box , watsapp..Any idea please suggest


  • dhiraj sahani

    Thanks , nice tutorial it helped me .


  • dhiraj sahani

    – (IBAction)button_SaveToCloudAction:(id)sender {

    NSURL *url = [self fileToURL ];

    NSArray *objectsToShare = @[url];

    UIActivityViewController *controller = [[UIActivityViewController alloc] initWithActivityItems:objectsToShare applicationActivities:nil];

    // Exclude all activities except AirDrop.

    NSArray *excludedActivities = @[UIActivityTypePostToTwitter, UIActivityTypePostToFacebook,

    UIActivityTypePostToWeibo,

    UIActivityTypeMessage, UIActivityTypeMail,

    UIActivityTypePrint, UIActivityTypeCopyToPasteboard,

    UIActivityTypeAssignToContact, UIActivityTypeSaveToCameraRoll,

    UIActivityTypeAddToReadingList, UIActivityTypePostToFlickr,

    UIActivityTypePostToVimeo, UIActivityTypePostToTencentWeibo];

    controller.excludedActivityTypes = excludedActivities;

    // Present the controller

    [self presentViewController:controller animated:YES completion:nil];

    }

    – (NSURL *) fileToURL

    {

    NSData *pngData = UIImagePNGRepresentation(self.image_SourceView.image);

    NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);

    NSString *documentsPath = [paths objectAtIndex:0]; //Get the docs directory

    NSString *filePath = [documentsPath stringByAppendingPathComponent:[NSString stringWithFormat:@”%@.png”,self.textField_DocumentName.text]]; //Add the file name

    [pngData writeToFile:filePath atomically:YES];

    return [NSURL fileURLWithPath:filePath];

    }

    using this code you can save image with custom name to iCloud ..


Leave a Reply to vikas
Cancel Reply

Shares