Files
Ryan Vogel 9cf4d8b427 iOS: plain permission prompts and no pre-prompt Allow button, for App Review (#2058)
* iOS: plain purpose strings for the microphone and speech recognition

App Review 5.1.1(ii) wants purpose strings that clearly and completely say why
Hex needs access. The old speech string named an API ("SpeechTranscriber")
instead of saying what happens, and the microphone string didn't say what
becomes of the audio. Both now say what Hex does with it and that it stays on
the iPhone:

- Microphone: "Hex turns what you say into text on this iPhone. Audio never
  leaves your iPhone and is deleted once it's transcribed."
- Speech recognition: "Hex turns your recordings into text with Apple's
  on-device speech recognition. Nothing you say is sent to a server."

Same strings in the app and the keyboard extension (project.yml and the
generated Info.plists).

Verified: xcodegen regenerates identical Info.plists; Release build for
generic/platform=iOS succeeds and HEX.app/Info.plist carries the new strings.

* iOS onboarding: no Allow button before the microphone prompt, and no dead end when it's declined

Two App Review 5.1.1(iv) rejection patterns on the Set up Hex page:

1. A custom screen that leads into a permission prompt may not use "Allow"
   (or similar) on the button that triggers it; Apple asks for "Continue" or
   "Next". The Microphone row's small Allow button is gone. The row now says
   why ("So Hex can hear you dictate"), and iOS asks when the person taps
   Continue, or the Keyboard row's Open Settings (unchanged: it asks first so
   Microphone is listed on Hex's Settings page). Denied still shows Open
   Settings.
2. Continue needed the microphone granted, so anyone who declined it could
   never get into Hex, though the keyboard types without it. Continue now
   needs only the keyboard (added or unverifiable). Declining leads on to Try
   the keyboard, and the app's setup card keeps showing the microphone until
   it's allowed.

README's first-run section updated to match.

Verified: Release build for generic/platform=iOS succeeds. Not yet rendered
in a simulator.
2026-11-20 16:13:36 +00:00

155 lines
5.4 KiB
YAML

name: HEXMobile
options:
minimumXcodeGenVersion: 2.46.0
bundleIdPrefix: anomaly.hex
deploymentTarget:
iOS: "18.0"
xcodeVersion: "2660"
packages:
FluidAudio:
url: https://github.com/FluidInference/FluidAudio.git
exactVersion: 0.15.5
settings:
base:
DEVELOPMENT_TEAM: 5NZ4Q7NXJ4
SWIFT_VERSION: 6.0
targets:
HEXMobile:
type: application
platform: iOS
sources:
- HEXMobile
- HEXShared
- HEXActivity
- path: ../app/AppIcon.icon
buildPhase: resources
dependencies:
- package: FluidAudio
- target: HEXKeyboard
embed: true
- target: HEXWidgets
embed: true
info:
path: HEXMobile/Info.plist
properties:
CFBundleDisplayName: Hex
CFBundleShortVersionString: $(MARKETING_VERSION)
CFBundleVersion: $(CURRENT_PROJECT_VERSION)
CADisableMinimumFrameDurationOnPhone: true
CFBundleURLTypes:
- CFBundleTypeRole: Editor
CFBundleURLName: anomaly.hex.mobile.keyboard-session
CFBundleURLSchemes:
- hex-dictation
NSMicrophoneUsageDescription: Hex turns what you say into text on this iPhone. Audio never leaves your iPhone and is deleted once it's transcribed.
NSSpeechRecognitionUsageDescription: Hex turns your recordings into text with Apple's on-device speech recognition. Nothing you say is sent to a server.
NSSupportsLiveActivities: true
ITSAppUsesNonExemptEncryption: false
UIBackgroundModes:
- audio
UILaunchScreen:
UIColorName: LaunchBackground
UISupportedInterfaceOrientations:
- UIInterfaceOrientationPortrait
- UIInterfaceOrientationLandscapeLeft
- UIInterfaceOrientationLandscapeRight
UISupportedInterfaceOrientations~ipad:
- UIInterfaceOrientationPortrait
- UIInterfaceOrientationPortraitUpsideDown
- UIInterfaceOrientationLandscapeLeft
- UIInterfaceOrientationLandscapeRight
settings:
base:
ASSETCATALOG_COMPILER_ACCENT_COLOR_NAME: AccentColor
ASSETCATALOG_COMPILER_APPICON_NAME: AppIcon
CODE_SIGN_STYLE: Automatic
CODE_SIGN_ENTITLEMENTS: HEXMobile/HEXMobile.entitlements
CURRENT_PROJECT_VERSION: 1
GENERATE_INFOPLIST_FILE: NO
MARKETING_VERSION: 0.2.0
TARGETED_DEVICE_FAMILY: "1"
OTHER_LDFLAGS: $(inherited) -weak_framework FoundationModels
OTHER_SWIFT_FLAGS: $(inherited) -Xfrontend -disable-autolink-framework -Xfrontend FoundationModels
PRODUCT_BUNDLE_IDENTIFIER: anomaly.hex.mobile
PRODUCT_NAME: HEX
scheme:
gatherCoverageData: false
testTargets:
- HEXMobileTests
HEXKeyboard:
type: app-extension
platform: iOS
sources:
- HEXKeyboard
- HEXShared
info:
path: HEXKeyboard/Info.plist
properties:
CFBundleDisplayName: Hex Keyboard
NSMicrophoneUsageDescription: Hex turns what you say into text on this iPhone. Audio never leaves your iPhone and is deleted once it's transcribed.
NSSpeechRecognitionUsageDescription: Hex turns your recordings into text with Apple's on-device speech recognition. Nothing you say is sent to a server.
CFBundleShortVersionString: $(MARKETING_VERSION)
CFBundleVersion: $(CURRENT_PROJECT_VERSION)
NSExtension:
NSExtensionAttributes:
IsASCIICapable: true
PrefersRightToLeft: false
PrimaryLanguage: en-US
RequestsOpenAccess: true
NSExtensionPointIdentifier: com.apple.keyboard-service
NSExtensionPrincipalClass: $(PRODUCT_MODULE_NAME).KeyboardViewController
settings:
base:
APPLICATION_EXTENSION_API_ONLY: YES
CODE_SIGN_ENTITLEMENTS: HEXKeyboard/HEXKeyboard.entitlements
COREML_CODEGEN_LANGUAGE: None
CODE_SIGN_STYLE: Automatic
CURRENT_PROJECT_VERSION: 1
GENERATE_INFOPLIST_FILE: NO
MARKETING_VERSION: 0.2.0
TARGETED_DEVICE_FAMILY: "1"
PRODUCT_BUNDLE_IDENTIFIER: anomaly.hex.mobile.keyboard
PRODUCT_NAME: HEXKeyboard
SKIP_INSTALL: YES
HEXWidgets:
type: app-extension
platform: iOS
sources:
- HEXWidgets
- HEXActivity
- HEXShared/HexTheme.swift
info:
path: HEXWidgets/Info.plist
properties:
CFBundleDisplayName: Hex
CFBundleShortVersionString: $(MARKETING_VERSION)
CFBundleVersion: $(CURRENT_PROJECT_VERSION)
NSExtension:
NSExtensionPointIdentifier: com.apple.widgetkit-extension
settings:
base:
APPLICATION_EXTENSION_API_ONLY: YES
CODE_SIGN_STYLE: Automatic
CURRENT_PROJECT_VERSION: 1
GENERATE_INFOPLIST_FILE: NO
MARKETING_VERSION: 0.2.0
TARGETED_DEVICE_FAMILY: "1"
PRODUCT_BUNDLE_IDENTIFIER: anomaly.hex.mobile.widgets
PRODUCT_NAME: HEXWidgets
SKIP_INSTALL: YES
HEXMobileTests:
type: bundle.unit-test
platform: iOS
sources:
- HEXMobileTests
- path: ../tests/fixtures/vocabulary/audio/term-hex-1.wav
buildPhase: resources
dependencies:
- target: HEXMobile
settings:
base:
BUNDLE_LOADER: $(TEST_HOST)
CODE_SIGN_STYLE: Automatic
GENERATE_INFOPLIST_FILE: YES
PRODUCT_BUNDLE_IDENTIFIER: anomaly.hex.mobile.tests
TEST_HOST: $(BUILT_PRODUCTS_DIR)/HEX.app/$(BUNDLE_EXECUTABLE_FOLDER_PATH)/HEX