Fundamental Implementation and Advanced Applications of UIActivityViewController for Text and Image Sharing in Swift

Core Concepts and Implementation Principles of UIActivityViewController

In iOS app development, implementing content sharing functionality is crucial for enhancing user experience. UIActivityViewController, as a core sharing component in the UIKit framework, provides developers with a system-level sharing interface that supports various data types including text, images, and URLs. Compared to alternatives like UIDocumentInteractionController, UIActivityViewController offers advantages of easy integration and unified interface, automatically adapting to system-built and third-party applications such as Mail, social media, and AirDrop.

Basic Text Sharing Implementation

The following refactored Swift code demonstrates how to implement basic text sharing functionality through UIActivityViewController. The code clearly separates data preparation, controller configuration, and interface presentation into three distinct steps, enhancing readability and maintainability:

import UIKit

class ShareViewController: UIViewController {
    
    @IBAction func handleTextSharing(_ sender: UIButton) {
        let sharedText = "This is an example text content ready for sharing."
        let activityItems = [sharedText]
        
        let activityController = UIActivityViewController(
            activityItems: activityItems, 
            applicationActivities: nil
        )
        
        // Configure iPad compatibility
        if let popoverController = activityController.popoverPresentationController {
            popoverController.sourceView = self.view
            popoverController.sourceRect = sender.frame
        }
        
        // Exclude specific activity types
        activityController.excludedActivityTypes = [
            .addToReadingList,
            .assignToContact
        ]
        
        self.present(activityController, animated: true)
    }
}

Key implementation details analysis: The activityItems parameter accepts an array of any objects conforming to sharing protocols, with text strings automatically converted to String type for processing. For iPad devices, setting the source view of popoverPresentationController is mandatory to prevent runtime crashes. The excludedActivityTypes property allows developers to hide specific system sharing options based on application requirements.

Image Sharing and Resource Management

The implementation logic for image sharing is fundamentally similar to text sharing, but requires special attention to image resource loading and memory management:

@IBAction func handleImageSharing(_ sender: UIButton) {
    guard let shareImage = UIImage(named: "example_asset") else {
        print("Failed to load image resource")
        return
    }
    
    let activityItems = [shareImage]
    let activityController = UIActivityViewController(
        activityItems: activityItems, 
        applicationActivities: nil
    )
    
    activityController.popoverPresentationController?.sourceView = self.view
    self.present(activityController, animated: true)
}

In practical development, it's recommended to safely unwrap the return value of UIImage(named:) to avoid unexpected crashes due to missing resources. When sharing images, the system automatically provides a "Save to Photos" option, but requires the application to pre-configure NSPhotoLibraryAddUsageDescription permission description in Info.plist, otherwise user actions will trigger permission errors.

Multi-type Content Hybrid Sharing

UIActivityViewController supports passing multiple types of content objects within the same sharing session:

@IBAction func handleMultiTypeSharing(_ sender: UIButton) {
    let textContent = "Exploring content sharing mechanisms in iOS development"
    let imageContent = UIImage(named: "demo_image")!
    let urlContent = URL(string: "https://developer.apple.com/documentation/uikit/uiactivityviewcontroller")!
    
    let activityItems: [Any] = [textContent, imageContent, urlContent]
    let activityController = UIActivityViewController(
        activityItems: activityItems, 
        applicationActivities: nil
    )
    
    activityController.popoverPresentationController?.sourceView = self.view
    self.present(activityController, animated: true)
}

During hybrid sharing, different target applications selectively process supported content types. For example, social media applications might prioritize displaying URL preview information, while email clients integrate all content into the email body.

Custom Sharing Content and Platform Adaptation

By implementing the UIActivityItemSource protocol, developers can achieve fine-grained control over shared content:

class CustomShareItemProvider: NSObject, UIActivityItemSource {
    
    func activityViewControllerPlaceholderItem(_ activityViewController: UIActivityViewController) -> Any {
        return ""
    }
    
    func activityViewController(_ activityViewController: UIActivityViewController, 
                               itemForActivityType activityType: UIActivity.ActivityType?) -> Any? {
        guard let type = activityType else { return "Default sharing content" }
        
        switch type {
        case .postToTwitter:
            return "#iOSDev detailed explanation of sharing functionality @example_handle"
        case .mail:
            return "Email-exclusive sharing content"
        default:
            return "Universal sharing content"
        }
    }
    
    func activityViewController(_ activityViewController: UIActivityViewController, 
                               subjectForActivityType activityType: UIActivity.ActivityType?) -> String {
        return "Custom sharing subject"
    }
}

// Using custom share provider
let customProvider = CustomShareItemProvider()
let activityController = UIActivityViewController(
    activityItems: [customProvider], 
    applicationActivities: nil
)

This implementation approach is particularly suitable for scenarios requiring content format adjustments based on different sharing targets, such as adding hashtags for Twitter or setting exclusive subjects for emails. The activityViewControllerPlaceholderItem method provides type placeholder, while itemForActivityType allows returning differentiated content based on specific sharing targets.

Practical Considerations and Best Practices

When using UIActivityViewController in actual projects, several key points require attention: First, ensure all UI operations are executed on the main thread to avoid interface lag or crashes. Second, for image sharing, consider using UIImageJPEGRepresentation or UIImagePNGRepresentation to handle large images and prevent memory spikes. Additionally, the completionWithItemsHandler</property> can be used to obtain callback information about user actions for data statistics or subsequent processing.