iOS Simulator: 개념 및 Xcode에서의 작동 방식

Xcode의 Simulator란?

Xcode Simulator는 Mac에서 직접 iOS 애플리케이션을 실행하고 디버깅하는 도구입니다. Android 에뮬레이터와 달리 Apple 시뮬레이터는 기기의 ARM 프로세서를 에뮬레이션하지 않습니다. 대신 코드가 호스트 아키텍처(Intel Mac에서는 x86_64, Apple Silicon에서는 arm64)의 기계어로 컴파일됩니다.

시뮬레이터는 SDK에서 직접 iOS 프레임워크를 사용하여 UIKit, SwiftUI, Foundation 및 Core Data에 대한 액세스를 제공합니다. Apple(WWDC 2024)에 따르면 90% 이상의 개발자가 개발 단계에서 시뮬레이터를 사용하며, 최종 테스트를 위해서만 물리적 기기를 연결합니다.

각 Xcode 버전에는 다양한 기기 모델 및 iOS 버전용 시뮬레이터 세트가 포함됩니다. 예를 들어, Xcode 16에는 iOS 18이 탑재된 iPhone 16 Pro, iPadOS 18이 탑재된 iPad Pro M4, Apple Watch Series 10 및 Apple TV 4K용 시뮬레이터가 포함됩니다.

시뮬레이터 설치 및 실행

시뮬레이터는 Mac App Store에서 Xcode와 함께 설치됩니다. 추가 iOS 버전을 추가하려면 메뉴 Settings → Platforms를 사용하세요. 빌드 스킴(Scheme)에서 시뮬레이터를 선택하고 Run을 누릅니다. 또는 Xcode → Open Developer Tool → Simulator 메뉴를 통해 시뮬레이터를 실행합니다.

// 시뮬레이터의 최소 iOS 버전 확인
if #available(iOS 18.0, *) {
    print("iOS 18 API 사용 가능")
}

시뮬레이터와 실제 기기의 차이점

시뮬레이터와 실제 기기의 차이점을 이해하는 것은 품질 테스트에 매우 중요합니다. 주요 차이점은 프로세서 아키텍처, 하드웨어 기능 및 그래픽 성능에 있습니다.

시뮬레이터의 성능은 일반적으로 실제 기기보다 높습니다. Mac의 강력한 프로세서를 사용하기 때문입니다. 이는 속도에 대한 잘못된 인상을 줄 수 있습니다. 실제 기기에서는 애니메이션, Core Data 작업 및 네트워크 요청이 더 느리게 작동할 수 있습니다.

기기에서 테스트가 필수적인 경우

출시 전에 반드시 실제 기기에서 애플리케이션을 실행하세요. 중요한 시나리오: 카메라 및 AVFoundation, Bluetooth 및 CoreBluetooth, APNs를 통한 푸시 알림, App Sandbox의 파일 시스템 작업, Metal의 그래픽 성능, 배터리 전력 소비.

코드에서 TARGET_OS_SIMULATOR 확인

시뮬레이터용 코드의 조건부 컴파일을 위해 Apple은 Objective-C에서 TARGET_OS_SIMULATOR와 Swift에서 targetEnvironment(simulator)를 제공합니다. 이 확인을 통해 디버그 로그, 모의 객체를 추가하거나 하드웨어 종속 코드를 비활성화할 수 있습니다.

import UIKit

class CameraViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        
        #if targetEnvironment(simulator)
        showMockCameraPreview()
        print("시뮬레이터: 모의 카메라 사용")
        #else
        setupRealCameraSession()
        #endif
    }
}

Objective-C에서 #if TARGET_OS_SIMULATOR 지시문도 유사하게 작동합니다. 하드웨어 센서나 카메라가 필요한 코드를 비활성화하는 데 사용하세요. 시뮬레이터용 컴파일 시 이 코드는 바이너리 파일에 포함되지 않습니다.

#if TARGET_OS_SIMULATOR
NSLog(@"시뮬레이터에서 실행 중 — 카메라 사용 불가");
self.cameraButton.hidden = YES;
#else
self.cameraButton.hidden = NO;
#endif

확인의 일반적인 사용 사례

TARGET_OS_SIMULATOR 확인은 세 가지 경우에 사용됩니다: UI 테스트 중 카메라를 모의 객체로 대체, 개발 속도를 높이기 위해 Core Bluetooth 비활성화, 릴리스 빌드에 포함되어서는 안 되는 디버그 정보 로깅. 비즈니스 로직을 변경하기 위해 확인을 사용하지 마세요 — 실제 기기에서 버그가 발생할 수 있습니다.

시뮬레이터에서 테스트 실행

Xcode Simulator는 전체 XCTest 테스트 스위트를 지원합니다: 단위 테스트(XCTestCase), UI 테스트(XCUITestCase) 및 성능 테스트. 시뮬레이터에서 테스트하려면 서명된 개발자 인증서가 필요하지 않아 CI/CD 설정이 간소화됩니다.

import XCTest

final class LoginTests: XCTestCase {
    var app: XCUIApplication!
    
    override func setUp() {
        continueAfterFailure = false
        app = XCUIApplication()
        app.launch()
    }
    
    func testLoginButtonExists() {
        XCTAssertTrue(app.buttons["loginButton"].exists)
    }
    
    func testEmptyEmailValidation() {
        app.textFields["emailField"].tap()
        app.buttons["loginButton"].tap()
        let errorLabel = app.staticTexts["errorMessage"]
        XCTAssertTrue(errorLabel.exists)
    }
}

명령줄에서 테스트를 실행하려면 스킴과 시뮬레이터를 지정하여 xcodebuild test를 사용하세요. -destination 매개변수는 테스트가 실행될 특정 시뮬레이터를 정의합니다.

# iPhone 16 시뮬레이터, iOS 18에서 단위 테스트 실행
xcodebuild test \
  -scheme "MyApp" \
  -destination "platform=iOS Simulator,name=iPhone 16,OS=18.0" \
  -testPlan "AllTests"

제한 사항 및 주의 사항

편리함에도 불구하고 Xcode Simulator에는 실제 기기에서 버그를 유발할 수 있는 여러 제한 사항이 있습니다. 가장 중요한 것은 ARM 에뮬레이션 부족입니다: 코드가 호스트 아키텍처용으로 컴파일되며 일부 작업의 동작이 다를 수 있습니다.

Core Data 및 파일 시스템은 Mac의 SSD 덕분에 시뮬레이터에서 더 빠르게 작동합니다. NAND 메모리가 있는 실제 기기에서는 읽기/쓰기 속도가 더 낮습니다. 특히 대규모 데이터 세트의 경우 출시 전에 기기에서 Core Data 성능을 테스트하세요.

시뮬레이터에서 전력 소비를 확인하는 것은 불가능합니다 — 시뮬레이터는 Mac에서 전원을 공급받습니다. 콘텐츠 로딩 및 가져오기 작업을 포함한 백그라운드 모드는 배터리 제한 및 Background Task Scheduler로 인해 실제 기기에서 다르게 동작합니다.

하드웨어 센서 및 생체 인식

시뮬레이터는 iPhone의 하드웨어 센서에 액세스할 수 없습니다. Face ID와 Touch ID는 시뮬레이터 메뉴를 통해 시뮬레이션할 수 있습니다: Features → Face ID → Matching Face. 가속도계, 자이로스코프 및 기압계는 사용할 수 없습니다 — CMDeviceMotion에 의존하는 코드는 기기에서 테스트해야 합니다. Core Location의 경우 GPX 파일을 선택하여 Debug → Simulate Location을 통해 좌표를 설정할 수 있습니다.

시뮬레이터에서 iCloud 및 StoreKit 확인도 제한됩니다. StoreKit Test를 사용하면 실제 App Store Connect 없이 구매를 시뮬레이션할 수 있지만, Sandbox 환경 및 프로덕션 구매 확인에는 물리적 기기가 필요합니다. 시뮬레이터에서 iCloud Drive 및 CloudKit 동기화가 올바르게 작동하지 않습니다 — Apple은 이러한 시나리오를 실제 기기에서만 테스트할 것을 권장합니다.

Apple Silicon Mac의 시뮬레이터

M 시리즈 프로세서가 탑재된 Mac에서 시뮬레이터는 근본적으로 다르게 작동합니다: 코드가 x86_64 대신 네이티브 ARM64로 컴파일됩니다(실제 iPhone에서와 같이). 이는 시뮬레이터와 기기 간의 격차를 크게 줄입니다. Apple Silicon 시뮬레이터에서 실행되는 애플리케이션은 물리적 iPhone과 동일한 ARM 명령을 사용하므로 성능 테스트의 대표성이 높아집니다. M 시리즈 시뮬레이터와 실제 iPhone 간의 Metal 및 Core Animation 성능 차이는 Intel 시뮬레이터에 비해 최소화됩니다.

CI용 시뮬레이터 구성

CI용 시뮬레이터 설정에는 필요한 기기 및 iOS 버전을 미리 생성해야 합니다. 지속적 통합 서버에서는 시뮬레이터가 자동으로 생성되지 않습니다 — 테스트 실행 전에 xcrun simctl create를 통해 추가해야 합니다.

# CI용 시뮬레이터 생성
xcrun simctl create \
  "iPhone 16 CI" \
  "com.apple.CoreSimulator.SimDeviceType.iPhone-16" \
  "com.apple.CoreSimulator.SimRuntime.iOS-18-0"

# 생성된 시뮬레이터에서 테스트 실행
xcodebuild test \
  -workspace MyApp.xcworkspace \
  -scheme MyApp \
  -destination "id=$(xcrun simctl list devices | grep 'iPhone 16 CI' | awk -F'[][]' '{print }')"

CI에서 병렬 테스트를 위해 여러 iOS 버전의 시뮬레이터를 구성하세요. Xcode Cloud, GitHub Actions 및 Bitrise는 병렬 테스트 실행을 지원하여 실행 시간을 2-3배 단축합니다. CI 서버에 테스트에 필요한 모든 iOS 시뮬레이터가 설치되어 있는지 확인하세요.