4'33" GARDEN VARIATIONS — APP MULTIPIATTAFORMA
Sergio Maltagliati · 2026

Questo pacchetto contiene un'unica opera-app predisposta per:

- Android: progetto nativo che produce un APK.
- iPhone e iPad: progetto nativo Apple per Xcode.
- Windows e Mac: progetto desktop che produce installer EXE e DMG.
- Installazione immediata dal browser: app web offline (PWA).

COMPORTAMENTO CONSERVATO

- Il microfono genera nuovi segni soltanto quando supera la soglia del silenzio.
- Nel silenzio non vengono create immagini automatiche.
- “Continua senza microfono” non genera immagini automatiche; resta disponibile
  soltanto il gesto manuale.
- Grafica, registrazione, semi, tavolozze e schermo intero sono inclusi.
- L'audio viene elaborato sul dispositivo e non viene inviato a server esterni.
- Su iPhone e iPad il motore audio viene attivato direttamente dal tocco e si
  riavvia quando l'app torna in primo piano.
- Su iPad la soglia adattiva, il guadagno grafico e la velocità di risposta sono
  calibrati per reagire anche ai suoni deboli senza produrre segni nel silenzio.
- Su iPad il primo segno viene creato nello stesso fotogramma dell'attacco
  sonoro, senza attendere i tempi casuali del processo generativo.

CARTELLE

web/
  App installabile universale e offline. È la versione più semplice da
  pubblicare sul sito e installare su tutti i dispositivi.

android/
  Progetto Android Studio. Genera app-debug.apk o un APK firmato di produzione.

ios/
  Progetto iPhone/iPad descritto da project.yml. XcodeGen crea il progetto
  Xcode; per un iPhone reale serve scegliere il proprio Team Apple.

desktop/
  Progetto Electron per creare installer Windows e Mac.

.github/workflows/
  Procedure automatiche per compilare APK Android, app di prova iOS e installer
  Windows/Mac su GitHub Actions.

INSTALLAZIONE PIÙ SEMPLICE SU TUTTI I DISPOSITIVI

1. Caricare tutto il contenuto della cartella web/ in una cartella HTTPS del
   proprio sito, per esempio:

   https://sergiomaltagliati.it/garden-variations-app/

2. Aprire quell'indirizzo sul dispositivo.

3. Android, Windows e Mac: premere INSTALLA nell'app oppure scegliere
   “Installa app” nel menu del browser.

4. iPhone/iPad: aprire con Safari, premere Condividi e scegliere
   “Aggiungi alla schermata Home”.

L'app installata funziona anche offline dopo il primo caricamento. Il microfono
richiede l'autorizzazione dell'utente.

CREARE L'APK ANDROID

Metodo Android Studio:
1. Aprire la cartella android/ con Android Studio.
2. Attendere la sincronizzazione Gradle.
3. Scegliere Build > Build APK(s).
4. Il file viene creato in:
   android/app/build/outputs/apk/debug/app-debug.apk

Metodo automatico GitHub:
1. Caricare l'intero pacchetto in un repository GitHub.
2. Aprire Actions > Crea APK Android > Run workflow.
3. Scaricare “Garden-Variations-Android-APK”.

IPHONE E IPAD

Su un Mac:
1. Installare Xcode e XcodeGen.
2. Nel Terminale entrare nella cartella ios/ ed eseguire:

   xcodegen generate

3. Aprire GardenVariations.xcodeproj.
4. In Signing & Capabilities scegliere il proprio Team Apple.
5. Collegare iPhone/iPad e premere Run.

Il workflow “Crea app iPhone-iPad di prova” produce una versione per il
simulatore. Apple richiede una firma personale per installare l'app nativa su
un dispositivo reale o distribuirla tramite App Store/TestFlight.

WINDOWS E MAC

Nella cartella desktop/:

   npm install

Windows:

   npm run dist:win

Mac:

   npm run dist:mac

Gli installer vengono creati in desktop/dist/. In alternativa usare il workflow
GitHub “Crea app Windows e Mac”. Gli installer non firmati possono mostrare un
avviso di sicurezza del sistema operativo; per la distribuzione pubblica è
consigliata la firma con un certificato personale.

IDENTITÀ DELL'APP

Nome: Garden Variations
Titolo completo: 4'33" Garden Variations
Autore: Sergio Maltagliati
Identificatore: it.sergiomaltagliati.gardenvariations
Versione: 1.0.3
