Pubblicato un rapido aggiornamento per Ultrahand Overlay, lo strumento ci permette di gestire in modo efficiente file e directory sulla scheda SD della console Nintendo Switch.

Ispirandosi a una nuova funzionalità di Zelda, questa utility offre funzionalità avanzate per creare e condividere pacchetti, consentendo agli utenti di personalizzare il proprio sistema di gestione dei file secondo le proprie esigenze.

Con Ultrahand, è possibile creare nuove directory, unire file e personalizzare le configurazioni utilizzando file di configurazione semplici come il file config.ini.

Questa nuova versione punta a migliorare prestazioni e compatibilità, soprattutto grazie alla migrazione della libreria zzip verso minizip, che garantisce un supporto migliore, incluso per file .z64.

Sono stati testati con successo download di quasi 4 GB, al limite del file system FAT32, e archivi zip contenenti migliaia di file.

Sono state inoltre calibrate le dimensioni dei buffer per operazioni di download, estrazione, copia e scrittura esadecimale, con parametri distinti per i due loader utilizzati: nx-ovlloader e nx-ovlloader+, con quest’ultimo che sfrutta buffer più ampi e non ha limiti sul numero di elementi visibili nella lista, al contrario del base loader, che ora si ferma a 250 voci per evitare crash.

L’ottimizzazione della gestione della memoria ha portato a un aumento dello spazio heap disponibile, contribuendo a migliorare la stabilità generale. Anche il sistema di selezione dei comandi è stato rifinito, rendendo l’interfaccia più snella.

La libreria Jansson è stata sostituita con cJSON, più leggera e veloce, mentre le funzionalità di rendering sono state affinate per ottenere prestazioni leggermente superiori rispetto alla versione precedente.

La compilazione ora avviene senza fstream, in favore di stdio.h, riducendo le dimensioni finali dell’eseguibile.

Sono stati risolti diversi bug, inclusi problemi nella gestione della memoria durante passaggi rapidi tra pagine, nella navigazione automatica del menu e nella visualizzazione delle liste dopo lo scrolling.

Aggiunta inoltre un’opzione per disattivare l’aggiornamento automatico dei loader, semplicemente inserendo un file vuoto con nome NO_LOADER_UPDATES.flag nella directory /config/ultrahand/flags/.

Tra le modifiche più tecniche, è stato ripulito l’uso di puntatori unici e condivisi in favore di puntatori raw, corretta la gestione della cache dei caratteri per evitare rallentamenti dopo molte operazioni, aggiunto il supporto visivo per nuove variabili di lingua e rimosse chiamate interne ridondanti che potevano causare leak o comportamenti imprevisti.

In sintesi, l’aggiornamento perfeziona notevolmente l’efficienza di Ultrahand, garantendo maggiore velocità, stabilità e flessibilità per gli utenti avanzati.

Caratteristiche

Ultrahand Overlay è un overlay Tesla che fornisce potenti funzionalità per la gestione di file e directory su di una scheda SD. Offre le seguenti caratteristiche:

• Crea directory:
  • Crea facilmente directory sulla tua scheda SD specificando il percorso della directory. Ultrahand gestirà il processo di creazione per te.
• Copia file o directory:
  • Copia facilmente file o directory da una posizione all’altra sulla tua scheda SD. Basta fornire i percorsi di origine e destinazione e Ultrahand gestirà senza problemi il processo di copia.
• Elimina file o directory:
  • Semplifica l’eliminazione di file e directory sulla scheda SD. Specificando il percorso del file o della directory che desideri eliminare, Ultrahand lo rimuove prontamente, rendendo il processo di eliminazione senza problemi.
• Sposta file o directory:
  • Sposta facilmente file o directory tra le posizioni sulla scheda SD. Fornisci il percorso di origine e il percorso della directory di destinazione e Ultrahand si prenderà cura del processo di spostamento, garantendo un trasferimento senza intoppi.
• Scarica file:
  • Scarica file sulla tua scheda SD con facilità. Recupera in modo efficiente file da repository o URL nella posizione desiderata. Che tu debba scaricare/aggiornare homebrew o trasferire file tra posizioni, questa funzione semplifica il processo, rendendo la gestione delle repository un gioco da ragazzi.
• Estrai file ZIP:
  • Estrai file compressi zip sulla scheda SD decomprimendo gli archivi, preservando la loro struttura originale. Che tu abbia scaricato archivi zip o ricevuto file compressi, questo comando semplifica il processo di estrazione, rendendo facile l’accesso ai contenuti.
• Modifica file INI:
  • Modifica facilmente i file INI sulla scheda SD. Assumi il pieno controllo delle tue configurazioni aggiornando le coppie chiave-valore esistenti, aggiungendo nuove voci o creando nuove sezioni all’interno del file INI utilizzando Ultrahand. Personalizza e personalizza i tuoi file INI senza sforzo attraverso la sua interfaccia intuitiva.
• Modifica file esadecimale:
  • Modifica esadecimale dei file sulla scheda SD. Modifica direttamente i dati binari, consentendo un controllo preciso sui dati. La funzione Hex Edit Files di Ultrahand consente di analizzare, modificare e personalizzare i file nella loro forma grezza.

Ultrahand fornisce una comoda interfaccia a riga di comando per eseguire queste operazioni, consentendoti di gestire in modo efficiente file, directory e file INI su una scheda SD.

Utilizzo

Per utilizzare Ultrahand, seguire questi passaggi:

1. Scaricare e installare l’ultima versione di nxovloader.
2. Scaricare l’ultima versione di Ultrahand ovlmenu.ovl e posizionarla nella cartella /switch/.overlays/.

ATTENZIONE: Questo sovrascriverà Tesla Menu se già installato.

3. Dopo aver installato Ultrahand Overlay, verrà creata una nuova cartella chiamata ultrahand nella cartella di configurazione principale sulla scheda SD (/config/ultrahand/), insieme a un file config.ini contenente varie impostazioni di Ultrahand.
4. Avviare Ultrahand (simile a Tesla Menu) con le combinazioni di tasti predefinite di Tesla o di Ultrahand ( + + ). Verrà creata una nuova cartella (/switch/.packages/) con un file package.ini preimpostato per i comandi del menu base.
5. Posizionare il file package.ini personalizzato nella directory dei pacchetti di Ultrahand (/switch/.packages/<NOME_PACCHETTO>/). Questo file conterrà i comandi per il pacchetto personalizzato di Ultrahand.
6. I comandi ora appariranno nel menu pacchetti all’interno di Ultrahand.

Funzionalità Aggiuntive

• Premere per eseguire qualsiasi comando, così come premere  per visualizzare/eseguire le singole linee di comando scritte nel file ini per l’esecuzione.
• Premere  nel menu principale per entrare nel menu delle impostazioni.
• Premere  sopra un overlay/pacchetto per aggiungerli ai preferiti.
• Premere  sopra un overlay/pacchetto per configurare impostazioni aggiuntive.
• Per ulteriore assistenza con i pacchetti personalizzati, consultare la Wiki di Ultrahand Overlay.

Opzioni di configurazione

Il file config.ini contiene diverse sezioni che definiscono insiemi di comandi eseguibili. Ogni sezione è racchiusa tra parentesi quadre [ ] e i comandi sono elencati sotto ciascuna sezione.

Ecco un esempio del formato del file config.ini:

Gli utenti hanno la possibilità di personalizzare le azioni eseguite da Ultrahand aggiungendo le proprie sezioni e comandi nel file config.ini.

È importante notare che i percorsi specificati nei comandi devono essere relativi alla directory principale della scheda SD e devono terminare con /.

Riferimento ai comandi

Ultrahand supporta i seguenti comandi:

• make o mkdir: Crea una nuova directory.
  • Utilizzo: make <percorso_directory>
• copy o cp: Copia un file o una directory.
  • Utilizzo: copy <source_file_path> <destination_file_path>
• delete o del: Elimina un file o una directory.
  • Utilizzo: delete <percorso_file>
• move o mv: Sposta o rinomina un file o una directory in una nuova posizione o con una nuova etichetta.
  • Utilizzo: move <file_path> <destination_directory_path>
• set-ini-val o set-ini-value: Modifica un file INI aggiornando o aggiungendo una sezione con la coppia chiave-valore desiderata.
  • Utilizzo: set-ini-val <file_to_edit> <sezione_desiderata> <chiave_desiderata> <valore_desiderato>
• set-ini-key: Modifica un file INI aggiornando una sezione con una nuova chiave.
  • Utilizzo: set-ini-key <file_to_edit> <sezione_desiderata> <chiave_desiderata> <chiave_nuova_desiderata>
• reboot: Riavvia il sistema.
  • Utilizzo: reboot
• shutdown: Spegne il sistema.
  • Utilizzo: shutdown

Assicurarsi di seguire la sintassi corretta e fornire gli argomenti richiesti per ciascun comando, questo è fondamentale per un utilizzo corretto di Ultrahand.

È possibile configurare questi comandi nel file config.ini inserendoli nelle sezioni corrispondenti e fornendo gli argomenti necessari come descritto per ciascun comando.

Changelog

1. Migliorati i comandi download e unzip.
   • La libreria zzip è stata sostituita da minizip per una migliore compatibilità, incluso il supporto ai file .z64.
   • Test effettuati con download vicini ai 4 GB (limite del file system FAT32) e con file contenuti all’interno di archivi .zip.
     • Test effettuati anche con archivi zip contenenti migliaia di file.
2. Calibrazione dei buffer per operazioni di download, unzip, copy e funzioni hex.
   • Le calibrazioni sono state impostate in base alla memoria heap disponibile, sia per nx-ovlloader che per nx-ovlloader+.
   • nx-ovlloader:
     • Download: Lettura 128 KB, scrittura 32 KB
     • Unzip: Lettura 128 KB, Scrittura 32 KB
     • Copy: Scrittura 64 KB
     • Hex: Scrittura 64 KB
   • nx-ovlloader+:
     • Download: Lettura 256 KB, scrittura 128 KB
     • Unzip: Lettura 256 KB, scrittura 128 KB
     • Copy: Scrittura 256 KB
     • Hex: Scrittura 256 KB
   • Il risultato è un aumento della velocità nelle operazioni di download, estrazione, copia ed editing esadecimale, con meno problemi di memoria.
     • Le ottimizzazioni apportate in questa versione hanno portato a una maggiore quantità di memoria heap disponibile.
3. Ottimizzata la gestione dell’overlay di selezione (comandi sorgente).
   • Migliorata la gestione della memoria per l’uso con nx-ovlloader (loader base).
     • Il loader base ora disegna al massimo 250 elementi nella lista per evitare crash.
       • Nota: Se ci sono più di 250 elementi, non verranno mostrati tutti.
       • Il loader nx-ovlloader+ invece non ha limiti nel numero di elementi visualizzati.
4. Migrata la libreria jansson a cJSON.
   • cJSON ha dimensioni di compilazione più ridotte ed è più veloce nei casi d’uso tipici di Ultrahand.
5. Ora viene compilato senza fstream (direttiva NO_FSTREAM), utilizzando invece stdio.h.
   • Questo porta a prestazioni migliori e a un file binario finale più piccolo.
6. Ottimizzazioni e correzioni ai vari metodi di rendering.
   • Il rendering è ora leggermente più veloce rispetto alla versione 1.9.6, con meno potenziali problemi.
7. Ottimizzazioni generali su tutti i metodi della libreria libultra.
   • Miglioramenti alle funzioni ini, hex, path e json.
   • Correzioni di bug legati alla direttiva NO_FSTREAM.
8. Pulizia grafica della classe List, eliminando piccoli fastidi visivi.
   • Corretto il problema del menu che non tornava in cima dopo uno scroll.
   • Risolto anche il salto automatico all’inizio o alla fine del menu quando si interagiva con una tabella.
   • Migliorato leggermente lo scorrimento nelle tabelle.
   • Rimozione di metodi interni non necessari.
   • Risolto un bug di perdita di memoria causato da passaggi rapidi tra pagine (più veloci del tempo di rendering).
9. Le aree touch inferiori sono ora correttamente allineate al testo, mantenendo uniformità anche con cambi di lingua.
   • Questo dovrebbe mantenere le aree touch pulite e uniformi, indipendentemente dai cambi di lingua.
10. Introdotta un’opzione per disabilitare l’aggiornamento automatico di nx-ovlloader/nx-ovlloader+ durante l’update del software.
    • Per attivarla, basta aggiungere un file vuoto chiamato NO_LOADER_UPDATES.flag nella cartella /config/ultrahand/flags/.
    • Nota: Usare con cautela, poiché con questo flag attivo, i loader non verranno più aggiornati automaticamente.
11. Durante download, estrazioni o copie di grandi dimensioni, la barra in basso mostrerà ora i pulsanti Hide e Cancel, con piena integrazione touch.
12. Ripuliti i puntatori unici e condivisi in main.cpp, ora sostituiti da puntatori raw.
13. La cache dei caratteri (glyph cache) verrà ora svuotata automaticamente entrando nei pacchetti Ultrahand o nell’overlay di selezione.
    • Questo previene ingrossamenti eccessivi della cache, possibile causa di leak di memoria.
14. L’overlay degli script ora mostra i comandi di inoltro dei pacchetti.
15. Aggiunta una nuova variabile di lingua per abbreviare la parola “Overlay” nell’area touch inferiore.
    • Utile per lingue in cui la traduzione di “Overlay” è troppo lunga.
16. Rimozione di tutte le dichiarazioni .reserve dal progetto.
    • I test hanno mostrato che tali riserve contribuivano al sovraccarico dell’heap e a perdite di memoria.
17. Tutti i metodi legati a __builtin_ per la gestione della memoria sono stati riportati alle controparti std.
    • Per l’uso in questo progetto, i metodi __builtin_ risultavano meno adatti, soprattutto quando la dimensione non è determinabile in fase di compilazione.
18. Corretto un bug in cui nx-ovlloader+ non si attivava automaticamente al primo clic, in assenza di file zip di espansione.
19. Corretto un problema che impediva alla funzione di aggiunta ai preferiti di gestire correttamente la navigazione tramite menu rapido.
20. Aggiustamenti vari di allineamento e correzione bug minori.

Download: Ultrahand Overlay v1.9.7

Download: lang.zip

Download: Source code Ultrahand Overlay 1.9.7

Fonte: gbatemp.net