project.base.yml

name: OpenGlasses
settings:
  base:
    DEAD_CODE_STRIPPING: "YES"
    ENABLE_USER_SCRIPT_SANDBOXING: "YES"
    CLANG_ANALYZER_LOCALIZABILITY_NONLOCALIZED: "YES"
    SWIFT_EMIT_LOC_STRINGS: "YES"
    ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS: "YES"
    # Personal signing (DEVELOPMENT_TEAM, personal entitlements/Info) lives in
    # project.local.yml — copy project.local.yml.example and fill in your team.
options:
  bundleIdPrefix: com.openglasses
  deploymentTarget:
    iOS: "26.0"
    watchOS: "26.0"
  # Sets LastUpgradeCheck (27.0 -> 2700). Keep in step with the project's Xcode
  # baseline so Xcode's "Update to recommended settings" validation stays quiet.
  xcodeVersion: "27.0"
  generateEmptyDirectories: true
  # Shared files must use the same complete group hierarchy as the app's source folder.
  # Xcode 27.2 rejects a group attached both at the root and beneath Sources.
  createIntermediateGroups: true
  developmentLanguage: en
  knownRegions:
    - en
    - zh-Hans
    - zh-Hant
    - ja
    - ko
    - cs
    - pl
    - pt-BR
    - pt-PT
    - es
    - es-MX
    - fr
    - fr-CA
    - de
    - it
    - nl
    - th
    - ar
    - hi
    - ur
    - ru
    - sv
    - fi
    - uk
    - el
    - tr
    - da
    - nb
    - ro
    - hu
    - hr
    - sk
    - ms
    - vi
    - id
    - ca

packages:
  HaishinKit:
    url: https://github.com/shogo4405/HaishinKit.swift.git
    from: "2.2.5"
  mlx-swift-lm:
    url: https://github.com/ml-explore/mlx-swift-lm.git
    # Pinned to a revision, not a tag, and deliberately: the Gemma 4 VLM load failure
    # (`keyNotFound(…k_norm.weight, Gemma4RMSNormZeroShift)` — KV-shared layers must not
    # declare k_proj/v_proj) is fixed upstream in 09deb8c, and no released tag contains it —
    # the newest, 3.31.4, predates it. Go back to `version:` as soon as a tag ships that does.
    #
    # Why *this* revision: it is the first that compiles against the Xcode 27 RC / iOS 27.0 SDK
    # (24A430). MLXFoundationModels tracks the FoundationModels API, and MLXHuggingFace — which we
    # link for `#hubDownloader` — pulls that module in through a default-on package trait, so its
    # build breakage is ours even though we never import it. Against the RC SDK the previous pin
    # fails on the shifted API (`LanguageModelCapabilities` is now unlabelled, `updateMetadata`
    # takes `[String: any ConvertibleToGeneratedContent]`); this revision retargets it. Chosen as
    # the minimal step — two commits past the previous pin — rather than upstream's tip.
    revision: 14414441fa44f45eee35a61e9fa0bab577cf9734
  swift-huggingface:
    # Same 0.x exposure as the DAT SDK, and it already drifted: the spec said `from: "0.1.0"` while
    # Package.resolved had walked to 0.9.0 — eight minor versions of a pre-1.0 package, adopted
    # silently. Pinned at the version actually in use.
    url: https://github.com/huggingface/swift-huggingface.git
    version: "0.9.0"
  swift-transformers:
    url: https://github.com/huggingface/swift-transformers.git
    from: "1.0.0"
  SystemNotification:
    url: https://github.com/danielsaidi/SystemNotification.git
    from: "1.0.0"
  WebRTC:
    url: https://github.com/stasel/WebRTC.git
    from: "120.0.0"
  # Vendored sherpa-onnx + onnxruntime iOS xcframeworks for the on-device Kokoro TTS
  # tier (Additional Capabilities #1). Local package; binaries under Vendor/SherpaOnnx/Frameworks.
  SherpaOnnx:
    path: Vendor/SherpaOnnx
  # Vendored MediaPipe Tasks Vision (Plan CK fingerspelling landmark pipeline). Local
  # package; binaries under Vendor/MediaPipeTasks/Frameworks are FETCHED, not committed —
  # run Scripts/fetch-mediapipe-frameworks.sh once after cloning (CI does it post-clone).
  MediaPipeTasks:
    path: Vendor/MediaPipeTasks
  # Vendored llama.cpp engine for the GGUF local-inference runtime (Plan DZ). Local package;
  # the binary under Vendor/LlamaCpp/Frameworks is BUILT, not committed — run
  # Scripts/fetch-llamacpp-framework.sh once after cloning (CI does it post-clone). The pin and
  # the digests are what's tracked: Vendor/LlamaCpp/{REVISION,SHA256SUMS,BUILD-INFO}.
  #
  # Linking it is not enabling it: nothing in the app reaches the engine unless
  # Config.ggufModelsEnabled is on, which it is not by default. The MLX path does not go through
  # this package at all.
  LlamaCpp:
    path: Vendor/LlamaCpp

targets:
  OpenGlasses:
    type: application
    platform: iOS
    sources:
      # Keep the StoreKit configuration visible to the scheme without shipping test products.
      - path: OpenGlasses/MedicalCompliance.storekit
        buildPhase: none
      - path: Contracts/fixtures/workiz-v2
        type: folder
        buildPhase: resources
      # Carries both string catalogs as resources: Resources/Localizable.xcstrings (the UI) and
      # Resources/InfoPlist.xcstrings, which Xcode compiles into each language's InfoPlist.strings
      # so the Info.plist privacy usage descriptions are shown in the phone's language. The
      # catalog's keys are the Info.plist keys; its English must match OpenGlasses/Info.plist
      # (LocalizationCatalogGuardTests holds the two together).
      - path: OpenGlasses/Sources
        excludes:
          - "Resources/Vaults/**"
      - path: OpenGlasses/Sources/Resources/Vaults
        type: folder
      # Shared with widget/watch targets — defines LogoIcon + AccentColors
      - path: GlassesActivityWidget/AccentColors.swift
      # Shared with widget target — UserDefaults-backed listening state
      - path: GlassesActivityWidget/SharedAppState.swift
      # Shared with widget target — the "Ask Avenkin" control's intent must be in the app too,
      # so iOS opens the app and runs it here; it hands the press over as a pending request.
      - path: GlassesActivityWidget/AskAvenkinControlIntent.swift
      - path: GlassesActivityWidget/PendingAskRequest.swift
    configFiles:
      Debug: Vendor/MediaPipeTasks/Frameworks/holistic-linker-flags.xcconfig
      Release: Vendor/MediaPipeTasks/Frameworks/holistic-linker-flags.xcconfig
    entitlements:
      path: OpenGlasses/OpenGlasses.entitlements
      properties:
        com.apple.developer.homekit: true
        # Read access for health summaries and the fitness coach's workout history, write access
        # for its saved workouts. Without it every HKHealthStore authorisation request fails in a
        # signed build. The App ID must carry the HealthKit capability before an archive signs.
        com.apple.developer.healthkit: true
        com.apple.developer.healthkit.access: []
        # get_weather, My Day's weather and the rain/alert answers come from WeatherKit. Without
        # the key every WeatherService request fails in a signed build. The App ID must carry the
        # WeatherKit capability and App Service before an archive signs.
        com.apple.developer.weatherkit: true
        com.apple.developer.carplay-voice-based-conversation: true
        com.apple.developer.kernel.increased-memory-limit: true
        # My Manuals' new-manual allowance syncs its history (fingerprints and dates, never a
        # manual) through iCloud key-value storage. The App ID must carry the iCloud capability
        # (key-value storage) before an archive signs. Without it the store stays local-only and
        # the keychain copy carries the history alone.
        com.apple.developer.ubiquity-kvstore-identifier: "$(TeamIdentifierPrefix)$(CFBundleIdentifier)"
        com.apple.security.application-groups:
          - group.com.openglasses.app
    settings:
      base:
        PRODUCT_BUNDLE_IDENTIFIER: com.openglasses.app
        MARKETING_VERSION: "2026.11"
        CURRENT_PROJECT_VERSION: "633"
        # The commit the project was generated at, for support reports (AppBuildIdentity).
        # Scripts/generate-xcodeproj.sh exports it; the Info.plist reads it as $(...). Stamped at
        # generation, not by a build phase: script sandboxing keeps a phase out of .git.
        AVENKIN_SOURCE_COMMIT: "${AVENKIN_SOURCE_COMMIT}"
        SWIFT_VERSION: "5.9"
        CODE_SIGN_ALLOW_ENTITLEMENTS_MODIFICATION: "YES"
        CODE_SIGN_STYLE: Automatic
        INFOPLIST_FILE: OpenGlasses/Info.plist
        GENERATE_INFOPLIST_FILE: "NO"
        INFOPLIST_KEY_CFBundleDisplayName: "Avenkin"
        INFOPLIST_KEY_LSApplicationCategoryType: "public.app-category.utilities"
        # Compiles the real on-device sherpa-onnx inference paths — Kokoro TTS (Additional
        # Capabilities #1, `#if KOKORO_ENABLED`) and SenseVoice ASR (#8, `#if SHERPA_ONNX_ENABLED`).
        # The vendored sherpa-onnx binary (Vendor/SherpaOnnx) provides the C API for both.
        OTHER_SWIFT_FLAGS: "$(inherited) -D KOKORO_ENABLED -D SHERPA_ONNX_ENABLED"
        SKIP_INSTALL: "NO"
      configs:
        # MediaPipe looks up graphs/calculators by name, so ordinary archive linking loses
        # their static registrations. Retain only the holistic CPU path using validated -u
        # anchors (issue #309), generated by Scripts/prepare-mediapipe-linking.py on fetch.
        # Use native xcconfig settings, not an ld @response file: Xcode does not notice
        # response-file edits when deciding whether an incremental build must relink.
        # -ObjC also retains the Tasks API categories (e.g. NSString cppString).
        # Never blanket-force-load the graph archive: that includes fst_types.o and its
        # OpenFst static initialisers, which hung pre-main in Release and XCTest (#304).
        # Both vendored frameworks are static archives; symbol counts alone do not establish
        # the precise Abseil binding/initialisation defect. Avoid its measured trigger.
        # Debug and Release use the same registrations so tests exercise the shipping graph.
        Debug:
          "OTHER_LDFLAGS[sdk=iphoneos*]": '$(inherited) $(MEDIAPIPE_HOLISTIC_LDFLAGS) "$(SRCROOT)/Vendor/MediaPipeTasks/Frameworks/graph_libraries/libMediaPipeTasksCommon_device_graph.a"'
          "OTHER_LDFLAGS[sdk=iphonesimulator*]": '$(inherited) $(MEDIAPIPE_HOLISTIC_LDFLAGS) "$(SRCROOT)/Vendor/MediaPipeTasks/Frameworks/graph_libraries/libMediaPipeTasksCommon_simulator_graph.a"'
        Release:
          "OTHER_LDFLAGS[sdk=iphoneos*]": '$(inherited) $(MEDIAPIPE_HOLISTIC_LDFLAGS) "$(SRCROOT)/Vendor/MediaPipeTasks/Frameworks/graph_libraries/libMediaPipeTasksCommon_device_graph.a"'
          "OTHER_LDFLAGS[sdk=iphonesimulator*]": '$(inherited) $(MEDIAPIPE_HOLISTIC_LDFLAGS) "$(SRCROOT)/Vendor/MediaPipeTasks/Frameworks/graph_libraries/libMediaPipeTasksCommon_simulator_graph.a"'
    dependencies:
      - package: HaishinKit
        product: HaishinKit
      - package: HaishinKit
        product: RTMPHaishinKit
      - package: mlx-swift-lm
        product: MLXLLM
      - package: mlx-swift-lm
        product: MLXLMCommon
      - package: mlx-swift-lm
        product: MLXVLM
      - package: mlx-swift-lm
        product: MLXHuggingFace
      - package: swift-huggingface
        product: HuggingFace
      - package: swift-transformers
        product: Tokenizers
      - package: SystemNotification
        product: SystemNotification
      - package: WebRTC
        product: WebRTC
      - package: SherpaOnnx
        product: SherpaOnnxWrapper
      - package: MediaPipeTasks
        product: MediaPipeTasksShim
      - package: LlamaCpp
        product: LlamaCppWrapper
      - target: GlassesActivityWidget
      - target: OpenGlassesShareExtension

  GlassesActivityWidget:
    type: app-extension
    platform: iOS
    sources:
      - path: GlassesActivityWidget
      - path: OpenGlasses/Sources/Models/GlassesActivityAttributes.swift
      # Shared with the main app — the widget stamps the deep-link trust token that the
      # app requires on any link that acts (capture, listen, quick action).
      - path: OpenGlasses/Sources/Shared/DeepLinkTrust.swift
      # Shared with the main app's tests — the Lock Screen row's layout and height budget.
      - path: OpenGlasses/Sources/Shared/LockScreenActivityLayout.swift
      # Shared with the main app, which writes it — the Home Screen widget's glasses line.
      - path: OpenGlasses/Sources/Shared/WidgetGlassesStatus.swift
    entitlements:
      path: GlassesActivityWidget/GlassesActivityWidget.entitlements
      properties:
        com.apple.security.application-groups:
          - group.com.openglasses.app
    info:
      path: GlassesActivityWidget/Info.plist
      properties:
        CFBundleDisplayName: "Avenkin"
        CFBundleShortVersionString: "$(MARKETING_VERSION)"
        CFBundleVersion: "$(CURRENT_PROJECT_VERSION)"
        NSExtension:
          NSExtensionPointIdentifier: com.apple.widgetkit-extension
    settings:
      base:
        PRODUCT_BUNDLE_IDENTIFIER: com.openglasses.app.GlassesActivityWidget
        MARKETING_VERSION: "2026.11"
        CURRENT_PROJECT_VERSION: "633"
        SWIFT_VERSION: "5.9"
        SKIP_INSTALL: "YES"
        CODE_SIGN_STYLE: Automatic

  # Share Extension (Teleprompter Phase 2 / PR B): accepts shared text, URLs, and text
  # files from the iOS share sheet and hands them to the app via the app-group inbox
  # (SharedTeleprompterInbox), which the main app drains into TeleprompterScriptStore.
  OpenGlassesShareExtension:
    type: app-extension
    platform: iOS
    sources:
      - path: OpenGlassesShareExtension
      # Shared with the main app — the app-group hand-off inbox.
      - path: OpenGlasses/Sources/Shared/SharedTeleprompterInbox.swift
    entitlements:
      path: OpenGlassesShareExtension/OpenGlassesShareExtension.entitlements
      properties:
        com.apple.security.application-groups:
          - group.com.openglasses.app
    info:
      path: OpenGlassesShareExtension/Info.plist
      properties:
        CFBundleDisplayName: "Avenkin Teleprompter"
        CFBundleShortVersionString: "$(MARKETING_VERSION)"
        CFBundleVersion: "$(CURRENT_PROJECT_VERSION)"
        NSExtension:
          NSExtensionPointIdentifier: com.apple.share-services
          NSExtensionPrincipalClass: ShareViewController
          NSExtensionAttributes:
            NSExtensionActivationRule:
              NSExtensionActivationSupportsText: true
              NSExtensionActivationSupportsWebURLWithMaxCount: 1
              NSExtensionActivationSupportsAttachmentsWithMaxCount: 1
    settings:
      base:
        PRODUCT_BUNDLE_IDENTIFIER: com.openglasses.app.ShareExtension
        MARKETING_VERSION: "2026.11"
        CURRENT_PROJECT_VERSION: "633"
        SWIFT_VERSION: "5.9"
        SKIP_INSTALL: "YES"
        CODE_SIGN_STYLE: Automatic

schemes:
  OpenGlasses:
    build:
      targets:
        OpenGlasses: all
        GlassesActivityWidget: all
        OpenGlassesShareExtension: all
    run:
      config: Debug
      debugEnabled: true
      askForAppToLaunch: false
      # Launch the app, not the widget. Without an explicit executable, XcodeGen
      # made the first buildable target the runnable — GlassesActivityWidget sorts
      # before OpenGlasses — and launchAutomaticallySubstyle: 2 turned the run
      # action into a WidgetKit "show widget" launch via SpringBoard, which fails
      # on a locked device ("Failed to show Widget … device was not unlocked").
      executable: OpenGlasses
      # Local StoreKit testing: the paywalls load these products with prices when run from
      # Xcode, without App Store Connect or a sandbox account. Keep the file's prices in
      # step with App Store Connect.
      storeKitConfiguration: OpenGlasses/MedicalCompliance.storekit
    archive:
      config: Release