Greeddk / UQuiz

프로젝트 소개

스크린샷

앱 소개 & 기획

‎UQuiz - 유저가 만드는 영화 퀴즈

개발 기간과 v1.0 버전 기능

개발 기간

• 2024.03.08 ~ 2024.03.24 (약 16일)
• 업데이트 진행중

Configuration

• 최소버전 16.0 / 라이트 모드 / 세로모드 / iOS전용

v1.0 기능

1. 퀴즈 만들기

• 영화 검색 기능
• 포스터 영역 선택 기능
• 퀴즈 정보 저장 기능
• 난이도 설정 기능
• 다른 포스터로 교체 기능

2. 퀴즈 풀기

• 애니메이션으로 영역 표시 기능
• 정답 입력창이 키보드 위로 따라다니는 기능
• 정답 및 오답 시 애니메이션 효과

업데이트 예정 목록

• 애니메이션 버그 수정
• 초성 퀴즈
• 영어 대응
• 퀴즈 공유 기능 (GameKit)
• 네트워크 단절 시 처리 기능
• 퀴즈 풀 때 bgm
• 퀴즈 힌트
• 통계 기능 (DGChart)

기술 스택

• UIKit / MVVM / Custom Observable
• CollectionViewPagingLayout / SnapKit / CodeBaseUI
• Realm Repository Pattern
• Alamofire Router Pattern / Kingfisher
• SPM

구현 고려 사항

1. Custom Observable

• 데이터의 변화를 감지하고 이에 반응하는 간단하고 재사용 가능한 Observable 클래스를 구현
• 이를 통해 데이터 바인딩 및 상태 관리에 활용

2. 영화 제목 정규화

• 정답에 특수문자까지 포함할 경우 난이도가 너무 높은 점을 고려
• 사용자 경험을 고려하여 한글 혹은 영문자만 일치할 시 정답으로 처리

코드 보기

extension String {
    
    func matchString (_ text: String) -> String {
        let strArr = Array(text)
        let pattern = "^[ㄱ-ㅎㅏ-ㅣ가-힣a-zA-z0-9]$"
        var resultString = ""
        
        if strArr.count > 0 {
            if let regex = try? NSRegularExpression(pattern: pattern, options: .caseInsensitive) {
                var index = 0
                while index < strArr.count {
                    let checkString = regex.matches(in: String(strArr[index]), options: [], range: NSRange(location: 0, length: 1))
                    if checkString.count == 0 {
                        index += 1
                    } else {
                        resultString += String(strArr[index])
                        index += 1
                    }
                }
            }
            return resultString
        } else {
            return text
        }
    }
    
}

3. Alamofire Router 패턴

• 여러개의 API 앤드 포인트 관리
• 코드 유지보수성 용이하여 적용

4. 애니메이션 구현

• 앤터테이먼트적인 요소를 극대화하기 위해 UIViewPropertyAnimator과 CAEmitterLayer를 사용

5. Firebase analytics와 crashlytics

• 앱의 사용성을 추적하고, 문제점을 신속하게 식별 및 해결하기 위해 추가
• 앱의 안정성을 향상시키고, 사용자 만족도를 높이기 위해 적용

6. MVVM

• 비즈니스 로직을 분리해 ViewController가 비대해지는 것을 방지하기 위해 MVVM 패턴을 적용

⚒️트러블 슈팅

1. Realm에 Initial Data 넣기

문제상황

• 앱을 시작할 때부터 데이터베이스로 사용하는 Realm에 데이터가 포함되어 있게 구현하고자 함
• 데이터가 많은 경우 하드 코딩으로 넣기가 어려움

해결방법

• realm 데이터 파일을 Bundle에 추가하여 앱이 처음 켜졌을 때 데이터를 추가하는 방식으로 구현

코드 보기

   func copyInitialRealm() {
   	let fileManager = FileManager.default
        let documentDirectory = fileManager.urls(for: .documentDirectory, in: .userDomainMask).first!
        let fileURL = documentDirectory.appendingPathComponent("InitialData.realm")
        
        if !fileManager.fileExists(atPath: fileURL.path) {
            let bundleURL = Bundle.main.url(forResource: "initial", withExtension: "realm")!
            
            do {
                try fileManager.copyItem(at: bundleURL, to: fileURL)
            } catch {
                print("Error copy file: \(error)")
            }
        }
    }

bundle에 있는 realm 파일을 document 폴더에 저장한 후

 func fetchInitialData() {
       	let fileManager = FileManager.default
        let documentDirectory = fileManager.urls(for: .documentDirectory, in: .userDomainMask).first!
        let fileURL = documentDirectory.appendingPathComponent("InitialData.realm")
 
        do {
            let initialRealm = try Realm(fileURL: fileURL)
            try realm.write {
                for object in initialRealm.objects(yourRealmModel.self) {
                    realm.create(yourRealmModel.self, value: object, update: .modified)
                }
            }
        } catch let error as NSError {
            print("Error: \(error.localizedDescription)")
        }
    }

document 폴더에 저장한 realm 파일을 불러와서 사용하였다.

Realm 초기 데이터 사용하기 블로그글

2. 애니메이션 백그라운드 상태에서 포그라운드 상태로 돌아왔을 때 버그

문제상황

• 앱이 백그라운드 상태로 갔다가 다시 포그라운드 상태로 돌아왔을 때, 애니메이션이 다 끝난 상태로 되어버리는 버그 발생

해결방법

• 기존 진행율을 저장해 놓았다가 다시 애니메이션을 지정하고 진행율에 따라 Cell backgroundColor를 조절하는 메서드를 구현
• SceneDelegate에서 NotificationCenter로 앱이 백그라운드 상태로 변경되는지 observing

코드 보기

	// SceneDelegate
func sceneDidEnterBackground(_ scene: UIScene) {
   NotificationCenter.default.post(name: Notification.Name("SceneResign"), object: nil, userInfo: ["willResign": true])
}

SceneDelegate에서 백그라운드 상태로 전환될 때를 케치

// 애니메이션을 실행한 ViewController에서
override func ViewDidLoad() {
	  NotificationCenter.default.addObserver(self, selector: #selector(sceneResignStatusNotification), name: NSNotification.Name("SceneResign"), object: nil)
}
 
// MARK: NotificationCenter (백그라운드 상태로 변화할때)
@objc private func sceneResignStatusNotification(notification: NSNotification) {
   if let value = notification.userInfo?["willResign"] as? Bool {
       isBackground = true
       pauseAnimations()
   }
}

애니메이션이 진행중이던 뷰컨트롤러에서 백그라운드 상태로 전환될 때, 애니메이션을 중지

    // UIViewPropertyAnimator 객체를 저장한 배열
    var animators: [UIViewPropertyAnimator] = []
    // 애니메이션 진행률 저장 
    var animatorProgress: [CGFloat] = []
    
	private func resumeAnimations() {
        
        // 애니메이션이 완료되면 1.0이 아닌 0으로 저장이 되기 때문에, 0이 아닌 애니메이션을 찾음
        guard let lastIndex = animatorProgress.firstIndex(where: { $0 != 0 }) else { return }
        let nextIndex = lastIndex + 1
        // 애니메이션이 표시될 cell 정보가 기억된 배열
        let list = Array(viewModel.outputQuizList.value[viewModel.outputCurrentIndex.value].selectedArea)
        let listLastIndex = list.count - 1
        
        // 백그라운드 상태인지 아닌지 Bool 값으로 구별
        if isBackground {
            
            // 마지막 애니메이션의 보이는 정도 복구
            for index in Array(list[lastIndex].area) {
                let cell = self.mainView.collectionView.cellForItem(at: IndexPath(item: index, section: 0))
                cell?.backgroundColor = .black.withAlphaComponent(1 - animatorProgress[lastIndex])
            }
            // 아직 안보이는 부분 검은색으로 다시 칠하기
            for restIndex in lastIndex + 1...listLastIndex {
                let areaList = list[restIndex]
                let areaIndex = Array(areaList.area)
                for index in areaIndex {
                    let cell = self.mainView.collectionView.cellForItem(at: IndexPath(item: index, section: 0))
                    cell?.backgroundColor = .black
                }
                // 애니메이션 다시 지정
                let animator = UIViewPropertyAnimator(duration: TimeInterval(2), curve: .linear) {
                    for index in areaIndex {
                        let cell = self.mainView.collectionView.cellForItem(at: IndexPath(item: index, section: 0))
                        cell?.backgroundColor = .clear
                    }
                }
                animators[restIndex] = animator
            }
 
            // 진행율로 애니메이션 남은 시간 계산하기
            let restTime: CGFloat = CGFloat(2) * (1 - animatorProgress[lastIndex])
            // 마지막 애니메이션 진행중인 곳에 애니메이션 주기
            let animator = UIViewPropertyAnimator(duration: Double(restTime), curve: .linear) {
                for index in Array(list[lastIndex].area) {
                    let cell = self.mainView.collectionView.cellForItem(at: IndexPath(item: index, section: 0))
                    cell?.backgroundColor = .clear
                }
            }
            animators[lastIndex] = animator
        }
        // 마지막 애니메이션 시작하기
        animators[lastIndex].startAnimation()
        // 애니메이션이 끝나면 그 다음 애니메이션 시작
        animators[lastIndex].addCompletion { position in
            if position == .end {
                self.startNextAnimation(index: nextIndex)
            }
        }
    }

포그라운드 상태로 돌아왔을 때, 애니메이션을 다시 시작

트러블 슈팅 블로그글

3. CollectionViewPagingLayout 화면 reloadData가 안 되는 버그

문제상황

• 퀴즈 목록에서 중간 index의 퀴즈를 삭제하면 위와 같이 화면이 나타나는 버그가 발생

해결방법

• performBatchUpdates와 invalidateLayout이라는 메서드를 사용

  self?.mainView.collectionView.reloadData()
  self?.mainView.collectionView.performBatchUpdates({
  self?.mainView.collectionView.collectionViewLayout.invalidateLayout()
  })

위 메서드들은 CollectionView의 레이아웃을 업데이트할 때, 특히 애니메이션과 함께 변경할 때 사용하는 메서드들로 '동적인 레이아웃 업데이트 시 사용'하거나 '애니메이션을 부드럽게 처리하는데' 사용한다고 한다. 즉 이런 버그는 UICollectionViewPagingLayout이라는 라이브러리를 활용해서 애니메이션과 동적인 레이아웃 UI를 구현해서 발생하는 버그였다.

4. BlurView가 사라지는 버그

문제상황

• 영화 포스터 이미지가 Blur가 사라지면서 보이게 되는 버그가 발생

해결방법

• Kingfisher의 내장 기능 중 Blur를 처리해 주는 process를 사용

 let url = PosterURL.thumbnailURL(detailURL: detailURL).endpoint
 let processor = BlurImageProcessor(blurRadius: 20.0)
 posterView.kf.setImage(with: url, options: [.processor(processor)])