권한 문구: 앱을 죽이거나 거짓말할 수 있는 문장

    info:
      path: Resources/Info.plist
      properties:
        # Shown at the prompt, under Apple's own sentence. Say what THIS app does.
        NSMicrophoneUsageDescription: >-
          Spark records your voice while you hold the dictation button, and for video notes you record.
        NSSpeechRecognitionUsageDescription: >-
          Spark turns your speech into text with the language model on this device, and refuses a
          language that has no on-device model.
        NSCameraUsageDescription: >-
          Spark uses the camera when you take a photo for a note.

// Sources/Dictation.swift
import Foundation
import Speech

enum DictationReadiness: Equatable, Sendable {
    case ready
    case refused(String)   // a sentence that names the remedy
}

/// The app names the language. It never guesses, and it never falls back to the server.
func dictationReadiness(for localeIdentifier: String) -> DictationReadiness {
    guard let recognizer = SFSpeechRecognizer(locale: Locale(identifier: localeIdentifier)) else {
        return .refused("Speech recognition does not support \(localeIdentifier).")
    }
    guard recognizer.supportsOnDeviceRecognition else {
        return .refused("Speech recognition is not available for \(localeIdentifier) on this device. "
            + "Add a keyboard for it and turn on Dictation in Settings > General > Keyboard.")
    }
    return .ready
}

func makeRequest() -> SFSpeechAudioBufferRecognitionRequest {
    let request = SFSpeechAudioBufferRecognitionRequest()
    request.requiresOnDeviceRecognition = true   // the privacy posture the usage string promises
    request.shouldReportPartialResults = true
    return request
}

// Tests/UsageStringTests.swift (a hosted test: Bundle.main is the app)
import Foundation
import XCTest

/// iOS terminates the app when it requests a permission whose usage string is missing,
/// and nothing warns before that first tap. Read the BUILT Info.plist instead.
final class UsageStringTests: XCTestCase {
    func testEveryRequestedPermissionHasAUsageString() {
        let required = [
            "NSMicrophoneUsageDescription",        // dictation records audio
            "NSSpeechRecognitionUsageDescription", // and recognizes it: TWO strings
            "NSCameraUsageDescription",
        ]
        let info = Bundle.main.infoDictionary ?? [:]   // a hosted test runs inside the app
        for key in required {
            let value = (info[key] as? String)?.trimmingCharacters(in: .whitespaces) ?? ""
            XCTAssertFalse(value.isEmpty, "\(key) is missing: the app would be terminated at the prompt")
        }
    }
}