wongbingg/ios-project-manager

프로젝트 관리 앱 저장소입니다.

📁 Project Manager

tags: README

개요

할 일 목록을 TODO, DOING, DONE 세 가지 카테고리로 나누어 유연하게 관리해주는 앱.

기술스택

Dependency	UI	Design Pattern
Realm, FireBase, SwiftLint	UIKit	MVVM + Coordinator, BuilderPattern

File Tree

.
├── ProjectManager
│   ├── swiftlint
│   ├── ProjectManager
│   │   ├── Utility
│   │   │   ├── Observable
│   │   │   ├── NetworkCheck
│   │   │   └── Builder
│   │   │       ├── Protocols
│   │   │       ├── LabelBuilder
│   │   │       ├── StackViewBuilder
│   │   │       ├── TextViewBuilder
│   │   │       ├── TextFieldBuilder
│   │   │       └── DatePickerBuilder
│   │   ├── Protocol
│   │   │   └── Coordinator
│   │   ├── Extensions
│   │   │   ├── UITextField+Extension
│   │   │   └── TimeInterval+Extension
│   │   ├── Application
│   │   │   ├── AppDelegate
│   │   │   ├── AppAppearance
│   │   │   └── AppCoordinator
│   │   ├── MainScene
│   │   │   ├── Coordinator
│   │   │   │   └── TodoListCoordinator
│   │   │   ├── ViewModel
│   │   │   │   ├── HeaderViewModel
│   │   │   │   ├── ListCollectionViewModel
│   │   │   │   └── ListCellViewModel
│   │   │   └── View
│   │   │       ├── TodoListViewController
│   │   │       └── ListView
│   │   │           ├── Header
│   │   │           │   └── HeaderView
│   │   │           └── CollectionView
│   │   │               ├── ListCollectionView
│   │   │               ├──ListCollectionView+UIGestureRecognizerDelegate
│   │   │               └── Cell
│   │   │                   └── ListCell
│   │   ├── FormSheetScene
│   │   │   ├── Coordinator
│   │   │   │   └── FormSheetViewCoordinator
│   │   │   ├── ViewModel
│   │   │   │   └── FormSheetViewModel
│   │   │   └── View
│   │   │       ├── FormSheetViewController
│   │   │       └── Template
│   │   │           └── FormSheetTemplateView
│   │   ├── HistoryScene
│   │   │   ├── Coordinator
│   │   │   │   └── HistoryViewCoordinator
│   │   │   ├── ViewModel
│   │   │   │   └── HistoryViewModel
│   │   │   └── View
│   │   │       ├── HistoryViewController
│   │   │       └── HistoryCell
│   │   ├── PopoverScene
│   │   │   ├── Coordinator
│   │   │   │   └── PopoverViewCoordinator
│   │   │   ├── ViewModel
│   │   │   │   └── PopoverViewModel
│   │   │   └── View
│   │   │       └── PopoverViewController
│   │   ├── Model
│   │   │   ├── History
│   │   │   ├── Todo
│   │   │   ├── TodoModel
│   │   │   └── Category
│   │   ├── DataManager
│   │   │   ├── TodoDataManager
│   │   │   ├── LocalDataManager
│   │   │   ├── RemoteDataManager
│   │   │   ├── NotificationManager
│   │   │   └── HistoryManager
│   │   ├── Assets
│   │   ├── LaunchScreen
│   │   └── Info
│   ├── Products
│   ├── Pods
│   └── Frameworks
└── Pods
    

Coordinator

화면구성

데이터 구성

TodoListViewController( 메인 뷰컨트롤러 )

Realm Model

class Todo: Object {
    @objc dynamic var id: UUID = UUID()
    @objc dynamic var category: String = Category.todo
    @objc dynamic var title: String = ""
    @objc dynamic var body: String = ""
    @objc dynamic var date: Date = Date()
}

Model

Realm 객체를 잠시 복사해서 갖고있을 모델타입

struct TodoModel {
    var id: UUID = UUID()
    let category: String
    let title: String
    let body: String
    let date: Date
}

ViewModel

HeaderViewModel , ListCollectionViewModel, ListCellViewModel, PopoverViewModel

클로저 데이터 바인딩 사용

TodoDataManager

• 싱글톤 패턴 구현
• 프로젝트의 전반에 걸친 CRUD 액션을 담당
• 안에서 LocalDataManager, RemoteDataManager, NotificationManager, HistoryManager, UndoManager 가 각 CRUD에서 상호작용

기능구현

- 할 일 추가

• "TodoListViewController" 에서 네비게이션 바의 우측상단 "+" 버튼을 누르면 modalTransitionStyle 이 .formSheet 형태로 입력양식을 띄움
  • 입력 양식에서 우측상단의 Done 버튼 탭시, 입력된 데이터를 저장 후 셀 생성
  • 입력 양식에서 좌측상단의 Cancel 버튼 탭시, 취소
• 이 루트를 통해 생성되는 셀은 모두 TODO List 로 추가 되도록 설정

- 할 일 삭제

• 해당 셀 trailing Swipe시, 삭제버튼이 나오도록 구현
  • 나타난 delete 버튼 탭시 셀 삭제
• 해당 셀 trailing Swipe를 끝까지할 시, 삭제

- 할 일 수정

• 특정 셀 탭시, modalTransitionStyle이 .formSheet 형태로 입력양식을 띄움
  • 입력 양식에는 해당 셀의 세부정보가 채워진다
  • 입력 양식에서 내용을 수정한 뒤, 좌측상단의 Edit 버튼 탭시 셀 정보 수정
  • 입력 양식에서 Done 버튼 탭시, 뒤로가기 (수정사항 반영 x)

- 할 일 이동

• 특정 리스트 내에서 LongTouch를 할 시, 나머지 리스트로 이동할 수 있는 modalTransitionStyle이 .popover인 양식 띄움.
• 두 버튼에 어느 리스트로 이동 할 것인지 표현, 버튼 탭시 해당 리스트로 셀을 이동.

- 네트워크 상태체크

• 네트워크가 끊겼을 때, Alert를 이용한 알림

- History 기록

• 상품의 추가, 삭제, 이동이 이루어진 내역을 history에 저장

- UndoManager

• Toolbar 를 추가해 undo 와 redo 작업 추가
• 각 작업에서 반대의 작업을 undoManager.registerUndo() 메서드를 이용해 등록
• undoManager.canUndo 와 undoManager.canRedo 를 통해 버튼의 isEnable Bool값을 조절

- Local Notification

• 아이템이 생성됨과 동시에 해당 날짜의 오전 9시에 Notification이 오도록 request

func requestSendNoti(with todo: Todo) {
        let notiContent = UNMutableNotificationContent()
        notiContent.title = todo.title
        notiContent.body = todo.body
        
        var notiDate = Calendar.current.dateComponents(
            [.year, .month, .day],
            from: todo.date
        )
        notiDate.hour = 9

        let trigger = UNCalendarNotificationTrigger(
            dateMatching: notiDate,
            repeats: true
        )
        
        let request = UNNotificationRequest(
            identifier: todo.id.uuidString,
            content: notiContent,
            trigger: trigger
        )
        
        notificationCenter.add(request) { (error) in
            print(#function, error as Any)
        }
    }

• 아이템이 삭제되면 예약했던 알림을 지움 (해당 request 생성 시 사용했던 id 값으로 식별)

func requestCancelNoti(with id: String) {
        notificationCenter.removePendingNotificationRequests(withIdentifiers: [id])
    }

- 기타

• HeaderView
  • 해당 리스트의 현재 셀 개수를 HeaderView.count에 동적 표현
• ListCell
  • 날짜가 지나면 dateLabel의 색을 빨간색으로 변경
  • 제목이 길면 끝에 ...으로 표현
  • 본문은 최대 3줄까지만 표현

⚒🛠Trouble Shooting

1. ViewModel 에서 UIKit 제거하기

ViewModel의 view transition 파트에서 파라미터로 CGPoint를 받아오는 부분 때문에 import UIKit이 되어있었다. 불필요한 부분이라 상위함수에서 전달해줄 때, CGPoint의 형태를 (Double, Double) 튜플형태로 전달 해주었다. 근거

추가적으로 Swift 5.5 버젼 이상에서는 CGFloat과 Double이 교환 가능하다고 합니다.

2. 클로져에서 [weak self] 캡쳐

습관적으로 클로저 사용 시, [weak self] 를 이용하여 캡쳐리스트를 가져왔는데, 리뷰어분의 질문에 의해 서칭을 한번 해보았다. 좋은 외국 아티클을 찾아 읽어보고 번역하며 내용을 이해해보았다. 아티클 내용번역

[weak self] 캡쳐를 해서 self를 사용하려면 optional binding을 해주거나 optional chaining 을 이용해야 하는데, 이 둘의 차이점에 대한 설명이 나와있었다.

첫번째로, guard let self = self else {return} 구문이다. 이렇게 옵셔널 해제를 시켜주면 self가 클로저 scope동안 일시적인 강한참조를 유지하게 된다. 그래서 만약 self(=viewController로 생각해보면) 가 클로저 실행 중간에 dismiss가 된 상황을 생각 해보았을 때, 해제가 되지 않고 클로저 구문이 다 실행된 후에 할당해제가 될 것이다. delayed deallocated 가 되는것이다. 이는 나의 의도에 따라 좋을수도, 나쁠수도있다.

두번째로, self?. 옵셔널 체이닝을 이용해 접근하는 것이다. 이 방법으로 self에 접근한다면 위에 말했던 것 처럼 클로저 실행 중간에 self가 dismiss가 된 상황을 생각해보면, 그 시점 이후에 클로저 내부 나머지 코드 중 self로 접근하는 메서드들이 있으면 nil check에서 모두 건너뛰어 질 것이다. 할당해제가 바로 되는 것이다. 이 또한 나의 의도가 어떤지에 따라 좋을수도 나쁠수도 있다. 필요에 따라 두가지 방법을 적절히 사용하는 것이 좋을 것 같다

아직 나머지 읽지 못한 부분이 있어 다 읽어본 후 내용이 추가 될 것이다.

3. 클로져로 데이터 바인딩

뷰 모델이 가지고 있는 클로저 프로퍼티를 어느 뷰에서 바인딩을 할 때, 클로저 프로퍼티는 하나이지만 처리해주어야 하는 ListView 는 3개나 된다. 재활용 되는 ListView 한 곳에서 처리해주면 되겠지 싶어 그 안에 바인딩을 해주었는데 왠걸, doneListView에만 바인딩이 되는 것이다..ㅎ 이유는 아마 모두 같은 적용이 되었을 텐데 todoListView, doingListView, doneListView 순서대로 생성을 해주어 마지막에 생성된 doneListView에서 바인딩시켜준 didChangedCount() 가 최종적으로 할당이 된 것이라 생각이 된다. 예시:

var number: Int?
number = 1
number = 2
number = 3

//최종은 3이 할당됨

해결방법 : 3개의 ListView를 모두 가지고 있는 ViewController에서 바인딩을 해 주었다. 수정 : 위처럼 해결하니 디미터법칙을 위반하게 되었다. 하여 직접 ListCollectionView 에서 바인딩을 해주는데, 할당이 아닌 배열에 추가해주는 방식으로 변경을 하여 3 객체 모두 등록이 되도록 만들었다. 그래서 뷰모델에서도 클로저타입 프로퍼티가 아닌, 클로저배열타입 프로퍼티로 변경해주었다.

var didChangedCount: [(() -> Void)] = []
var didCreatedTodo: ((Todo) -> Void)?
var didEditedTodo: [(([Todo]) -> Void)] = []
var didMovedTodo: [(() -> Void)] = []

실행 시:

// in function

didMovedTodo.forEach { $0() }
didChangedCount.forEach { $0() }

4. 키보드가 텍스트뷰를 가림

실기기에서 테스트 결과, 할일의 내용을 작성하는 textView에서 키보드가 textView를 가려 내용이 보이지 않았다. 이 오류해결을 위해 먼저, formSheet 뷰를 scroll뷰로 한번 감싼 뒤, 키보드가 올라와 가리는 높이 만큼 bottomInset을 주어서 작성중인 내용이 가려지지 않도록 구현했다.

5. 로컬저장소와 원격저장소의 활용 (해결)

로컬저장소를 통하면 네트워크가 없이도 작업이 가능한데, 원격저장소는 왜 필요할까? 라는 의문에서 어떤방식으로 이 둘을 활용할지 케이스 별로 고민

1. 한 어플을 여러개의 기기에서 사용 할 경우 - 해결 리모트저장소를 기준으로 하여 여러대의 기기에서 CRUD가 일어난 내역을 저장하고 최종적으로 무작위 기기에서 실행할 때는 , 로컬데이터와 리모트데이터가 다를 경우 리모트데이터를 받아오도록 설정
2. 어플을 지웠다가 다시 설치한 경우 - 해결 이 경우 로컬에 저장되어 있던 데이터가 모두 지워진다. 따라서, 앱이 설치되고 처음 실행 시, 기존의 원격저장소의 데이터를 불러와주었다.

6. 네트워크 연결이 끊겼을 때, 작업을 진행 후 앱을 껐다가 다시 켤 때 (해결)

앱이 켜저있는 상태에서 네트워크가 끊겼다가 다시 연결되면, 원격저장소로 보내지는 작업들이 밀려있다가 실행되는 반면, 중간에 앱이 꺼졌다가 다시 켜지면 원격저장소로 동기화가 되지 않는다.

------------------------수정----------------------------

이후 원격저장소로 가는 어떠한 작업을 수행 시 밀렸던 작업과 함께 수행된다.

7. 네트워크 연결상태 확인 (해결)

와이파이를 끊으면, .satisfied 상태가 되고 , 와이파이를 연결하면 .unsatisfied 상태가 된다. 정확히 반대로 동작한다. 시뮬레이터의 오류인지 아직 이유를 알 수 없다..!

------------------------수정----------------------------

리뷰어 제임스도 같은 경험이 있었고, 이는 시뮬레이터 오류라고 말씀해주셨다! 결론: 실기기에서는 잘 동작한다 !

// Network MOnitoring 시작
    public func startMonitoring(in viewController: UIViewController) { // 상태값이 반대로 된다 ..
        monitor.start(queue: queue)
        monitor.pathUpdateHandler = { [weak self] path in
            self?.isConnected = path.status == .satisfied
            self?.getConnectionType(path)

            if self?.isConnected == true {
                print("연결됨")
            } else {
                print("연결안됨")
                let alert = UIAlertController(title: "인터넷 연결이 원활하지 않습니다.", message: "Wifi 또는 셀룰러를 활성화 해주세요.", preferredStyle: .alert)
                let confirm = UIAlertAction(title: "확인", style: .default, handler: nil)
                alert.addAction(confirm)
                DispatchQueue.main.async {
                    viewController.present(alert, animated: true)
                }
            }
        }
    }

8. 로컬과 리모트 저장소 동기화

• 여러대의 기기를 사용할 경우 로컬 데이터와 리모트 데이터가 달라진다 (각 기기의 로컬데이터가 다르기 때문)
• 앱을 시작할 때, 로컬 데이터와 리모트 데이터가 다를 경우 로컬 데이터를 지워준 후, 원격에서 데이터를 받아와서 해결했다

9. TodoDataManger의 비대

기능이 추가될 수록 Singleton 패턴으로 사용중인 TodoDataManger가 비대해졌다. TodoManager안에서는 Realm, Firebase, HistoryManager, UndoManager, Notification 총 5가지 기능이 처리되고 있다. 비대해진 TodoDataManager에서 각각의 기능들을 Manager로 독립 시킨 후, 인스턴스화 해서 사용하는 방식으로 코드수정을 했다. Realm 과 Firebase는 데이터관리라는 공통점이 있으므로 delegate로 연관을 지어주었다.

참고 링크

• Apple Article: Displaying transient content in a popover
• LongTouchGestureRecognizer사용법
• 스크롤 시, 네비게이션 바 자동 숨김처리 비활성화
• UIView그림자 만들기
• 키보드가 텍스트뷰를 가릴때, 해결방법
• Coden 님의 블로그 MVVM 패턴
• realm 공식 사이트
• Apple Docs - UndoManager
• Registering Undo Operations
• Apple Article - Notification