[Merge] #182 - pull request #187 from YAPP-Github/feat/#182-share-extension

[Feat] Share Extension을 통한 외부 앱 네컷사진 저장 기능 추가

Author: Remaked-Swain

Neki-iOS.xcodeproj/project.pbxproj

@@ -33,6 +33,7 @@ struct AppCoordinator {
             }
         }
         var pendingSessionStatus: UserSessionStatus?
+        var pendingShareAppGroupID: String?
         var lastVersionCheckedTime: Date?
 
         init() {
@@ -50,12 +51,14 @@ struct AppCoordinator {
         case onAppLaunched
         case didTapUpdateAlert
         case didTapLaterAlert
+        case onOpenURL(URL)
 
         // Internal Actions
         case splashSequenceCompleted(UserSessionStatus, AppVersionClient.VersionResult)
         case userSessionStatusChanged(UserSessionStatus)
         case scenePhaseChanged(ScenePhase)
         case backgroundVersionCheckResult(Result<AppVersionClient.VersionResult, Error>)
+        case executePendingShareExtensionIfNeeded
 
         // Binding Actions
         case binding(BindingAction<State>)
@@ -108,6 +111,16 @@ struct AppCoordinator {
                     await send(.splashSequenceCompleted(finalStatus, finalVersionResult))
                 }
 
+            case let .onOpenURL(url):
+                guard url.scheme == "neki" && url.host == "shareExtension" else { return .none }
+                guard let components = URLComponents(url: url, resolvingAgainstBaseURL: false),
+                      let appGroupID = components.queryItems?.first(where: { $0.name == "appGroupID" })?.value
+                else { return .none }
+                state.pendingShareAppGroupID = appGroupID
+                
+                guard case .mainTab = state.route else { return .none }
+                return .send(.executePendingShareExtensionIfNeeded)
+                
             case let .scenePhaseChanged(phase):
                 guard phase == .active else { return .none }
                 if state.versionAlert == .updateNeeded { return .none }
@@ -155,6 +168,12 @@ struct AppCoordinator {
 
                 return navigateToNextScreen(state: &state, sessionStatus: finalStatus)
 
+            case .executePendingShareExtensionIfNeeded:
+                guard let appGroupID = state.pendingShareAppGroupID else { return .none }
+                guard case .mainTab = state.route else { return .none }
+                state.pendingShareAppGroupID = nil
+                return .send(.route(.mainTab(.archive(.root(.addPhotoFromShareExtension(appGroupID: appGroupID))))))
+                
             case .didTapUpdateAlert:
                 // TODO: 앱스토어 URL 필요
                 return .run { _ in
@@ -204,7 +223,7 @@ struct AppCoordinator {
             case let .route(.auth(.delegate(.moveToMainTab(user)))):
                 state.$userSessionStatus.withLock { $0 = .signedIn(user) }
                 state.route = .mainTab(.init(user: user))
-                return .none
+                return .send(.executePendingShareExtensionIfNeeded)
 
             case .route(.mainTab(.delegate(.signedOut))):
                 state.$userSessionStatus.withLock { $0 = .signedOut }
@@ -237,7 +256,7 @@ struct AppCoordinator {
         switch sessionStatus {
         case .signedIn(let user):
             state.route = .mainTab(.init(user: user))
-            return .none
+            return .send(.executePendingShareExtensionIfNeeded)
 
         case .signedOut, .expired:
             if state.hasSeenOnboarding {

Neki-iOS/APP/Sources/Application/AppCoordinator.swift

@@ -25,11 +25,12 @@ struct Neki_iOSApp: App {
                 .onOpenURL { handleIncomingURL($0) }
         }
     }
-}
-
-private extension Neki_iOSApp {
-    func handleIncomingURL(_ url: URL) {
-        if url.scheme == "neki" { return }
+    
+    private func handleIncomingURL(_ url: URL) {
+        if url.scheme == "neki" {
+            store.send(.onOpenURL(url))
+            return
+        }
 
         if url.scheme == "https" || url.scheme == "http" {
             guard let host = url.host(), host == "neki.suitestudy.com" else { return }

Neki-iOS/APP/Sources/Application/Neki_iOSApp.swift

@@ -11,6 +11,7 @@ import PhotosUI
 
 public struct ImageUploadClient {
     public var upload: @Sendable (_ data: [ImageUploadEntity], _ mediaType: ImageMediaType) async throws -> [Int]
+    public var uploadConcurrentlyFromURLs: @Sendable (_ fileURLs: [URL], _ mediaType: ImageMediaType) async throws -> [Int]
     public var convert: @Sendable (_ items: [PhotosPickerItem]) async -> [ImageUploadEntity]
 }
 
@@ -22,13 +23,31 @@ extension ImageUploadClient: DependencyKey {
             upload: { items, mediaType in
                 return try await repository.upload(items: items, mediaType: mediaType)
             },
+            
+            uploadConcurrentlyFromURLs: { fileURLs, mediaType in
+                var uploadedMediaIDs: [Int] = []
+                let chunkSize: Int = 3
+                let chunks = stride(from: 0, to: fileURLs.count, by: chunkSize).map { Array(fileURLs[$0..<min($0 + chunkSize, fileURLs.count)]) }
+                
+                for chunk in chunks {
+                    var entities: [ImageUploadEntity] = []
+                    for url in chunk {
+                        let data = try Data(contentsOf: url)
+                        entities.append(ImageUploadEntity(data: data, format: data.detectedImageFormat))
+                    }
+                    
+                    let resultIDs = try await repository.upload(items: entities, mediaType: mediaType)
+                    uploadedMediaIDs.append(contentsOf: resultIDs)
+                }
+                return uploadedMediaIDs
+            },
+            
             convert: { items in
                 await withTaskGroup(of: ImageUploadEntity?.self) { group in
                     for item in items {
                         group.addTask {
                             guard let data = try? await item.loadTransferable(type: Data.self) else { return nil }
-                            let format = data.detectedImageFormat
-                            return ImageUploadEntity(data: data, format: format)
+                            return ImageUploadEntity(data: data, format: data.detectedImageFormat)
                         }
                     }
 
@@ -37,7 +56,6 @@ extension ImageUploadClient: DependencyKey {
                         guard let result else { continue }
                         results.append(result)
                     }
-                    
                     return results
                 }
             }

Neki-iOS/Core/Sources/ImagePicker/Domain/ImageUploadClient.swift

@@ -0,0 +1,61 @@
+//
+//  FileManagerSharedImageRepository.swift
+//  Neki-iOS
+//
+//  Created by SwainYun on 3/20/26.
+//
+
+import Foundation
+import Dependencies
+import DependenciesMacros
+import UniformTypeIdentifiers
+import os
+
+public struct FileManagerSharedImageRepository {
+    private let fileManager: FileManager
+    
+    public init(fileManager: FileManager = .default) { self.fileManager = fileManager }
+    
+    private func sharedImageURLs(for appGroupID: String) throws -> [URL] {
+        guard let groupURL = fileManager.containerURL(forSecurityApplicationGroupIdentifier: appGroupID) else { return [] }
+        let sharedDirectoryURL = groupURL.appendingPathComponent("SharedImages", conformingTo: .directory)
+        
+        guard fileManager.fileExists(atPath: sharedDirectoryURL.path()) else { return [] }
+        return try fileManager.contentsOfDirectory(at: sharedDirectoryURL, includingPropertiesForKeys: nil)
+    }
+}
+
+
+// MARK: - FileManagerSharedImageRepository + SharedImageRepository
+
+extension FileManagerSharedImageRepository: SharedImageRepository {
+    public func fetchSharedImageURLs(appGroupID: String) async throws -> [URL] {
+        return try sharedImageURLs(for: appGroupID)
+    }
+    
+    public func clearSharedImages(appGroupID: String) async throws {
+        let fileURLs = try sharedImageURLs(for: appGroupID)
+        
+        for url in fileURLs {
+            do {
+                try fileManager.removeItem(at: url)
+            } catch {
+                Logger.data.error("파일 정리 실패: \(url.lastPathComponent) - \(error.localizedDescription)")
+            }
+        }
+    }
+}
+
+
+// MARK: - Dependency
+
+private enum SharedImageRepositoryKey: DependencyKey {
+    static let liveValue: SharedImageRepository = FileManagerSharedImageRepository()
+}
+
+extension DependencyValues {
+    var sharedImageRepository: SharedImageRepository {
+        get { self[SharedImageRepositoryKey.self] }
+        set { self[SharedImageRepositoryKey.self] = newValue }
+    }
+}

Neki-iOS/Features/Archive/Sources/Data/Sources/FileManagerSharedImageRepository.swift

@@ -0,0 +1,35 @@
+//
+//  SharedImageClient.swift
+//  Neki-iOS
+//
+//  Created by SwainYun on 3/20/26.
+//
+
+import Foundation
+import Dependencies
+import DependenciesMacros
+
+@DependencyClient
+public struct SharedImageClient {
+    public var fetchSharedImageURLs: @Sendable (_ appGroupID: String) async throws -> [URL]
+    public var clearSharedImages: @Sendable (_ appGroupID: String) async throws -> Void
+}
+
+extension SharedImageClient: DependencyKey {
+    public static let liveValue: SharedImageClient = {
+        @Dependency(\.sharedImageRepository) var sharedImageRepository
+        
+        return SharedImageClient { appGroupID in
+            try await sharedImageRepository.fetchSharedImageURLs(appGroupID: appGroupID)
+        } clearSharedImages: { appGroupID in
+            try await sharedImageRepository.clearSharedImages(appGroupID: appGroupID)
+        }
+    }()
+}
+
+extension DependencyValues {
+    public var sharedImageClient: SharedImageClient {
+        get { self[SharedImageClient.self] }
+        set { self[SharedImageClient.self] = newValue }
+    }
+}

Neki-iOS/Features/Archive/Sources/Domain/Sources/Client/SharedImageClient.swift

@@ -0,0 +1,13 @@
+//
+//  SharedImageRepository.swift
+//  Neki-iOS
+//
+//  Created by SwainYun on 3/20/26.
+//
+
+import Foundation
+
+public protocol SharedImageRepository {
+    func fetchSharedImageURLs(appGroupID: String) async throws -> [URL]
+    func clearSharedImages(appGroupID: String) async throws
+}

Neki-iOS/Features/Archive/Sources/Domain/Sources/Interfaces/Repositories/SharedImageRepository.swift

@@ -69,6 +69,7 @@ struct ArchiveFeature {
         case albumsResponse(Result<[AlbumItem], Error>)
         case favoriteAlbumResponse(Result<AlbumItem, Error>)
         case photoListResponse(Result<[PhotoEntity], Error>)
+        case uploadSharedImagesResponse(Result<[Int], Error>)
 
         // Image Upload Action
         case imagePicker(ImagePickerFeature.Action)
@@ -85,6 +86,8 @@ struct ArchiveFeature {
         // Internal Action
         case addPhotoFromQRScanner(imageID: Int)
         case processUploadImages(imageIDs: [Int])
+        case addPhotoFromShareExtension(appGroupID: String)
+        case cleanSharedImages(appGroupID: String)
 
         // Delegate Action
         case delegate(DelegateAction)
@@ -95,6 +98,8 @@ struct ArchiveFeature {
     }
 
     @Dependency(\.archiveClient) var archiveClient
+    @Dependency(\.imageUploadClient) var imageUploadClient
+    @Dependency(\.sharedImageClient) var sharedImageClient
 
     var body: some ReducerOf<Self> {
         BindingReducer()
@@ -282,6 +287,31 @@ struct ArchiveFeature {
                 state.selectUploadAlbum = SelectUploadAlbumFeature.State(uploadedImageIds: imageIDs, albums: state.albums)
                 return .none
 
+            case let .addPhotoFromShareExtension(appGroupID):
+                state.isLoading = true
+                return .run { send in
+                    do {
+                        let fileURLs = try await sharedImageClient.fetchSharedImageURLs(appGroupID: appGroupID)
+                        
+                        guard fileURLs.isEmpty == false else {
+                            await send(.delegate(.showToast(NekiToastItem("가져올 수 있는 이미지가 없어요.", style: .error))))
+                            await send(.uploadSharedImagesResponse(.failure(UploadError.uploadFailed)))
+                            return
+                        }
+                        
+                        let uploadedMediaIDs = try await imageUploadClient.uploadConcurrentlyFromURLs(fileURLs, .photoBooth)
+                        
+                        await send(.cleanSharedImages(appGroupID: appGroupID))
+                        await send(.uploadSharedImagesResponse(.success(uploadedMediaIDs)))
+                        
+                    } catch {
+                        Logger.presentation.error("공유 확장 이미지 업로드 에러: \(error)")
+                        
+                        await send(.cleanSharedImages(appGroupID: appGroupID))
+                        await send(.uploadSharedImagesResponse(.failure(error)))
+                    }
+                }
+                
             case let .selectUploadAlbum(.presented(.delegate(delegateAction))):
                 switch delegateAction {
                 case let .uploadDidSuccess(albumId):
@@ -322,6 +352,22 @@ struct ArchiveFeature {
                     await send(.delegate(.showToast(NekiToastItem("사진 등록에 실패했어요", style: .error))))
                 }
 
+            case let .cleanSharedImages(appGroupID):
+                return .run { send in
+                    do {
+                        try await sharedImageClient.clearSharedImages(appGroupID: appGroupID)
+                    } catch {
+                        Logger.presentation.error("임시 파일 정리 실패: \(error)")
+                    }
+                }
+                
+            case let .uploadSharedImagesResponse(.success(imageIDs)):
+                return .send(.processUploadImages(imageIDs: imageIDs))
+                
+            case .uploadSharedImagesResponse(.failure):
+                state.isLoading = false
+                return .send(.delegate(.showToast(NekiToastItem("업로드에 실패했어요", style: .error))))
+                
                 // MARK: - Binding
 
             case .binding(\.newAlbumTitle):

Neki-iOS/Features/Archive/Sources/Presentation/Sources/Feature/ArchiveFeature.swift

@@ -10,5 +10,9 @@
 	<array>
 		<string>applinks:neki.suitestudy.com</string>
 	</array>
+	<key>com.apple.security.application-groups</key>
+	<array>
+		<string>group.com.Neki-dev.Share-Extension</string>
+	</array>
 </dict>
 </plist>

Neki-iOS/Neki-iOS.entitlements Neki-iOS/Neki-iOS-Debug.entitlementsNeki-iOS/Neki-iOS.entitlements renamed to Neki-iOS/Neki-iOS-Debug.entitlements

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>com.apple.developer.applesignin</key>
+	<array>
+		<string>Default</string>
+	</array>
+	<key>com.apple.developer.associated-domains</key>
+	<array>
+		<string>applinks:neki.suitestudy.com</string>
+	</array>
+	<key>com.apple.security.application-groups</key>
+	<array>
+		<string>group.com.OneTen.Neki-iOS.Share-Extension</string>
+	</array>
+</dict>
+</plist>