iOS - SharePanel [ ShareLink & UIActivityViewController ]

[Phangg]

iOS 의 SharePanel ?

SwiftUI - ShareLink

UIKit - UIActivityViewController

[Phangg]

iOS - SharePanel

앱에서 보통 이런 공유를 위한 시트를 SharePanel 이라고 표현 ( ShareSheet ) 그렇다면 iOS 에서는 어떻게 저 기능을 사용할 수 있을까? UI 를 담당하는 2가지의 프레임워크에서 각각 알아보자

---

SwiftUI - ShareLink

• SwiftUI 4.0, iOS 16 부터 지원하고 있는 기능
• SharePanel ( ShareSheet ) 를 컨트롤

• 위 코드와 주석처럼 ShareLink 에서 공유할 아이템(item), 아이템에 이름(subject)과 설명(message), 미리보기 이미지 등(preview)을 설정할 수 있음

• 또한, 아이템에는 타입이 정해져있지 않음을 알 수 있음 ( 공식문서 참고 )

  이때, 만약 커스텀한 타입을 공유하려고 한다면? Transferable프로토콜을 채택하고 있어야 함 ( 전달 가능한 객체 ) URL을 비롯한 기본적인 타입을 보면 Transferable프로토콜을 채택하고 있음

• 마지막으로 ShareLink 를 사용하는 코드 예시

  ToolbarItem(placement: .topBarTrailing) {
  // 공유하기
  ShareLink(item: "\(user.userName)님의 게시글",    // 실제는 글의 딥링크를 공유해야하지만 예시에서 텍스트만 공유
            subject: Text("\(post.title)"),
            message: Text("\(AppLocalized.AppName) 에서 게시글을 공유했어요!"),
            // 미리보기
            preview: SharePreview(
              Text("\(user.userName)님의 게시글"),
              image: Image(ViewValues.AppIcon))
  ) {
      Image(systemName: "square.and.arrow.up")
  }
  }

  
  

---

UIKit - UIActivityViewController

• iOS 6 부터 지원되고 있는 기능

• SharePanel ( ShareSheet ) 를 컨트롤

• 공식문서를 보면 기본적인 타입들 혹은 UIActivityItemSource 프로토콜을 따르는 아이템을 공유가능 한 것을 알 수 있음

  SwiftUI 에서 Transferable 을 채택한 아이템 처럼, UIKit 에서는 UIActivityItemSource 를 채택해야 함

• 내가 사용했던 UIActivityViewController 코드 예시

  SwiftUI + TCA 코드

  
  // MARK: - ActivityView ( SharePanel )
  // UIKit 의 UIActivityViewController 를 SwiftUI 에 이식하기 위함
  struct ActivityView: UIViewControllerRepresentable {
  @Bindable var store: StoreOf<SettingViewFeature>

  func makeUIViewController( context: Context ) -> UIViewController { UIViewController() }

  func updateUIViewController( uiViewController: UIViewController, context: Context ) { // store 는 TCA 의 리듀서 // var activityItem: ActivityItem? 이렇게 변수를 가지고 있음 let activityViewController = UIActivityViewController( activityItems: store.activityItem?.items ?? [], applicationActivities: store.activityItem?.activities) if store.isActivityViewPresented, uiViewController.presentedViewController == nil { uiViewController.present(activityViewController, animated: true) } activityViewController.completionWithItemsHandler = { (, , , _) in store.send(.closeActivityView) } } }

// MARK: - ActivityItem // UIActivityViewController 의 activityItems 에 들어갈 구조체 타입 생성 struct ActivityItem: Equatable { var items: [ActivityItemSource] // Any 가 아닌, ActivityItemSource 타입을 사용 var activities: [UIActivity]? var excludedTypes: [UIActivity.ActivityType]

static func == (lhs: ActivityItem, rhs: ActivityItem) -> Bool {
    lhs.activities == rhs.activities
}

// items: `UIActivityViewController` 를 통해 공유할 아이템
// activities: 시트에 포함시키고자 하는 커스텀 `UIActivity`
init(
    items: [ActivityItemSource],
    activities: [UIActivity]? = nil,
    excludedTypes: [UIActivity.ActivityType] = []
) {
    self.items = items
    self.activities = activities
    self.excludedTypes = excludedTypes
}

}

```swift
// MARK: - Custom 된 ActivityItemSource
// 아이템 타입 커스텀 - UIActivityItemSource 채택
final class ActivityItemSource: NSObject, UIActivityItemSource {
    private let url: URL

    init(url: URL) {
        self.url = url
        super.init()
    }

    func activityViewControllerPlaceholderItem(
        _ activityViewController: UIActivityViewController
    ) -> Any {
        return url
    }

    func activityViewController(
        _ activityViewController: UIActivityViewController,
        itemForActivityType activityType: UIActivity.ActivityType?
    ) -> Any? {
        return url
    }

    func activityViewController(
        _ activityViewController: UIActivityViewController,
        subjectForActivityType activityType: UIActivity.ActivityType?
    ) -> String {
        return AppLocalized.fileDescription
    }

    func activityViewController(
        _ activityViewController: UIActivityViewController,
        thumbnailImageForActivityType activityType: UIActivity.ActivityType?,
        suggestedSize size: CGSize
    ) -> UIImage? {
        return UIImage(named: AppLocalized.appIcon) ?? UIImage()
    }

    func activityViewControllerLinkMetadata(
        _ activityViewController: UIActivityViewController)
    -> LPLinkMetadata? {
        let metadata = LPLinkMetadata()
        metadata.iconProvider = NSItemProvider(
            object: UIImage(named: AppLocalized.appIcon) ?? UIImage())
        metadata.title = url.lastPathComponent
        let size = url.formattedFileSize()
        let type = AppLocalized.fileDescription
        let subtitleString = "\(type) \(size)"
        metadata.originalURL = URL(fileURLWithPath: subtitleString)
        return metadata
    }
}

참고자료

ShareLink - 그린 블로그 ShareLink - appcoda 글 UIActivityViewController - 공식문서 UIActivityViewController / UIActivityItemSource - 공식문서 UIActivityViewController - ActivityType 관련 UIActivityViewController - medium 블로그 UIActivityViewController - 위 medium 블로그 GitHub 코드 UIActivityViewController / Metadata - 블로그