Feat/#311 앱스토어의 앱 버전과 기존 앱의 버전을 추적하여 강제 업데이트 기능

Plugins/EnvironmentPlugin/ProjectDescriptionHelpers/InfoPlist.swift

@@ -50,7 +50,9 @@ public extension [String: Plist.Value] {
         "NMFClientId": "$(NAVERMAP_CLIENT_ID)",
         "TERMS_OF_PRIVACY_URL": "$(TERMS_OF_PRIVACY_URL)",
         "LOCATION_PRIVACY_URL": "$(LOCATION_PRIVACY_URL)",
-        "INQURY_URL": "$(INQURY_URL)"
+        "INQUIRY_URL": "$(INQUIRY_URL)",
+        "APPSTORE_ID": "$(APPSTORE_ID)",
+        "DOMAIN_URL": "$(DOMAIN_URL)",
     ]
 
     static let additionalInfoPlist: Self = [

Projects/App/Sources/AppDelegate+Register.swift

@@ -38,6 +38,9 @@ extension AppDelegate {
         = DefaultLocalNotificationService()
         let regularAlarmEditingService: RegularAlarmEditingService
         = DefaultRegularAlarmEditingService()
+        // TODO: 추후 의존 주입 형태 변경
+//        let versionCheckRepository: VersionCheckRepository
+//        = DefaultVersionCheckRepository(networkService: networkService)
 
         DIContainer.register(
             type: FavoritesUseCase.self,
@@ -92,5 +95,12 @@ extension AppDelegate {
             type: RegularAlarmEditingService.self,
             regularAlarmEditingService
         )
+
+//        DIContainer.register(
+//            type: VersionCheckUseCase.self,
+//            DefaultVersionCheckUseCase(
+//                versionCheckRepository: versionCheckRepository
+//            )
+//        )
     }
 }

Projects/App/Sources/SceneDelegate.swift

@@ -8,6 +8,7 @@
 
 import UIKit
 
+import Core
 import NetworkService
 import Domain
 import Data
@@ -18,9 +19,20 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate {
     var window: UIWindow?
     var appCoordinator: AppCoordinator?
     var deeplinkHandler: DeeplinkHandler?
+
+    let disposeBag = DisposeBag()
+
+    // MARK: 추후 구체타입이 아닌 형태로 변경
+    private var useCase: VersionCheckUseCase
+    = DefaultVersionCheckUseCase(
+        versionCheckRepository: DefaultVersionCheckRepository(
+            networkService: DefaultNetworkService()
+        ),
+        forceUpdateService: DefaultForceUpdateService()
+    )
 
     func scene(
-        _ scene: UIScene, 
+        _ scene: UIScene,
         willConnectTo session: UISceneSession,
         options connectionOptions: UIScene.ConnectionOptions
     ) {
@@ -37,6 +49,7 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate {
         )
         appCoordinator?.start()
         window?.makeKeyAndVisible()
+        // 앱 진입할 때 확인
         deeplinkHandler = .init(appCoordinator: appCoordinator)
         if let url = connectionOptions.urlContexts.first?.url {
             deeplinkHandler?.handleUrl(url: url)
@@ -52,7 +65,9 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate {
     func sceneWillResignActive(_ scene: UIScene) {
     }
 
+    /// 앱이 Foreground로 전환될때 실행될 함수
     func sceneWillEnterForeground(_ scene: UIScene) {
+        checkAndUpdateIfNeeded()
     }
 
     func sceneDidEnterBackground(_ scene: UIScene) {
@@ -66,5 +81,47 @@ final class SceneDelegate: UIResponder, UIWindowSceneDelegate {
             deeplinkHandler?.handleUrl(url: url)
         }
     }
+
+    private func checkAndUpdateIfNeeded() {
+        useCase.fetchAppStoreURL()
+            .subscribe(with: self) { owner, str in
+                guard let str else { return }
+                owner.showUpdateAlert(with: str)
+            } onFailure: { _, error in
+                print(error)
+            }
+            .disposed(by: disposeBag)
+    }
+
+    private func showUpdateAlert(with urlString: String) {
+        let alert = UIAlertController(
+            title: "업데이트 알림",
+            message: "더 나은 서비스를 위해 업데이트 되었어요 ! 업데이트 해주세요.",
+            preferredStyle: .alert
+        )
+
+        let alertAction = UIAlertAction(
+            title: "업데이트",
+            style: .default
+        ) { [weak self] _ in
+            guard let self else { return }
+
+            openAppStore(urlString)
+        }
+
+        alert.addAction(alertAction)
+
+        Task { @MainActor in
+            window?.rootViewController?.present(alert, animated: true)
+        }
+    }
+
+    private func openAppStore(_ str: String) {
+        guard let url = URL(string: str) else { return }
+
+        if UIApplication.shared.canOpenURL(url) {
+            UIApplication.shared.open(url)
+        }
+    }
 }
 

Projects/App/Widget/ArrivalInfo/View/ArrivalInfoView.swift

@@ -10,7 +10,7 @@ import SwiftUI
 import WidgetKit
 import DesignSystem
 
-@available (iOS 17.0, *)
+@available(iOS 17.0, *)
 struct ArrivalInfoView: View {
     var entry: ArrivalInfoProvider.Entry
     @Environment(\.widgetFamily) var widgetFamily

Projects/Core/Sources/Extension/String+.swift

@@ -34,11 +34,13 @@ public extension String {
         return serverKey
     }
 
-    static func getCurrentVersion() -> String {
+    /// 프로젝트 버전
+    static func getCurrentVersion() -> [Int] {
         guard let dictionary = Bundle.main.infoDictionary,
               let version = dictionary["CFBundleShortVersionString"] as? String
-        else { return "" }
-        return version
+        else { return [1, 0, 0] }
+
+        return version.split(separator: ".").compactMap { Int($0) }
     }
 
     static func getDeviceIdentifier() -> String {

Projects/Data/Sources/DTO/AppInfoDTO.swift

@@ -0,0 +1,43 @@
+//
+//  AppInfoDTO.swift
+//  Data
+//
+//  Created by Jisoo HAM on 8/1/24.
+//  Copyright © 2024 Pepsi-Club. All rights reserved.
+//
+
+import Foundation
+
+import Domain
+
+public struct AppInfoDTO: Decodable {
+    let resultCount: Int
+    let results: [AppDetailDTO]
+}
+
+extension AppInfoDTO {
+    var toDomain: AppVersionInfoResponse? {
+        guard let versionString = results.map({ $0.version }).first 
+        else { return nil }
+
+        let versionComponents = versionString.split(separator: ".")
+            .compactMap { Int($0) }
+
+        guard versionComponents.count == 3 
+        else { return nil }
+
+        return AppVersionInfoResponse(
+            major: versionComponents[0],
+            minor: versionComponents[1],
+            patch: versionComponents[2]
+        )
+    }
+}
+
+extension AppInfoDTO {
+    struct AppDetailDTO: Decodable {
+        let trackId: Int
+        /// App Version
+        let version: String
+    }
+}

Projects/Data/Sources/DTO/RequiredVersionDTO.swift

@@ -0,0 +1,35 @@
+//
+//  RequiredVersionDTO.swift
+//  Data
+//
+//  Created by Jisoo Ham on 3/26/25.
+//  Copyright © 2025 Pepsi-Club. All rights reserved.
+//
+
+import Foundation
+
+import Domain
+
+public struct RequiredVersionDTO: Decodable {
+    let version: String
+
+    enum CodingKeys: String, CodingKey {
+        case version = "ver"
+    }
+}
+
+extension RequiredVersionDTO {
+    var toDomain: AppVersionInfoResponse {
+        let versionComponents = version.split(separator: ".")
+            .compactMap { Int($0) }
+
+        guard versionComponents.count == 3
+        else { return AppVersionInfoResponse(major: 1, minor: 2, patch: 5) }
+
+        return AppVersionInfoResponse(
+            major: versionComponents[0],
+            minor: versionComponents[1],
+            patch: versionComponents[2]
+        )
+    }
+}

Projects/Data/Sources/Repository/DefaultVersionCheckRepository.swift

@@ -0,0 +1,96 @@
+//
+//  DefaultVersionCheckRepository.swift
+//  Data
+//
+//  Created by Jisoo HAM on 8/1/24.
+//  Copyright © 2024 Pepsi-Club. All rights reserved.
+//
+
+import UIKit
+
+import Core
+import Domain
+import NetworkService
+
+import RxSwift
+
+public final class DefaultVersionCheckRepository: VersionCheckRepository {
+    private let networkService: NetworkService
+
+    @UserDefaultsWrapper(
+        key: "ForceUpdate",
+        defaultValue: ForceUpdate(
+            version: AppVersionInfoResponse(major: 1, minor: 2, patch: 4),
+            date: Date(timeIntervalSince1970: 0)
+        )
+    )
+    private var forceUpdateInfo: ForceUpdate
+
+    public init(networkService: NetworkService) {
+        self.networkService = networkService
+    }
+
+    /// 서버로 부터 받은 App의 최소 지원 버전
+    public func fetchRequiredVersion()
+    -> Single<Result<AppVersionInfoResponse, Error>> {
+        return networkService.request(
+            endPoint: MinVersionEndpoint(domain: getDomainURL()),
+            responseType: RequiredVersionDTO.self
+        )
+        .map { result in
+            switch result {
+            case .success(let value):
+                return .success(value.toDomain)
+            case .failure(let error):
+                return .failure(error)
+            }
+        }
+    }
+
+    public func getStoreLink() -> String? {
+        return OpenStoreEndpoint(appStoreID: getAppStoreID()).toURLString
+    }
+
+    public func getAppStoreID() -> String {
+        guard let appId = Bundle.main.object(
+            forInfoDictionaryKey: "APPSTORE_ID"
+        ) as? String
+        else { return "" }
+
+        return appId
+    }
+
+    public func getUserAppVersion() -> AppVersionInfoResponse {
+        guard let dictionary = Bundle.main.infoDictionary,
+              let version = dictionary["CFBundleShortVersionString"] as? String
+        else { return AppVersionInfoResponse(major: 1, minor: 0, patch: 0) }
+
+        let splitedVersion = version.split(separator: ".")
+            .compactMap { Int($0) }
+
+        return AppVersionInfoResponse(
+            major: splitedVersion[0],
+            minor: splitedVersion[1],
+            patch: splitedVersion[2]
+        )
+    }
+
+    /// 최소 요구 버전, fetch 받은 날짜를 UserDefaults 저장
+    public func saveForceUpdateInfo(_ newValue: ForceUpdate) {
+        forceUpdateInfo = newValue
+    }
+
+    /// UserDefaults 저장된 최소 요구 버전, fetch 받은 날짜
+    public func getForceUpdateInfo() -> ForceUpdate {
+        return forceUpdateInfo
+    }
+
+    private func getDomainURL() -> String {
+        guard let domainURL = Bundle.main.object(
+            forInfoDictionaryKey: "DOMAIN_URL"
+        ) as? String
+        else { return "" }
+
+        return domainURL
+    }
+}

Projects/Data/Sources/Service/ForceUpdateService/DefaultForceUpdateService.swift

@@ -0,0 +1,23 @@
+//
+//  DefaultForceUpdateService.swift
+//  Data
+//
+//  Created by Jisoo Ham on 3/27/25.
+//  Copyright © 2025 Pepsi-Club. All rights reserved.
+//
+
+import Foundation
+
+import Domain
+
+public final class DefaultForceUpdateService: ForceUpdateService {
+
+    public init() { }
+
+    public func compareVersion(
+        user: AppVersionInfoResponse,
+        required: AppVersionInfoResponse
+    ) -> Bool {
+        return required > user
+    }
+}

Projects/Domain/Sources/Entity/ForceUpdate.swift

@@ -0,0 +1,22 @@
+//
+//  ForceUpdate.swift
+//  Domain
+//
+//  Created by Jisoo Ham on 3/27/25.
+//  Copyright © 2025 Pepsi-Club. All rights reserved.
+//
+
+import Foundation
+
+public struct ForceUpdate: Codable {
+    let version: AppVersionInfoResponse
+    let date: Date
+
+    public init(
+        version: AppVersionInfoResponse,
+        date: Date
+    ) {
+        self.version = version
+        self.date = date
+    }
+}