Home Homebrew Pubblicato un nuovo aggiornamento per RAWeb

Pubblicato un nuovo aggiornamento per RAWeb

Di
Francesco Lanzillotta
-
77
0

Pubblicato un rapido aggiornamento correttivo per RAWeb, la piattaforma di RetroAchievements.org che gestisce obiettivi, dati di gioco e funzionalità per la community.

L’applicazione, sviluppata con Laravel (TALL stack), permette agli utenti di interagire con il sistema di RetroAchievements per tracciare i progressi nei giochi e condividerli con altri membri della community.

Tra le novità principali, viene abilitata la possibilità per alcuni emulatori di effettuare il downgrade della modalità “hardcore” per client deprecati, offrendo così maggiore compatibilità con software meno recenti.

Inoltre, viene reso generalmente disponibile il sistema Events 2.0, una revisione della gestione degli eventi sulla piattaforma.

Nei forum, è stato aggiunto il nuovo shortcode [event], mentre sul fronte delle notifiche ora è attivo un sistema di promemoria via email per gli sviluppatori, relativo alla scadenza delle richieste di claim sugli achievement.

Per quanto riguarda i bug fix, l’interfaccia utente è stata affinata modificando lo stile di interruzione delle parole nelle email, mentre nella sezione “Compare Progress” dei giochi non verranno più mostrati gli utenti bannati.

Sono stati corretti anche problemi SEO che causavano malfunzionamenti nella generazione dei template a causa dell’uso delle virgolette, e nella visualizzazione dei profili utente è stato risolto un errore che includeva erroneamente i punti evento nei grafici dei progressi recenti.

Inoltre è stato migliorato in modo marginale il rendimento del database e sono stati esclusi i punti evento dai calcoli aggregati relativi ai punteggi dei giocatori.

Dal lato gestionale, è stata ripristinata la possibilità di cliccare su alcuni selettori di data e risolti errori rari che potevano verificarsi nella gestione dei giochi.

Non sono state introdotte modifiche alle API, ma dal punto di vista dell’infrastruttura, sono state aggiunte nuove tabelle a supporto di una futura revisione della pagina di download degli emulatori.

Infine, è stato attivato il supporto completo a Sentry con tracciamento full-stack per il frontend basato su Inertia/React, migliorando così l’osservabilità e il monitoraggio degli errori nell’intera applicazione.

Requisiti

Per eseguire RAWeb localmente, sono necessari i seguenti componenti:

  • Server web locale: È necessario un server web per eseguire l’applicazione.
  • PHP 8.2: La piattaforma richiede PHP 8.2, con diverse estensioni abilitate (come curl, gmp, mysqli, pdo_mysql, gd, intl, sockets).
  • Composer: Il gestore di dipendenze PHP, necessario per installare le librerie richieste da RAWeb.
  • MariaDB 10: Il database supportato per memorizzare i dati.
  • Node.js 20 e pnpm 9: Questi strumenti sono utilizzati per la gestione dei pacchetti frontend e la build degli asset.

RAWeb è compatibile con i seguenti sistemi operativi e configurazioni:

  • Windows, macOS, Linux.
  • Diverse opzioni di configurazione sono disponibili: Docker (con Laravel Sail), XAMPP e Laravel Valet per macOS.

Opzioni di configurazione

Esistono diverse opzioni per configurare RAWeb:

  1. Docker Compose (Windows, Linux, macOS):
    Utilizzando Laravel Sail, l’ambiente di sviluppo viene creato automaticamente con i container Docker. La documentazione di Laravel Sail descrive i passaggi dettagliati. Una volta configurato, è possibile avviare i container con il comando sail up o in modalità demone con sail up -d.
  2. XAMPP (Windows, Linux, macOS):
    È necessario installare XAMPP con PHP 8.2, che include un server Apache, MySQL/MariaDB e PHP. Si dovranno abilitare alcune estensioni in php.ini (come curl, gmp, mysqli, ecc.) per garantire la compatibilità con le dipendenze di RAWeb.
  3. Laravel Valet (macOS):
    Se si utilizza Laravel Valet su macOS, è possibile configurare facilmente l’ambiente locale. Valet agisce come driver per l’ambiente di sviluppo e fornisce una configurazione web locale senza complicazioni.

Installazione di RAWeb

Una volta che il server e le dipendenze sono configurati, l’installazione di RAWeb avviene in due fasi principali:

  1. Installazione delle dipendenze: Dopo aver clonato il repository di RAWeb, eseguire composer install per installare tutte le librerie necessarie. Se si desidera utilizzare la versione locale di composer.phar invece di una globale, si può eseguire php composer.phar install.
  2. Configurazione dell’ambiente: È necessario eseguire il comando composer setup per configurare correttamente l’ambiente. Questo script imposterà le variabili di ambiente e le configurazioni iniziali. Durante questa fase, si consiglia di adattare il file .env con le credenziali del database e l’URL dell’applicazione.

Configurazione dell’ambiente (.env)

Il file .env contiene valori predefiniti sensati, ma potrebbero essere necessarie alcune modifiche:

  • Credenziali del database: Impostare i valori per la connessione al database locale (DB_*).
  • Configurazione dell’URL dell’applicazione: Impostare l’URL dell’applicazione (APP_URL). Per esempio, se si usa Docker, l’URL potrebbe essere http://localhost:64000. Con Valet, potrebbe essere https://raweb.test.

Se si sta utilizzando un ambiente Docker, non sono necessarie ulteriori configurazioni specifiche, poiché l’applicazione rileverà automaticamente la configurazione del container Laravel Sail.

Se si utilizza XAMPP o Valet, sarà necessario regolare l’URL dell’applicazione e configurare correttamente i virtual host o il dominio.

Costruzione e configurazione del frontend

Per generare gli asset frontend:

  1. Installazione delle dipendenze frontend: Utilizzare pnpm install per installare le dipendenze necessarie.
  2. Costruzione degli asset: Eseguire pnpm build per creare la build finale. Con Docker Sail, è possibile eseguire questi comandi tramite sail pnpm install e sail pnpm build.
  3. Creazione dei symlink per il filesystem: Per rendere accessibili i file di archiviazione, eseguire php artisan ra:storage:link --relative per creare i collegamenti simbolici necessari. Anche questo comando è disponibile tramite Sail (sail artisan ra:storage:link --relative).

Configurazione del database

Dopo aver configurato l’ambiente e costruito gli asset, è necessario preparare il database:

  1. Esegui la migrazione: Esegui php artisan migrate per applicare le migrazioni e configurare il database.
  2. Popola il database con dati di test: Usa il comando php artisan db:seed per popolare il database con i dati di test. Puoi eseguire anche questo comando tramite Sail (sail artisan db:seed).

Accesso all’applicazione

A seconda dell’ambiente scelto, puoi accedere all’applicazione nel seguente modo:

Utilizzo per lo sviluppo di obiettivi

Se desideri sviluppare obiettivi localmente, puoi aggiungere un file host.txt nella directory di RALibRetro accanto al file RAIntegration.dll. Questo file deve contenere l’URL del tuo server locale, che potrebbe essere uno dei seguenti:

Sicurezza

Per gestire eventuali vulnerabilità di sicurezza, consulta la Security Policy di RetroAchievements.org, che fornisce indicazioni su come gestire i rischi e proteggere la piattaforma.

In questo modo, puoi configurare e utilizzare RAWeb per gestire obiettivi, giochi e funzionalità della community direttamente dal tuo server locale.

Changelog

Nuove funzionalità

  • Emulatori: Abilitato il downgrade della modalità hardcore per i client deprecati (a cura di @Jamiras, #3369).
  • Eventi 2.0: Resi generalmente disponibili (a cura di @wescopeland, #3318).
  • Forum: Aggiunto lo shortcode [event] (a cura di @wescopeland, #3372).
  • Notifiche: Introdotti promemoria via email per gli sviluppatori sulla scadenza delle richieste di claim (a cura di @Jamiras, #3375).

Correzioni di bug

  • Email: Modificato lo stile della suddivisione delle parole (a cura di @wescopeland, #3384).
  • Giochi: gli utenti bannati non vengono più mostrati nella sezione “Confronta Progressi” (a cura di @wescopeland, #3353).
  • SEO: risolto un problema in cui le virgolette rompevano il template (a cura di @wescopeland, #3374).
  • Profili Utente: i punti evento non vengono più conteggiati nel grafico “Progressi Recenti” (a cura di @wescopeland, #3378).
  • Profili Utente: migliorata moderatamente la performance del database (a cura di @wescopeland, #3382).
  • Profili Utente: esclusi i punti ottenuti negli eventi dal totale dei punti normalizzati del giocatore (a cura di @wescopeland, #3379).

Modifiche alla Console di Gestione

  • Resa di nuovo cliccabile parte dei selettori di data (a cura di @wescopeland, #3383).
  • Risolto un raro errore server nelle pagine di gestione giochi (a cura di @wescopeland, #3381).

Modifiche API

  • Nessuna

Modifiche all’Ambiente

  • Emulatori: Aggiunte nuove tabelle per supportare una versione rinnovata della pagina Download (a cura di @wescopeland, #3333).
  • Osservabilità: Configurato Sentry per Inertia/React, attivando il tracciamento completo dello stack (a cura di @wescopeland, #3371).

Changelog completo: 2025.03.30 → 2025.04.04

Download: Source code RAWeb 2025.04.04

Fonte: x.com

ARTICOLI CORRELATIALTRO DALL'AUTORE