Если камера пропала после включения App Sandbox или подписи Release, начинать нужно не с `AVCaptureSession`, а с разрешений самой сборки. macOS проверяет entitlement, текст назначения в Info.plist и пользовательское решение TCC. Ошибка на любом уровне выглядит похоже, но исправляется в разных местах.
Возьмите именно `.app`, установленный пользователю, а не настройки target в открытом Xcode. Capability могла быть включена в Debug и отсутствовать в Release entitlements, либо архив подписан другим профилем. Система исполняет подписанный результат, а не намерение в проекте.
Три воротa камеры проверяются по очереди
| Слой | Что должно быть | Наблюдаемый сбой |
|---|---|---|
| подпись/entitlement | com.apple.security.device.camera = true | sandbox не разрешает доступ к устройству |
| Info.plist | NSCameraUsageDescription с понятным текстом | нет корректного privacy contract |
| TCC | authorized для video | denied/restricted или ещё не был запрос |
| AVFoundation | подходящий device и рабочий input | ошибка конфигурации session |
| железо/политика | камера доступна системе | нет устройств или ограничение организации |
Apple указывает: на macOS 10.14 и новее пользователь явно разрешает доступ. Для sandboxed target также включается Camera entitlement. Entitlement выражает намерение приложения, но сам по себе не означает согласие пользователя.
Проверяем не проект, а подписанный bundle
codesign -d --entitlements :- /Applications/Example.app
plutil -p /Applications/Example.app/Contents/Info.plist
codesign --verify --deep --strict --verbose=2 /Applications/Example.appВ первом выводе найдите `com.apple.security.app-sandbox` и `com.apple.security.device.camera` со значением true. Во втором — непустой `NSCameraUsageDescription`. Команды не изменяют приложение. Если bundle вложен в launcher/helper, проверьте executable, который реально обращается к AVFoundation: entitlement родительского процесса автоматически ему не передаётся.
Статус TCC читается до создания session
let status = AVCaptureDevice.authorizationStatus(for: .video)
switch status {
case .authorized:
startCapture()
case .notDetermined:
AVCaptureDevice.requestAccess(for: .video) { granted in
DispatchQueue.main.async { granted ? startCapture() : showDeniedUI() }
}
case .denied, .restricted:
showPrivacySettingsHint()
@unknown default:
showUnsupportedState()
}Запрос показывают в момент, когда человек выбирает функцию камеры, а не при старте программы. Повторный `requestAccess` после отказа не создаст новый системный диалог: приложение объясняет, где пользователь может изменить решение в System Settings → Privacy & Security → Camera. Автоматически нажимать или обходить это решение нельзя.
Debug и Release сравнивают как два разных продукта
- Сверьте bundle identifier и подпись: TCC связывает решение с идентичностью приложения.
- Проверьте Release configuration и итоговый `.xcent`, а не только галочку Signing & Capabilities.
- Запускайте копию из конечного пути установки; не подменяйте её неподписанным build.
- Если есть XPC service или helper, определите процесс, который открывает устройство.
- Для камеры с микрофоном добавьте отдельные entitlement и NSMicrophoneUsageDescription.
Ситуация «Xcode работает, архив нет» обычно локализуется именно здесь. Логи должны содержать bundle ID, build number, authorization status и ошибку добавления input, но не записывать изображение или список пользовательских устройств без необходимости.
Наличие устройства и разрешение — разные вопросы
После `.authorized` получите discovery session и проверьте, найдено ли видеоустройство. Нулевой список может означать отсутствие камеры, занятую/отключённую внешнюю камеру или корпоративную политику. Ошибку `AVCaptureDeviceInput` сохраняйте целиком с доменом и кодом. Не показывайте пользователю одно сообщение «дайте доступ» для всех этих случаев.
| authorizationStatus | Устройства | Следующее действие |
|---|---|---|
| notDetermined | неважно | показать контекст и запросить доступ |
| denied | могут находиться | ссылка-инструкция к Privacy & Security |
| restricted | неважно | объяснить системное/организационное ограничение |
| authorized | пусто | проверить hardware и discovery criteria |
| authorized | есть, input не добавляется | разобрать AVFoundation error и session preset |
Минимальная матрица воспроизводит проблему подписи
- Установить чистую Debug-сборку, запросить доступ и записать результат.
- Повторить с архивом Release и тем же bundle ID на отдельной тестовой учётной записи.
- Сравнить извлечённые entitlements и Info.plist двух bundle.
- Проверить сценарии notDetermined, authorized и denied без изменения кода между ними.
- Подключить и отключить внешнюю камеру до и после запуска session.
- Проверить helper/XPC отдельно, если захват выполняется не главным процессом.
- Убедиться, что интерфейс не зависает, пока permission callback возвращается асинхронно.
Для удалённого разбора нужны macOS version, модель распространения, bundle ID, извлечённые entitlements, privacy keys, authorizationStatus и обезличенная ошибка AVFoundation. Provisioning profile и приватный ключ подписи не передавайте. Ремонт завершён, когда Release впервые показывает системный запрос, уважает отказ и стабильно запускает capture после разрешения.