본질의 중요성

iOS 접근성 개발 참고 자료

you90100 — Wed, 25 Aug 2021 15:26:57 +0900

Accessibility for UIKit

접근성 관련해서 잘 지원해주는 플랫폼 중 하나는 애플이다. 아래는 애플의 접근성 관련 설명 페이지

https://developer.apple.com/documentation/uikit/accessibility_for_uikit

Supporting VoiceOver in Your App

여러 접근성 중 보이스오버가 가장 많이 적용하는 것 중 하나일 것이다. 아래 페이지는 애플 가이드 페이지

https://developer.apple.com/documentation/uikit/accessibility_for_ios_and_tvos/supporting_voiceover_in_your_app

The accessibilityLabel property provides descriptive text that VoiceOver reads when the user selects an element.
The accessibilityHint property provides additional context (or actions) for the selected element.

Accessibility for iOS Developer Guide

iOS 접근성 관련해서 정말 잘 설명되어있는 가이드 페이지!

https://a11y-guidelines.orange.com/en/mobile/ios/development/

iOS developer guide - Orange digital accessibility guidelines

VoiceOver must vocalize every informative element with a high degree of quality in order to let the user know and perfectly understand the context of the consulted page. The accuracy of this vocalization is done through four attributes: label, hint, value

a11y-guidelines.orange.com

Raywenderlich의 Accessibility 가이드 페이지

https://www.raywenderlich.com/6827616-ios-accessibility-getting-started

iOS Accessibility: Getting Started

In this iOS accessibility tutorial, learn how to make apps more accessible using VoiceOver and the Accessibility inspector.

www.raywenderlich.com

https://www.raywenderlich.com/4720178-ios-accessibility-tutorial-making-custom-controls-accessible

iOS Accessibility Tutorial: Making Custom Controls Accessible

In this iOS accessibility tutorial, you’ll learn to make custom controls accessible using VoiceOver, elements group, custom action, traits, frame and more.

www.raywenderlich.com

시뮬레이터에서 접근성 테스트 방법

XCode > Open Developer Tool > Accessibility Insepector

실용주의 프로그래머 책을 시작하며 ... + 서문

you90100 — Tue, 10 Aug 2021 23:39:55 +0900

연차가 쌓일수록 나에게 멘토가 필요했다.
그 멘토를 찾는 과정에서 발견한 이 책.

이 책의 부제는 '숙련공에서 마스터로' 이다.
숙련공이 마스터가 되는 것은 단순한 기계적 학습이 아닌, 지혜가 필요하다.
마스터로부터 그런 통찰과 직관, 지혜를 배울 수 있는 책.

이 책을 정독하고, 블로그에 내용을 정리할 예정이다.

실용주의란?

어떤 특정 기술에 매이면 안 되며, 개별 상황마다 그 상황에서 좋은 해결방안을 고를 수 있도록 충분한 배경지식과 경험을 가지는 것.
배경지식은 컴퓨터 과학의 기본 원리들을 이해하는 것이서 나오고, 경험은 다양한 범위의 실제 프로젝트들을 수행해보는 것에서 나온다.
이론과 실천의 결합은 우리를 강하게 만든다.

무엇이 실용주의 프로그래머를 만드는가?

얼리어덥터 성향 / 새로운 것에 빨리 적응하는 성향
캐묻기 좋아한다.
비판적인 사고의 소유자
현실적이다.
다방면의 기술에 익숙하다.

실용주의 프로그래머 Tip

이 책은 실용주의 프로그래머가 되기 위한 많은 팁을 제공한다. 그중에 이 장에서는 두가지 ...

자신의 기술(craft)에 관심과 애정을 가져라.
자신의 일에 대해 생각하면서 일하라!
- 모든 개발 과정에서, 매일, 우리가 내리는 모든 결정을 지속적이고 비판적으로 평가해보는 것.
- 절대 기계적으로 일하지 말라. 언제나 생각하고, 언제나 일하면서, 동시에 자신의 일을 비평하고 분석하라.
- 오래된 IBM의 표어인 생각하라!(THINK!) 가 실용주의 프로그래머의 주문(mantra)이다.

이것은 끊임없이 지속되는 과정

매일 같이 지금 있는 기술들을 더 다듬고, 우리 기술 목록에 새로운 도구들을 추가하라.
몇 년이 지나면 얼마나 우리의 경험이 무르익고 기술이 자랐는지 우리 스스로 놀랄 것이다.

Reference.
The Pragmatic Programmer: From Journeyman to Master by Andrew Hunt, David Thomas

[iOS] UNUserNotificationCenter, Push Notification 권한 요청 방법

you90100 — Tue, 6 Jul 2021 16:01:55 +0900

UNUserNotificationCenter란?

앱과 앱 익스텐션에 대한 알림 관련 작업을 관리하기 위한 센트럴 오브젝트.
공유된 UNUserNotificationCenter 객체를 사용하여 앱과 앱 확장의 모든 알림 관련 동작을 관리한다.

Push Notification 사용 권한 요청

알림에 응답하여 알럿을 표시하거나, 소리를 재생하거나, 앱 아이콘에 배지를 달 수 있는 권한을 요청하는 방법에 대해 알아보자.

1. UNUserNotificationCenterDelegate 채택

알림 관련 작업을 처리하려면 UNUserNotificationCenterDelegate 프로토콜을 채택하는 객체를 생성하여 이 객체의 델리게이트 프로퍼티에 할당한다. 이 작업은 해당 델리게이트와 상호작용을 할 수 있는 다른 작업을 수행 하기 전에 이 델리게이트 프로퍼티에 객체를 항상 할당하자.

class AppDelegate: UIResponder, UIApplicationDelegate, UNUserNotificationCenterDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        UNUserNotificationCenter.current().delegate = self
        return true
    }
}

2. Notification 권한 부여 요청

승인을 요청하려면, UNUserNotificationCenter 인스턴스를 가져와서 requestAuthorization(options:completionHandler:) 을 호출하자. (alert, sound, badge 타입 요청 가능)

let center = UNUserNotificationCenter.current()
center.requestAuthorization(options: [.alert, .sound, .badge]) { granted, error in
    
    if let error = error {
        // Handle the error here.
    }
    
    // Enable or disable features based on the authorization.
}

3. APNS(Apple Push Notification Service)에 원격 알림을 수신하도록 등록

Apple Push Notification Service에 등록 프로세스를 시작하려면 아래 메소드를 호출하자. (Main Thread에서 진행해야함.)

DispatchQueue.main.async {
    UIApplication.shared.registerForRemoteNotifications()
}

등록이 성공되었다면, 앱은 앱 델리게이트 객체의 application(_:didRegisterForRemoteNotificationsWithDeviceToken:) 메소드를 호출하여 디바이스 토큰을 전달함. (디바이스의 원격 알림을 생성하기 위해서는 서버에 이 토큰을 전달해야함.)

func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
}

등록이 실패되었다면, 앱은 앱 델리게이트 객체의 application(_:didFailToRegisterForRemoteNotificationsWithError:) 메소드를 호출한다.

func application(_ application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: Error) {
}

Ref.

https://developer.apple.com/documentation/uikit/uiapplication/1623078-registerforremotenotifications

[iOS] iOS 애플리케이션 실행 순서, UIApplicationMain, @main

you90100 — Tue, 6 Jul 2021 00:04:55 +0900

C언어 기반의 프로그래밍 언어에서는 main이라는 함수가 앱의 시작이 된다.
iOS 앱 또한 Objective-C 기반에서 돌아가기 때문에 앱은 main 함수에서 시작된다.

iOS 애플리케이션 실행 순서

main 함수 실행
main 함수에서 UIApplicationMain 함수 실행 (앱의 본체에 해당하는 객체인 UIApplication 객체 생성)
Info.plist 파일을 읽어들여 파일에 기록된 정보를 참고하여 그 외에 필요한 데이터 로드.
(Main nib 파일을 사용하는 경우 이 과정에서 로드됨.)
Main nib 파일이 없거나 그 속에서 앱 델리게이트가 없는 경우, 앱 델리게이트 객체를 만들고 앱 객체와 연결.
런루프를 만드는 등 실행에 필요한 준비를 마무리함.
실행 완료를 앞두고, 앱 객체가 앱 델리게이트에게 application:didFinishLaunchingWithOptions: 메시지를 보냄.

Objective-C 기반 iOS 프로젝트 main.m 파일

UIApplicationMain 함수: 앱 로딩 프로세스

파라미터

principalClassName: 앱 객체가 될 클래스 이름. nil이면 UIApplication으로 대체
appDelegateClassName: 앱 델리게이트 클래스 이름.

기능

앱의 본체에 해당하는 객체인 UIApplication 객체 생성, 이 객체는 앱의 Life Cycle 관리
지정된 클래스(@UIApplicationMain이 표시된)에서 델리게이트를 인스턴스화 하고 이를 앱의 객체에 할당
앱의 Run Loop를 포함한 기본 이벤트처리 루프를 설정하고 이벤트 처리 시작
앱의 info.plist에 불러올 main nib 파일이 명시되어있으면, 해당 nib 파일을 불러옴.

이제 @main에 대해 알아보자.

Swift 기반으로된 iOS 프로젝트는 main 파일이 없다. 그이유는?
@main을 선언하여 iOS 앱의 진입점을 컴파일러가 합성하기 때문.

@main을 선언해줌으로써, UIKit 앱의 진입점은 해당 클래스이고, 시스템은 UIApplicationDelegate 프로토콜에 구현되어있는 정적 main() 함수를 호출함.

(추가) Swift 5.3부터 프로그램의 entry point를 알려주는 속성이 @UIApplicationMain에서 @main으로 변경됨.

Ref.

https://developer.apple.com/documentation/uikit/uiapplicationdelegate/3656306-main

https://barosalki.tistory.com/entry/iOS-Swift-53-main-type기반의-프로그램-진입점

https://soooprmx.com/앱델리게이트-이해하기-ios앱-만들기-01/

https://hcn1519.github.io/articles/2017-09/ios_app_lifeCycle

https://oleb.net/blog/2012/02/app-launch-sequence-ios-revisited/

https://you9010.tistory.com/225

[개념 정리] Functional / Reative 개념은 왜 탄생했을까?

you90100 — Thu, 12 Mar 2020 02:22:39 +0900

아래 내용은 let us: Go! 2017 'Functional Reactive Programming 패러다임' 발표 내용을 정리한 글입니다.

Programming
Paradigm (패러다임)
Functional
1) Immutable
2) Pure function (순수 함수)
3) Generator, Function, Consumer, Composition
4) High-Order function, First Class Citizen
5) Imperative Programming(명령형 프로그래밍) vs Declarative Programming(선언형 프로그래밍)
Reactive

Summary

Functional: (Concurrent 시대에 여러 프로그램이 동시에 돌아가기 위해서 외부에 영향을 주지 않아야 하기 때문에 )
Side-Effect가 없도록 프로그래밍 하는 패러다임
Reative:
Async한 작업을 Functional하게 처리하는 아이디어
RxSwift:
Reactive 아이디어를 구현한 Swift 라이브러리

1. Programming

Input으로 Output을 만드는 것, Output을 만드는 과정을 프로그래밍

2. Paradigm(패러다임)

정의
어떤 한 시대 사람들이 견해나 사고를 근본적으로 규정하고 있는 테두리로서의 인식의 체계, 또는 사물에 대한 이론적인 틀이나 체계를 의미하는 개념 (by 위키백과)

(동시대를 살아가고 있는 사람들이 같은 생각을 가지고 있는 것 - 그 시대를 반영함)

시대	Low Memory	Mass Production	Concurrency
특징	Low Memory Optimized Data : Program = 1 : 1	Medium Memory Resuable Abstract Data	High Memory Performance / Responsibility Concurrency
설명	- 최적화가 목표	- 프로그래밍 대량 생산해야 하는 시대 - 데이터 처리 재사용성을 높이는 방법과 클래스화, 추상화를 하여 재사용성을 높이는 새로운 패러다임이 생김	- 동시에 여러개인 프로그램이 실행되야 하는 시대 : 프로그램이 동시에 여러 인스턴스로 실행됨 - 프로그램이 다른 프로그램의 영향을 주면 안됨 : Performance, 신뢰성 중요

3. Functional

Immutable, Pure function, Composition, High-Order function, first class citizen 등 이와 같은 용어가 왜 생겨나게 되었는지 살펴보자.

1) Immutable

데이터 공유에 대한 문제점을 해결하고자 값을 쓰지 못하게 하는 Immutable 용어 등장
Concurrency 시대에서 데이터를 여러 프로그램(인스턴스)이 동시에 읽고 쓰는 문제가 생김. (Read는 문제가 없지만 Write에 문제가 있음)
- 전 시대에는 synchronize를 걸고, 세마포어나 뮤텍스를 사용하여 동기화를 맞추는 방법으로 해결함
- 요즘 modern language들은 못쓰는 변수 제공 : "Immutable" (ex. Swift Langauge의 let)

2) Pure function (순수 함수)

Pure function(순수 함수): 외부 변수를 사용하지 않고 파라미터로 값을 만들고 새로운 값을 리턴하는 함수
배경: Concurrency 시대에 값을 공유함으로써 Side-Effect가 생김 (외부 변수에 문제가 생기기 때문에 Side-Effect라고 부름)
결론: 순수함수를 사용하자. (high memory 시대니까 메모리는 걱정 없으니까 side-effect를 줄이기 위해서)

3) Generator, Function, Consumer, Composition

함수 종류의 용어 정리
- Generator: Output만 존재하는 함수
- Function: Input, Output이 존재하는 함수
- Consumer: Input만 존재하는 함수
- (Ref. Submodule, Action: Input, Output이 없는 함수)
Composition (함수의 합성) : 함수와 함수를 섞어서 사용하는 것을 뜻함.

4) High-Order function, First Class Citizen

High-Order function (고차 함수):
함수가 파라미터로 전달되는 될 때, 함수 안에서 함수가 사용되는 것이 2개면 2차 함수, 3개면 3차함수, 여러개면 고차함수.
First Class Citizen (일급 개체):
변수에 담거나 리턴값으로 사용할 수 있거나, Array에 담을 수 있는 것을 일급 개체라고 함.
Funtional Language: Function 자체를 일급 개체화 할 수 있는 언어
Swift는 Multi-Paradigm Language : Function, Protocol, Struct를 일급개체화 할 수 있으므로.
(Ref. 자바는 Object를 일급개체화 하므로 OOP)

5) Imperative Programming(명령형 프로그래밍) vs Declarative Programming(선언형 프로그래밍)

데이터를 정의하고 그것의 변화 과정을 프로그래밍 할 것이냐, 행위를 정의하고 거기에 데이터를 넣을 것이냐의 차이

특별한 기술이 아니고 기존에 있던 방식으로 function 방식으로 프로그래밍을 하면 Functional Programming인 것.
생각의 주체를 데이터에 두느냐 함수에 두드냐 생각의 관점이 옮겨짐 => 패러다임

6) 'Functional' Summary

데이터는 immutable하게 취급하자
데이터 변경이 필요할 때는 새로 만들자
Side-Effect를 없애기 위해서 Pure function을 사용하자
Function들의 Composition과 High-Order Function으로 프로그램을 만들자
Data가 아닌 Process에 집중해서 프로그램을 만들자

4. Reactive

Async job, Expensive job : Callback or Delegate pattern으로 주로 사용
배경: Async한 상황에서 async한 데이터를 어떻게 처리할 것이냐! 로 개념이 나오게 됨.
결론: 스트림을 만들고 거기에 데이터를 흘려보내자,

Reactive 정의

In computing, reactive programming is an asynchronous programming paradigm concerned with data streams and the propagation of change.

Observable은 데이터를 만드는 타입. 데이터가 흘러가는 사이에 Operator를 통해서 데이터를 변형 또는 조작이 이루어짐.

getText에 url을 넣으면 Stream을 리턴하는 것. 통신을 마치고 데이터를 스트림을 통해서 원하는 곳에 전달이 된다.

Reactive Summary

Async한 처리를 Functional하게 처리하자
리턴값은 Stream인 Observable을 반환하자
Stream에 흐르는 Data/Event를 Operator로 처리하자
Stream과 Stream을 연결하자
Data가 아닌 Process에 집중해서 프로그램을 만들자

Ref.

https://iamchiwon.github.io/2017/11/04/frpp/

Functional Reactive Programming Paradigm

let us: Go! 2017 가을 세미나에서 발표한 내용

iamchiwon.github.io

[Git] 커밋 메시지 수정하기 - git rebase

you90100 — Fri, 6 Mar 2020 10:29:04 +0900

예전에 커밋한 메시지를 수정하는 방법을 알아보자

1. 수정을 원하는 커밋이 존재하는 곳까지 HEAD로 부터 지정

git rebase -i HEAD~5

그러면 아래와 같이 편집을 할 수 있는데, 수정을 원하는 커밋에 pick 대신 edit(또는 e)를 써준다!
(커밋 메시지 수정 외의 다른 기능도 있음 - 아래 명령어 참조)

pick cc5605d test1
e 487bd6b test2
e 73bda22 test3
pick 0ce101f test4
pick a2198fc test5

# Rebase bb0d4f2..a2198fc onto bb0d4f2 (5 commands)
#
# Commands:
# p, pick <commit> = use commit
# r, reword <commit> = use commit, but edit the commit message
# e, edit <commit> = use commit, but stop for amending
# s, squash <commit> = use commit, but meld into previous commit
# f, fixup <commit> = like "squash", but discard this commit's log message
# x, exec <command> = run command (the rest of the line) using shell
# b, break = stop here (continue rebase later with 'git rebase --continue')
# d, drop <commit> = remove commit
# l, label <label> = label current HEAD with a name
# t, reset <label> = reset HEAD to a label
# m, merge [-C <commit> | -c <commit>] <label> [# <oneline>]
# .       create a merge commit using the original merge commit's
# .       message (or the oneline, if no original merge commit was
# .       specified). Use -c <commit> to reword the commit message.
#
# These lines can be re-ordered; they are executed from top to bottom.
#
# If you remove a line here THAT COMMIT WILL BE LOST.
#
# However, if you remove everything, the rebase will be aborted.
#
# Note that empty commits are commented out

2. 위 vi를 수정하고 저장하면 edit(또는 e)로 지정한 커밋 메시지로 차례차례 옮겨진다.

아래 명령어를 입력하여 현재 위치에 있는 메시지 수정

git commit -amend

수정이 완료가 되었으면 아래 명령어 입력. 아래 명령어를 입력하면 다음 수정하는 커밋으로 HEAD가 이동된다.

git rebase --continue

수정을 원하는 커밋이 모두 수정 완료되면

Successfully rebased and updated refs/heads/branch_name.

이렇게 나오면 정상적으로 수정 끝!

[Swift 5.2] Subscripts - Apple Documentation

you90100 — Thu, 5 Mar 2020 18:15:47 +0900

Subscript Syntax
Subscript Usage
Type Subscripts

Subscripts

Classes, structures, and enumerations can define subscripts, which are shortcuts for accessing the member elements of a collection, list, or sequence.

(subscript - 컬렉션, 리스트, 시퀀스의 멤버 엘리먼트에 접근하기 위한 shortcut을 제공)

ex) someArray[index], someDictionary[key], ...

1. Subscript Syntax

- subscripts can be read-write or read-only.

subscript(index: Int) -> Int {
    get {
        // Return an appropriate subscript value here.
    }
    set(newValue) {
        // Perform a suitable setting action here.
    }
}

2. Subscript Usage

struct Matrix {
    let rows: Int, columns: Int
    var grid: [Double]
    init(rows: Int, columns: Int) {
        self.rows = rows
        self.columns = columns
        grid = Array(repeating: 0.0, count: rows * columns)
    }
    func indexIsValid(row: Int, column: Int) -> Bool {
        return row >= 0 && row < rows && column >= 0 && column < columns
    }
    subscript(row: Int, column: Int) -> Double {
        get {
            assert(indexIsValid(row: row, column: column), "Index out of range")
            return grid[(row * columns) + column]
        }
        set {
            assert(indexIsValid(row: row, column: column), "Index out of range")
            grid[(row * columns) + column] = newValue
        }
    }
}

3. Type Subscripts

enum Planet: Int {
    case mercury = 1, venus, earth, mars, jupiter, saturn, uranus, neptune
    static subscript(n: Int) -> Planet {
        return Planet(rawValue: n)!
    }
}
let mars = Planet[4]
print(mars)

Ref.

https://docs.swift.org/swift-book/LanguageGuide/Subscripts.html

https://kka7.tistory.com/118?category=919617

[Swift 5.2] Methods - Apple Documentation

you90100 — Thu, 5 Mar 2020 18:08:14 +0900

Methods

Instance Method
Type Method

Class, Structure, Enumeration 모두 생성 가능

1. Instance Method

Modifying Value Types from Within Instance Methods

기본적으로, Value 타입의 property는 인스턴스 메소드 안에서 수정될 수 없음. (여기서말하는 value 타입은 struct, enum)
mutating 키워드 : 메소드에서 property의 수정이 가능하도록 정의하기 위해 추가

struct Point {
    var x = 0.0, y = 0.0
    mutating func moveBy(x deltaX: Double, y deltaY: Double) {
        x += deltaX
        y += deltaY
    }
}
var somePoint = Point(x: 1.0, y: 1.0)
somePoint.moveBy(x: 2.0, y: 3.0)
print("The point is now at (\(somePoint.x), \(somePoint.y))")
// Prints "The point is now at (3.0, 4.0)"

2. Type Method

타입 자체에서 호출되는 메소드
func 키워드 앞에 static 키워드 작성
Objective-C에서는 Class에서만 type-level method를 정의할 수 있었다. Swift에서는 모든 클래스, 구조체, 열거형에서 정의 가능

class SomeClass {
    class func someTypeMethod() {
        // type method implementation goes here
    }
}
SomeClass.someTypeMethod()

struct LevelTracker {
    static var highestUnlockedLevel = 1
    var currentLevel = 1

    static func unlock(_ level: Int) {
        if level > highestUnlockedLevel { highestUnlockedLevel = level }
    }

    static func isUnlocked(_ level: Int) -> Bool {
        return level <= highestUnlockedLevel
    }

    @discardableResult
    mutating func advance(to level: Int) -> Bool {
        if LevelTracker.isUnlocked(level) {
            currentLevel = level
            return true
        } else {
            return false
        }
    }
}

Ref.

https://docs.swift.org/swift-book/LanguageGuide/Methods.html

https://kka7.tistory.com/117?category=919617

[Swift] ExpressibleByStringLiteral, CustomStringConvertible

you90100 — Tue, 18 Feb 2020 17:45:12 +0900

https://developer.apple.com/documentation/swift/expressiblebystringliteral

ExpressibleByStringLiteral - Swift Standard Library | Apple Developer Documentation

Protocol ExpressibleByStringLiteral A type that can be initialized with a string literal. Declarationprotocol ExpressibleByStringLiteral OverviewThe String and StaticString types conform to the ExpressibleByStringLiteral protocol. You can initialize a vari

developer.apple.com

Overview

The String and StaticString types conform to the ExpressibleByStringLiteralprotocol. You can initialize a variable or constant of either of these types using a string literal of any length.

Conforming to ExpressibleByStringLiteral

To add ExpressibleByStringLiteral conformance to your custom type, implement the required initializer.

https://developer.apple.com/documentation/swift/customstringconvertible

CustomStringConvertible - Swift Standard Library | Apple Developer Documentation

developer.apple.com

Overview

Types that conform to the CustomStringConvertible protocol can provide their own representation to be used when converting an instance to a string. The String(describing:) initializer is the preferred way to convert an instance of any type to a string. If the passed instance conforms to CustomStringConvertible, the String(describing:) initializer and the print(_:) function use the instance’s custom description property.

Accessing a type’s description property directly or using CustomStringConvertible as a generic constraint is discouraged.

Conforming to the CustomStringConvertible Protocol

Add CustomStringConvertible conformance to your custom types by defining a description property.

For example, this custom Point struct uses the default representation supplied by the standard library:

Example

enum CompassPoint {
    case north
    case south
	case custom(String)
}

extension CompassPoint: ExpressibleByStringLiteral {
	init(stringLiteral value: String) {
        switch value {
        case "north":
            self = .north
        case "south":
            self = .south
		default:
        	self = .custom(value)
		}
	}
}

extension CompassPoint: CustomStringConvertible {
	public var description: String {
        switch self {
        case .north:
	        return "north"
        case .south:
        	return "south"
        case .custom(let type):
            return type
        }
    }
}

[Swift] ReactorKit 개념과 사용 방법

you90100 — Sun, 9 Feb 2020 04:31:35 +0900

Basic Concept
View
1) 뷰 정의하기
2) bind(reactor:) 이란?
Reactor = ViewModel
1) mutate()
2) reduce()
3) transform()
Advanced
- Global States
- View Comminucation

1. Basic Concept

ReactorKit is a combination of Flux and Reactive Programming.
유저의 액션과 뷰 상태는 observable stream을 통해 각 레이어로 전달됨
이 스트림들은 한방향이다: 뷰는 오직 액션만 방출할 수 있고 리액터는 상태만 방출할 수 있다.

2. View

뷰는 데이터를 보여주는 역할.
뷰는 사용자의 인풋을 액션스트림에 바인딩하고, 뷰 상태를 UI 컴포넌트에 바인딩함.
뷰 레이어에는 비지니스 로직이 없다. 뷰는 단지! 액션 스트림과 상태 스트림을 보여주는 방법을 정의하는 것

1) 뷰 정의하기

뷰를 정의하기 위해서, 존재하는 클래스에 View 프로토콜을 컨펌시키자. 그러면 reactor라는 프로퍼티를 자동으로 가질 수 있다.
이 프로퍼티는 일반적으로 view의 외부에 설정된다. (뷰 외부에서 reator 주입시키는 것이 일반적)

class ProfileViewController: UIViewController, View {
  var disposeBag = DisposeBag()
}

profileViewController.reactor = UserViewReactor() // inject reactor(reactor 주입)

2) bind(reactor:) 란?

=> 뷰와 리엑터 사이의 액션 스트림과 상태 스트림을 바인드하기 위한 메서드
reactor 프로퍼티가 변경되면, bind(reacor:)가 호출된다.

func bind(reactor: ProfileViewReactor) {
  // action (View -> Reactor)
  refreshButton.rx.tap.map { Reactor.Action.refresh }
    .bind(to: reactor.action)
    .disposed(by: self.disposeBag)

  // state (Reactor -> View)
  reactor.state.map { $0.isFollowing }
    .bind(to: followButton.rx.isSelected)
    .disposed(by: self.disposeBag)
}

NOTE
ReatorKit에서 말하는 액션 스트림과 상태 스트림은 아래 Reactor 클래스의 구현부를 보면 알 수 있다.
뷰에 있는 UI 컴포넌트에 rx를 이용하여 해당 Observable을 reactor의 action이 구독한다.
그리고, reactor.state인 Observable을 뷰의 UI 컴포넌트가 구독한다.

이와 같이 단방향으로 액션 스트림과 상태스트림으로 Action과 State 데이터가 이동한다.

3. Reactor = ViewModel

Reactor는 뷰의 상태를 관리하는 UI 독립적인 계층
Reactor의 가장 중요한 역할은 뷰로부터 제어 흐름을 분리하는 것
모든 뷰는 해당 Reacor를 가지고 있으며, 모든 로직을 그 Reactor에 위임한다.
Reactor는 뷰의 의존성이 없기 때문에 테스트하기가 용이하다.

리엑터를 정의하기 위해서는 Reactor 프로토콜을 준수하자!

세개 타입 Action, Mutation, State. + initialState 프로퍼티 필수!

Action은 사용자의 인터렉션, State는 뷰의 상태

class ProfileViewReactor: Reactor {
  // represent user actions (유저 액션을 나타냄)
  enum Action {
    case refreshFollowingStatus(Int)
    case follow(Int)
  }

  // represent state changes (상태 변화를 나타냄)
  enum Mutation {
    case setFollowing(Bool)
  }

  // represents the current view state (현재 뷰 상태를 나타냄)
  struct State {
    var isFollowing: Bool = false
  }

  let initialState: State = State()
}

(중요)

리엑터는 2단계로 액션 스트림을 상태 스트림으로 변경한다: mutate()와 reduce().

1) mutate()

View로부터 Action을 받고, Observable<Mutation>을 생성한다

func mutate(action: Action) -> Observable<Mutation>

비동기 오퍼레이션 또는 API 호출과 같은 모든 사이드 이펙트는 이 메소드 안에서 수행된다

func mutate(action: Action) -> Observable<Mutation> {
  switch action {
  case let .refreshFollowingStatus(userID): // receive an action
    return UserAPI.isFollowing(userID) // create an API stream
      .map { (isFollowing: Bool) -> Mutation in
        return Mutation.setFollowing(isFollowing) // convert to Mutation stream
      }

  case let .follow(userID):
    return UserAPI.follow()
      .map { _ -> Mutation in
        return Mutation.setFollowing(true)
      }
  }
}

2) reduce()

기존 State과 Mutation으로부터 새로운 State를 생성

func reduce(state: State, mutation: Mutation) -> State

이 메소드는 순수함수(pure function)이므로 동기적으로 새로운 State를 리턴해야한다. 이 함수안에서 어떤 side effect들을 수행하지 말자.

func reduce(state: State, mutation: Mutation) -> State {
	var state = state 	// create a copy of the old state
    switch mutation {
    case let .setFollowing(isFollowing):
    	state.isFollowing = isFollowing // manipulate the state, create a new state
        return state	// return the new state
    }
}

3) transform()

transform()은 각 스트림을 변형한다. 세 transform() 함수가 존재한다:

func transform(action: Observable<Action>) -> Observable<Action>
func transform(mutation: Observable<Mutation>) -> Observable<Mutation>
func transform(state: Observable<State>) -> Observable<State>

다른 observable 스트림을 결합하고 변경하려면 이 함수들을 구현하자.

예를들어, transform(mutation:)은 global event stream을 mutation stream에 결합하기 위한 좋은 방법이다. Global state는 아래에서 자세히 살펴보자.

이 메소드는 디버깅을 위한 목적으로 사용될 수 있다.

func transform(action: Observable<Action>) -> Observable<Action> {
  return action.debug("action") // Use RxSwift's debug() operator
}

4. Advanced

Global States

Reactor의 일반적 Action → Mutation → State 흐름에 global state는 없으므로, global state 변경을 위해서 transform(muation:)을 사용해야 한다.
예) 현재 인증된 유저들을 저장하는 global BehaviorSubject가 있다고 가정. 만약 currentUser가 변경되었을 때 Mutation.setUser(User?)를 방출하기를 원한다면 아래와 같이 작성. 그리고 그 mutation은 뷰가 액션을 리엑터에게 보낼 때 각 시간에 방출될 것이다.

var currentUser: BehaviorSubject<User> // global state

func transform(mutation: Observable<Mutation>) -> Observable<Mutation> {
  return Observable.merge(mutation, currentUser.map(Mutation.setUser))
}

View Communication

ReactorKit은 global app state를 정의하고 있지 않으므로, global state를 관리하기 위해서 BehaviorSubject, PublishSubject, reactor를 사용할 수 있다.
여러개의 뷰들을 커뮤니케이션하기 위해서는 callback 클로저나 delegate 패턴을 사용하는 것이 일반적.
ReactorKit은 reactive extension을 사용하는것을 추천한다.
주요 목적은 커스텀한 뷰에 대한 커뮤니케이션을 해결하기 위한 것.

예) ChatViewController는 메시지를 보여주는 뷰컨트롤러. ChatViewController는 MessageInputView를 가지고 있다.

유저가 MessageInputView의 보내기 버튼을 탭하면, 그 텍스트는 ChatViewController에 보내질 것이고, ChatViewController는 리엑터의 액션과 바인드될 것이다. MessageView의 reactor extension의 예이다:

extension Reactive where Base: MessageInputView {
  var sendButtonTap: ControlEvent<String> {
    let source = base.sendButton.rx.tap.withLatestFrom(...)
    return ControlEvent(events: source)
  }
}

ChatViewController에서 messageinputView extension를 아래와 같이 사용하자:

messageInputView.rx.sendButtonTap
  .map(Reactor.Action.send)
  .bind(to: reactor.action)

Ref.

https://github.com/ReactorKit/ReactorKit

본질의 중요성

iOS 접근성 개발 참고 자료

Accessibility for UIKit

Supporting VoiceOver in Your App

Accessibility for iOS Developer Guide

Raywenderlich의 Accessibility 가이드 페이지

시뮬레이터에서 접근성 테스트 방법

실용주의 프로그래머 책을 시작하며 ... + 서문

실용주의란?

무엇이 실용주의 프로그래머를 만드는가?

실용주의 프로그래머 Tip

이것은 끊임없이 지속되는 과정

[iOS] UNUserNotificationCenter, Push Notification 권한 요청 방법

목차

UNUserNotificationCenter란?

Push Notification 사용 권한 요청

1. UNUserNotificationCenterDelegate 채택

2. Notification 권한 부여 요청

3. APNS(Apple Push Notification Service)에 원격 알림을 수신하도록 등록

[iOS] iOS 애플리케이션 실행 순서, UIApplicationMain, @main

iOS 애플리케이션 실행 순서

UIApplicationMain 함수: 앱 로딩 프로세스

파라미터

기능

이제 @main에 대해 알아보자.

[개념 정리] Functional / Reative 개념은 왜 탄생했을까?

Contents

Summary

1. Programming

2. Paradigm(패러다임)

3. Functional

1) Immutable

2) Pure function (순수 함수)

3) Generator, Function, Consumer, Composition

4) High-Order function, First Class Citizen

5) Imperative Programming(명령형 프로그래밍) vs Declarative Programming(선언형 프로그래밍)

6) 'Functional' Summary

4. Reactive

Reactive Summary

[Git] 커밋 메시지 수정하기 - git rebase

[Swift 5.2] Subscripts - Apple Documentation

Subscripts

1. Subscript Syntax

2. Subscript Usage

3. Type Subscripts

[Swift 5.2] Methods - Apple Documentation

Methods

1. Instance Method

2. Type Method

[Swift] ExpressibleByStringLiteral, CustomStringConvertible

Overview

Conforming to ExpressibleByStringLiteral

Overview

Conforming to the CustomStringConvertible Protocol

Example

[Swift] ReactorKit 개념과 사용 방법

1. Basic Concept

2. View

1) 뷰 정의하기

2) bind(reactor:) 란?

3. Reactor = ViewModel

1) mutate()

2) reduce()

3) transform()

4. Advanced

Global States

View Communication