Как устанавливать приложения в muOS через Archive Manager (файлы .muxapp)

Приложения для muOS распространяются одним файлом с расширением .muxapp. Его не нужно распаковывать и не нужно копировать папки: в muOS есть встроенный установщик Archive Manager, который делает это за вас. В руководстве показан весь процесс, что происходит внутри, и две вещи, на которых чаще всего спотыкаются: обновления, сбрасывающие настройки, и удаление приложений.

Проверено на: Anbernic RG40XXH · muOS 2601.0 Jacaranda. На других консолях с muOS всё работает так же.

Что такое файл .muxapp

Файл .muxapp — это обычный ZIP-архив с другим расширением. Внутри одна папка с названием приложения, например:

WiFiTransfer.muxapp
└── WiFiTransfer/
    ├── mux_launch.sh    ← через этот файл muOS запускает приложение
    ├── config.ini
    └── …

Установка — это распаковка этой папки в MUOS/application/ на SD-карте. Каждое приложение из этой папки появляется в меню Applications.

Шаг 1: скопируйте файл в папку ARCHIVE

Archive Manager показывает файлы из папки ARCHIVE в корне SD-карты 1 (карты, с которой работает muOS). Если такой папки нет, создайте её — заглавными буквами.

Есть три простых способа положить туда файл:

Картридер: выключите консоль, вставьте SD-карту 1 в компьютер и скопируйте файл .muxapp в ARCHIVE. Перед тем как вынуть карту, корректно извлеките её.
По Wi-Fi через Wi-Fi Transfer: откройте приложение на консоли, откройте показанный адрес в браузере телефона или ПК и на вкладке SD-карта 1 нажмите Добавить игры и выберите .muxapp. Он автоматически попадёт в ARCHIVE.
SFTP: muOS умеет запускать SFTP-сервер: включите SFTP + Filebrowser в Configuration → Connectivity → Web Services. После этого любое SFTP-приложение (FileZilla, Cyberduck, WinSCP) может скопировать файл в ARCHIVE на SD-карте 1.

Не меняйте имя файла: Archive Manager решает, что делать, по расширению (.muxapp).

Шаг 2: установите через Archive Manager

На консоли откройте Applications → Archive Manager.
Выберите файл .muxapp и нажмите A.
muOS закроет меню и во время работы покажет текстовый экран: Inspecting Archive…, распаковываемые файлы, Sync Filesystem и в конце All Done!
Через пару секунд вы вернётесь в Archive Manager. Файл теперь помечен как INSTALLED.

Откройте Applications: новое приложение есть в списке. Некоторым приложениям перед запуском нужен включённый Wi-Fi (Configuration → Connectivity → Wi-Fi Network).

После установки файл .muxapp остаётся в ARCHIVE. Его можно оставить как резервную копию или удалить: установленному приложению он не нужен.

Что на самом деле делает Archive Manager

Прежде чем что-то распаковывать, Archive Manager проверяет архив и отказывается его устанавливать, если какой-либо путь внутри ведёт за пределы целевой папки (абсолютный путь или ..). Поэтому повреждённый или вредоносный пакет не сможет таким способом перезаписать системные файлы muOS.

Эта проверка касается расположения файлов, а не того, что приложение делает после запуска. В muOS приложения работают с полным доступом к системе, поэтому устанавливайте файлы .muxapp только из надёжных источников: с сайта самого разработчика или со страницы релизов на GitHub.

Archive Manager нужен не только для приложений. Способ установки он выбирает по расширению файла:

Расширение	Что это	Куда попадает
`.muxapp`	Приложение	`MUOS/application/`
`.muxthm`	Тема	`MUOS/theme/<название>/`
`.muxalt`	Альтернативный вид текущей темы	папка активной темы
`.muxzip`	Пакет контента (например, сохранения, BIOS или коллекции — зависит от содержимого)	соответствующие папки muOS
`.muxcat`	Пакет каталога (обложки и описания)	`MUOS/package/catalogue/`
`.muxcfg`	Пакет настроек RetroArch	`MUOS/package/config/`
`.muxupd`	Обновление системы muOS	сама система

Обновление приложения: сначала сохраните настройки

Чтобы обновить приложение, скопируйте новый .muxapp в ARCHIVE и установите его так же. Archive Manager распакует его поверх существующей папки приложения:

файлы из нового пакета заменят старые, включая config.ini;
файлы, которых нет в пакете, например папки data/ или logs/ приложения, сохранятся.

Поэтому всё, что вы меняли в config.ini приложения, после обновления вернётся к значениям по умолчанию. Перед обновлением скопируйте config.ini приложения в надёжное место (или запишите настройки), а потом верните изменения. Game Manager — исключение: в его пакете нет config.ini, поэтому ваши настройки, включая API-ключ itch.io, после обновления сохраняются. Список установленных игр лежит в data/ и переживает обновление.

Если новый файл называется так же, как старый, сначала удалите или замените старый в ARCHIVE, чтобы точно знать, какой вы устанавливаете.

Удаление приложения

В muOS 2601 нет кнопки удаления приложений. Чтобы удалить приложение, удалите его папку:

SD-карта 1 → MUOS/application/<ИмяПриложения>

Сделайте это через картридер, по SFTP или с помощью Wi-Fi Transfer. Затем вернитесь в главное меню и снова откройте Applications — приложения больше нет. Вместе с папкой удаляются и собственные настройки и данные приложения, поэтому заранее скопируйте то, что хотите сохранить.

Решение проблем

Archive Manager пишет “No Archives Found”: файла нет в ARCHIVE в корне SD-карты 1, или папка называется иначе. Она должна называться ARCHIVE и не лежать внутри ROMS или MUOS.
Файл виден в списке, но установка падает с ошибкой “unsafe paths”: пакет собран неправильно. Свяжитесь с разработчиком приложения; не пытайтесь распаковать его вручную.
“Could not open archive… Corrupt?”: загрузка не завершилась или копирование прервалось. Скачайте файл заново и, если разработчик указывает контрольную сумму SHA-256, сравните её (shasum -a 256 file.muxapp на Mac или Linux).
Приложение установлено, но не появляется: вернитесь в главное меню и снова откройте Applications. Если его по-прежнему нет, проверьте, существует ли MUOS/application/<ИмяПриложения>/mux_launch.sh.
Приложение запускается и сразу закрывается: многие приложения пишут журнал в свою папку, обычно logs/app.log. Загляните в него и включите Wi-Fi, если приложению нужен интернет.

Кратко

Положите файл .muxapp в ARCHIVE на SD-карте 1.
Applications → Archive Manager, выберите файл, нажмите A, дождитесь All Done!
Откройте приложение в Applications.
Перед обновлением сохраните config.ini приложения. Для удаления удалите его папку в MUOS/application/.

Вопросы? Пишите на feedback@pocketkode.com.

PocketKode не связан с muOS или Anbernic.