2.0.2

.github/workflows/appstore_release.yml

@@ -10,15 +10,15 @@ on:
 
 jobs:
   build:
-    runs-on: macos-latest
+    runs-on: macos-26
 
     steps:
     - uses: actions/checkout@v4
 
     - name: Set up Xcode
       uses: maxim-lobanov/setup-xcode@v1
       with:
-        xcode-version: '16.1'
+        xcode-version: latest-stable
 
     - uses: shimataro/ssh-key-action@v2
       with:

.github/workflows/build_test.yml

@@ -12,15 +12,15 @@ on:
 
 jobs:
   build:
-    runs-on: macos-latest
+    runs-on: macos-26
 
     steps:
     - uses: actions/checkout@v4
 
     - name: Set up Xcode
       uses: maxim-lobanov/setup-xcode@v1
       with:
-        xcode-version: '16.1'
+        xcode-version: latest-stable
 
     - uses: shimataro/ssh-key-action@v2
       with:

.github/workflows/develop_hotfix.yml

@@ -12,7 +12,7 @@ on:
 jobs:
   build:
     if: startsWith(github.event.head_commit.message, '[hotfix]')
-    runs-on: macos-latest
+    runs-on: macos-26
 
     steps:
     - uses: actions/checkout@v4

.github/workflows/testflight_release.yml

@@ -15,15 +15,15 @@ on:
 jobs:
   build:
     if: ${{ github.event_name == 'workflow_dispatch' || github.event.pull_request.merged == true }}
-    runs-on: macos-latest
+    runs-on: macos-26
 
     steps:
     - uses: actions/checkout@v4
 
     - name: Set up Xcode
       uses: maxim-lobanov/setup-xcode@v1
       with:
-        xcode-version: '16.1'
+        xcode-version: latest-stable
 
     - uses: shimataro/ssh-key-action@v2
       with:

Projects/App/Resources/Pokit-info.plist

@@ -21,7 +21,7 @@
 	<key>CFBundlePackageType</key>
 	<string>APPL</string>
 	<key>CFBundleShortVersionString</key>
-	<string>2.0.0</string>
+	<string>2.0.2</string>
 	<key>CFBundleURLTypes</key>
 	<array>
 		<dict>
@@ -94,5 +94,7 @@
 		<string>UIInterfaceOrientationLandscapeLeft</string>
 		<string>UIInterfaceOrientationLandscapeRight</string>
 	</array>
+	<key>AMPLITUDE_API_KEY</key>
+	<string>$(AMPLITUDE_API_KEY)</string>
 </dict>
 </plist>

Projects/App/ShareExtension/Info.plist

@@ -13,7 +13,7 @@
 	<key>CFBundleName</key>
 	<string>Pokit</string>
 	<key>CFBundleShortVersionString</key>
-	<string>1.0.9</string>
+	<string>2.0.1</string>
 	<key>CFBundleURLTypes</key>
 	<array>
 		<dict>

Projects/App/Sources/AppDelegate/AppDelegate.swift

@@ -6,19 +6,25 @@
 //
 
 import SwiftUI
+import UIKit
 
 import ComposableArchitecture
 import Firebase
 import FirebaseMessaging
 import GoogleSignIn
+import Dependencies
 
 final class AppDelegate: NSObject {
+    @Dependency(\.amplitude)
+    private var amplitude
+
     let store = Store(initialState: AppDelegateFeature.State()) {
         AppDelegateFeature()
     }
 }
 //MARK: - UIApplicationDelegate
 extension AppDelegate: UIApplicationDelegate {
+
     func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
         if GIDSignIn.sharedInstance.handle(url) { return true }
         return false
@@ -30,6 +36,15 @@ extension AppDelegate: UIApplicationDelegate {
         didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil
     ) -> Bool {
         self.store.send(.didFinishLaunching)
+
+        // 운영체제 버전 (ex: "iOS 18.0.0")
+        let osVersion = "iOS \(UIDevice.current.systemVersion)"
+
+        // 앱 번들 버전 (ex: "2.0.1")
+        let appVersion = Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String ?? ""
+        let amplitudeKey = Bundle.main.infoDictionary?["AMPLITUDE_API_KEY"] as? String ?? ""
+        amplitude.initialize(amplitudeKey, nil)
+        amplitude.track(.app_open(deviceOS: osVersion, appVersion: appVersion))
         return true
     }
 

Projects/App/Sources/MainTab/MainTabFeature.swift

@@ -24,6 +24,9 @@ public struct MainTabFeature {
     private var categoryClient
     @Dependency(UserDefaultsClient.self)
     private var userDefaults
+    @Dependency(\.amplitude.track)
+    private var amplitudeTrack
+
     /// - State
     @ObservableState
     public struct State: Equatable {
@@ -103,6 +106,14 @@ public struct MainTabFeature {
             guard state.linkPopup == nil else { return .none }
             state.categoryOfSavedContent = nil
             return .none
+        case .binding(\.selectedTab):
+            switch state.selectedTab {
+            case .pokit:
+                amplitudeTrack(.view_home_pokit(entryPoint: "pokit"))
+            case .recommend:
+                amplitudeTrack(.view_home_recommend(entryPoint: "recommend"))
+            }
+            return .none
         case .binding:
             return .none
         case let .pushAlertTapped(isTapped):
@@ -197,6 +208,13 @@ private extension MainTabFeature {
                 let categoryIdString = queryItems.first(where: { $0.name == "categoryId" })?.value,
                 let categoryId = Int(categoryIdString)
             else { return .none }
+
+            switch state.selectedTab {
+            case .pokit:
+                amplitudeTrack(.view_home_pokit(entryPoint: "deeplink"))
+            case .recommend:
+                amplitudeTrack(.view_home_recommend(entryPoint: "deeplink"))
+            }
 
             return .send(.async(.공유받은_카테고리_조회(categoryId: categoryId)))
         case .경고_확인버튼_클릭:

Projects/App/Sources/MainTab/MainTabFeatureView.swift

@@ -74,10 +74,8 @@ public extension MainTabView {
                         }
 
                         if self.store.linkPopup != nil {
-                            PokitLinkPopup(
-                                type: $store.linkPopup,
-                                action: { send(.링크팝업_버튼_눌렀을때, animation: .pokitSpring) }
-                            )
+                            PokitLinkPopup(type: $store.linkPopup)
+                                .onAction { send(.링크팝업_버튼_눌렀을때, animation: .pokitSpring) }
                         }
                     }
                 }
@@ -93,11 +91,9 @@ private extension MainTabView {
             .overlay(alignment: .bottom) {
                 VStack(spacing: 0) {
                     if store.linkPopup != nil {
-                        PokitLinkPopup(
-                            type: $store.linkPopup,
-                            action: { send(.링크팝업_버튼_눌렀을때, animation: .pokitSpring) }
-                        )
-                        .padding(.bottom, 20)
+                        PokitLinkPopup(type: $store.linkPopup)
+                            .onAction { send(.링크팝업_버튼_눌렀을때, animation: .pokitSpring) }
+                            .padding(.bottom, 20)
                     }
 
                     bottomTabBar
@@ -273,7 +269,14 @@ private extension MainTabView {
 
         var body: some View {
             GeometryReader { proxy in
-                let bottomSafeArea = proxy.safeAreaInsets.bottom
+                let bottomPadding: CGFloat = {
+                    if #available(iOS 26.0, *) {
+                        return 32
+                    } else {
+                        return 48
+                    }
+                }()
+
                 HStack(spacing: 20) {
                     Spacer()
 
@@ -306,7 +309,7 @@ private extension MainTabView {
 
                     Spacer()
                 }
-                .padding(.bottom, 48 - bottomSafeArea)
+                .padding(.bottom, bottomPadding)
                 .padding(.top, 36)
                 .pokitPresentationCornerRadius()
                 .pokitPresentationBackground()
@@ -319,6 +322,7 @@ private extension MainTabView {
                 }
                 .presentationDetents([.height(self.height)])
             }
+            .ignoresSafeArea(edges: .bottom)
         }
     }
 }

Projects/App/Sources/MainTab/MainTabPath.swift

@@ -194,13 +194,13 @@ public extension MainTabFeature {
                 case .검색:
                     return .merge(
                         .send(.path(.element(id: stackElementId, action: .검색(.delegate(.컨텐츠_검색))))),
-                        .send(.inner(.링크팝업_활성화(.success(title: Constants.링크_저장_완료_문구))), animation: .pokitSpring)
+                        .send(.inner(.링크팝업_활성화(.success(title: Constants.링크_저장_완료_문구, until: 4))), animation: .pokitSpring)
                     )
                 default:
-                    return .send(.inner(.링크팝업_활성화(.success(title: Constants.링크_저장_완료_문구))), animation: .pokitSpring)
+                    return .send(.inner(.링크팝업_활성화(.success(title: Constants.링크_저장_완료_문구, until: 4))), animation: .pokitSpring)
                 }
             case .recommend(.delegate(.저장하기_완료)):
-                return .send(.inner(.링크팝업_활성화(.success(title: Constants.링크_저장_완료_문구))), animation: .pokitSpring)
+                return .send(.inner(.링크팝업_활성화(.success(title: Constants.링크_저장_완료_문구, until: 4))), animation: .pokitSpring)
             /// - 각 화면에서 링크 복사 감지했을 때 (링크 추가 및 수정 화면 제외)
             case let .path(.element(_, action: .알림함(.delegate(.linkCopyDetected(url))))),
                  let .path(.element(_, action: .검색(.delegate(.linkCopyDetected(url))))),

Projects/CoreKit/Project.swift

@@ -36,6 +36,7 @@ let coreKit: Target = .target(
         .external(name: "KakaoSDKCommon"),
         .external(name: "KakaoSDKShare"),
         .external(name: "KakaoSDKTemplate"),
+        .external(name: "AmplitudeSwift"),
     ],
     settings: .settings()
 )

Projects/CoreKit/Sources/Core/Analytics/AmplitudeManager.swift

@@ -0,0 +1,73 @@
+import Foundation
+import AmplitudeSwift
+
+/// Amplitude Analytics 관리자
+public final class AmplitudeManager {
+    public static let shared = AmplitudeManager()
+
+    private var amplitude: Amplitude?
+
+    private init() {}
+
+    /// Amplitude 초기화
+    /// - Parameters:
+    ///   - apiKey: Amplitude API Key
+    ///   - userId: 사용자 ID (옵셔널)
+    public func initialize(apiKey: String, userId: String? = nil) {
+        amplitude = Amplitude(configuration: Configuration(
+            apiKey: apiKey
+        ))
+
+        if let userId = userId {
+            setUserId(userId)
+        }
+    }
+
+    /// 사용자 ID 설정
+    /// - Parameter userId: 사용자 ID
+    public func setUserId(_ userId: String) {
+        amplitude?.setUserId(userId: userId)
+    }
+
+    /// 사용자 속성 설정
+    /// - Parameter properties: 사용자 속성
+    public func setUserProperties(_ properties: [String: Any]) {
+        let identify = Identify()
+        properties.forEach { key, value in
+            identify.set(property: key, value: value)
+        }
+        amplitude?.identify(identify: identify)
+    }
+
+    /// 이벤트 전송
+    /// - Parameter event: AnalyticsEvent
+    public func track(_ event: AnalyticsEvent) {
+        guard let amplitude = amplitude else {
+            print("⚠️ Amplitude가 초기화되지 않았습니다.")
+            return
+        }
+
+        let eventProperties = event.properties.isEmpty ? nil : event.properties
+        amplitude.track(
+            eventType: event.eventName,
+            eventProperties: eventProperties
+        )
+
+        #if DEBUG
+        print("📊 [Analytics] \(event.eventName)")
+        if let properties = eventProperties {
+            print("   Properties: \(properties)")
+        }
+        #endif
+    }
+
+    /// 이벤트 버퍼 즉시 전송
+    public func flush() {
+        amplitude?.flush()
+    }
+
+    /// Amplitude 리셋 (로그아웃 시 사용)
+    public func reset() {
+        amplitude?.reset()
+    }
+}