iOS 앱에서 빌드 번호와 버전 번호를 가져와 화면에 표시하는 방법

이 글에서는 iOS 앱에서 빌드(Build) 번호와 버전(Version) 번호를 가져와서 화면에 표시하는 방법을 단계별로 알아보겠습니다.

1단계: 프로젝트 생성

Xcode를 실행한 후 New Project → Single View Application을 선택하고, 프로젝트 이름을 "ShowBuildAndVersion"으로 지정합니다.

2단계: 스토리보드에 레이블 추가

Main.storyboard를 열고 아래 이미지처럼 두 개의 UILabel을 추가합니다. 하나는 버전 번호를, 다른 하나는 빌드 번호를 표시하는 용도로 사용합니다.

3단계: IBOutlet 연결

추가한 두 개의 레이블을 ViewController에 @IBOutlet으로 연결합니다.

@IBOutlet weak var buildLabel: UILabel!
@IBOutlet weak var versionLabel: UILabel!

4단계: 프로젝트 설정에서 빌드/버전 값 확인

프로젝트 설정(Target → General)에서 Version과 Build 값을 원하는 숫자로 변경합니다. 이 값들이 실제로 앱에서 읽어올 정보입니다.

5단계: infoDictionary에서 값 가져오기

ViewController의 viewDidLoad() 메서드에서 메인 번들(Bundle.main)의 infoDictionary를 통해 빌드 번호와 버전 번호를 읽어와 각각의 레이블에 표시합니다.

override func viewDidLoad() {
    super.viewDidLoad()
    if let version = Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String {
        versionLabel.text = "Version: \(version)"
    }
    if let build = Bundle.main.infoDictionary?["CFBundleVersion"] as? String {
        buildLabel.text = "Build: \(build)"
    }
}

핵심 개념 정리

메인 번들의 infoDictionary에는 앱의 각종 메타 정보가 담겨 있으며, 그중에서 다음 두 가지 키를 사용합니다.

• CFBundleShortVersionString: 사용자에게 노출되는 마케팅 버전 번호 (예: 1.0.0)
• CFBundleVersion: App Store Connect에서 관리되는 내부 빌드 번호

이 두 키를 참조하면 각각 버전 번호와 빌드 번호를 손쉽게 가져올 수 있습니다.

6단계: 실행 결과 확인

프로젝트를 빌드하고 실행하면 시뮬레이터 화면에 아래와 같이 빌드 번호와 버전 번호가 정상적으로 출력되는 것을 확인할 수 있습니다.