Guia de instalação
iPhone e iPad
Não há versão na App Store: compila a aplicação no seu Mac com o Xcode e instala-a no seu próprio iPhone ou iPad. No primeiro arranque, a aplicação copia os dados do jogo da sua própria cópia.
- iOS e iPadOS 15 ou posterior
- Um Mac com o Xcode 26
- Basta um ID Apple gratuito
- Cerca de 2 GB livres no dispositivo
1Do que precisa
- Um Mac com o Xcode 26 ou posterior, da Mac App Store. Abra o Xcode uma vez para que instale os seus componentes.
- Um ID Apple, com sessão iniciada em Xcode › Settings › Accounts. Um gratuito serve, mas as aplicações dele deixam de abrir ao fim de sete dias e têm de ser compiladas de novo; uma adesão paga ao Developer Program assina por um ano.
- Um iPhone ou iPad com iOS ou iPadOS 15 ou posterior, e o respetivo cabo, ou emparelhado com o Mac por Wi-Fi.
- A sua pasta do Total Annihilation, a que tem
totala1.hpi: cerca de 1,1 GB com as duas expansões e a música. Onde a encontrar num Mac.
2Instalar as ferramentas
Abra o Terminal e instale as ferramentas de linha de comandos do Xcode e depois o CMake e o Ninja, por exemplo com o Homebrew. O Python 3 vem com as ferramentas de linha de comandos.
$ xcode-select --install$ brew install cmake ninja
3Obter o código-fonte
A primeira compilação também obtém e compila, uma única vez, as bibliotecas de que o jogo precisa para iOS.
$ git clone https://github.com/open-annihilation/open-annihilation.git$ cd open-annihilation$ python3 tools/bootstrap_text_fonts.py --fonts-only
4Criar o projeto Xcode
Encontre o seu ID de equipa: em Xcode › Settings › Accounts, escolha o seu ID Apple 1 e leia o ID da equipa 2.
Depois, na pasta open-annihilation, crie o projeto. Abre-se no Xcode:
$ platforms/ios/scripts/xcode.sh --device --team A1B2C3D4E5 --openPara um dispositivo de teste, cmake -B build-ios-xcode -DOA_IOS_BUNDLED_GAME_DIR="$HOME/Games/Total Annihilation" inclui a sua pasta do jogo na aplicação: fica cerca de 1,1 GB maior, mas pode jogar assim que é instalada.
5Compilar e instalar
- Ligue o iPhone ou iPad e desbloqueie-o. Da primeira vez, toque em Confiar no dispositivo.
- Na barra de ferramentas do Xcode, escolha o esquema oa-game 1 e o seu dispositivo 2.
- Se o Xcode disser que o identificador da aplicação não está disponível, mude o Bundle Identifier em Signing & Capabilities para um seu 4, como
net.yourname.open-annihilation. - Escolha Product › Run 3.
oa-game›Commander’s iPhoneReady6Permitir a aplicação no dispositivo
Da primeira vez, o dispositivo recusa abrir uma aplicação da sua própria equipa. No iOS e iPadOS 16 e posteriores, ative o Modo de programador: Definições › Privacidade e segurança › Modo de programador 1, ative-o 2 e reinicie o dispositivo quando lhe for pedido.
Depois, confie no seu perfil de programador: Definições › Geral › VPN e gestão de dispositivos, escolha o seu ID Apple em App de programador 1 e toque em Confiar 2. Agora abra o Open Annihilation no ecrã principal.
7Adicionar os ficheiros do jogo
Da primeira vez que a abre, o ecrã Game files oferece três formas de trazer os ficheiros do Total Annihilation para o dispositivo. Seja qual for a escolhida, os ficheiros são verificados, e a aplicação nunca fecha por falta deles.
- Coloque a pasta do Total Annihilation onde o dispositivo lhe consiga aceder: iCloud Drive, uma unidade USB, uma pasta partilhada de um computador (ligue-se a ela primeiro na aplicação Ficheiros) ou o próprio dispositivo.
- Toque em CHOOSE FOLDER, depois em Explorar, encontre a pasta, abra-a e toque em Abrir. A aplicação só lê nomes e tamanhos, por isso ainda não é transferido nada.
- Ready to copy mostra o que encontrou, com interruptores para as partes opcionais, o que deixa de fora e o espaço de que a cópia precisa. Toque em COPY.
- A cópia mostra o progresso, o tempo restante e o ficheiro em curso. Mantenha a aplicação aberta até terminar; se sair, a cópia fica em pausa e continua quando voltar. Os ficheiros que só estão no iCloud são transferidos à medida que são copiados.
- A cópia é verificada com a verificação do próprio jogo e, depois, Ready to play indica o que o jogo vai usar. Toque em PLAY.
- Com o Mac: ligue o dispositivo, selecione-o na barra lateral do Finder, abra o separador Ficheiros e arraste a pasta do Total Annihilation para Open Annihilation.
- No dispositivo: na aplicação Ficheiros, copie a pasta para No meu iPhone (ou iPad) › Open Annihilation.
Dê à pasta copiada o nome Total Annihilation e toque em I HAVE COPIED IT. Se tiver outro nome, a aplicação encontra-a e propõe colocá-la no sítio certo.
- Transfira o instalador da demo, um programa Windows de 21,5 MB normalmente chamado
Total Annihilation.exe, no próprio dispositivo, por exemplo no Safari, que o guarda em Ficheiros › Descargas. - Toque em CHOOSE INSTALLER, escolha o ficheiro e depois COPY.
A aplicação reconhece o instalador pela soma de verificação, nunca o executa e extrai os seus 20 MB de dados do jogo. Depois toque em PLAY.
8Jogar
Abra o Open Annihilation e rode o dispositivo para a horizontal: o jogo só funciona na horizontal. Os controlos de toque incluem tocar para mover, a gaveta de construção, a roda de ordens com um toque prolongado e o zoom com o gesto de pinça; um teclado, rato ou trackpad funciona como num computador.
✓Já está no jogo, Comandante
Quando aparecer o menu principal, o jogo encontrou os seus ficheiros. Escolha uma campanha, uma escaramuça ou um jogo em rede.
Gerir os ficheiros do jogo
Abra as definições com o botão Definições, a roda dentada no menu principal, e escolha Ficheiros do jogo: o que está instalado, o tamanho e o espaço livre, se os ficheiros entram nas cópias de segurança do dispositivo (desativado por predefinição, pois ocupariam cerca de 1,1 GB no iCloud), e MANAGE…, que adiciona uma expansão, mapas ou um mod, volta a verificar os ficheiros, ou remove-os ou substitui-os. Os jogos guardados e as definições ficam sempre.
Jogos em rede
Da primeira vez que o jogo usa a rede, o iOS pergunta se pode encontrar e ligar-se a dispositivos na sua rede local: toque em Permitir, ou ative-o mais tarde em Definições › Privacidade e segurança › Rede local. Uma versão assinada com um ID Apple gratuito não pode procurar jogos por difusão: entre escrevendo o endereço do anfitrião no ecrã TCP/IP (o endereço de um dispositivo está em Definições › Wi-Fi, no botão de informações). Uma equipa paga pode pedir à Apple a autorização de rede multicast e compilar com --multicast-entitlement.
Resolução de problemas
“Programador não fidedigno”
A aplicação deixou de abrir ao fim de uma semana
“This folder does not hold a Total Annihilation installation” (a pasta não tem uma instalação do Total Annihilation)
totala1.hpi.“Not enough space” (espaço insuficiente)
“The copy stopped” (a cópia parou)
Não aparecem jogos na procura
Atualizar e remover
Para atualizar, execute git pull na pasta open-annihilation e volte a compilar e instalar (passo 5); os ficheiros do jogo, os jogos guardados e as definições ficam no dispositivo. Para remover o jogo, mantenha premido o ícone e escolha Remover app, o que também remove os ficheiros do jogo copiados para ela.
Outras plataformas
Algo não corresponde ao descrito? Discord · Issues do GitHub