VOX è un pioniere nel settore del turismo e della cultura, noto per aver rivoluzionato le visite guidate con i suoi sistemi audio fin dal 2001. Oggi, attraverso la sua piattaforma B2B2C PopGuide, offre alle aziende la possibilità di creare app personalizzate per tour autonomi con audio-guide e itinerari.
Per ampliare ulteriormente il proprio ecosistema e permettere a terze parti di integrare queste funzionalità, VOX aveva bisogno di una soluzione robusta, sicura e facile da adottare per gli sviluppatori.
La sfida
L’obiettivo era creare una libreria modulare, scalabile e facile da adottare, capace di gestire autenticazione, download di contenuti multilingua e gestione dei media, tutto mantenendo la compatibilità multipiattaforma. Serviva quindi creare un ponte tra la complessa infrastruttura di PopGuide e le diverse applicazioni dei loro partner sviluppando uno strumento che permettesse un'integrazione fluida senza esporre la logica di business proprietaria.
Le necessità chiave erano:
Semplificare l'integrazione
Fornire a sviluppatori esterni un modo semplice per implementare funzioni come login, download di itinerari e gestione dei media.
Garantire la sicurezza
Proteggere i dati e i contenuti di VOX, distribuendo il pacchetto software solo a partner autorizzati.
Assicurare la compatibilità
Creare una soluzione nativa per l'ecosistema React Native, garantendo performance e compatibilità multipiattaforma (iOS e Android).
Accelerare l'adozione
Fornire una documentazione chiara ed esempi pratici per ridurre la curva di apprendimento e i tempi di sviluppo per i team esterni.
La soluzione
La nostra soluzione si è concretizzata nello sviluppo di un SDK in React Native, distribuito come un pacchetto NPM privato e progettato con un approccio modulare e sicuro. Per garantire un'architettura scalabile e un codice di alta qualità, abbiamo utilizzato lo scaffold React Native Builder Bob, implementando TypeScript per la sicurezza dei tipi e una combinazione di ESLint e Prettier per mantenere il codice pulito e coerente. L'architettura del pacchetto, modellata sulla controparte Kotlin, assicura compatibilità multipiattaforma e affidabilità.
Il risultato è una libreria che semplifica l'integrazione di funzionalità chiave come login e download di contenuti, la cui adozione è ulteriormente facilitata da un'app di esempio completa. Infine, per garantire la massima sicurezza, la distribuzione avviene tramite un registry privato su GitHub, con accesso controllato da un token riservato ai partner di VOX.
Sviluppo dell’SDK e della libreria NPM
Il cuore del progetto è un pacchetto NPM privato che astrae la complessità delle API di PopGuide. Questo pacchetto consente agli sviluppatori di terze parti di implementare le funzionalità chiave con poche righe di codice.
- Autenticazione semplificata: abbiamo gestito i flussi di autenticazione per garantire un accesso sicuro ai contenuti solo agli utenti autorizzati.
- Gestione dei contenuti: l'SDK permette il download e la gestione di itinerari, commenti audio e altri contenuti multimediali, con supporto multilingua integrato.
- Documentazione e App di esempio: per massimizzare la facilità d'uso, abbiamo redatto una documentazione dettagliata e sviluppato un'applicazione di esempio che guida gli sviluppatori passo dopo passo nell'integrazione.
Architettura scalabile e moderna
Per costruire una base solida e garantire la qualità del codice, abbiamo utilizzato lo scaffold React Native Builder Bob. Questa scelta strategica ci ha permesso di adottare le migliori pratiche di sviluppo sin dall'inizio:
- Type-safety: l'uso di TypeScript ha garantito un codice più robusto e manutenibile.
- Code Quality: strumenti come ESLint e Prettier hanno assicurato una formattazione del codice coerente e pulita.
- Automazione: le GitHub Actions pre-configurate hanno automatizzato i processi di build e testing, ottimizzando il ciclo di sviluppo.
Distribuzione sicura e controllata
Per rispondere ai requisiti di sicurezza, abbiamo implementato un sistema di distribuzione tramite un registry privato su GitHub. L'accesso al pacchetto è consentito solo tramite un token di autenticazione riservato ai clienti di VOX. Questo approccio protegge la proprietà intellettuale di VOX e assicura che solo i partner autorizzati possano integrare l'SDK, nel pieno rispetto delle linee guida sulla privacy e sicurezza di Android e iOS.
Documentazione e supporto agli sviluppatori
Abbiamo fornito guide complete e esempi pratici per accelerare l’integrazione, ridurre errori e velocizzare i tempi di sviluppo.
Risultati e impatto
Il rilascio dell'SDK ha prodotto benefici tangibili per VOX e per il suo network di partner, posizionando PopGuide come una tecnologia ancora più integrabile e versatile.
- Accelerazione delle partnership: i partner di VOX possono ora integrare le funzionalità di PopGuide nelle loro app in tempi molto più brevi, riducendo drasticamente i costi e la complessità dello sviluppo.
- Espansione dell'ecosistema: l'SDK ha aperto nuove opportunità di business, permettendo a PopGuide di diventare una funzionalità "embedded" all'interno di altre app leader nel settore del turismo.
- Developer Experience di alto livello: la combinazione di un'architettura moderna, documentazione chiara e un'app di esempio ha creato un'esperienza di integrazione fluida e positiva per gli sviluppatori.
- Scalabilità e manutenzione: architettura modulare e strumenti avanzati garantiscono facilità di aggiornamento e ampliamento delle funzionalità.
- Sicurezza dei contenuti: distribuzione controllata e accesso selettivo proteggono dati sensibili e rispettano gli standard di privacy di Android e iOS.
VOX può così offrire una piattaforma innovativa ai propri partner internazionali, migliorando l’accessibilità e la qualità delle visite culturali in tutto il mondo.