# Rocknix и ABL: как прошить портативную консоль и не получить кирпич

> AI Release · @ai_release1 · https://ai-release.org/guides/rocknix-abl-proshivka-konsoli.html

## TL;DR

- Время выполнения: 30–40 минут
- Уровень сложности: Advanced
- Понадобится:
  - портативная игровая консоль, которая **уже загружается через загрузчик ROCKNIX** (на других загрузчиках ABL Dual Boot не заработает);
  - ПК с установленным `adb` и исправным USB-кабелем с передачей данных;
  - `git` на ПК;
  - доступ к терминалу ROCKNIX (локально или по SSH);
  - установленный Decky Loader — менеджер плагинов для портативных консолей, если хотите переключатель внутри Linux;
  - репозиторий `kingsleydon/abl-dualboot` на GitHub.

## Требования и подготовка
![Иллюстрация к разделу «Требования и подготовка»](https://ai-release.org/guides/img/rocknix-abl-proshivka-konsoli-ru-1.jpg?v=1793695491)


Главная защита от кирпича — не трогать загрузчик. ABL Dual Boot (ABL — Android Bootloader, загрузчик Android) работает **поверх** загрузчика ROCKNIX: он лишь переключает уже установленные системы, а не прошивает загрузочную область. Процедуры прошивки загрузчика в описании проекта нет — не выполняйте её «на всякий случай».

- [ ] Убедиться, что консоль загружается в ROCKNIX (Linux-прошивка для портативных консолей) — это обязательное условие проекта.
- [ ] Проверить, что на устройстве есть обе системы: Android и Linux. Переключать нечего, если одна из них отсутствует.
- [ ] Установить на ПК `adb` и `git`, проверить их доступность в PATH.
- [ ] Подготовить USB-кабель с передачей данных (зарядные кабели без линий данных не подходят).
- [ ] Сделать резервную копию пользовательских данных на обеих системах — установка стороннего ПО и переключения её не заменяют.
- [ ] Скачать репозиторий `kingsleydon/abl-dualboot` и прочитать README: точные имена файлов, требования к root и порядок установки указаны там.

**Пример:** проверка инструментов на ПК перед началом.

```bash
git --version
adb version
```

Ожидаемый вывод: строка вида `git version <номер>` и строка `Android Debug Bridge version <номер>`. Если команда не найдена — установите пакет платформенных инструментов Android и повторите, иначе `adb install` на шаге 2 не сработает.

**Зачем:** без `adb` вы не поставите APK, без `git` — не получите сам проект. **Как проверить:** обе команды завершаются без `command not found`.

## Шаг 1. Проверка загрузчика ROCKNIX и связи с устройством

**Что сделать:** подтвердить, что система загружается именно через ROCKNIX, и настроить ADB-доступ.

**Зачем:** это единственный технический барьер, названный в описании проекта. Если загрузчик другой, переключение не заработает в принципе — и вы потратите время на установку компонентов, которые ни к чему не подключатся.

На консоли откройте терминал (локально или по SSH к ROCKNIX) и выполните:

```bash
cat /etc/os-release
uname -a
```

Ожидаемый вывод: строки `NAME=`/`PRETTY_NAME=` с упоминанием ROCKNIX и строка ядра Linux. Если в `PRETTY_NAME` другой дистрибутив или файл отсутствует — сверьтесь с документацией вашей сборки, прежде чем продолжать.

Затем подключите консоль к ПК кабелем, включите отладку по USB в Android и проверьте связь:

```bash
adb devices
```

Ожидаемый вывод:

```
List of devices attached
<серийный-номер>	device
```

Слово `device` — успех. `unauthorized` и `offline` — см. раздел проблем.

**Пример:** на устройстве после подключения появляется системный запрос «Разрешить отладку по USB?» — нажмите «Разрешить» и повторите `adb devices`; строка должна смениться с `unauthorized` на `device`.

**Как проверить:** в `adb devices` ровно одна строка со статусом `device`, а `uname -a` показывает Linux-ядро ROCKNIX.

## Шаг 2. Установка трёх компонентов ABL Dual Boot
![Иллюстрация к разделу «Шаг 2. Установка трёх компонентов ABL Dual Boot»](https://ai-release.org/guides/img/rocknix-abl-proshivka-konsoli-ru-2.jpg?v=1793695497)


**Что сделать:** получить репозиторий и установить все три части проекта — Android-приложение с плиткой Quick Settings (плитка в шторке быстрых настроек Android), плагин Decky и Linux-скрипт.

**Зачем:** каждая часть — это кнопка переключения в своей среде. Плитка работает из Android, плагин — из интерфейса Decky в Linux, скрипт — из терминала. Ставите только те, которыми будете пользоваться, но набор удобнее держать полным: если одна среда перестанет отвечать, останется вторая точка входа.

| Компонент | Где работает | Что делает |
|---|---|---|
| Android-приложение с плиткой Quick Settings | Android | Переключение одним нажатием из шторки |
| Плагин Decky | Linux (Decky Loader) | Переключение из интерфейса плагинов |
| Linux-скрипт | Терминал ROCKNIX | Переключение командой |

Клонируйте репозиторий и посмотрите состав:

```bash
git clone https://github.com/kingsleydon/abl-dualboot
cd abl-dualboot
ls -la
```

Ожидаемый вывод: список файлов, среди которых APK, файл плагина и `.sh`-скрипт. Точные имена файлов сверьте с README репозитория — они могут меняться от версии к версии. Общий порядок установки проекта с GitHub разобран в гайде [Sideraven: как установить с GitHub и перенести закладки](https://ai-release.org/guides/sideraven-ustanovka-s-github.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide).

Установите APK:

```bash
adb install -r <имя-файла>.apk
```

Ожидаемый вывод: `Success`. Перед установкой полезно проверить сам файл — методика в гайде [WordCraft APK для Android: где скачать, как проверить файл и установить](https://ai-release.org/guides/wordcraft-apk-android-skachat.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide).

Установите Linux-скрипт и дайте ему право на запуск:

```bash
chmod +x <имя-скрипта>.sh
./<имя-скрипта>.sh
```

Ожидаемый вывод: сообщение скрипта о старте переключения либо код возврата `0` без текста ошибки. Плагин Decky ставится штатным способом Decky Loader; если скрипт требует root, README укажет это прямо — сверьтесь с документацией проекта.

**Пример:** `adb install -r abl-dualboot.apk` → в терминале `Success`, а в шторке Android появляется новая плитка. Если плитки нет — приложение установилось, но не добавлено в набор быстрых настроек: добавьте вручную через редактирование шторки.

**Как проверить:** `adb shell pm list packages | grep -i abl` выводит имя установленного пакета, а в шторке Android видна плитка проекта.

## Шаг 3. Проверка переключения Android ⇄ Linux
![Иллюстрация к разделу «Шаг 3. Проверка переключения Android ⇄ Linux»](https://ai-release.org/guides/img/rocknix-abl-proshivka-konsoli-ru-3.jpg?v=1793695504)


**Что сделать:** по очереди проверить каждую точку входа и убедиться, что система действительно меняется.

**Зачем:** установленный компонент и работающее переключение — разные вещи. Проверка по одному каналу за раз показывает, какой именно компонент не работает, и избавляет от «переставил всё, а причина была в одном».

Порядок проверки:

1. **Плитка в Android.** Откройте шторку, нажмите плитку ABL Dual Boot. Ожидаемый результат: консоль уходит в Linux/ROCKNIX.
2. **Плагин Decky.** В Linux откройте меню Decky и нажмите кнопку плагина. Ожидаемый результат: загрузка Android.
3. **Linux-скрипт.** В терминале ROCKNIX запустите `./<имя-скрипта>.sh`. Ожидаемый результат: тот же переход в Android.

Проверьте, в какой системе вы оказались:

```bash
uname -a                                          # в Linux выведет ядро ROCKNIX
adb shell getprop ro.product.model                # в Android выведет модель устройства
```

Ожидаемый вывод: либо строка ядра Linux, либо строка с моделью вида `<модель-устройства>` без ошибок. Значение зависит от вашей прошивки — это нормально.

**Пример:** нажали плитку → экран перезагрузился в ROCKNIX → в терминале `uname -a` показывает Linux → нажали кнопку плагина Decky → снова Android, а `adb shell getprop ro.product.model` возвращает модель консоли. Цикл замкнулся — установка успешна.

**Как проверить:** оба перехода выполняются без ошибок, и хотя бы один компонент из трёх даёт переход в каждую сторону. Если плитка работает, а плагин нет — проблема в Decky, а не в загрузчике.

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

**Проблема. Компьютер не видит консоль при установке APK**

- Ошибка: `error: device unauthorized.`
- Причина: на консоли не подтверждён запрос на отладку по USB — ADB видит устройство, но не имеет разрешения.
- Решение: отключите и снова подключите кабель, на экране консоли нажмите «Разрешить», затем перезапустите сервер: `adb kill-server && adb devices`. Статус должен смениться на `device`.

**Проблема. Скрипт не запускается из терминала**

- Ошибка: `bash: ./<имя-скрипта>.sh: Permission denied`
- Причина: у файла нет бита исполнения — он скачан как обычный текстовый файл.
- Решение: выполните `chmod +x <имя-скрипта>.sh` и запустите снова через `./<имя-скрипта>.sh`.

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

- Ошибка: `adb: failed to install <имя-файла>.apk: Failure [INSTALL_FAILED_INVALID_APK]`
- Причина: файл скачан не полностью или повреждён при передаче.
- Решение: перекачайте APK из репозитория, сверьте контрольную сумму, если она опубликована, и повторите `adb install -r <имя-файла>.apk`. Проверка файлов перед установкой разобрана по шагам в [гайде по WordCraft APK](https://ai-release.org/guides/wordcraft-apk-android-skachat.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide).

Отдельно: если плитка и плагин установлены, но переключение не происходит ни в одну сторону — проверьте загрузчик. Проект требует ROCKNIX bootloader; на других загрузчиках он не заработает. Не начинайте перепрошивку загрузчика «для проверки» — сверьтесь с документацией вашей модели.

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

Установка сводится к трём действиям: подтвердить загрузчик ROCKNIX и ADB-доступ, поставить APK с плиткой, плагин Decky и Linux-скрипт, затем проверить оба перехода. Дальше настройте наиболее удобную точку входа как основную и держите вторую как резервную на случай, если одна среда не загрузится.

## FAQ

**Работает ли ABL Dual Boot на консоли с другим загрузчиком?**
Нет. Проект требует устройство с загрузчиком ROCKNIX; на других загрузчиках переключение не заработает.

**Где взять сам проект?**
На GitHub: репозиторий `kingsleydon/abl-dualboot`. Точные имена файлов и порядок установки сверяйте с README — состав может меняться.

**Какие компоненты входят в ABL Dual Boot?**
Три: Android-приложение с плиткой Quick Settings, плагин Decky и Linux-скрипт. Каждый даёт переключение в своей среде.

**Можно ли получить кирпич при установке?**
Сама установка компонентов загрузочную область не меняет — проект работает поверх уже имеющегося загрузчика ROCKNIX. Риск возникает при попытке перепрошить загрузчик: процедура в описании проекта не приводится, поэтому не выполняйте её без документации от производителя вашей модели.