Bundle - Foundation

참고 자료 : developer.apple.com/documentation/foundation/bundle

 

찾아보게 된 이유

Apple 에서 제공하는 Food Tracker 앱을 구현하는 도중 @IBDesignable 을 사용하여 custom control을 Interface Builder가 실행할 수있게 해주었습니다.

 

그런데 Asset Catalog 에 저장한 이미지를 Interface Builder가 올바르게 불러올 수 있게 하려면 Catalog의 번들을 명시적으로 지정해주어야 한다고 합니다.

 

그래서 UIImage(named:) 대신 UIImage(named:in:compatibleWith:) 메서드를 사용하는데, 여기서 Bundle 의 개념을 몰라서 정리하게 되었습니다.

 

Overview

 

디스크 내의 Bundle directory 에 저장된 코드와 자원들에 대한 표현방식 입니다.

 

애플은 앱, 프레임워크, 플러그인 등을 표현하는 방법으로 Bundle 을 사용합니다.

 

Bundle 은 자신이 포함하고 있는 자원들을 잘 정의된 서브 디렉토리에 정리합니다.

 

그리고 Bundle 의 구조는 Bundle 의 타입이나 플랫폼에 따라 다양합니다.

 

Bundle 오브젝트를 사용함으로서, 어떤 Bundle의 구조를 몰라도 그 Bundle의 자원에 접근할 수 있습니다.

번들을 사용하는 이유가 되겠네요!

 

Bundle 오브젝트는 아이템의 위치를 알아내고, Bundle 의 구조, 사용자 설정, localization 그리고 다른 관련된 요소들을 알아내는데 단 하나의 인터페이스를 제공합니다.

 

어떠한 실행 파일 이든 Bundle 오브젝트를 사용하여 앱 Bundle 내부 혹은 다른 곳에 위치한 알려진 Bundle 에 있는 자원의 위치를 알아낼 수 있습니다.

 

컨테이너 디렉터리나 파일시스템의 다른 부분에 있는 파일들을 찾는데에는 Bundle 오브젝트를 사용하지 않습니다.

컨테이너 디렉터리가 무엇을 말하는지 아직 잘 모르겠습니다..

 

Bundle 오브젝트를 사용하는 일반적인 패턴은 다음과 같습니다:

 

1. 의도한 Bundle 디렉터리 의 Bundle 오브젝트를 생성하기

 Food Tracker 에서는 Bundle.main 으로 앱 번들 인스턴스를 얻었습니다.

 

2. 필요한 자원의 위치를 찾거나 불러오기 위하여 Bundle 오브젝트의 메서드를 사용하기

 

3. 자원과 상호작용하기 위하여 다른 시스템 API 를 사용하기

Food Tracker에서는 UIImage(named:in:compatibleWith:) 의 in 파라미터에 Bundle을 넣었습니다.

 

자주 사용되는 몇몇 자원들은 Bundle 을 통하지 않고 위치를 찾아내거나 불러올 수 있습니다.

 

예를 들어 이미지를 불러올 때, 우리는 Asset catalog 에 이미지를 저장하고 UIImage(named:) 메서드를 이용해 불러옵니다.

FoodTracker에서는 @IBDesinable을 사용한 custom control 을 Interface builder 가 올바른 이미지를 불러오게 하기 위해 다른 메서드를 사용하였습니다.

 

마찬가지로 문자열 자원을 불러올때, .string 파일을 불러오는 대신에 NSLocalizedString 을 사용해 개별 문자열을 불러옵니다.

---

 

Finding and Opening a Bundle

 

자원이 어디있는지 찾기 전에, 우리는 먼저 어떤 Bundle이 자원을 가지고 있는지 반드시 명시해야 합니다.

 

Bundle 클래스는 많은 생성자를 가지고 있지만, 가장 자주 자용하는 것은 Bundle.main 입니다.

 

Main Bundle 은 현재 실행되고 있는 코드를 포함하고 있는 Bundle 디렉터리를 나타냅니다.

 

그래서 어떤 앱의 Main bundle 오브젝트는 앱과 함께 딸려오는 자원들에 대한 접근을 제공합니다.

 

 만약 우리의 앱이 플러그인이나 프레임워크 혹은 다른 번들 콘텐츠와 상호작용한다면, Bundle 클래스의 다른 생성자를 사용할 수도 있습니다.

 

우리는 항상 알려진 URL 이나 경로를 통해서 Bundle 오브젝트를 생성할 수 있지만, 다른 메서드는 우리가 이미 사용하고 있는 Bundle에 쉽게 접근할 수 있게 해줍니다.

 

예를 들어 만약 우리의 앱을 프레임워크와 연결할 때, 우리는 그 프레임워크에 정의된 클래스를 기반으로한 프레임 워크 번들을 찾기 위해 init(for:) 메서드를 사용할 수 있습니다.

// Get the app's main bundle
let mainBundle = Bundle.main

// 혹은
let mainBundle = Bundle(for: type(of: self))

// Get the bundle containing the specified private class.
let myBundle = Bundle(for: NSClassFromString("MyPrivateClass")!)

---

 

Locating Resources in a Bundle

 

우리는 Bundle 안에 있는 특정 자원의 위치를 얻기 위해 Bundle 오브젝트를 사용합니다.

 

자원을 찾을때, 우리는 자원의 이름과 자원의 타입을 최소한으로 전달합니다.

 

특정 서브디렉터리에 있는 자원의 경우, 우리는 그 디렉터리를 또한 지정할 수 있습니다.

 

자원의 위치를 찾은 후에는, 번들 루틴이 우리가 파일을 열 수 있도록경로 문자열이나 URL 을 반환합니다.

 

Bundle 오브젝트가 자원을 찾는 패턴이 있습니다.

 

항상 언어에 종속적이지 않은 Global resources 먼저 찾아서 반환합니다.

언어가 정해져있는 자원은 .lproj  디렉터리에 위치합니다.

 

성능상의 이유로 Global 와 Localized 가 존재한다면 항상 Global 을 반환하므로, 같은 자원에 대해 두 가지 버전을 동시에 두면 안됩니다.

 

 

 

끝!

---

 

다음 글: