클라우드 Mac에서 iOS UserDefaults 기본값과 초기화 동작 검증하기

클라우드 Mac에서 iOS UserDefaults 기본값과 초기화 동작 검증하기

클라우드 Mac에서 iOS UserDefaults 기본값과 초기화 동작 검증하기

원격 Mac 데스크톱에서 “기본 설정 복원”을 테스트했는데도 스위치 값이 그대로 남아 있거나, 테스트 실행 순서를 바꾸자 결과가 달라질 수 있습니다. 그렇다고 곧바로 대기 시간을 추가하거나 강제 동기화를 적용하지는 마세요. UserDefaults에서 읽은 값은 등록된 기본값일 수 있으며, 영구 저장된 데이터가 남아 있다는 뜻은 아닙니다. 먼저 클라우드 Mac에서 독립 Swift 스크립트를 실행한 다음, 같은 동작 계약을 iOS 테스트로 옮겨 기본값, 명시적 덮어쓰기, 초기화 범위를 확인하겠습니다.

먼저 설정 읽기의 동작 계약 정의하기

“힌트 표시”는 기본적으로 켜져 있고, “재시도 횟수”는 기본 세 번이라고 정합니다. 사용자가 명시적으로 힌트를 끄거나 재시도 횟수를 0으로 선택하면 기본값보다 우선해야 합니다. 설정 키를 삭제한 뒤에는 다시 기본값을 사용해야 합니다.

register(defaults:)는 등록 도메인에 대체값을 제공할 뿐, 그 값을 앱의 영구 도메인에 쓰지는 않습니다. 일반적인 읽기는 여러 도메인을 검색하지만, persistentDomain(forName:)은 지정한 영구 도메인만 확인합니다. 두 API가 답하는 질문은 다르므로 검증할 때도 각각 별도로 단언해야 합니다.

“읽을 수 있다”는 것이 “영구 저장되었다”는 뜻은 아닙니다. dictionaryRepresentation()은 검색 대상 도메인을 합친 뷰이므로, 디스크에 저장되었다는 증거로 사용할 수 없습니다.

우선 초기 대체값, 명시적 덮어쓰기, 단일 키 삭제, 전체 도메인 초기화라는 네 가지 상태를 테스트 케이스에 넣으세요. 화면의 스위치 위치만 확인해서는 안 됩니다.

독립 suite로 기본 동작 검증하기

터미널에서 xcrun swift --version을 실행해 도구를 사용할 수 있는지 확인한 뒤, 아래 내용을 defaults-contract.swift로 저장하고 xcrun swift defaults-contract.swift를 실행하세요. 출력 없이 종료 코드가 0이면 모든 전제조건 검사를 통과한 것입니다. 검사에 실패하면 실행이 중단됩니다.

무작위 suite 이름을 사용하면 오래 사용한 머신에 남아 있는 기존 데이터를 피할 수 있습니다. 키 이름도 별도로 생성해 같은 프로세스 안에서 등록 도메인의 키가 충돌할 가능성을 줄입니다. 이 스크립트는 자신이 만든 영구 도메인만 다루며, 실제 앱 설정에는 접근하지 않습니다.

import Foundation

let token = UUID().uuidString
let suite = "local.defaults.contract." + token
guard let defaults = UserDefaults(suiteName: suite) else {
    fatalError("Unable to create defaults suite")
}

let enabled = token + ".hintsEnabled"
let retries = token + ".retryCount"
defer {
    defaults.removePersistentDomain(forName: suite)
}

defaults.register(defaults: [
    enabled: true,
    retries: 3
])

precondition(defaults.bool(forKey: enabled))
precondition(defaults.integer(forKey: retries) == 3)
precondition(defaults.persistentDomain(forName: suite)?[enabled] == nil)

defaults.set(false, forKey: enabled)
defaults.set(0, forKey: retries)
precondition(!defaults.bool(forKey: enabled))
precondition(defaults.integer(forKey: retries) == 0)
precondition(
    defaults.persistentDomain(forName: suite)?[enabled] as? Bool == false
)

defaults.removeObject(forKey: enabled)
precondition(defaults.bool(forKey: enabled))
precondition(defaults.persistentDomain(forName: suite)?[enabled] == nil)
precondition(defaults.integer(forKey: retries) == 0)

defaults.removePersistentDomain(forName: suite)
precondition(defaults.bool(forKey: enabled))
precondition(defaults.integer(forKey: retries) == 3)
precondition(defaults.persistentDomain(forName: suite)?[retries] == nil)

이 스크립트가 검증하는 것은 현재 프로세스 안에서의 Foundation 동작이지, 프로세스 간 디스크 기록 시점이 아닙니다. 이 결과만으로 앱을 다시 실행한 뒤의 읽기까지 검증했다고 볼 수 없으며, iOS 샌드박스 안에서 실행하는 테스트를 대신할 수도 없습니다.

비즈니스 로직 계층에 저장소 주입하기

비즈니스 코드가 UserDefaults.standard를 직접 사용하면 테스트를 격리하기 어렵습니다. 설정 저장소가 UserDefaults 인스턴스를 전달받도록 만들고, 프로덕션에서는 정해진 저장소를, 테스트에서는 새로 만든 suite를 전달하세요. 기본값 등록은 저장소 초기화 시 한곳에서 처리하고, 여러 화면의 생명주기 코드에 흩어 놓지 마세요.

명시적으로 끈 설정을 기본값으로 덮어쓰지 않기

“읽은 값이 false이면 true로 바꾼다”는 로직은 피해야 합니다. bool(forKey:)는 키가 없을 때도 false를 반환할 수 있으므로, 참·거짓만으로 키의 존재 여부를 판단할 수 없습니다. 기본값을 등록했다면 일반적인 읽기만으로 약속한 대체값을 얻을 수 있습니다.

마찬가지로 재시도 0회도 유효한 설정이므로, 0을 “설정되지 않음”으로 취급해서는 안 됩니다. 사용자가 특정 옵션을 저장한 적이 있는지 확인해야 한다면 대상 영구 도메인에 해당 키가 있는지 검사하세요. object(forKey:) 역시 등록 도메인을 검색하므로 이 판단에 사용할 수 없습니다.

모든 설정을 초기화할지, UI 관련 설정만 초기화할지도 저장소 인터페이스에 명확히 정의해야 합니다. 같은 영구 도메인에 다른 비즈니스 로직용 플래그가 저장되어 있다면, 프로덕션 코드는 허용 목록에 있는 키만 삭제해야 합니다. 테스트의 전체 도메인 삭제 방식을 그대로 가져오면 안 됩니다.

iOS 테스트에서 생명주기 경계까지 검증하기

위 전제조건 검사를 XCTest 단언으로 바꾸고 iOS 테스트 타깃에서 실행하세요. 각 테스트 케이스는 자체 suite를 사용하고, 종료 단계에서 정리해야 합니다. 무작위 키 이름은 앱이 실제로 사용하는 키를 대체하기 위한 것이 아닙니다. 비즈니스 로직 테스트에서는 여전히 저장소 인터페이스를 통해 실제 키를 다뤄야 합니다.

테스트 케이스를 병렬로 실행할 때도 주의가 필요합니다. 등록 도메인은 suite마다 완전히 독립적인 사본을 갖는 구조가 아닙니다. 같은 프로세스 안에서 이름이 같은 등록 키는 서로 영향을 줄 수 있으므로, suite 이름이 다르다는 이유만으로 완전히 격리되었다고 판단해서는 안 됩니다. 같은 이름의 키를 사용하는 테스트 케이스를 순차 실행하거나, 테스트용 저장소에 키 접두사를 주입할 수 있습니다.

앱 재실행을 검증하려면 별도의 통합 테스트를 만드세요. 설정을 기록하고, 정상 종료한 뒤 다시 실행해 값을 확인합니다. 테스트 프로세스의 suite가 자동으로 앱 프로세스에서 사용하는 suite가 되는 것은 아니므로, 명시적인 테스트 진입점이 필요합니다. 완료 조건이 없는 흐름에 고정 대기 시간을 덧붙이지 말고, synchronize()로 잘못된 저장소 선택 문제를 덮으려 하지 마세요.

실패 양상에 따라 원인 좁히기

초기화 후에도 기본값이 읽힌다면 먼저 영구 도메인이 비워졌는지 확인하세요. 이는 정상적인 기본값 대체 동작인 경우가 많습니다. 명시적으로 저장한 false가 true로 바뀐다면 참·거짓 값에 기반한 초기화 로직이 있는지 살펴보세요. 단독 실행에서는 통과하지만 전체 테스트 실행에서 실패한다면 등록 키 충돌과 공유된 standard부터 확인하세요.

실패 기록에는 suite 이름, 테스트 키, 예상 타입만 남기고 전체 환경설정 딕셔너리를 내보내지 마세요. 최종 검증은 “무엇이 삭제되었는가”와 “삭제 후 어떤 값이 읽히는가”를 모두 다뤄야 합니다. 여기에 초기화를 반복하는 테스트 케이스를 추가해 두 번째 실행도 안전한지 확인하세요. 이렇게 해야 우연히 맞아떨어진 화면 상태가 아니라, 재사용할 수 있는 설정 동작 계약을 확보할 수 있습니다.

자주 묻는 질문

register(defaults:)는 기본값을 디스크에 저장하나요?

아니요. 등록 도메인에 대체값을 제공합니다. 저장된 데이터는 dictionaryRepresentation()이 아니라 persistentDomain(forName:)으로 확인해야 합니다.

저장 도메인을 삭제해도 설정값이 읽히는 이유는 무엇인가요?

읽기 결과가 등록 기본값으로 돌아가기 때문입니다. 저장 도메인에서 업무 키가 사라졌는지와 읽기 결과가 예상 기본값인지 각각 검증하세요.

전용 Mac 한 대로 워크플로를 검증해 보세요

먼저 모델, 노드 위치, 대여 기간을 확인한 다음 하루 단위로 테스트해 보세요. 실제 이용 가능 여부는 콘솔에서 실시간으로 확인할 수 있습니다.