Xiaomi: INSTALL_FAILED_USER_RESTRICTED при установке приложения

#Что означает ошибка

На телефонах Xiaomi, Redmi и POCO с MIUI/HyperOS при установке APK через adb install или из Android Studio появляется сообщение INSTALL_FAILED_USER_RESTRICTED: Install canceled by user. Система запрещает установку приложений через USB, пока в «Для разработчиков» не включены специальные переключатели, для которых требуется вход в Mi-аккаунт и SIM-карта.

#Причины и решения

#Пошаговое решение

1. Включите режим разработчикаЕсли это ваш Android и вы осознанно устанавливаете программу через USB, откройте «Настройки» → «О телефоне» → нажмите «Номер сборки» или «Версия MIUI/HyperOS» семь раз до сообщения о режиме разработчика. Затем найдите «Для разработчиков» через поиск в настройках и включите «Отладка по USB» только на время диагностики. Подключите телефон кабелем передачи данных, разблокируйте экран и подтвердите отпечаток ключа RSA только своего компьютера. На компьютере с установленными официальными Android SDK Platform-Tools откройте терминал в папке platform-tools и выполните adb devices: статус device означает подключение, unauthorized — требуется подтверждение на телефоне, offline — переподключение/перезапуск ADB. После работы выключите отладку.
2. Откройте параметрыТолько на личном телефоне, если вы устанавливаете доверенное приложение через свой компьютер: откройте «Настройки» → «Расширенные настройки» → «Для разработчиков» (для появления раздела на части Xiaomi нужно семь раз нажать «Версия MIUI/HyperOS» в «О телефоне»). Перед включением отладки убедитесь, что устройство не рабочее и не ограничено администратором. По окончании диагностики выключите отладку USB.
3. Включите отладкуЕсли установка идёт через ADB, в «Настройки» → «Расширенные настройки» → «Для разработчиков» включите «Отладка по USB» и подтвердите предупреждение. Подключите телефон к собственному компьютеру кабелем передачи данных, разблокируйте экран, сверьте отпечаток ключа и разрешите доступ только доверенному ПК. Это не нужно при обычной установке из Google Play. После окончания выключите отладку.
4. Включите установку по USBНа некоторых MIUI есть отдельная настройка «Установка по USB» в «Для разработчиков»: её может не быть в вашей версии. Если доступна, используйте только при установке своей проверенной сборки с доверенного ПК и при осознанном согласии с предупреждением системы. Если пункт недоступен или его блокирует политика безопасности, не пытайтесь обходить ограничения через сомнительные утилиты — используйте официальный магазин или обратитесь к администратору.
5. Включите безопасную отладкуОткройте «Настройки» → «Приложения» → «Все приложения» → «проблемное приложение» → «Разрешения». Найдите именно нужный доступ: «Микрофон» для звонка, «Камера» для съёмки или «Уведомления» для оповещений. Выберите «Разрешить только во время использования» для микрофона/камеры, если это соответствует задаче, либо разрешите уведомления. Вернитесь в приложение и повторите исходное действие. Если разрешение запрещено администратором устройства, не обходите запрет.
6. Подтвердите на экранеОткройте браузер на телефоне и попробуйте открыть несколько обычных сайтов. Если не открываются, смахните шторку быстрых настроек и сравните Wi-Fi с мобильной передачей данных (мобильный трафик может тарифицироваться). Если проблема только в домашнем Wi-Fi, проверьте другие устройства и перезапустите маршрутизатор, не сбрасывая его настройки. Если сайты открываются, а приложение выдаёт ошибку, проверьте сам сервис и переходите к следующему способу.
7. Повторите установкуОткройте командную строку через поиск в меню «Пуск»; если команда изменяет систему, используйте «Запуск от имени администратора». Найдите блок команд под инструкцией, выполняйте команды по очереди и читайте результат после каждой. Не запускайте команды из другой операционной системы.
8. Проверьте приложение «Безопасность»Откройте «Настройки» → «Приложения» → «Управление приложениями» и найдите приложение, которое не удаётся установить. Если устройство управляется организацией или семейным контролем, именно эта политика может запрещать установку. У штатной Xiaomi «Безопасность» набор пунктов зависит от версии; не выдавайте незнакомому установщику дополнительные разрешения «на всякий случай». Запишите точный код INSTALL_FAILED_USER_RESTRICTED для администратора или разработчика приложения.
9. Дополнительная команда по теме

   Linux · Терминал (Bash)КомандаКопировать всёВыделить

   Проверка подключения и установка APK через ADB (скачайте platform-tools).

   adb devices

   adb install -r app.apk

Если пункт «Установка по USB» не включается, проверьте, что вставлена SIM-карта и включён мобильный интернет или Wi-Fi: MIUI проверяет аккаунт через сервер. В HyperOS пункт может называться «Установка через USB» либо «USB debugging (Security settings)». Если на экране телефона появляется диалог MIUI Optimization, отключите «Оптимизацию MIUI» в разделе для разработчиков (потребуется перезагрузка). Подробности по ADB — в документации Android.