Apple Intelligence가 사용 불가능할 때 우아하게 대처하는 방법

I’m happy to translate the article for you, but I’ll need the text you’d like translated. Could you please paste the content (or the portion you want translated) here? I’ll keep the source line exactly as you provided and preserve all formatting, markdown, and technical terms.

소개

Apple Intelligence는 수년간 iOS 개발자들에게 가장 흥미로운 발전 중 하나입니다. Foundation Models 프레임워크는 대형 언어 모델에 직접, 디바이스 내에서 접근할 수 있게 해줍니다—API 비용도 없고, 네트워크 호출도 없으며, 완전한 프라이버시를 보장합니다.

하지만 현실은 많은 사용자가 이를 실행할 수 없다는 것입니다. 체크 없이 LanguageModelSession()을 앱에 바로 넣어버리면, 많은 디바이스에서 깨진 경험을 제공하게 됩니다.

아래는 복사해서 바로 사용할 수 있는 깔끔한 가이드이며, 다음을 보여줍니다:

• 어떤 디바이스가 Apple Intelligence를 사용할 수 없는지
• 프레임워크가 보고하는 세 가지 가용성 상태
• UI에서 각 경우를 어떻게 처리할지
• 기능 코드를 깔끔하게 유지하기 위한 간단하고 재사용 가능한 아키텍처

Apple Intelligence를 사용할 수 없는 경우

다음 기기만 하드웨어 요구 사항을 충족합니다:

• iPhone 15 Pro / iPhone 15 Pro Max
• iPhone 16 / 16 Plus / 16 Pro / 16 Pro Max
• iPhone 16e
• iPhone 17 / 17 Pro / 17 Pro Max / iPhone Air

그 외 모든 기기—표준 iPhone 15 포함—는 iOS 26.3을 실행하지만 Foundation Models 접근 권한을 전혀 받지 못합니다.

자격을 갖춘 하드웨어라도 다음 조건을 만족해야 합니다:

1. 설정에서 Apple Intelligence가 활성화되어 있어야 함(옵트인)
2. 7 GB 이상의 여유 저장 공간 확보
3. 기기 및 Siri 언어가 지원되는 언어로 설정되어 있어야 함
4. 모델이 완전히 다운로드되어 있어야 함(활성화 후 백그라운드에서 다운로드됨)

핵심 요점: OS 버전이 최신이라고 해서 모델이 자동으로 제공된다고 가정해서는 안 됩니다.

세 가지 사용 불가 경우

SystemLanguageModel.default.availability는 세 가지 사용 불가 경우 중 하나가 될 수 있습니다 (행복한 경로인 .available 포함):

import FoundationModels

switch SystemLanguageModel.default.availability {
case .available:
    // Good to go
case .unavailable(.deviceNotEligible):
    // A13 or older chip – Foundation Models will never work here
case .unavailable(.appleIntelligenceNotEnabled):
    // Compatible device, but user hasn't turned on Apple Intelligence
case .unavailable(.modelNotReady):
    // Compatible + enabled, but model is still downloading
@unknown default:
    // Future‑proof: handle any new cases Apple might add
    break
}

각 경우마다 다른 UX 응답이 필요합니다.

Source: …

Proper Fallback 전략 구축하기

세 가지 경우를 각각 별개의 UX 문제로 생각하세요.

Case 1 – Device Not Eligible

영구적인 제한. 하드웨어가 Apple Intelligence를 절대 지원하지 못합니다.
스피너나 “나중에 다시 확인” 메시지를 표시하지 마세요. 대신 완전하게 작동하는 비‑AI 버전의 기능을 제공하세요.

case .unavailable(.deviceNotEligible):
    // Serve a non‑AI version of the feature
    showBasicTextSummarizer()

예시: 스마트 저널링 앱에서는 자동 태깅을 건너뛰고 사용자가 직접 태그하도록 할 수 있습니다. 라이팅 어시스턴트에서는 생성된 제안 대신 미리 정의된 템플릿을 제공할 수 있습니다.

Case 2 – Apple Intelligence Not Enabled

하드웨어는 가능하지만 사용자가 아직 옵트인하지 않은 경우입니다. 프롬프트를 표시할 수 있지만 부드럽게 안내하세요.

case .unavailable(.appleIntelligenceNotEnabled):
    showEnablementBanner(
        message: "Enable Apple Intelligence in Settings to unlock AI‑powered suggestions.",
        settingsURL: URL(string: UIApplication.openSettingsURLString)!
    )
    // Still show the basic version of the feature below the banner

• 배너는 한 번만 표시되며 이점이 명확히 설명됩니다.
• 배너를 탭하면 UIApplication.openSettingsURLString을 통해 Settings → Apple Intelligence & Siri 로 이동합니다.
• 해당 하위 화면으로 직접 딥링크할 수 없으므로 사용자가 직접 탐색해야 합니다.

Case 3 – Model Not Ready

활성화 후 모델이 다운로드되는 동안의 일시적인 상태입니다. 여기서는 대기하고 재시도해야 하며, 영구적으로 대체하지 마세요.

case .unavailable(.modelNotReady):
    showLoadingState(message: "AI features are warming up. This only takes a moment.")
    scheduleAvailabilityCheck()

간단한 재시도 구현 예시:

func scheduleAvailabilityCheck() {
    Task {
        try? await Task.sleep(for: .seconds(10))   // 10‑second delay
        await checkAndUpdateAvailability()
    }
}

사용자가 화면에 머무르는 동안 10~30초 간격보다 더 자주 폴링하지 않도록 하세요.

Putting It Together: A Clean Architecture

아래는 모든 가용성 처리를 중앙 집중화하고 UI 코드를 깔끔하게 유지하는 최소한의 재사용 가능한 패턴입니다.

import FoundationModels
import SwiftUI

// MARK: - Availability State

enum AIAvailabilityState {
    case available
    case unsupportedDevice
    case notEnabled
    case modelLoading
}

// MARK: - Feature Manager

@Observable
final class AIFeatureManager {
    private(set) var state: AIAvailabilityState = .modelLoading

    init() {
        refreshAvailability()
    }

    /// Checks the system availability and updates `state`.
    func refreshAvailability() {
        switch SystemLanguageModel.default.availability {
        case .available:
            state = .available
        case .unavailable(.deviceNotEligible):
            state = .unsupportedDevice
        case .unavailable(.appleIntelligenceNotEnabled):
            state = .notEnabled
        case .unavailable(.modelNotReady):
            state = .modelLoading
        @unknown default:
            state = .modelLoading
        }
    }

    /// Periodically re‑checks availability (used for the “model not ready” case).
    func scheduleRecheck() {
        Task {
            try? await Task.sleep(for: .seconds(15))
            await MainActor.run { refreshAvailability() }
        }
    }
}

// MARK: - SwiftUI View Example

struct AIFeatureView: View {
    @StateObject private var manager = AIFeatureManager()

    var body: some View {
        VStack {
            switch manager.state {
            case .available:
                AIEnabledView()               // Your full AI‑powered UI
            case .unsupportedDevice:
                BasicFeatureView()           // Non‑AI fallback
            case .notEnabled:
                VStack {
                    BasicFeatureView()
                    EnableBanner()
                }
            case .modelLoading:
                LoadingView(message: "AI is warming up…")
                    .onAppear { manager.scheduleRecheck() }
            }
        }
        .animation(.default, value: manager.state) // smooth transitions
    }
}

// MARK: - UI Helpers (simplified)

struct EnableBanner: View {
    var body: some View {
        Button {
            if let url = URL(string: UIApplication.openSettingsURLString) {
                UIApplication.shared.open(url)
            }
        } label: {
            Text("Enable Apple Intelligence in Settings")
                .font(.subheadline)
                .padding()
                .background(Color.blue.opacity(0.1))
                .cornerRadius(8)
        }
    }
}

struct LoadingView: View {
    let message: String
    var body: some View {
        VStack(spacing: 12) {
            ProgressView()
            Text(message)
                .font(.footnote)
                .foregroundColor(.secondary)
        }
        .padding()
    }
}

작동 방식

1. **AIFeatureManager**는 모든 시스템 검사를 캡슐화하고 단일 state 값을 외부에 제공합니다.
2. SwiftUI 뷰는 state에 반응하여 적절한 UI를 표시합니다:
   • 전체 AI 기능 (AIEnabledView)
   • 기본 폴백 (BasicFeatureView)
   • 활성화 배너 + 기본 UI (EnableBanner)
   • 모델 다운로드 중 로딩 스피너 (LoadingView)
3. 모델이 아직 다운로드 중일 때, 뷰는 scheduleRecheck()를 호출해 짧은 지연 후 다시 확인하도록 합니다.

AIFeatureManager는 여러 화면에서 재사용할 수 있으며, 앱의 여러 부분에서 동일한 가용성 정보를 필요로 할 경우 @EnvironmentObject로 래핑해서 사용할 수도 있습니다.

TL;DR 체크리스트

정확한 사용 불가 이유를 감지하고 적절히 대응함으로써, 최신 iPhone 17 Pro Max든 iPhone 12든 모든 사용자의 경험을 원활하게 유지할 수 있습니다. 즐거운 코딩 되세요!

Source: …

Apple Intelligence 가용성 처리

Apple Intelligence(또는 기타 기반 모델)를 통합하면 다음과 같은 3가지 비가용성 상태를 만나게 됩니다:

아래는 SwiftUI에서 이러한 상태를 간결하게 처리하는 방법입니다.

1️⃣ 모델 레이어: 가용성 감지

import SwiftUI
import FoundationModels

final class AIFeatureManager: ObservableObject {
    enum State {
        case available
        case unsupportedDevice
        case notEnabled
        case modelLoading
    }

    @Published private(set) var state: State = .unsupportedDevice

    init() {
        refreshAvailability()
    }

    func refreshAvailability() {
        switch SystemLanguageModel.default.availability {
        case .available:
            state = .available
        case .unavailable(.deviceNotEligible):
            state = .unsupportedDevice
        case .unavailable(.appleIntelligenceNotEnabled):
            state = .notEnabled
        case .unavailable(.modelNotReady):
            state = .modelLoading
            scheduleRetry()
        @unknown default:
            // Future‑proofing: treat unknown cases as unsupported
            state = .unsupportedDevice
        }
    }

    private func scheduleRetry() {
        Task {
            try? await Task.sleep(for: .seconds(15))
            refreshAvailability()
        }
    }
}

2️⃣ 뷰 레이어: 올바른 UI 렌더링

struct SmartFeatureView: View {
    @StateObject private var aiManager = AIFeatureManager()

    var body: some View {
        switch aiManager.state {
        case .available:
            AIEnhancedView()
        case .unsupportedDevice:
            BasicFallbackView()
        case .notEnabled:
            EnablePromptView {
                aiManager.refreshAvailability()
            }
        case .modelLoading:
            LoadingView(message: "AI features are getting ready…")
        }
    }
}

각 상태마다 전용 뷰를 두어 UI를 얇고 유지보수하기 쉽게 만들었습니다. 모델이 사용 가능해지면 refreshAvailability()가 state를 업데이트하고 SwiftUI가 자동으로 다시 렌더링합니다.

실제로 해야 할 폴백 UI

폴백은 단순히 “AI 버튼을 숨기는” 것이 아닙니다. 모델 없이도 가치를 제공해야 합니다. 다음은 일반적인 패턴입니다:

Goal: iPhone 14 사용자가 앱을 열었을 때 작동하고 유용한 기능을 보게 해야 합니다—깨진 화면이나 기기가 충분하지 않다는 설명이 가득한 텍스트가 아니라.

A Note on @unknown default

Apple의 API는 계속 진화하고 있기 때문에, switch에 항상 @unknown default를 포함하세요. 향후 OS 버전에서 새로운 사용 불가 이유가 나타나면, 컴파일러가 경고를 표시하고 이를 “지원되지 않는 기기”로 안전하게 처리할 수 있습니다.

테스트: 적격 장치 없이

세 가지 비가용 상태를 시뮬레이션하는 방법은 다음과 같습니다:

가용성 모킹 가능하게 만들기

protocol LanguageModelAvailabilityChecker {
    var availability: SystemLanguageModel.Availability { get }
}

struct LiveChecker: LanguageModelAvailabilityChecker {
    var availability: SystemLanguageModel.Availability {
        SystemLanguageModel.default.availability
    }
}

struct MockChecker: LanguageModelAvailabilityChecker {
    var availability: SystemLanguageModel.Availability
}

프로덕션에서는 LiveChecker를, 단위 테스트에서는 MockChecker를 주입합니다. 이를 통해 물리적 장치 없이도 모든 가용성 상태에 대한 UI 동작을 검증할 수 있습니다.

더 큰 그림

Great apps treat foundation models as progressive enhancements—they improve the experience for capable devices while still functioning perfectly on older hardware.

1. Build the baseline (fallback UI) first.
2. Layer the intelligence on top once the baseline is solid.

Requirements

• iOS 26+
• Xcode 26+

Apple Intelligence‑compatible devices

• iPhone 15 Pro / Pro Max
• All iPhone 16 and iPhone 17 models

Happy coding! 🎉