[swift] SwiftMessages의 소스 코드 분석

20 Nov 2023

swift

SwiftMessages는 iOS 앱에서 사용자에게 메시지를 표시하는 데 사용되는 강력한 라이브러리입니다. 이 라이브러리는 다양한 종류의 메시지를 표시할 수 있으며, 알림, 경고, 에러 등의 메시지를 매우 쉽게 구현할 수 있습니다.

이번 포스트에서는 SwiftMessages의 소스 코드를 분석해보겠습니다. SwiftMessages의 소스 코드는 GitHub 저장소에서 확인할 수 있습니다. 해당 저장소를 클론하고 소스 코드를 열어봅시다.

1. 구조 분석

SwiftMessages는 몇 가지 핵심 클래스와 구조로 이루어져 있습니다. 주요 클래스는 다음과 같습니다:

MessageView: 메시지를 표시하는 데 사용되는 뷰 클래스입니다. 이 클래스에서는 메시지의 모양, 배경색, 텍스트 등을 설정할 수 있습니다.
SwiftMessages: 메시지를 생성하고 표시하는 데 사용되는 싱글톤 클래스입니다. 이 클래스는 메시지를 화면에 표시하거나 숨기는 메소드 등을 제공합니다.
Config: 메시지의 기본 설정을 담당하는 클래스입니다. 이 클래스에서는 애니메이션 스타일, 디스플레이 타입 등을 설정할 수 있습니다.

그 외에도 PresentationStyle, PresentationContext, Message, MessagePresenter 등의 클래스가 있으며, 이들은 각각 메시지의 표시 스타일, 화면 표시 위치, 실제 메시지 내용 등을 관리합니다.

2. 메시지 표시하기

SwiftMessages를 사용하여 메시지를 표시하는 것은 매우 간단합니다. 다음 코드를 참고해봅시다:

let successMessage = Message(
    view: MessageView.successMessageView(),
    layout: .cardView,
    theme: .success,
    title: "Success",
    body: "Operation was successful."
)

SwiftMessages.show(message: successMessage)

위의 코드는 “Success”라는 제목과 “Operation was successful.”라는 내용을 가진 성공 메시지를 생성하고 화면에 표시하는 예시입니다. MessageView.successMessageView()는 성공 메시지를 표시하기 위한 기본 뷰를 반환하는 유틸리티 메소드입니다.

3. 메시지 숨기기

메시지를 숨기기 위해서는 다음과 같은 코드를 사용할 수 있습니다:

SwiftMessages.hide()

위의 코드는 현재 화면에 표시된 메시지를 숨깁니다.

4. 커스텀 메시지 뷰 만들기

SwiftMessages에서는 커스텀 메시지 뷰를 만들 수 있습니다. 커스텀 메시지 뷰를 생성하기 위해서는 MessageView 클래스를 상속받아 필요한 메시지 뷰를 구현해야 합니다. 예를 들어, 다음과 같이 사용자 정의 메시지 뷰를 만들 수 있습니다:

class CustomMessageView: MessageView {
    // 필요한 UI 요소들을 선언합니다.
    let titleLabel = UILabel()
    let bodyLabel = UILabel()

    override init(frame: CGRect) {
        super.init(frame: frame)

        // UI 요소들의 속성을 설정하고, 뷰에 추가하는 코드를 작성합니다.
        titleLabel.font = UIFont.boldSystemFont(ofSize: 16)
        titleLabel.textColor = .white
        addSubview(titleLabel)

        bodyLabel.font = UIFont.systemFont(ofSize: 14)
        bodyLabel.textColor = .white
        addSubview(bodyLabel)

        // 뷰의 레이아웃을 설정하는 코드를 작성합니다.
        titleLabel.translatesAutoresizingMaskIntoConstraints = false
        bodyLabel.translatesAutoresizingMaskIntoConstraints = false

        NSLayoutConstraint.activate([
            titleLabel.topAnchor.constraint(equalTo: topAnchor, constant: 8),
            titleLabel.leadingAnchor.constraint(equalTo: leadingAnchor, constant: 8),
            titleLabel.trailingAnchor.constraint(equalTo: trailingAnchor, constant: -8),

            bodyLabel.topAnchor.constraint(equalTo: titleLabel.bottomAnchor, constant: 4),
            bodyLabel.leadingAnchor.constraint(equalTo: leadingAnchor, constant: 8),
            bodyLabel.trailingAnchor.constraint(equalTo: trailingAnchor, constant: -8),
            bodyLabel.bottomAnchor.constraint(equalTo: bottomAnchor, constant: -8)
        ])
    }

    // 메시지의 내용을 업데이트하는 메소드를 오버라이드합니다.
    override func configureContent(title: String?, body: String?) {
        titleLabel.text = title
        bodyLabel.text = body
    }
}

위의 코드는 커스텀 메시지 뷰를 구현하는 예시입니다. configureContent(title:body:) 메소드를 오버라이드하여 메시지의 내용을 업데이트할 수 있습니다.

결론

이번 포스트에서는 SwiftMessages의 소스 코드를 분석하고, 메시지를 표시하고 숨기는 방법, 커스텀 메시지 뷰를 만드는 방법 등을 살펴보았습니다. SwiftMessages는 간편하게 사용할 수 있는 메시지 표시 라이브러리로, iOS 앱에서 다양한 유형의 메시지를 사용자에게 효과적으로 전달하는 데 도움이 됩니다.

참고 자료

GitHub 저장소