[#234] NaverMap API 연결

Author: jayn2u

EATSSU/App/Sources/Presentation/Auth/ViewController/SetNickNameViewController.swift

@@ -47,8 +47,8 @@ final class SetNickNameViewController: BaseViewController {
         }
     }
 
-    override func setCustomNavigationBar() {
-        super.setCustomNavigationBar()
+    override func setESNavigationBar() {
+        super.setESNavigationBar()
         navigationItem.title = TextLiteral.setNickName
     }
 

EATSSU/App/Sources/Presentation/Maps/ViewController/MapsViewController.swift

@@ -0,0 +1,20 @@
+//
+//  MapsViewController.swift
+//  EATSSU
+//
+//  Created by JIWOONG CHOI on 1/28/25.
+//
+
+import UIKit
+
+import EATSSUDesign
+
+import NMapsMap
+
+final class MapsViewController: BaseViewController {
+    override func viewDidLoad() {
+        super.viewDidLoad()
+        let mapView = NMFMapView(frame: view.frame)
+        view.addSubview(mapView)
+    }
+}

EATSSU/App/Sources/Presentation/MyPage/ViewController/CreatorViewController.swift

@@ -37,9 +37,9 @@ class CreatorViewController: BaseViewController {
         }
     }
 
-    override func setCustomNavigationBar() {
+    override func setESNavigationBar() {
         // TODO: setCustomNavigationBar에 파라미터로 title 값을 받아서 네비게이션 바를 설계하도록 변경
-        super.setCustomNavigationBar()
+        super.setESNavigationBar()
         navigationItem.title = "만든 사람들"
     }
 }

EATSSU/App/Sources/Presentation/MyPage/ViewController/MyPageViewController.swift

@@ -46,8 +46,8 @@ final class MyPageViewController: BaseViewController {
 
     // MARK: - Functions
 
-    override func setCustomNavigationBar() {
-        super.setCustomNavigationBar()
+    override func setESNavigationBar() {
+        super.setESNavigationBar()
         navigationItem.title = TextLiteral.MyPage.myPage
     }
 

EATSSU/App/Sources/Presentation/MyPage/ViewController/MyReviewViewController.swift

@@ -49,8 +49,8 @@ final class MyReviewViewController: BaseViewController {
 
     // MARK: - Functions
 
-    override func setCustomNavigationBar() {
-        super.setCustomNavigationBar()
+    override func setESNavigationBar() {
+        super.setESNavigationBar()
         navigationItem.title = TextLiteral.MyPage.myReview
     }
 

EATSSU/App/Sources/Presentation/MyPage/ViewController/ProvisionViewController.swift

@@ -33,8 +33,8 @@ final class ProvisionViewController: BaseViewController {
 
     // MARK: - Functions
 
-    override func setCustomNavigationBar() {
-        super.setCustomNavigationBar()
+    override func setESNavigationBar() {
+        super.setESNavigationBar()
         navigationItem.title = navigationTitle
     }
 

EATSSU/App/Sources/Presentation/MyPage/ViewController/UserWithdrawViewController.swift

@@ -64,8 +64,8 @@ final class UserWithdrawViewController: BaseViewController {
         }
     }
 
-    override func setCustomNavigationBar() {
-        super.setCustomNavigationBar()
+    override func setESNavigationBar() {
+        super.setESNavigationBar()
         navigationItem.title = "탈퇴하기"
     }
 

EATSSU/App/Sources/Presentation/Review/ViewController/ChoiceMenuViewController.swift

@@ -104,8 +104,8 @@ final class ChoiceMenuViewController: BaseViewController {
         nextButton.addTarget(self, action: #selector(nextButtonTapped), for: .touchUpInside)
     }
 
-    override func setCustomNavigationBar() {
-        super.setCustomNavigationBar()
+    override func setESNavigationBar() {
+        super.setESNavigationBar()
         navigationItem.title = "리뷰 남기기"
     }
 

EATSSU/App/Sources/Presentation/Review/ViewController/FormerReportViewController.swift

@@ -165,7 +165,7 @@ final class FormerReportViewController: BaseViewController {
         setDelegate()
         addArray()
         setButtonEvent()
-        setCustomNavigationBar()
+        setESNavigationBar()
     }
 
     override func viewWillAppear(_: Bool) {
@@ -230,8 +230,8 @@ final class FormerReportViewController: BaseViewController {
         sendButton.addTarget(self, action: #selector(sendButtonIsTapped), for: .touchUpInside)
     }
 
-    override func setCustomNavigationBar() {
-        super.setCustomNavigationBar()
+    override func setESNavigationBar() {
+        super.setESNavigationBar()
         title = "신고하기"
 
         let navBarApperance = UINavigationBarAppearance()

EATSSU/App/Sources/Presentation/Review/ViewController/ReportViewController.swift

@@ -43,7 +43,7 @@ final class ReportViewController: BaseViewController {
         setDelegate()
         addArray()
         setButtonEvent()
-        setCustomNavigationBar()
+        setESNavigationBar()
     }
 
     override func viewWillDisappear(_: Bool) {
@@ -98,8 +98,8 @@ final class ReportViewController: BaseViewController {
         self.reviewID = reviewID
     }
 
-    override func setCustomNavigationBar() {
-        super.setCustomNavigationBar()
+    override func setESNavigationBar() {
+        super.setESNavigationBar()
         title = "신고하기"
 
         let navBarApperance = UINavigationBarAppearance()

EATSSU/App/Sources/Presentation/Review/ViewController/ReviewViewController.swift

@@ -89,8 +89,8 @@ final class ReviewViewController: BaseViewController {
         }
     }
 
-    override func setCustomNavigationBar() {
-        super.setCustomNavigationBar()
+    override func setESNavigationBar() {
+        super.setESNavigationBar()
         navigationItem.title = "리뷰"
     }
 

EATSSU/App/Sources/Presentation/Review/ViewController/SetRateViewController.swift

@@ -284,8 +284,8 @@ final class SetRateViewController: BaseViewController {
         nextButton.addTarget(self, action: #selector(tappedNextButton), for: .touchUpInside)
     }
 
-    override func setCustomNavigationBar() {
-        super.setCustomNavigationBar()
+    override func setESNavigationBar() {
+        super.setESNavigationBar()
         if reviewId != nil {
             navigationItem.title = "리뷰 수정하기"
         } else {

EATSSU/App/Sources/Presentation/Review/ViewController/WriteReviewViewController.swift

@@ -99,7 +99,7 @@ class WriteReviewViewController: BaseViewController, UIImagePickerControllerDele
 
     override func viewDidLoad() {
         super.viewDidLoad()
-        setCustomNavigationBar()
+        setESNavigationBar()
         setStarButtons()
 
         userReviewTextView.delegate = self
@@ -182,8 +182,8 @@ class WriteReviewViewController: BaseViewController, UIImagePickerControllerDele
         userReviewTextView.resignFirstResponder()
     }
 
-    override func setCustomNavigationBar() {
-        super.setCustomNavigationBar()
+    override func setESNavigationBar() {
+        super.setESNavigationBar()
         navigationItem.title = "리뷰 남기기"
     }
 

EATSSU/App/Sources/Presentation/TabBar/RootTabBarViewController.swift

@@ -16,7 +16,7 @@ class RootTabBarViewController: UITabBarController {
 
     private func setupTabBar() {
         let homeViewController = HomeViewController()
-        let searchViewController = HomeViewController()
+        let searchViewController = MapsViewController()
         let settingsViewController = MyPageViewController()
 
         // 각 뷰컨트롤러를 네비게이션 컨트롤러로 래핑
@@ -26,7 +26,7 @@ class RootTabBarViewController: UITabBarController {
 
         // 탭바 아이템 설정
         homeNav.tabBarItem = UITabBarItem(title: "Home", image: UIImage(systemName: "house.fill"), tag: 0)
-        searchNav.tabBarItem = UITabBarItem(title: "Search", image: UIImage(systemName: "magnifyingglass"), tag: 1)
+        searchNav.tabBarItem = UITabBarItem(title: "Search", image: UIImage(systemName: "map.fill"), tag: 1)
         settingsNav.tabBarItem = UITabBarItem(title: "Settings", image: UIImage(systemName: "gearshape.fill"), tag: 2)
 
         // 탭바 컨트롤러에 뷰컨트롤러 추가

EATSSU/App/Sources/Utility/Base/BaseViewController.swift

@@ -1,8 +1,8 @@
 //
 //  BaseViewController.swift
-//  EatSSU-iOS
+//  EATSSU
 //
-//  Created by 박윤빈 on 2023/03/15.
+//  Edited by Jiwoong CHOI on 01/28/2025.
 //
 
 // TODO: BaseViewController 코드 Utility 모듈로 모듈화 간 재정비
@@ -20,7 +20,7 @@ import SnapKit
 /// - configureUI
 /// - setLayout
 /// - setButtonEvent
-/// - setCustomnavigationBar
+/// - setESnavigationBar
 ///
 /// - Important: configureUI와 setLayout 메소드는 필수로 오버라이딩 해야 합니다.
 /// 오버라이딩 하지 않으면 런타임 에러가 발생합니다.
@@ -40,9 +40,10 @@ class BaseViewController: UIViewController {
         fatalError("init(coder:) has not been implemented")
     }
 
-    // TODO: deinit 메소드의 목적이 무엇인지 알아보기
     deinit {
-        print("DEINIT: \(className)")
+        #if DEBUG
+            print("메모리 해제 ViewController: \(className)")
+        #endif
     }
 
     override func viewDidLoad() {
@@ -51,15 +52,17 @@ class BaseViewController: UIViewController {
         configureUI()
         setLayout()
         setButtonEvent()
-        setCustomNavigationBar()
+        setESNavigationBar()
         view.backgroundColor = .systemBackground
     }
 
     override func viewWillAppear(_ animated: Bool) {
         super.viewWillAppear(animated)
 
         if !NetworkMonitor.shared.isConnected {
-            print("네트워크 오류")
+            #if DEBUG
+                print("네트워크 오류")
+            #endif
             showAlertController(title: "오류", message: "네트워크를 확인해주세요", style: .destructive)
         }
     }
@@ -114,7 +117,7 @@ class BaseViewController: UIViewController {
     ///
     /// # 네비게이션 백버튼 속성
     /// - `gray500`으로 백버튼 색상을 설정합니다.
-    func setCustomNavigationBar() {
+    func setESNavigationBar() {
         // 네비게이션 바 타이틀 속성
         navigationController?.navigationBar.titleTextAttributes = [
             .foregroundColor: EATSSUDesignAsset.Color.GrayScale.gray700.color,

EATSSU/App/Sources/Utility/Base/BaseViewControllerProtocol.swift

@@ -0,0 +1,52 @@
+//
+//  BaseViewControllerProtocol.swift
+//  EATSSU
+//
+//  Created by JIWOONG CHOI on 1/28/25.
+//
+
+import UIKit
+
+/// EATSSU 앱에서 UIViewController의 공통 인터페이스를 정의하는 프로토콜입니다.
+protocol BaseViewControllerProtocol: AnyObject {
+    // MARK: - Required Methods
+
+    /// UIViewController에서 사용 중인 UIView를 연결합니다.
+    ///
+    /// # Example
+    /// ```swift
+    /// func configureUI() {
+    ///     view.addSubview(rootView)
+    /// }
+    /// ```
+    func configureUI()
+
+    /// 연결된 UIView 클래스의 레이아웃을 UIViewController의 View 프로퍼티를 기준으로 레이아웃을 조정합니다.
+    ///
+    /// # Example
+    /// ```swift
+    /// func setLayout() {
+    ///     rootView.snp.makeConstraints { make in
+    ///         make.edges.equalToSuperview()
+    ///     }
+    /// }
+    /// ```
+    func setLayout()
+
+    // MARK: - Optional Methods
+
+    /// UIViewController에서 버튼이 있다면 버튼 액션을 연결합니다.
+    ///
+    /// 버튼이 없다면 기본적으로 비워둡니다.
+    func setButtonEvent()
+
+    /// EATSSU 앱에서 사용하고 있는 네비게이션 바의 속성을 정의합니다.
+    func setESNavigationBar()
+}
+
+// MARK: - Default Implementation
+
+extension BaseViewControllerProtocol {
+    func setButtonEvent() {}
+    func setESNavigationBar() {}
+}

EATSSU/Project.swift

@@ -1,10 +1,12 @@
 import ProjectDescription
 
 let appInfoPlist: InfoPlist = .extendingDefault(with: [
-    "UILaunchStoryboardName": "LaunchScreen",
+    // API Keys Settings
     "BASE_URL": "https://$(BASE_URL)",
     "KAKAO API KEY": "$(KAKAO_API_KEY)",
+    "NMFClientId": "$(NMAP_CLIENT_ID)",
     "GADApplicationIdentifier": "$(GADApplicationIdentifier)",
+    "UILaunchStoryboardName": "LaunchScreen",
     "CFBundleURLTypes": [
         [
             "CFBundleTypeRole": "Editor",
@@ -102,6 +104,7 @@ let project = Project(
                 .external(name: "KakaoSDKCommon"),
                 .external(name: "KakaoSDKTalk"),
                 .external(name: "GoogleMobileAds"),
+                .external(name: "NMapsMap"),
 
                 // EATSSU 내장 라이브러리
                 .project(target: "EATSSUDesign", path: .relativeToRoot("../EATSSUDesign"), condition: .none),
@@ -139,6 +142,7 @@ let project = Project(
                 .external(name: "KakaoSDKCommon"),
                 .external(name: "KakaoSDKTalk"),
                 .external(name: "GoogleMobileAds"),
+                .external(name: "NMapsMap"),
 
                 // EATSSU 내장 라이브러리
                 .project(target: "EATSSUDesign", path: .relativeToRoot("../EATSSUDesign"), condition: .none),

Tuist/Package.resolved

@@ -1,5 +1,5 @@
 {
-  "originHash" : "927f3970054f96b698bb1f4d42eec10f20bdcf37978d07047fc3af226ed8ed97",
+  "originHash" : "f7acbf13d8ff28deccedf1b13d9163bb3548128ddcdec705eab977fbd5b1c7f0",
   "pins" : [
     {
       "identity" : "abseil-cpp-binary",
@@ -208,6 +208,24 @@
         "version" : "5.7.1"
       }
     },
+    {
+      "identity" : "spm-nmapsgeometry",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/navermaps/SPM-NMapsGeometry.git",
+      "state" : {
+        "revision" : "436d5e2e684f557faf5ef5862fd6633a42d7af11",
+        "version" : "1.0.2"
+      }
+    },
+    {
+      "identity" : "spm-nmapsmap",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/navermaps/SPM-NMapsMap",
+      "state" : {
+        "revision" : "606cb2df9bcffcf6df62ba00d0322965a4c730e9",
+        "version" : "3.20.0"
+      }
+    },
     {
       "identity" : "swift-package-manager-google-mobile-ads",
       "kind" : "remoteSourceControl",

Tuist/Package.swift

@@ -36,6 +36,9 @@ import PackageDescription
 
             // RxSwift
             "RxSwift": .framework,
+
+            // Naver Maps
+            "NMapsMap": .framework,
         ]
     )
 #endif
@@ -55,5 +58,6 @@ let package = Package(
         .package(url: "https://github.com/realm/realm-swift", from: "20.0.0"),
         .package(url: "https://github.com/ReactiveX/RxSwift", from: "6.7.1"),
         .package(url: "https://github.com/googleads/swift-package-manager-google-mobile-ads.git", from: "11.0.0"),
+        .package(url: "https://github.com/navermaps/SPM-NMapsMap", from: "3.20.0"),
     ]
 )