csj.iOS

WebSocket

성재's — Tue, 30 Jul 2024 16:21:09 +0900

Notion 정리 링크

https://trusting-turnip-6f9.notion.site/WebSocket-f46c2d9a192d4e4e842f15ded8c89f0b?pvs=4

WebSocket | Notion

WebSocket 이란?

trusting-turnip-6f9.notion.site

ReactorKit

성재's — Tue, 30 Jul 2024 16:19:27 +0900

Notion 정리 링크

https://trusting-turnip-6f9.notion.site/ReactorKit-73e6c6bffcf448e78910676867d49a97?pvs=4

ReactorKit | Notion

ReactorKit

trusting-turnip-6f9.notion.site

FlexLayout & PinLayout

성재's — Tue, 30 Jul 2024 16:16:35 +0900

Notion 정리 링크

https://trusting-turnip-6f9.notion.site/FlexLayout-PinLayout-d06ad6c9957341cdafb85e6a6e3ebfa7?pvs=4

FlexLayout & PinLayout | Notion

FlexLayout

trusting-turnip-6f9.notion.site

WWDC 2024

성재's — Tue, 30 Jul 2024 16:15:44 +0900

Notion 정리 링크

https://trusting-turnip-6f9.notion.site/WWDC-2024-1-95b9002531dd438a8b93be8d20a0467b?pvs=4

WWDC 2024 (1) | Notion

New Swift 6

trusting-turnip-6f9.notion.site

https://trusting-turnip-6f9.notion.site/WWDC-2024-2-7ea025c3b1764cf28580294351ac8095?pvs=4

WWDC 2024 (2) | Notion

trusting-turnip-6f9.notion.site

Privacy Manifest

성재's — Tue, 30 Jul 2024 16:14:32 +0900

Notion 정리 링크

https://trusting-turnip-6f9.notion.site/Privacy-Manifest-1501c11ae30e417999b1cae3f50c6154

Privacy Manifest | Notion

What?

trusting-turnip-6f9.notion.site

iOS [Swift] - DispatchGroup

성재's — Mon, 8 May 2023 13:55:08 +0900

DispatchGroup

DispatchQueue는 Tread를 Safe하게 관리할 수 있는 도구이다.
특징
- DispatchQueue들을 Group으로 묶어서 trailing closure를 할 수 있도록 한다.
- 서로 다른 성격의 Queue들을 Group으로 묶어서 사용 가능하다.
- enter와 leave의 위치를 작업 단위로 설정하여 개발자가 원하는 작업의 범위를 지정할 수 있다. 아래 예시는 for문 한 사이클을 1작업으로 두고 enter & leave를 했지만, for문 밖에 enter & leave를 한다면 총 1쌍으로 notify를 보낼 수 있다.
예시

let dispatchGroup = DispatchGroup()

func queueTask(number: Int,
            completionHandler: @escaping (String) -> Void) {

  // 여기서 시간이 지연되는 작업이 있어도 끝날 때까지 Wait
//  sleep(2)
  completionHandler("Number \(number) is Entered.")
}

for i in 0..<10 {
  dispatchGroup.enter()
  print("")
  print("=========== dispatchGroup.enter(\(i)) ===========")
  print("")
  queueTask(number: i) { text in
    print(text)
    
    dispatchGroup.leave()
    print("")
    print("=========== dispatchGroup.leave(\(i)) ===========")
    print("")
    print("_________________________________________________")
    print("")
  }
}

dispatchGroup.notify(queue: .main) {
  print("This is Dispatch Group Notify")
}


// 출력 결과
/**

=========== dispatchGroup.enter(0) ===========

Number 0 is Entered.

=========== dispatchGroup.leave(0) ===========

_________________________________________________


=========== dispatchGroup.enter(1) ===========

Number 1 is Entered.

=========== dispatchGroup.leave(1) ===========

_________________________________________________

...
...
... 

_________________________________________________


=========== dispatchGroup.enter(9) ===========

Number 9 is Entered.

=========== dispatchGroup.leave(9) ===========

_________________________________________________

This is Dispatch Group Notify

 */

iOS [Swift] - Keychain 정리

성재's — Tue, 14 Feb 2023 16:00:29 +0900

Keychain 개념

Apple에서 공식적으로 제공하고 있는 보안 프레임워크

암호화된 Data Base

사용자의 민감한 데이터를 저장

UserDefaults는 App이 삭제되면 같이 삭제되지만, Keychain은 그와 반대로 App이 삭제돼도 데이터 유지

Keychain은 중복된 값을 새로운 값이 자동으로 덮어씌우지 못함. 따라서 항상 기존의 값을 삭제 해주어야 함

Keychain Item

Keychain에 데이터를 저장할 때, 데이터를 Wrapping해서 Item형태로 저장

Data & Attribute 형태 → Item

Attribute를 통해 데이터를 검색 및 접근

Keychain 속성(kSecClass)

kSecClass : 저장된 Item이 어떤 정보를 가지고 있는지 나타낸다.

각 암호화 데이터 별로 다른 Attribute를 가진다.

k- 접두어는 [konstant = constant] 이므로 붙는다.

kSecClassGenericPassword : 일반 암호 항목

kSecClassInternetPassword : 인터넷 비밀 항목

kSecClassCertificate : 인증서 항목

kSecClassIdentity : 아이디 항목

kSecClassKey : 암호화 키 항목

kSecClass : 데이터 종류 지정

kSecAttrAccount : 데이터 저장하기 위한 Key 입력 [개인키]

kSecAttrService: 데이터 저장하기 위한 Key 입력 [공개키]

kSecValueData : 저장할 데이터를 Data Type으로 캐스팅, 실제 저장할 값

kSecReturnAttributes : 값이 항목 속성을 반환하는 것에 대한 여부

kSecReturnData : 값이 항목 데이터를 반환하는 것에 대한 여부

kSecValueData : update할 value

〰️ 등 등 더 많은 속성은 공식 문서를 통해 확인할 수 있습니다 〰️

Keychain 사용

SecItemAdd

SecItemAdd 메소드를 호출하고 Keychain에 Dictionary를 추가

결과 값으로 Bool Type 반환됨

중복된 Key 값으로 추가될 경우에는 이 전 값을 삭제하던가 updateItem해서 업데이트 해준다.

func addItem(id: Any, password: Any) -> Bool {
    // Keychain Query 정의
    let addQuery: [CFString: Any] = [kSecClass: kSecClassGenericPassword,
                               kSecAttrAccount: id,
                                 kSecValueData: (password as AnyObject).data(using: String.Encoding.utf8.rawValue) as Any]
    
    let result: Bool = {
      let status = SecItemAdd(addQuery as CFDictionary, nil)
      if status == errSecSuccess {
        return true
      } else if status == errSecDuplicateItem {
        return updateItem(value: pwd, key: id)
      }
      
      print("addItem Error : \(status.description))")
      return false
    }()
    
    return result
  }

SecItemCopyMatching

SecItemCopyMatching 메소드 호출하고 Keychain에 Key값을 조회

결과 값으로는 원하는 형태로 Data를 캐스팅하여 반환

func readItems(key: Any) -> String? {
    let query: [CFString: Any] = [kSecClass: kSecClassGenericPassword,
                            kSecAttrAccount: key,
                       kSecReturnAttributes: true,
                             kSecReturnData: true]
    var item: CFTypeRef?
    let result = SecItemCopyMatching(query as CFDictionary, &item)
    
    if result == errSecSuccess {
      if let existingItem = item as? [String: Any],
         let data = existingItem[kSecValueData as String] as? Data,
         let password = String(data: data, encoding: .utf8) {
        return password
      }
    }
    
    print("readItems Error : \(result.description)")
    return nil
  }

SecItemUpdate

SecItemUpdate 메소드 호출하고 update된 결과 값을 반환

update할 상황은 Key값이 동일한 상태에서 Value를 최신화 시켜주는 것

따라서, 직전의 Keychain Query 정보를 Dictionary 형태로 담아주고 Update할 Query Dictionary와 함께 SecItemUpdate에 전달

func updateItem(value: Any, key: Any) -> Bool {
    let previousQuery: [CFString: Any] = [kSecClass: kSecClassGenericPassword,
                                    kSecAttrAccount: key]
    let updateQuery: [CFString: Any] = [kSecValueData: (value as AnyObject).data(using: String.Encoding.utf8.rawValue) as Any]
    
    let result: Bool = {
      let status = SecItemUpdate(previousQuery as CFDictionary, updateQuery as CFDictionary)
      if status == errSecSuccess { return true }
      
      print("updateItem Error : \(status.description)")
      return false
    }()
    
    return result
  }

SecItemDelete

Keychain 삭제를 위한 Query를 작성하고 SecItemDelete 메소드 호출

매칭되는 Key 값의 Keychain을 Update하여 결과 값을 반환

func deleteItem(key: String) -> Bool {
    let deleteQuery: [CFString: Any] = [kSecClass: kSecClassGenericPassword,
                                  kSecAttrAccount: key]
    let status = SecItemDelete(deleteQuery as CFDictionary)
    if status == errSecSuccess { return true }
    
    print("deleteItem Error : \(status.description)")
    return false
  }

ViewController.swift

override func viewDidLoad() {
    super.viewDidLoad()
    
    if KeyChain.shared.addItem(id: "honggildong", pwd: "141433") {
      valueLabel.text = "addItem Success!!!"
      print("addItem Success!!!")
    }
  }

@IBAction func tapOnButton(_ sender: Any) {
    
    if KeyChain.shared.deleteItem(key: "honggildong") {
      valueLabel.text = "삭제 성공"
    }
  }

viewDidLoad()에서 addItem하고 성공하면 label Text 변경

버튼 클릭하면 deleteItem을 하여 키체인 정보 삭제 후 label Text 변경

Keychain Error Codes

Error Code	Error Value	Error Description
errSecSuccess	0	No error encountered 오류가 발생하지 않았습니다.
errSecUnimplemented	-4	Function or operation not implemented 구현되지 않은 기능 및 작업이 있습니다.
errSecParam	-50	One or more parameters passed to the function were not valid 함수에 전달된 하나 이상의 매개변수가 유효하지 않습니다.
errSecAllocate	-108	Failed to allocate memory 메모리 할당에 실패 하였습니다.
errSecNotAvailable	-25291	No trust results are available 신뢰할 수 있는 결과가 없습니다.
errSecAuthFailed	-25293	Authorization / authentication Failed 승인 / 인증 실패 하였습니다.
errSecDuplicateItem	-25299	The item already exists 항목이 이미 존재합니다.
errSecItemNotFound	-25300	The item cannot be found 항목을 찾을 수 없습니다.
errSecInteractionNotAllowed	-25308	Interaction with the Security Server is no allowed 보안 서버와의 상호 작용이 허용되지 않습니다.
errSecDecode	-26275	Unable to decode the provided data 제공된 데이터를 디코딩할 수 없습니다.

Keychain OpenSource

KeychainSwift

위와 같이 Apple에서 기본적으로 제공해주는 메소드들만으로도 Keychain을 구성할 수 있다.

하지만, 더욱 간편하게 사용할 수 있는 오픈소스가 있다.

Podfile에 KeychainSwift를 install 해준다.

프로젝트를 열고 KeychainSwift를 import & 인스턴스 생성을 한다.

인스턴스를 통해 get, set, delete, clear 등의 메소드를 사용한다.

자세한 내용은 Github Page를 통해 안내하겠습니다.

번외 및 마무리

Keychain라고 해서 무조건 앱을 삭제해도 데이터가 유지되는 것은 아니다.

iOS 10.3.3 이상 기기에서 iTunes & iCloud 백업 / 복원을 했을 때, 사라지는 현상이 발생한다고 한다.

iTunes 백업 / 복원 상황에서는 kSecAttrAccessible 설정을 해주면 사라지지 않을 수 있다.

다만, iCloud 백업 / 복원 상황에서 사용자가 iCloud 설정 > Keychain 백업 옵션을 OFF 해놓았다면, 삭제될 수 있다.

확실한 암호화 & 복호화 방법을 사용하는 솔루션을 사용하거나, 서버를 이용하는 것이 보다 안전할 것이라고 생각한다.

위에 작성한 예시들 뿐만 아니라, 다른 Class Type들은 어떻게 사용할 수 있을지에 대한 고민도 필요하다고 생각한다.

References

Apple Document

Apple Developer Documentation

https://developer.apple.com/documentation/security/keychain_services

⚠️ Error Codes

iOS Components and Frameworks: Understanding the Advanced Features of the iOS SDK

Keychain Error Codes The Keychain can return several specialized error codes depending on any issues encountered at runtime. These errors are described in Table 18.3. Table 18.3 Keychain Error ... - Selection from iOS Components and Frameworks: Understanding the Advanced Features of the iOS SDK [Book]

https://www.oreilly.com/library/view/ios-components-and/9780133086898/ch18lev2sec7.html

Open Source

https://github.com/evgenyneu/keychain-swift

Keychain Example

[iOS] 키체인 (Keychain Service)

안녕하세요~ 차니에요! 오늘은 키체인에 대해 알아보겠습니다~~! 1. 키체인이란? Apple에서 공식으로 제공하는 보안 프레임워크이며, 사용자의 민감한(개인 정보 등) 데이터들을 저장하는 저장소입니다. 키체인은 사용자가 직접 제거하지 않는 한, 앱을 제거해도 키체인 데이터는 남아있고 디바이스가 lock되면 키체인도 함께 lock되며 디바이스가 unlock되면 키체인도 unlock된다는 특징이 있습니다. 키체인은 하나 이상의 Keychain Item을 갖습니다.

https://dvlpr-chan.tistory.com/27

Uploaded by N2T

iOS [Swift] - OAuth 개념 스터디

성재's — Tue, 14 Feb 2023 15:56:04 +0900

개념

Third Party Application의 인증 권한 부여 및 관리를 위해 사용하는 것이다.

외부 사이트에 저장된 자신의 정보에 대해 접근 권한을 부여할 수 있는 공통 수단으로 사용된다. 개방형 표준

OAuth 기반 서버에서 인증이 필요한 API를 호출할 때는 OAuth 토큰을 반드시 이용한다.

외부 SNS 계정을 기반으로 간편 회원가입 & 로그인을 할 수 있게 해주는 역할을 한다.

뿐만 아니라, 외부 App에서 제공하는 기능들을 사용할 수 있다. [기타 Api]
- Google 로그인 → API 통신 → 사용자 Google Calendar 정보 열람

장점 : 사용자가 다른 애플리케이션에서 사용하고 있는 서비스의 정보를 가공하여 보다 가치 있는 결과물을 제공할 수 있다.

Authentication(인증) / Authorization(허가)

일반 로그인 : 아이디 & 비밀번호를 통해 인증을 하는 것

OAuth 로그인 : 타 App의 정보에 접근하기 위해 우리의 App이 허락받아 사용자 인증을 하는 것

OAuth Actor

Resource Server : Client가 제어할 자원(resource)을 보유한 서버
- Twitter, Google, Facebook 등 사용자의 Api를 제공하는 타 App

Resource Owner : 자원(resource) 소유자
- 로그인을 행하는 실제 사용자

Client : Resource Server에 접속해서 정보를 가져오는 대상 (Web Application)
- 다시 말해, 사용자가 사용하고자 하는 우리가 만든 서비스

OAuth [Client - Server]

요약 : Client에서 Server의 Token을 받고, 그 Token을 가지고 다시 Server에 요청해서 원하는 자원을 획득할 수 있다.

Token의 종류
- Access Token : 요청 절차를 정상적으로 종료한 Client에게 발급 (시간 제한 있음)
- Refresh Token : "Resource Server"가 아니라 "Authorization Server"에서만 사용 가능 (시간 제한 없음)
- Token은 Apple의 Keychain 저장소에 저장한다. 자세한 내용은 여기

Flow
1. MyApp(Client)이 Facebook(Resource Server)에 API를 사용하겠다고 등록 요청합니다.
1. Facebook(Resource Server)은 MyApp(Client)를 식별할 수 있는 Client ID & Secret을 발급해줍니다.
1. 사용자(Resource Owner)는 MyApp(Client)에서 Facebook 로그인을 요청합니다.
1. MyApp(Client)은 사용자(Resource Owner)에게 Facebook(Resource Server) 로그인 화면을 띄워줍니다.
1. 사용자(Resource Owner)는 MyApp(Client)이 Facebook(Resource Server) 자신의 정보에 접근해도 괜찮은지에 대한 동의를 받습니다. ("MyApp에서 당신의 Facebook 정보를 사용해도 괜찮겠습니까?")
  1. 사용자가 MyApp에게 Facebook 권한을 허용했을 때
    1. Facebook(Resource Server)은 MyApp(Client)에게 암호화 코드를 제공합니다.
    1. MyApp(Client)은 2번에서 발급 받은 Client ID & Secret을 암호화 코드와 함께 Facebook(Resource Server)으로 다시 보냅니다.
    1. Facebook(Resource Server)은 암호화 코드, Client ID & Secret이 모두 자신이 제공한 것과 일치한다고 판단했을 때, 최종 접근 권한 부여의 의미로 Access Token을 발급해줍니다.
  1. 사용자가 MyApp에게 Facebook 권한을 거부했을 때
    1. Facebook 로그인 정보에 대한 접근이 없기 때문에 로그인이 불가합니다.

용어 정리

Web Application

웹 브라우저와 웹 기술을 사용하여 사용자와 소통할 수 있도록 만든 컴퓨터 프로그램

Web Container

동적인 처리를 담당한다. Servlet Container라고도 하며 JSP, Servlet을 실행할 수 있는 프로그램이다. JSP, Servlet은 웹 서버로부터 받은 동적인 데이터를 처리하여 정적인 페이지를 생성한다. 하지만, Web Container는 웹 서버로부터 받은 정보로 동적 페이지를 생성하여 웹 서버에게 전달해줄 수 있다.

Web Application Server (WAS)

Web Server + Web Container, 정적인 페이지(HTML)에서 처리할 수 없는 Business Logic, DB 조회 등 동적인 컨텐츠를 제공한다.톰캣

[웹 서버는 정적 처리, WAS는 동적 처리]를 같이 사용하면, 서버 부하를 막으면서 물리적인 분리를 통해 보안을 강화할 수 있다.

Uploaded by N2T

iOS [Swift] - Moya를 통한 네트워크 통신

성재's — Tue, 14 Feb 2023 15:08:28 +0900

iOS에서 네트워크 작업이라고 하면 가장 떠오르는 URLSession, Alamofire가 있을 것이다. URLSession은 프로젝트의 복잡도가 올라가고 가독성이 안좋은 반면, URLSession 기반의 Alamofire는 보다 간결하고 가독성이 좋다. 하지만, Alamofire는 유지보수 & 테스트에 적합하다고 확언할 수 없다. 그래서 오늘의 주제 Moya를 살펴볼 것이다.

개념

URLSession을 추상화 시킨 Alamofire를 한 번 더 추상화시킨 Networking Library이다.

Enum(열거형)을 사용해서 네트워크 요청을 type-safe한 방식으로 캡슐화한다. (안전 & 깔끔)
- type-safe
  - 해당 Type에는 정해진 Type만 저장이 가능하다. 라는 의미 (다른 Type 안돼!! ❌)
  - 즉, 변수의 Type이 명확해진다.

특징

Alamofire에서 네트워크 계층을 구조화하는 방법과는 다른 방법을 제공한다.

Alamofire Library를 Enum 타입으로 만들어 더 사용성과 테스트성을 용이하게 만들었다.
- Enum이기 때문에 Type 지정을 해주기 편하다.

기존 네트워킹 방식 VS Moya
- 기존 네트워킹 사용법은 왼쪽 그림처럼 Network Layer를 통해 자유롭게 구현되고 있다.
- 따라서, 기존 네트워킹 방식은 다음과 같은 문제점들을 가지고 있었다.
  - 새 App을 작성하기 어렵다.(어디서부터 시작해야하는가?)
  - 기존 App을 유지하기 어렵게 만든다.(아놔, 너무 엉망 진창이네..)
  - 단위 테스트를 작성하기 어렵게 만든다.(이 작업을 다시 하려면 어떻게 해야해?)
- Moya는 오른쪽 그림처럼 보다 깔끔한 Layer를 통해 자체적으로 네트워킹을하지 않고 Alamofire를 통해 구현된다.
- 뿐만 아니라, Network Layer를 Template화 시켜서 재사용이 가능하다.

Moya의 장점
- 올바른 API 엔드포인트 액세스를 위한 컴파일 시간 검사.
- 연결된 열거형 값을 사용하여 다양한 엔드포인트의 명확한 사용법을 정의할 수 있습니다.
- 테스트 스텁을 일급 시민으로 취급하므로 단위 테스트가 매우 쉽습니다.

Flow (정말 간단하게만 사용법 익히기)

Pod 설치
1. pod init
1. pod install
```
pod 'Moya', '~> 15.0'
```

API 통신을 위한 Moya > TargetType을 정의

import Foundation
import Moya

enum APIClient {
  case users, todos, comments
}

extension APIClient: TargetType {
  var baseURL: URL {
    switch self {
    case .users, .todos, .comments:
      return URL(string: "https://jsonplaceholder.typicode.com/")!
    }
  }
  
  var path: String {
    switch self {
    case .users:
      return "users"
    case .todos:
      return "todos"
    case .comments:
      return "comments"
    }
  }
  
  var method: Moya.Method {
    switch self {
    case .users, .todos, .comments:
      return .get
    }
  }
  
  var task: Moya.Task {
    switch self {
    case .users:
      return .requestPlain
    case .todos:
      return .requestPlain
    case .comments:
      return .requestPlain
    }
  }
  
  var headers: [String : String]? {
    return ["Content-type": "application/json"]
  }
}

Json Model Struct 작성

struct Todos: Codable {
  var userId: Int
  var id: Int
  var title: String
  var completed: Bool
}

API 통신

func getDataFromJsonPlaceHolder() {
    let moyaProvider = MoyaProvider<APIClient>()
    
    moyaProvider.request(.todos) { result in
      switch result {
      case .success(let response):
//        guard let todoTitle = try? response.mapJSON() else { return }
        guard let todo = try? response.map([Todos].self) else { return }
        self.labelText.text = todo[Int.random(in: 1..<10)].title
      case .failure(let moyaError):
        print(moyaError.errorDescription ?? "Moya API Request Error")
      }
    }
  }

마무리

URLSession & Alamofire VS Moya 차이점
- 기존에 사용해봤던 URLSession과 Alamofire는 request/response를 하면서 동시에 여러가지(url, method 등)를 신경 써야했다. (사용할 때마다 반복 작성)
- Moya를 공부하고 사용해보면서 하나의 타입을 다 정의 해줘야한다는 작업이 조금(?)은 귀찮을 수 있지만, 같은 API를 많이 사용하게 되는 프로젝트라면 사용하는게 좋다고 생각됐다.
- 아무래도 같은 API에 대해서 반복적으로 같은 코드를 작성하는 것은 비효율적일 수 있다. 또한, 데이터 처리하는 과정에서 어쩌면 집중도를 떨어뜨리는 요인이 될 수 있다고 생각한다.
- Moya의 TargetType에서 여러가지 항목들을 미리 작성해놓고, 반복적으로 사용되는 부분을 재사용한다면 데이터 처리하는 과정에서 보다 집중도 있고 가독성이 좋은 코드를 작성할 수 있다고 생각한다.

오히려 내가 지금 반복적으로 말하고 있긴하지만 ㅋㅋ 아무튼간!! Moya는 상황에 따라 맞춰 필요한 프로젝트에 적용하면 좋을 것 같다.

그리고 Moya를 좀 더 효율적으로 쓰기 위해선 CommonMoyaProvider를 만들어서 모든 API 코드에 적용하는 것이 좋다고 생각한다.
- ex) 모든 api response에 중복 로그인 에러 처리를 하는 반복적인 코드를 작성하지 않기 위해 Custom 해주는 것.
- CommonMoyaProvider에는 Moya TargetType을 가진 API들을 모두 담아 사용할 수 있도록 Generic 형태로 사용하는 것이 좋다. CommonMoyaProvider<T: TargetType>

막 네트워크 통신을 위해서 Moya는 쓰는게 진짜 좋아!! 이정도의 메리트는 아닌 느낌이 들었다. 그러나 분명히 쓰임새가 좋고 활용도가 높은건 확실!하다. 코드도 간결해지고..?

이번 포스팅 끝!

References

iOS Networking and Testing | 우아한형제들 기술블로그

Networking은 요즘 앱에서 거의 필수적인 요소입니다. 설치되어 있는 앱들 중에 네트워킹을 사용하지 않는 앱은 거의 없을 겁니다. API 추가가 쉽고 변경이 용이한 네트워킹 모듈을 개발하는것이 중요한 이유죠. 미드 보셨나요? 쉘든 쿠퍼 라는 주인공은 16살에 박사학위를 취득할 만큼 천재이면서 동시에 대단히 특이한 사람입니다. 주변에서 "Are you crazy?" 라는 말을 자주 듣습니다.

https://techblog.woowahan.com/2704/

Uploaded by N2T

iOS [Swift] - FileManager를 이용해서 파일 다운로드 후 저장하기

성재's — Wed, 18 Jan 2023 13:21:34 +0900

내용을 살펴보기에 앞서 Apple 공식 문서에 정의된 FileManager에 대해 짚고 넘어가보겠습니다 :)

FileManager

FileManager Class는 shared file manager object에 편리한 접근을 제공합니다.
File manager object는 일반적으로 파일 시스템과 상호 작용하는 것을 기본 모드로 합니다.
따라서, 저희는 이를 통해 파일 & 디렉토리를 찾고, 만들고, 복사하고, 이동할 수 있습니다.
그리고 또 파일 & 디렉토리에 대한 정보를 얻거나 속성의 일부를 변경할 때 사용할 수 있습니다.

만약에 파일이나 디렉토리를 이동, 복사, 연결, 제거하는 경우 file manager object와 함께 delegate를 사용하여 작업 관리를 할 수 있습니다. delegate의 역할은 작업을 확인하고, 오류가 발생할 때 진행할지 말지에 대한 여부를 결정하는 것입니다.
iOS 5.0 이상 & macOS 10.7 이상에서 FileManager에는 iCloud에 저장된 항목을 관리하는 메서드가 포함되어 있습니다.
따라서, cloud 저장소로 태그가 지정된 파일이나 디렉토리는 iCloud에 동기화돼서 사용자의 iOS 장비나 mac에서 사용할 수 있습니다.

이제 FileManager에 대한 개념을 살펴 보았으니 다음 단계로 진행해보겠습니다. ㅎㅎ

저는 "회사 자산 관리 시스템의 매뉴얼 ppt" 다운로드를 FileManager를 사용해서 아이폰 > 파일 에 저장해보도록 할 것입니다.

따라서, ppt를 다운로드 하는 과정은 Alamofire를 이용할 것이고, 다운로드 된 파일의 경로 설정은 FileManager를 이용할 것입니다.

가장 먼저!! 우리는 FileManager를 통해 내 휴대폰의 경로를 찾아내고 그 곳에 파일을 생성하거나 수정하거나 다운로드 할 것이기 때문에..

info.plist에 그것의 사용에 대한 permission(?)을 YES로 설정해주어야 합니다. (Alamofire를 위해 네트워크 설정하는 것은 또 별도이기 때문에 그 것에 대한 설정도 추가해주시길 바랍니다. ㅎㅎ)

SO!! 다음과 같이 값을 추가해주세용. (mac에서 휴대폰 연결하고 파일에서도 확인하고 싶으시다면, Application supports iTunes file sharing -> YES 처리 해주세용)

이제 준비는 마쳤고, 코드를 살펴 보겠습니다.

아래 코드는 download~~(url: URL, fileName: String, completion: @escaping () -> Void) 형태의 메소드로 감싸져 있는 점 참고 부탁드립니다 :)

    // FileManager의 인스턴스를 생성합니다.
    let fileManager = FileManager.default
    
    // 사용자 기기의 document 디렉토리의 경로를 가져온다. 
    // 인자의 for 부분을 통해 다양한 디렉토리에 대한 경로를 가져올 수 있으니 SearchPathDirectory 키워드를 참고하시면 좋을 것 같습니다. :)
    let appURL = fileManager.urls(for: .documentDirectory, in: .userDomainMask)[0]
    
    // 위에서 사용자의 경로를 가져온 후, 맨 뒤에 저장할 파일의 이름을 저장하는 것입니다. 
    let fileURL = appURL.appendingPathComponent("csj시스템 사용법.pptx")
    
    // 최종적으로 파일이 저장될 위치에 대한 목적지 정보!!
    let destination: DownloadRequest.Destination = { _, _ in
      return (fileURL, [.removePreviousFile, .createIntermediateDirectories])
    }

	// AlamoFire를 이용한 File Download
    AF.download(url,
                method: .get,
                parameters: nil,
                encoding: JSONEncoding.default,
                to: destination).downloadProgress { (progress) in
	  // 설치의 진행도를 알 수 있다. 이를 가지고 시각화하여 사용자에게 제공해도 좋다.                
      print(progress.fractionCompleted)
    }.response{ response in
      if response.error != nil {
        print("파일다운로드 실패")
      }else{
        print("파일다운로드 완료")
        completionHandler()
      }
    }