[ iOS ] 공유하기 기능 구현 - UIActivityViewController

 

 

 

목차

1. UIActivityViewController 생성하기
2. excludedActivityTypes를 사용해 필요없는 앱 제거
3. completionWithItemsHandler 처리하기
4. UIActivityViewController의 또 다른 Instance Property: allowsProminentActivity

 

 

 

 

---

 

 

 

 

 

 

Apple에서 기본적으로 제공하는 '공유하기' 기능이 있다. 메일, 메모장, 클립보드 복사 등을 사용할 수도 있고, 카톡, 트위터, 페이스북 등 타 앱에서 공유기능을 지원한다면 개발자가 따로 구현할 필요없이 자신의 앱에서 타 앱으로 데이터 공유가 가능하다.

 

'공유하기'는 UIActivityViewController 클래스를 통해 구현할 수 있다. UIAvtivityViewController는 UIViewController를 상속받기 때문에 우리가 항상 해오던 것처럼 Present하고 Dismiss하며 사용할 수 있다.

UIActivityViewController 읽기

 

 

 

UIActivityViewController 생성하기

UIActivityController 객체를 생성하기 위해서는 아래와 같이 activityItems와 applicationActivities 파라미터가 필요하다.

 

activityItems은 공유할 데이터를 할당할 파라미터로, 간단히 실제 데이터를 넣어도 되고  UIActivityItemSource 프로토콜을 준수한 클래스를 만들어 공유할 데이터 객체를 커스텀할 수도 있다. 여기서는 실제 데이터를 넣어 공유하는 방법만 예시로 들고 다음 게시글에서 UIActivityItemSource 프로토콜을 사용한 방법을 정리할 예정이다.

activityItems '구글'

 

 

 

 

applicationActivities 는 커스텀 서비스를 표시하는 UIActivity  객체 배열로, 아직 실습해보지는 않았지만 '공유하기' 하단에 위치한 '동작'을 추가하는 용도로 사용한다.

예) 링크를 연결해 버튼 클릭 시 바로 사파리로 연결되게 끔 하는 기능을 구현하는데 사용할 수 있다고 한다.

applicationActivities 'Safari로 열기'

 

 

 

UIActivityViewController는 아래와 같이 객체를 생성해줄 수 있다.

let title: String = "구글"
let activityItems: [Any] = [title]

let activityViewController = UIActivityViewController(
    activityItems: activityItems,
    applicationActivities: nil
    )

init(activityItems:applicationActivities:) 읽기

 

 

 

 

 

excludedActivityTypes를 사용해 필요없는 앱 제거

iOS에서 공유하기 화면을 Present했을 때 기본적으로 떠 있는 여러 앱들이 있다. 하지만 이 중 데이터를 공유하기에 적합하지 않다고 생각되는 앱이 있을 수도 있다. 그럴 때에는 excludedActivityTypes 프로퍼티를 사용해 제외할 앱들을 설정해줄 수 있다. 제외할 수 있는 요소들은 메일, 메세지, airDrop, 트위터, 페이스북 등이 있으며 activityType 에서 확인할 수 있다.

 

activityViewController.excludedActivityTypes = [ .message, .airDrop ]

 

excludedActivityTypes 읽기

 

 

 

completionWithItemsHandler 처리하기

'공유하기' 화면을 dismiss하거나 데이터에 대한 동작을 완료한 후 실행되는 Handler이다. 이 Handler의 매개변수로는 선택된 activity를 알 수 있는 activityType, 동작 성공 여부를 알 수 있는 completed, 변경 사항을 전달하는 returnItems, 동작에 실패했을 시 발생한 오류를 전달하는 error 가 있다. 

각 매개변수에 자세한 설명은 UIActivityViewController.completionWithItemsHandler 읽기 를 통해 확인할 수 있다.

activityViewController.completionWithItemsHandler = {(activity, isSuccess, returnedItems, error) in
    if isSuccess {
        print("Success, 사용된 서비스 명: \(String(describing: activity))")
    } else {
        print("Fail, 발생한 오류: \(error?.localizedDescription)")
    }
}

 

 

 

 

UIActivityViewController의 또 다른 Instance Property

 

allowsProminentActivity

UIActvityViewController에는 위에서 정리한 것들 외에 프로퍼티가 하나 더 존재한다. 공식 문서에는 따로 설명이 기재되어 있지 않지만 Xcode에서 'Jump to Definition'을 통해 간략한 설명을 볼 수 있다. 

 

// 일부 상황에서, 특정 activity를 향상시키기 위해 activity view controller는 헤더 view에서 특정 activity를 상승시킬 수 있다.
// 헤더 view로 올려져 눈에 띄는 activity는 오직 시스템에 의해서만 선택될 수 있다.
// 기본 값은 true이다.

 

하지만 이 프로퍼티의 값을 변경시켜 보아도 시각적으로 보이는 변화가 없어 정확히 어떤 역할을 수행하는지 아직 잘 모르겠다. 설명을 바탕으로 추측해보자면 특정 앱 또는 동작을 자동으로 앞 쪽에 위치시키는 기능이 아닐까 싶은데, 순서는 Edit이 가능하니 아닌 것 같기도 하다. 추후에 다시 한 번 알아봐야겠다. 

 

/// In some contexts, the activity view controller can elevate a specific activity in the header view to enhance it.
/// The prominent activity can only be chosen by the system.
/// Defaults to YES.

@available(iOS 15.4, *)
open var allowsProminentActivity: Bool