Recomendação:

Quase todas as fontes que vi que falam sobre o Onion OS recomendam comprar um novo cartão SD e deixar o cartão que veio com ele guardado, como backup. Acredito ser uma boa prática, mas parte disso se deve ao fato de que o cartão SD que vem com o aparelho, dizem alguns, é de baixa qualidade e pode corromper se usado demais. Bem, após um mês, mais ou menos, o meu ainda funciona, mas comprei outro por segurança e fiz o original de backup. Até mesmo porque ele vem recheado de jogos e é muito mais fácil procurar um jogo nele do que na internet.

Verifique seu firmware

Antes de seguir com a instalação, verifique o firmware do seu dispositivo, que fica no aparelho em si. O Onion OS, na verdade, é um "frontend" que ficará no seu cartão SD.

Veja a versão atual em Settings -> Device Info -> Version.

Para que o Onion OS possa ser instalado você precisará de pelo menos uma versão de firmware 20230505****. Se sua versão não atender a esse requisito, faça a atualização conforme estas instruções:

Baixe a versão do Onion OS em: https://github.com/OnionUI/Onion/releases

Escolhi a versão estável, mas fique a vontade para optar pela versão beta (de testes) se preferir.

Baixe o arquivo .zip. Exemplo: "Onion-v4.3.1-1.zip".

Deixe o arquivo guardado no seu computador.

Formatação do cartão SD

Insira o cartão SD que receberá o Onion OS no seu leitor de cartões e conecte-o ao computador.

Detalhe: caso seu cartão SD seja de 64GB ou mais, o leitor de cartões precisará ser compatível com a tecnologia SDXC (Secure Digital eXtended Capacity). Caso contrário, o cartão não será reconhecido. O Miyoo Mini Plus vem com um leitor de cartão compatível (o meu veio). Mas se você optou por comprar um aparelho sem o cartão, talvez não venha com um leitor e você terá que comprar um. Por isso verifique se esse leitor é compatível com SDXC.

Você pode usar ferramentas gráficas como gparted, gnome-disks ou outras para fazer a formatação do cartão SD em FAT32.

Se preferir usar linha de comando, aqui está:

Use um dos seguintes comandos para listar os dispositivos:

lsblk

ou

sudo fdisk -l

Procure um dispositivo que corresponda ao tamanho do seu cartão SD. Será algo como /dev/sdX (por exemplo, /dev/sdb, /dev/sdc). A partição dentro dele será /dev/sdX1. Para este tutorial, vamos assumir que o seu cartão SD é /dev/sdb. Substitua /dev/sdb pelo nome correto do seu dispositivo em todos os comandos.

Antes de formatar, o dispositivo não pode estar em uso. Se o sistema o montou automaticamente, desmonte-o:

sudo umount /dev/sdb*

Formate:

sudo mkfs.vfat -F 32 -n NOME_DO_CARTAO /dev/sdb1

Após a formatação, pode remover e reinserir o cartão, e o seu sistema deverá montá-lo automaticamente, pronto a usar.

Descompactar o arquivo zip

Descompacte o Onion-versão.zip usando o seguinte comando (substitua "Onion-versão" pelo nome do arquivo zip que você baixou):

unzip Onion-versão.zip -d Onion-versão

Copie as 7 pastas para o seu cartão SD, usando o seguinte comando (substitua "/run/media/mmcblk0p1" pelo caminho para o seu cartão SD, que pode ser bem diferente como /usuario/media/mmcblk0p1 ou outro):

cp -r Onion-versão/. /run/media/mmcblk0p1

Os arquivos de instalação do Onion consistem nas seguintes pastas:

.tmp_update/ # Oculta
BIOS/
Media/
miyoo/
miyoo354/
RetroArch/
Themes

Insira o cartão SD no dispositivo Miyoo e ligue-o para iniciar a instalação. Quando a instalação estiver concluída, você será recebido com o Guia rápido - uma visão geral rápida do Onion. Em seguida, será apresentado o Gerenciador de Pacotes (Package Manager), escolha os sistemas e aplicativos que deseja habilitar e pressione "START" duas vezes. Quando a instalação estiver concluída, pressione o botão "A" e o dispositivo será reiniciado.

ROMS e BIOS

Copie seus arquivos ROM para suas respectivas subpastas em Roms. Se você tem o cartão original com os jogos, pode copiar dele.

Para BIOS optei pela redundância. Copiei todo conteúdo de "~/Retroarch/.retroarch/system/" do cartão original em "BIOS" no cartão do Onion OS, e também em "~/Retroarch/.retroarch/system/" do cartão do Onion OS.

Caso não tenha o cartão original, poderá baixar o pacote de bios se buscar por "androgaming Onion OS BIOS files Collection (Miyoo Mini Plus)" no Google.

Insira seu cartão SD, inicialize seu Mini e pressione "SELECT " escolha "Atualizar todas as ROMs" para atualizar as ROMs (forçando uma reindexação dos seus jogos).

Agora seus jogos aparecerão! Já pode se divertir.

A seguir veremos algumas dicas e configurações de uso.