Guida

iPhone e iPad

Non c'è una versione su App Store: compili l'app sul tuo Mac con Xcode e la installi sul tuo iPhone o iPad. Al primo avvio copia i dati di gioco dalla tua copia.

  • iOS e iPadOS 15 o successivi
  • Un Mac con Xcode 26
  • Basta un Apple ID gratuito
  • Circa 2 GB liberi sul dispositivo

1Cosa ti serve

  • Un Mac con Xcode 26 o successivo, dal Mac App Store. Apri Xcode una volta perché installi i suoi componenti.
  • Un Apple ID, con accesso effettuato in Xcode › Settings › Accounts. Ne basta uno gratuito, ma le sue app smettono di aprirsi dopo sette giorni e vanno ricompilate; un'iscrizione a pagamento al Developer Program firma per un anno.
  • Un iPhone o iPad con iOS o iPadOS 15 o successivi, e il suo cavo, oppure abbinato al Mac via Wi-Fi.
  • La tua cartella di Total Annihilation, quella con totala1.hpi: circa 1,1 GB con entrambe le espansioni e la musica. Dove trovarla su un Mac.

2Installa gli strumenti

Apri il Terminale e installa gli strumenti da riga di comando di Xcode, poi CMake e Ninja, per esempio con Homebrew. Python 3 è incluso negli strumenti da riga di comando.

Terminal
$ xcode-select --install$ brew install cmake ninja
Illustrazione

3Codice sorgente

La prima compilazione scarica e compila anche, una sola volta, le librerie di cui il gioco ha bisogno per iOS.

Terminal
$ git clone https://github.com/open-annihilation/open-annihilation.git$ cd open-annihilation$ python3 tools/bootstrap_text_fonts.py --fonts-only
Illustrazione

4Crea il progetto Xcode

Trova il tuo team ID: in Xcode › Settings › Accounts, scegli il tuo Apple ID 1 e leggi l'ID del team 2.

Accounts
GeneralAccountsBehaviorsNavigationThemes
Apple IDs
you@example.com
TeamRole
Your Name (Personal Team)User
A1B2C3D4E5
Illustrazione

Poi, dalla cartella open-annihilation, crea il progetto. Si apre in Xcode:

Terminal
$ platforms/ios/scripts/xcode.sh --device --team A1B2C3D4E5 --open
Illustrazione

Per un dispositivo di test, cmake -B build-ios-xcode -DOA_IOS_BUNDLED_GAME_DIR="$HOME/Games/Total Annihilation" include la cartella del gioco nell'app: circa 1,1 GB in più, ma si gioca appena installata.

5Compila e installa

  1. Collega l'iPhone o l'iPad e sbloccalo. La prima volta, tocca Autorizza sul dispositivo.
  2. Nella barra degli strumenti di Xcode, scegli lo schema oa-game 1 e il tuo dispositivo 2.
  3. Se Xcode dice che l'identificatore dell'app non è disponibile, cambia Bundle Identifier in Signing & Capabilities con uno tuo 4, come net.yourname.open-annihilation.
  4. Scegli Product › Run 3.
▶oa-game›Commander’s iPhoneReady
open-annihilation
oa-game
platforms
src
GeneralSigning & CapabilitiesInfoBuild Settings
Automatically manage signing
Your Name (Personal Team)
net.yourname.open-annihilation
Illustrazione

6Autorizza l'app sul dispositivo

La prima volta, il dispositivo si rifiuta di aprire un'app del tuo team. Su iOS e iPadOS 16 e successivi, attiva la Modalità sviluppatore: Impostazioni › Privacy e sicurezza › Modalità sviluppatore 1, attivala 2 e riavvia il dispositivo quando te lo chiede.

9:41
‹ ImpostazioniPrivacy e sicurezza
LocalizzazioneSì›
Tracciamento›
Rete locale›
Sicurezza
Modalità sviluppatoreNo›
9:41
‹ IndietroModalità sviluppatore
Modalità sviluppatore
L'attivazione della modalità sviluppatore riavvia il dispositivo.
Illustrazione

Poi autorizza il tuo profilo sviluppatore: Impostazioni › Generali › VPN e gestione dispositivi, scegli il tuo Apple ID sotto App sviluppatore 1 e tocca Autorizza 2. Ora apri Open Annihilation dalla schermata Home.

9:41
‹ GeneraliVPN e gestione dispositivi
VPNNon connesso›
App sviluppatore
Apple Development: you@example.com›
9:41
‹ IndietroApple Development
Autorizza “Apple Development: you@example.com”
App di questo sviluppatore: Open Annihilation
Illustrazione

7Aggiungi i file del gioco

La prima volta che lo apri, la schermata Game files offre tre modi per portare i file di Total Annihilation sul dispositivo. Qualunque tu scelga, i file vengono controllati, e l'app non si chiude mai perché mancano.

The Game files screen on an iPad
ScreenshotLa schermata Game files su un iPad.
  1. Metti la cartella di Total Annihilation dove il dispositivo può raggiungerla: iCloud Drive, un'unità USB, la cartella condivisa di un computer (collegati prima dall'app File) o il dispositivo stesso.
  2. Tocca CHOOSE FOLDER, poi Sfoglia, trova la cartella, aprila e tocca Apri. L'app legge solo nomi e dimensioni, quindi per ora non viene scaricato nulla.
  3. Ready to copy mostra cosa ha trovato, con gli interruttori per le parti facoltative, cosa esclude e lo spazio necessario per la copia. Tocca COPY.
Ready to copy
ScreenshotReady to copy (pronto per la copia).
  1. La copia mostra l'avanzamento, il tempo rimanente e il file in corso. Tieni aperta l'app finché non termina; se esci, si mette in pausa e riprende quando torni. I file presenti solo su iCloud vengono scaricati man mano che vengono copiati.
Copying
ScreenshotCopying (copia in corso).
  1. La copia viene verificata con il controllo del gioco stesso, poi Ready to play indica cosa userà il gioco. Tocca PLAY.
Ready to play
ScreenshotReady to play (pronto per giocare).

8Gioca

Apri Open Annihilation e ruota il dispositivo in orizzontale: il gioco funziona solo in orizzontale. I controlli touch comprendono il tocco per muovere, il cassetto di costruzione, la ruota degli ordini con la pressione prolungata e il pizzico per lo zoom; tastiera, mouse o trackpad funzionano come su un computer.

✓Ci sei, Comandante

Quando appare il menu principale, il gioco ha trovato i tuoi file. Scegli una campagna, una schermaglia o una partita in rete.

Open Annihilation main menu
Screenshot

Gestione dei file del gioco

Apri le impostazioni OA dal menu principale e scegli Game files: cosa è installato, quanto occupa e lo spazio libero, se i file vanno nei backup del dispositivo (disattivato per impostazione predefinita, perché occuperebbero circa 1,1 GB su iCloud) e MANAGE…, che aggiunge un'espansione, mappe o una mod, ricontrolla i file, oppure li rimuove o li sostituisce. Partite salvate e impostazioni restano sempre.

Managing the game files on an iPhone
ScreenshotGestione dei file del gioco su un iPhone.

Partite in rete

La prima volta che il gioco usa la rete, iOS chiede se può trovare dispositivi sulla tua rete locale e connettersi a essi: tocca Consenti, oppure attivalo in seguito in Impostazioni › Privacy e sicurezza › Rete locale. Una build firmata con un Apple ID gratuito non può cercare partite tramite broadcast: unisciti digitando l'indirizzo dell'host nella schermata TCP/IP (l'indirizzo di un dispositivo si trova in Impostazioni › Wi-Fi, con il pulsante informazioni). Un team a pagamento può richiedere ad Apple l'entitlement per il networking multicast e compilare con --multicast-entitlement.

Risoluzione dei problemi

“Sviluppatore non autorizzato”
Autorizza il tuo profilo sviluppatore, passaggio 6.
L'app ha smesso di aprirsi dopo una settimana
Un Apple ID gratuito firma per sette giorni: compila e installa di nuovo, passaggio 5.
“This folder does not hold a Total Annihilation installation”
Scegli la cartella che contiene totala1.hpi.
“Not enough space” (spazio insufficiente)
Libera spazio in Impostazioni › Generali › Spazio iPhone, oppure disattiva una parte facoltativa, poi CHECK AGAIN o CONTINUE; ciò che è stato copiato viene mantenuto.
“The copy stopped” (copia interrotta)
Un'unità, una cartella condivisa o la rete non è più disponibile: ricollegati e tocca CONTINUE.
Nessuna partita compare durante la ricerca
Digita l'indirizzo dell'host nella schermata TCP/IP, oppure compila con l'entitlement per il networking multicast.

Aggiornamento e rimozione

Per aggiornare, esegui git pull nella cartella open-annihilation, poi compila e installa di nuovo (passaggio 5); i file del gioco, i salvataggi e le impostazioni restano sul dispositivo. Per rimuovere il gioco, tieni premuta la sua icona e scegli Rimuovi app, che rimuove anche i file del gioco copiati al suo interno.

Altre piattaforme

Qualcosa non va come descritto? Discord · Segnalazioni su GitHub