# Пошаговое руководство: установка Horizon-Android (эмулятор Nintendo Switch) на Android и настройка игр

> AI Release · @ai_release1 · https://ai-release.org/guides/poshagovoe-rukovodstvo-ustanovka-horizon-android-emulya.html

## TL;DR

- Время выполнения: 40–60 минут (без учёта скачивания игр)
- Уровень сложности: Intermediate
- Понадобится: ARM64-устройство на Android с поддержкой Vulkan, ПК с Android Platform Tools (`adb`), APK Horizon-Android из официального релиза проекта, `prod.keys` и файлы прошивки, снятые с вашей собственной консоли, игра в формате NSP/XCI, свободное место не меньше суммы размеров игры, прошивки и кэша

Большинство инструкций заканчиваются на «установите APK и добавьте игру». После этого читатель получает чёрный экран и не понимает, что именно сломалось: сборка не встала на устройство, эмулятор не нашёл ключи или GPU не вытягивает Vulkan. Этот гайд построен вокруг трёхслойной диагностики — каждый шаг заканчивается проверкой, которая отсекает свой слой.

Второй момент, который обычно пропускают: на Android 11+ файловые менеджеры не видят каталог `/Android/data/`, поэтому ключи и прошивку нельзя «перетащить» через проводник — только через `adb` или через встроенный файловый пикер эмулятора. Ниже команды для обоих путей.

| Слой | Как проявляется | Чем проверяется |
|---|---|---|
| 1. APK и ABI | «Приложение не установлено», установка падает | `adb shell getprop ro.product.cpu.abi` |
| 2. Данные: ключи и прошивка | Эмулятор ставится, но игра не открывается | `adb shell ls .../files/keys` |
| 3. GPU и драйвер Vulkan | Запуск есть, дальше чёрный экран / артефакты | `adb shell pm list features \| grep vulkan` |

Идентификатор пакета и точные пути внутри каталога приложения зависят от сборки Horizon-Android — в тексте они помечены как `<package-эмулятора>` и `<путь>`. Эти значения сверьте с документацией проекта.

## Требования и подготовка
![Иллюстрация к разделу «Требования и подготовка»](https://ai-release.org/guides/img/poshagovoe-rukovodstvo-ustanovka-horizon-android-emulya-ru-1.jpg?v=1795250820)


- Android-устройство с 64-битным ARM-процессором (`arm64-v8a`). На `armeabi-v7a` эмулятор не установится — минимальную версию Android сверьте с документацией сборки.
- Поддержка Vulkan (проверяется одной командой в Шаге 1). Без неё эмулятор либо не запустит рендер, либо упадёт при старте игры.
- ПК с Windows/macOS/Linux и Android Platform Tools — набор утилит, где `adb` (Android Debug Bridge) передаёт файлы и команды с компьютера на телефон.
- APK Horizon-Android из официального релиза. Сторонние APK и магазины ставятся по инструкции [как установить сторонние магазины приложений на Android 17 и пройти верификацию разработчика](https://ai-release.org/guides/poshagovoe-rukovodstvo-kak-ustanovit-storonnie-magaziny.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide) — там же разобрано разрешение установки из неизвестных источников.
- `prod.keys` и файлы прошивки, снятые с вашей собственной консоли. Файлы игр и ключей из чужих источников не используйте.
- Игра в формате `.nsp` или `.xci` плюс отдельные файлы обновления/DLC, если они нужны.

Чек-лист перед стартом:

- [ ] В настройках разработчика включена «Отладка по USB»
- [ ] На экране телефона подтверждён запрос «Разрешить отладку по USB?» с отпечатком ключа ПК
- [ ] `adb devices` показывает статус `device`, а не `unauthorized`
- [ ] Свободного места хватает на игру, прошивку и кэш шейдеров
- [ ] `prod.keys` не переименован в `prod.keys.txt` (частая причина отказа)

## Шаг 1. Установка APK и проверка ABI
![Иллюстрация к разделу «Шаг 1. Установка APK и проверка ABI»](https://ai-release.org/guides/img/poshagovoe-rukovodstvo-ustanovka-horizon-android-emulya-ru-2.jpg?v=1795250824)


**Что сделать:** подключить телефон по USB, проверить разрядность и Vulkan, установить APK.

**Зачем:** это слой 1. Если ABI не совпадает, дальше идти бессмысленно — эмулятор просто не встанет на устройство.

**Как проверить:** три команды ниже и строка `Success` в конце.

```bash
adb devices
adb shell getprop ro.product.cpu.abi
adb shell pm list features | grep vulkan
adb install -r horizon-android.apk
```

**Пример:** ожидаемый вывод.

```text
List of devices attached
R58M12ABCDE	device
arm64-v8a
feature:android.hardware.vulkan.version
Performing Streamed Install
Success
```

Если `adb devices` показывает `unauthorized` — на телефоне не подтвердили отладку; отключите и подключите кабель заново. Если `ro.product.cpu.abi` вернул `armeabi-v7a`, устройство не подходит.

Установить приложение можно и без ПК — через магазин приложений или файловый менеджер, пошагово это разобрано в гайде [как скачивать и устанавливать ИИ-приложения на Android через RuStore](https://ai-release.org/guides/kak-skachivat-i-ustanavlivat-ii-prilozheniya-na-android.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide). Логика та же: скачать APK, разрешить установку из этого источника, подтвердить установку.

Запомните идентификатор пакета — он понадобится в Шаге 2:

```bash
adb shell pm list packages | grep -i horizon
```

**Пример:** `package:<id-пакета-из-релиза>` — подставьте его вместо `<package-эмулятора>` везде ниже.

## Шаг 2. Ключи, прошивка и каталог игр
![Иллюстрация к разделу «Шаг 2. Ключи, прошивка и каталог игр»](https://ai-release.org/guides/img/poshagovoe-rukovodstvo-ustanovka-horizon-android-emulya-ru-3.jpg?v=1795250827)


**Что сделать:** положить `prod.keys`, файлы прошивки и игру в каталог, который читает эмулятор.

**Зачем:** ключи (`prod.keys` — набор криптографических ключей консоли, без них эмулятор не расшифрует образ игры) и прошивка — это слой 2. APK уже стоит, но без данных игра не откроется: эмулятор покажет сообщение об отсутствии ключей или пустой список игр.

**Как проверить:** список файлов в каталоге ключей и появление игры в библиотеке эмулятора.

Типовая раскладка каталога данных приложения выглядит так (структуру конкретной сборки сверьте с документацией):

```text
/sdcard/Android/data/<package-эмулятора>/files/
├── keys/
│   └── prod.keys
├── nand/
│   └── system/Contents/registered/   ← сюда распакованная прошивка
└── ...
```

Заливка ключей и прошивки:

```bash
adb shell mkdir -p /sdcard/Android/data/<package-эмулятора>/files/keys
adb push prod.keys /sdcard/Android/data/<package-эмулятора>/files/keys/prod.keys
adb shell ls -l /sdcard/Android/data/<package-эмулятора>/files/keys
```

**Пример:** ожидаемый вывод последней команды.

```text
-rw-rw---- 1 u0_a321 sdcard_rw  prod.keys
```

Прошивка заливается распакованным набором файлов, а не архивом:

```bash
adb push ./firmware/. /sdcard/Android/data/<package-эмулятора>/files/nand/system/Contents/registered/
adb shell ls /sdcard/Android/data/<package-эмулятора>/files/nand/system/Contents/registered/ | head
```

Игра кладётся в отдельную папку, которую вы потом укажете в эмуляторе как каталог игр:

```bash
adb shell mkdir -p /sdcard/Games/Switch
adb push MyGame.nsp /sdcard/Games/Switch/MyGame.nsp
```

**Пример:** `adb shell ls /sdcard/Games/Switch` → `MyGame.nsp`.

Почему это работает: `adb shell` имеет доступ к `/Android/data/`, а обычный файловый менеджер на Android 11+ — нет, поэтому «перетаскивание» через проводник молча не срабатывает. Если ПК под рукой нет, те же файлы выбираются через встроенный файловый пикер эмулятора (пункт вида «Import keys» / «Install firmware») — точные названия пунктов сверьте с документацией.

В эмуляторе укажите каталог игр `/sdcard/Games/Switch`. Обновления и DLC ставятся после базовой игры отдельными файлами — сначала база, потом обновление.

## Шаг 3. Драйвер GPU, настройки и запуск игры

**Что сделать:** выбрать драйвер рендера, выставить разрешение и запустить игру.

**Зачем:** это слой 3. Даже с корректными ключами игра упадёт, если выбран неподходящий драйвер Vulkan — типовой симптом «чёрный экран через 2–3 секунды после заставки».

**Как проверить:** игра доходит до главного меню, а в `logcat` нет ошибок ключей и падений рендера.

Запуск с логом:

```bash
adb logcat -c
adb logcat | grep -iE "vulkan|nca|keys|fatal signal"
```

**Пример:** успешный запуск — строки про инициализацию Vulkan без `Keys not found` и без `Fatal signal 11`. Неудачный — `Fatal signal 11 (SIGSEGV), code 1 (SEGV_MAPERR)` в момент старта рендера.

Что менять в настройках эмулятора (названия пунктов сверьте с документацией):

1. GPU driver / Renderer — системный драйвер Vulkan по умолчанию. На Adreno часто быстрее кастомный Turnip (открытый Vulkan-драйвер для чипов Adreno), если сборка поддерживает импорт драйвера.
2. Разрешение (resolution scale) — начните с 1x; повышайте только после стабильного запуска.
3. Режим docked/handheld — docked даёт более высокое разрешение и сильнее грузит GPU; для слабых устройств оставьте handheld.
4. Accuracy/точность эмуляции — если игра глючит визуально, попробуйте более высокий уровень точности, если тормозит — более низкий.

Замеры FPS и совместимость конкретных игр здесь не приводятся: они зависят от SoC, драйвера и версии сборки — сверьтесь с документацией проекта и списком совместимости.

Признак успеха: игра стабильно держит главное меню, звук есть, артефактов нет. Если картинка есть, но стабильно падает через минуту — вернитесь к пункту 1 и смените драйвер.

## Возможные проблемы и решения

**Проблема. APK не устанавливается, установка обрывается сразу**

- Ошибка: `Failure [INSTALL_FAILED_NO_MATCHING_ABIS: Failed to extract native libraries, res=-113]`
- Причина: устройство или прошивка 32-битные (`armeabi-v7a`), а APK содержит только 64-битные библиотеки.
- Решение: проверьте `adb shell getprop ro.product.cpu.abi`. Если вывод `armeabi-v7a` — устройство не подходит, установка невозможна. Если `arm64-v8a` — удалите старую версию (`adb uninstall <package-эмулятора>`) и поставьте APK заново.

**Проблема. Эмулятор открывается, но игра не запускается, библиотека пустая**

- Ошибка: сообщение вида `Keys not found` (в части сборок — `Firmware not found`)
- Причина: `prod.keys` лежит не в том каталоге, переименован в `prod.keys.txt` или прошивка залита архивом вместо распакованных файлов.
- Решение: `adb shell ls -l /sdcard/Android/data/<package-эмулятора>/files/keys` — в списке должен быть ровно `prod.keys`. Переименуйте файл при необходимости и перезапустите эмулятор: `adb shell am force-stop <package-эмулятора>`.

**Проблема. Игра стартует и вылетает с чёрным экраном или артефактами**

- Ошибка: в логе `Fatal signal 11 (SIGSEGV), code 1 (SEGV_MAPERR)` сразу после инициализации Vulkan
- Причина: неподходящий драйвер GPU или слишком высокое разрешение.
- Решение: смените драйвер (системный ↔ Turnip на Adreno), поставьте resolution scale 1x, отключите docked-режим. На устройствах с GPU Mali кастомные Vulkan-драйверы не устанавливаются — там доступен только системный драйвер, и часть игр может не запускаться вовсе; сверьтесь со списком совместимости.

## Резюме и следующие шаги

Рабочая установка — это три подтверждённых слоя: `arm64-v8a` + Vulkan, `prod.keys` и прошивка на месте, подобранный драйвер GPU. Дальше настраивайте resolution scale и точность эмуляции под конкретную игру, сверяясь со списком совместимости сборки.

## FAQ

**Нужен ли root для Horizon-Android?**
Нет. Установка APK, ключи и игры работают на обычном устройстве; `adb` нужен только для удобной передачи файлов, и его можно заменить файловым пикером эмулятора.

**Почему игра не видна в библиотеке, хотя файл на месте?**
Проверьте формат (`.nsp`/`.xci`) и что в настройках указан именно тот каталог, куда вы залили файл. Обновление или DLC без базовой игры не отображается как отдельная игра.

**Работает ли эмулятор на MediaTek и Mali?**
Запуск возможен только на системном Vulkan-драйвере, кастомный Turnip там не устанавливается. Часть игр будет падать или выдавать артефакты — сверьтесь со списком совместимости вашей сборки.

**Где брать ключи и прошивку?**
Только дампом со своей консоли. Файлы `prod.keys` и прошивка из сторонних источников — риск повреждённых данных и нарушения прав правообладателя.
