Files
OSGKeyboard/OSGKeyboardShared/Constants/AppGroup.swift
T
Rocky 537a68552a perf(asr): speed up local Flow dictation and land CLM/keyboard refactor
Reduce perceived latency from key release to final text:
- Adaptive chunking: 2.5s first chunk + 5s follow-ups so short
  utterances start on-device recognition while still recording.
- Session-level ASR warmup and audio-format cache reuse to remove
  per-utterance cold-start of SpeechAnalyzer.
- Mirror live pipelined partials to the keyboard transcript line via
  a new flow.transcriptionPartial App Group key + Darwin ping.

Also commits the accumulated custom language model, Flow session,
keyboard extension restructure, and Xiaomi MiMo provider work in
progress on this branch.
2026-07-06 00:00:19 +08:00

71 lines
3.0 KiB
Swift

// AppGroup.swift
// OSGKeyboard · Shared
//
// App Group identifier shared between main app and keyboard extension.
// UserDefaults(suiteName:) and file containers use this.
import Foundation
public enum AppGroup {
/// App Group container identifier (must match entitlements in both targets)
public static let identifier = "group.com.osgkeyboard.shared"
/// Whether the App Group container is available on this device.
///
/// Checks both `UserDefaults(suiteName:)` *and* the on-disk container.
/// The suite alone can appear to open while the container is still `(null)`
/// when provisioning is misconfigured — that case produces the
/// `CFPrefsPlistSource … Container: (null)` console warning.
public static let isAvailable: Bool = {
guard UserDefaults(suiteName: identifier) != nil else { return false }
return FileManager.default.containerURL(
forSecurityApplicationGroupIdentifier: identifier
) != nil
}()
/// Shared UserDefaults when the App Group suite is available; `nil` otherwise.
///
/// Prefer this in Release builds and in the keyboard extension so callers
/// can surface a setup error instead of silently reading/writing the wrong suite.
public static var defaultsIfAvailable: UserDefaults? {
guard isAvailable else { return nil }
return UserDefaults(suiteName: identifier)
}
/// Shared UserDefaults instance for cross-process config.
///
/// In DEBUG builds a missing App Group is a hard `fatalError`: silently
/// falling back to `.standard` desyncs the keyboard extension from the
/// main App (the extension would write to one suite and the main App
/// would read from another, or vice-versa) and the symptom is "I gave
/// the App an API key and nothing happens" — which is exactly the bug
/// this is meant to prevent.
///
/// In Release builds there is **no** `.standard` fallback — use
/// `defaultsIfAvailable` and handle `nil` when provisioning is missing.
public static var defaults: UserDefaults {
guard let suite = defaultsIfAvailable else {
#if DEBUG
fatalError("""
⚠️ App Group \(identifier) unavailable.
Add the App Group in:
1. Apple Developer portal → Identifiers → App Groups → add
\(identifier)
2. Both bundle IDs (main app + keyboard extension) → enable
that App Group under Capabilities
3. Re-generate the provisioning profile, download it, and
re-run the project.
Falling back to .standard would silently desync the keyboard
extension from the main App — a hard crash in DEBUG is the
only way to make the misconfiguration impossible to miss.
""")
#else
fatalError("App Group \(identifier) unavailable. Check entitlements and provisioning.")
#endif
}
return suite
}
}