Skip to content

Play your own Switch games on iPhone/iPad — one-click macOS app, no terminal. | 把 Switch 游戏装进 iPhone:图形界面一键构建,不用命令行。Bring your own game.

24.3 KB
Raw Blame

Follows CHANGELOG.md as of v1.0.2

Changelog

La cronologia delle versioni di NX2Apple, dalla più recente alla meno recente. Ogni versione, corredata dal testo completo delle note di rilascio, è disponibile nella pagina delle release.

Dalla più recente alla meno recente. Il fork segue gli aggiornamenti upstream ogni giorno, perciò l'elenco dei giochi e le correzioni all'host arrivano automaticamente.

Data Versione Cosa è cambiato
2026-11-02 v1.0.2 Esporta come IPA e invia i dati di gioco a un dispositivo o a un'unità esterna (#531, #416): la scheda Installa del launcher per Mac presenta ora un selettore tra Installa sul dispositivo ed Esporta come IPA. L'esportazione non richiede né un dispositivo collegato né un team di firma: compila l'app condivisa con i framework dei giochi presenti nella libreria e scrive un file NX2Apple.ipa non firmato nella cartella dell'app contenitore, pronto per AltStore, SideStore o qualsiasi altro strumento di firma. I dati di gioco non sono inclusi nell'IPA: il passaggio 3 li invia all'app su un dispositivo associato oppure li copia su un'unità esterna o in una cartella, con barra di avanzamento e pulsante Stop. Contenuto dell'IPA (#542, #540): Esporta come IPA offre una seconda modalità. App condivisa resta l'opzione predefinita, mentre Un gioco, tutto incluso crea un singolo file IPA per gioco con tutti i dati di gioco al suo interno, pensato per gli strumenti di sideloading che non permettono di copiare file dentro un'app. Ha un proprio bundle ID (org.nxnative.<title ID>), quindi i relativi salvataggi restano separati, ed è compilato tramite il percorso a gioco singolo del motore. Non ancora testato dall'inizio alla fine: nessuno ha ancora provato l'esportazione su un dispositivo reale o con un'app installata tramite sideloading, e anche l'IPA a gioco singolo non è ancora stato verificato con uno strumento di sideloading. Un file IPA molto grande potrebbe non installarsi e il limite di dimensione non è noto (vedi Problemi noti). Interfaccia in italiano (#528) a cura di @Dino0005. I 38 testi della scheda di esportazione, i testi della nuova opzione e le due stringhe shell.frameworkIncomplete e shell.gameLeftOut sono una traduzione automatica in attesa di revisione. Ogni lingua è ora un singolo file JSON (#478, #479, #480, #481): i launcher per Mac e per Windows leggono gli stessi file, l'elenco delle lingue viene generato a partire da essi e un test per ciascun front-end verifica ogni file. L'app contenitore su iPhone parla la lingua del giocatore (#482, #485): i suoi testi provengono da questi file e anche le righe delle impostazioni di ciascun gioco vengono mostrate nella lingua scelta. Un tocco su un gioco in Giocati di recente lo avvia direttamente (#457, #425) e le righe hanno più spazio. Il codice del launcher è stato riorganizzato in store modulari (#456, #458, #460, #462, #466, #467, #469, #471, #473, #476, #530): nessuna modifica visibile. Il commit del motore passa a 65501fbb (#536): secondo le note upstream, su Mac arrivano TRIANGLE STRATEGY, Castlevania: Belmont's Curse, SUPER ROBOT WARS Y, Splatoon Raiders, Super Mario RPG e Fire Emblem Fortune's Weave. La finestra delle impostazioni su Mac si chiude quando si preme Play. Lo script NSP decodifica i filmati AV1 tramite dav1d e legge gli archivi shader compressi con gzip. Compaiono i salvataggi di Digimon (non testato direttamente qui). Rimosse le patch 0045 e 0052 poiché integrate upstream, mentre le patch 0001, 0053, da 0046 a 0050, 0032 e 0054 restano nella coda del fork. Strumenti per gli sviluppatori: tools/bump_candidates.py elenca i commit upstream di un aggiornamento di versione da cui dipendono i front-end (#465). Correzioni: l'eliminazione interrotta di un vecchio framework di gioco non blocca più la compilazione successiva (#539), poiché ora la rimozione avviene tramite rinomina immediata più cancellazione in background e i framework incompleti vengono esclusi con un avviso chiaro. I dispositivi su Xcode 27.2 vengono nuovamente rilevati dopo il cambio di formato di devicectl (#496, #488). I file ._ dei volumi exFAT non interrompono più la creazione del pacchetto per Mac, patch 0057 di @lucaszhongsj (#521, #486). I pacchetti PFS0 legacy privi del terminatore finale del nome vengono letti correttamente, patch 0058, e il rewriter riconosce le tail call tramite puntatore prima del padding di zeri, patch 0059, entrambe di @BadAppleD (#520, #519). Il campo Salva in nella scheda Compila permette di creare nuove cartelle, a cura di @SifatTaj (#522). Problemi noti: Esporta come IPA e Invia i dati di gioco non sono ancora stati testati su un dispositivo reale o con un'app installata tramite sideloading. Anche la modalità Un gioco, tutto incluso non è stata verificata con uno strumento di sideloading e un file IPA molto grande può fallire l'installazione. Il primo avvio con Play dopo l'aggiornamento ricompila i giochi perché la catena degli shader è cambiata. La suddivisione degli shader può restare ferma al 99% per diversi minuti verso la fine (#489). Restano aperti il problema di riempimento del disco con Breath of the Wild (#413) e l'errore dello step shader di Super Mario Odyssey su chip M1 con Xcode 27.2 (#361)
2026-11-01 v1.0.1 L'app contenitore individua ogni gioco dalla sua immagine (#441, #443): la cartella condivisa dei dati di gioco su iPhone o iPad non richiede più una sottocartella specifica per ogni gioco. Ciascun titolo viene riconosciuto dall'identità del suo file romfs.img, fino a due livelli di profondità sotto la cartella scelta, qualunque sia il nome delle cartelle. Upstream passa a cd859c38 (#444): secondo le note upstream (non ancora verificate nel launcher), il motore da solo è ora in grado di fare girare Donkey Kong Bananza (Switch 2, testato fino al completamento del primo livello, solo su Mac) e Hollow Knight, aggiunge un profilo per Dead Cells e consente di compilare un gioco a partire da una cartella di file estratti senza prod.keys. Il launcher non supporta ancora la compilazione di giochi Switch 2 o da cartelle di file estratti, vedi #445. La combinazione Maiusc più un tasto freccia muove la levetta destra sul Mac. I giochi NVN richiedono Xcode 27.2 (#447, #444): il nuovo motore blocca la versione del compilatore Metal a quella di Xcode 27.2 e il launcher lo segnala chiaramente. Se usi Xcode 27.1, aggiorna Xcode prima di compilare un gioco. Correzioni: il messaggio di errore relativo a più giochi presenti nella stessa cartella del nuovo motore viene ancora riconosciuto correttamente (#444)
2026-10-31 v1.0.0 Il motore proviene direttamente dalla release (#267): l'app distribuita conserva il motore nel proprio archivio interno e compila a partire da lì, senza più clonare o aggiornare il repository tramite git. Le Impostazioni mostrano lo stato del motore con un pulsante Controlla, i canali Stabile e Sperimentale e un interruttore per gli aggiornamenti automatici. Il cambio di canale chiede conferma prima di procedere. Il motore viene scaricato con un file latest.json firmato e l'app rifiuta qualsiasi pacchetto che non superi la verifica. Un'unica app contenitore per iPhone e iPad (#226): l'app raccoglie tutti i tuoi giochi, con una libreria basata sulle copertine, Cover Flow con lo schermo in orizzontale, impostazioni per ogni singolo gioco e navigazione tramite controller o tastiera. La destinazione iPhone / iPad compila i giochi dentro questa app contenitore. Le nuove firme e le reinstallazioni preservano i dati di gioco e i salvataggi. Miglioramenti generali al launcher (#281): la libreria permette di filtrare tra Posseduti e Compilati, un cursore modificato rispetto al valore predefinito testato mostra una freccia di ripristino, una nuova versione disponibile viene segnalata da un'icona all'estremità della barra superiore, l'icona nel Dock riflette l'avanzamento di una compilazione in corso e la modalità console elenca per primi i giochi pronti su questo Mac. Le Impostazioni includono un programma di disinstallazione che rimuove le preferenze del launcher e l'albero del motore lasciando intatti giochi, salvataggi e chiavi e spostando l'app nel Cestino. L'icona per Mac adotta lo stile Liquid Glass (#290). Il front-end Qt adotta la palette cromatica del launcher Mac e il font Manrope (#222). Upstream passa a c5fe6b5d (#319): specializzazione delle pipeline Metal 4, shader host condivisi compilati durante la build, scansioni parallele del rewriter e correzioni per gli offset dei buffer NVN, la capacità degli attachment e l'accoppiamento depth/stencil. La correzione per lo schermo intero introdotta upstream sostituisce la nostra. Release candidate (#332): ogni versione viene prima testata come candidata, così i giocatori ricevono esattamente la build che è stata verificata. Correzioni: il selettore della cartella dei salvataggi cloud su iPhone si apre una sola volta per tocco e Apri memorizza correttamente la cartella (#321), Tears of the Kingdom 1.4.2 non gira più a velocità doppia (#311, #312), Mario Tennis Aces supera il passaggio di riscrittura (#307) e il crash successivo al caricamento dei font condivisi (#314), i DLC su iOS in Documents/aoc vengono rilevati (#319), i controlli della toolchain su Windows indicano la soluzione per il link probe, gli stub SDK, le installazioni di Metal e Git e i pacchetti wheel fissati (#206), la modalità console nasconde il puntatore inattivo e richiede nuovamente lo schermo intero al termine di un gioco (#339), una sincronizzazione del motore non riuscita ripristina engine/ allo stato precedente (#338) e una patch che non si applica non viene più scambiata per una già integrata upstream (#323)
2026-10-31 v0.7.5 Xcode 27.2 non blocca più la compilazione dei giochi: l'aggiornamento automatico di Xcode aveva portato il compilatore Metal alla versione 32023.922 fermando i giochi NVN prima dei passaggi relativi agli shader. Un compilatore più recente appartenente alla stessa generazione registrata ora prosegue la compilazione annotando un avviso nel log. I compilatori più vecchi o di generazioni diverse continuano a mostrare un avviso. Usi la versione 0.7.3 o precedente? Aggiorna subito. Le versioni precedenti dell'app non possono più compilare giochi e mostrano "Repository: not found". Installando questa versione la compilazione tornerà a funzionare, mantenendo intatti giochi e salvataggi (dettagli nella discussione #306)
2026-10-31 v0.7.4 Il motore viene scaricato autonomamente (#273): l'aggiornamento non include più il codice sorgente del motore nel pacchetto dell'app. Le correzioni upstream si sincronizzano online direttamente dentro il launcher, senza dover attendere una nuova release. Ciò richiede l'accesso a GitHub e il launcher mostra l'avanzamento o il motivo di un eventuale errore. La lingua del gioco è ora un menu proprio come nell'app iOS, impostato su Sistema per impostazione predefinita (#283). Un launcher più reattivo: passaggio tra le schede (#297), pannelli Opzioni e Gestisci (#294), rendering di font e pulsanti. Correzioni: la modalità console avvia correttamente un gioco da una finestra appena uscita dallo schermo intero, una cartella di gioco situata dentro iCloud Drive ferma la compilazione con una spiegazione perché iCloud sposta i file della cache di build (#279), la modalità console nasconde il puntatore dopo alcuni secondi di inattività (#280), Riavvia ora apre la nuova copia tramite un helper non appena il vecchio processo è terminato (#277). Sulla versione 0.7.3 o precedente, il messaggio Repository: not found indica che il controllo del repository della vecchia app non corrisponde più alla nuova struttura: aggiorna alla 0.7.4 ed esegui nuovamente la configurazione
2026-10-30 v0.7.3 Interfaccia in tedesco (#225), grazie a @kidziiii. Salvataggi: individua il salvataggio del gioco sul dispositivo stesso, quindi scegli l'iPhone o l'iPad con cui sincronizzarlo (#260). zbic è ora incluso (#258): legge i moduli con variante zstd di Nintendo e il controllo delle dipendenze ne verifica la presenza. Correzioni: un gioco il cui NSP base si trova in una sottocartella (nsp本体) trova correttamente l'aggiornamento e i DLC accanto ad essa (#240, #246), la finestra Scegli file accetta i formati NSZ e XCZ (#243), l'installazione su un dispositivo non passa più l'opzione --remove-existing-content che cancellava i dati di gioco già presenti (#266), un sistema Windows in cinese non ripiega più sull'inglese nell'app Qt (#256), i trucchi sono contrassegnati come non disponibili su iPhone e iPad (#257) e i pacchetti Python inclusi sono verificati tramite hash (#259)
2026-10-30 v0.7.2 I giochi che si aprivano su uno schermo nero tornano a caricarsi (ad es. Super Mario Bros. Wonder): l'archivio delle pipeline su Mac viene contrassegnato con la versione del sistema operativo del Mac in uso anziché con quella dell'SDK, così le pipeline vengono caricate invece di essere ricompilate al primo avvio (upstream #673). 26 commit upstream: colori del bordo dei sampler emulati, operazioni logiche NVN e snapshot automatici di feedback nello stesso passaggio
2026-10-29 v0.7.1 La modalità console avvia i giochi a schermo intero (#220, #219): Play forza DM_FULLSCREEN e la finestra entra a schermo intero non appena si trova sullo Space attivo, quindi basta ricompilare il gioco per ricevere la correzione. Il gioco si apre sullo schermo del launcher (#221, DM_SCREEN, scritto e revisionato con due monitor ma non ancora validato dall'inizio alla fine su una configurazione a schermo singolo). Un pannello trucchi per singolo gioco (#218). Gli errori di compilazione spiegano cosa fare (#215): righe dedicate per chiavi, file di gioco, unità disco, spazio libero, firma e installazione sul dispositivo, ciascuna con la causa e il pulsante che risolve il problema. Le build iOS leggere includono i DLC selezionati (#212). La pagina di aggiornamento interpreta il formato Markdown (#216) e un file NSP privo di ticket ottiene il proprio Title ID dal pacchetto (#217). Correzioni: il launcher torna in stato di inattività dopo una compilazione (#208), una cartella contenente più giochi viene preparata senza errori (#209), un ambiente virtuale inferiore a Python 3.12 non viene considerato pronto e vengono rilevate le installazioni Python di mise e asdf (#211), il front-end Qt non va più in crash alla chiusura (#224), sincronizzazione giornaliera upstream (#223)
2026-10-29 v0.7.0 Modalità console (#169): con un controller collegato, il tasto Select o Vista → Modalità console porta la libreria a schermo intero, pensata per l'uso con il controller, completa di copertine, opzioni di avvio, indicatori della batteria ed elenco dei controller (anche tramite Opzione-Comando-K). Salvataggi in cloud (#185): l'app per Mac e l'app per iPhone di un gioco condividono lo stesso salvataggio attraverso una cartella su iCloud Drive, con controlli SHA-256 e backup datati, verificato con Tears of the Kingdom su entrambe le piattaforme. Configurazione guidata al primo avvio (#119, #120) e strumenti di compilazione e Python integrati nell'app (#154), così nessuno deve installare Homebrew. Reinstallazione senza ricompilare e Salva IPA… (#155). Scadenza della firma e rinnovo sul posto per gli ID Apple gratuiti (#156). Gli errori di compilazione diventano righe chiare che indicano il motivo e il passo successivo (#166, #205). Localizzazione in svedese (#168), un README pensato per i giocatori, smistamento delle issue in modalità segnalazione (#143) e, su Windows, un pannello guidato delle dipendenze per i due download Apple più una correzione di crash del link-probe (#192, #196). Correzioni: Xcode installato ma mai aperto viene riconosciuto come stato a sé stante con un pulsante Correggi, un'installazione delle dipendenze non riuscita mostra il motivo e il comando eseguito, il controllo del bundle ID non va più in crash sul progetto di un altro utente, il blocco diagnostico non stampa più (null), il sistema di aggiornamento trova le versioni di Python installate da uv e le relative stringhe superano la CI. Problemi noti: le mod non sono ancora state testate in partita con una mod reale, la pipeline di compilazione su Windows non è stata verificata su hardware fisico
2026-10-28 v0.6.0 Configurazione guidata al primo avvio: benvenuto, piattaforma, Xcode, chiavi e giochi, con un'unica richiesta di permessi da amministratore per la toolchain e il download di Metal Toolchain e piattaforma iOS con barra di avanzamento. Gli strumenti di compilazione e Python vivono dentro l'app (zstd, glslangValidator, spirv-cross, xcodegen, CPython 3.13 da sorgenti fissati e verificati tramite checksum), eliminando la necessità di Homebrew. Reinstallazione senza ricompilare tramite devicectl e funzione Salva IPA… per gli strumenti di sideloading. Scadenza e rinnovo della firma: la scheda del gioco mostra i giorni rimanenti per un ID Apple gratuito e Rinnova esegue nuovamente la firma sul posto. Il rilevamento del dispositivo sa se un gioco è già installato sul dispositivo collegato. Un README pensato per i giocatori (1.900 parole invece di 8.000), smistamento delle issue e primo soccorso sui log in modalità segnalazione. La sincronizzazione upstream diventa una coda di patch con veri merge a tre vie. Correzioni: Xcode installato ma non selezionato ha un proprio stato dedicato con correzione in un clic, il fallimento di un'installazione delle dipendenze mostra il motivo e il comando, il controllo del bundle ID non va più in crash sul progetto di un altro utente, il blocco diagnostico non stampa più (null), l'updater individua le versioni di Python installate da uv
2026-10-27 v0.5.0 Arriva il launcher per Mac: le opzioni di avvio risiedono nell'archivio delle preferenze proprie del gioco (launcher.<VAR>, lo stesso letto da upstream), il menu Gestisci della libreria si apre anche con il controller e un semplice ID Apple gratuito basta per installare poiché Xcode crea il certificato alla prima installazione. I dati di gioco su iPhone restano finalmente memorizzati (il segnalibro viene scritto mentre l'ambito di sicurezza dell'app File è attivo) e un'app priva di dati si avvia nel launcher anziché bloccarsi. L'installatore chiede conferma prima di copiare i file di gioco via USB. Gli strumenti di compilazione si aggiornano da soli, anche partendo da una vecchia copia ZIP (#87). I moduli per le issue e il template delle PR richiedono tutti i dati necessari per una segnalazione. Correzioni: il nuovo tentativo di firma conserva la propria riga di avanzamento, ogni versione estratta del gioco viene conservata come risorsa di compilazione, viene eseguita la sincronizzazione upstream successiva e ogni patcher viene testato contro il vero codice upstream nella CI. Problemi noti: le mod non sono ancora state provate con una mod reale, la build per Windows non è fornita nella pagina delle release
2026-10-27 v0.4.9 La libreria segue la cartella: i salvataggi e il log di un gioco su Mac vivono accanto al file .app e vengono migrati da ~/Library al primo avvio. I dati di gioco su iPhone possono risiedere ovunque (selettore dell'app File con memorizzazione della posizione). Tutte le otto funzionalità pianificate sono state completate (#77–#84: verifica preliminare delle chiavi, trascinamento della selezione, notifiche di fine compilazione, avviso strumenti obsoleti, controllo spazio libero, trasferimento salvataggi tra Mac e dispositivo, copia dei dati diagnostici, layout dei controller). Windows: corretta l'interfaccia in cinese, il controllo di Metal funziona anche con nomi utente in caratteri cinesi, risolto il crash in caso di installazione fallita, il Vulkan SDK viene individuato automaticamente
2026-10-27 v0.4.8 Il launcher per Mac diventa pienamente usabile: installazione di una build per iPhone su un dispositivo associato (#28), controllo completo del launcher tramite controller (#56), opzioni di avvio suddivise tra base e avanzate (#54) con modalità di visualizzazione e scala di rendering espressa in pixel reali (#55) più una sezione Mod tramite DM_ROMFS_OVERLAY (#57), tasti della tastiera e pulsanti del controller rimappabili (#39). Gli strumenti di compilazione si aggiornano all'apertura dell'app (#60) e una nuova versione mostra l'elenco delle novità prima dell'installazione. Correzioni: la riscrittura di qualsiasi gioco andava in crash (TEXT_LO in patch_nso.py usato prima dell'assegnazione, #59), l'app per Mac rifiutava ogni compilazione chiedendo Python 3.12 (#53), una cartella ROM contenente più giochi non riusciva a compilarne alcuno (#58), una compilazione fallita puntava a un log fuori dallo schermo (#52), Windows in lingua cinese mostrava l'interfaccia in inglese, la CI non riusciva ad aprire le issue
2026-10-27 v0.4.7 94 profili di gioco (+7 dalla sincronizzazione giornaliera: Octopath Traveler, Donkey Kong Country Returns HD, Donkey Kong Country: Tropical Freeze, Mario + Rabbids Sparks of Hope, Kirby e la terra perduta, Yoshi's Crafted World, Xenoblade Chronicles 3). Un singolo binario host per il layout di memoria di qualsiasi gioco (profili a runtime — le fondamenta per il launcher universale). Il selettore della lingua traduce l'intera interfaccia. Le versioni beta di Xcode vengono riconosciute (il controllo interroga xcode-select). Un avviso evidente segnala quando un aggiornamento upstream invalida gli shader salvati in cache. La cartella di output è ora documentata come sede della cache di compilazione. Front-end Windows: Python 3.12 integrato nell'app, clonazione dell'SDK oltre il limite di lunghezza dei percorsi di Windows, LLVM verificato tramite compilazione anziché con --version, eliminate le finestre nere della console. La ricompilazione su una cartella di lavoro esterna formattata in exFAT non va più in crash
2026-10-26 v0.4.6 App per Windows corretta in base ai test su hardware reale: aggiunta la riga mancante per il .NET SDK (non compariva mai, impedendone l'installazione), eliminate le finestre nere della console che rubavano il primo piano, mirror di download scelti tramite test di velocità (risolvendo un download di LLVM da 974 secondi), strumenti installati all'esterno della cartella dell'app così gli aggiornamenti non li cancellano, e controlli del repository che mostrano cosa sta facendo git
2026-10-26 v0.4.5 Output come app per Mac (un file .app avviabile con doppio clic generato dalla stessa compilazione). Supporto per dispositivi A15/A16 e precedenti tramite decodifica BC su CPU, attivabile come opzione dell'app. Cartelle dei dati separate per ogni gioco (Documents/games/<id>/) per consentire l'uso di unità esterne. L'intestazione NRO non viene più scansionata come codice eseguibile. La sincronizzazione notturna non può più fallire silenziosamente
2026-10-26 v0.4.4 Corregge un errore di compilazione che colpiva tutte le build nella v0.4.3 (variabile work letta prima dell'assegnazione). 72 giochi supportati (+3)
2026-10-26 v0.4.3 I dump in formato NSZ e XCZ funzionano direttamente senza passaggi aggiuntivi. Una nuova installazione di Xcode segnala ora l'eventuale assenza dell'SDK di iOS. Risolti tre problemi legati alle variabili d'ambiente
2026-10-25 v0.4.2 L'app scarica e aggiorna autonomamente sia il repository sia se stessa. 58 giochi supportati (+10). Risolto un deadlock durante il caricamento dei salvataggi. Ripristino automatico in caso di errori temporanei di NuGet
2026-10-24 v0.4.1 Animal Crossing: New Horizons verificato su iPhone (103.645 file in 72 frammenti). La creazione dell'archivio riutilizza il lavoro rimasto invariato
2026-10-23 v0.4.0 La cartella dell'archivio è pronta per la copia con una guida all'installazione integrata. L'elenco delle dipendenze è comprimibile. Versioni di aggiornamento richieste per ogni gioco indicate nella tabella. Il progetto assume il nome NX2Apple
2026-10-23 v0.3.1 Correzioni per Python 3.15 di Homebrew e DOTNET_ROOT (#1, #2)
2026-10-22 v0.3.0 Nuova icona dell'app, 46 giochi supportati
2026-10-21 v0.2.1 Correzione della compilazione con Python 3.9
2026-10-20 v0.2.0 Interfaccia bilingue (Inglese / 中文)
2026-10-20 v0.1.0 Prima release: interfaccia grafica (GUI) e archiviazione RomFS