# Guideline 2.5.4: background mode rifiutato da Apple

> Apple rifiuta un background mode dichiarato senza una funzione che lo usi. Togli la chiave o mostra al reviewer la funzione.

Pagina originale: [Guideline 2.5.4: background mode rifiutato da Apple](https://devoria.fr/it/blog/guideline-2-5-4-background-mode-rifiutato-apple)
Autore: [Mehdi Azizi](https://devoria.fr/it/mehdi-azizi)
Pubblicazione: 2026-11-04
Ultima revisione dei contenuti: 2026-11-04


La guideline 2.5.4 limita i background mode al loro uso previsto: audio, posizione, chiamate VoIP, completamento di attività, notifiche locali. Il rifiuto arriva quando il tuo Info.plist dichiara uno di questi mode e il reviewer non trova nessuna funzione che ne abbia bisogno. **Togli la chiave se niente la usa, altrimenti mostra la funzione al reviewer in trenta secondi.**

Pubblico le mie app iOS con Expo. Solys, la mia sveglia con mini-giochi, dichiara il mode audio: l'ho tolto, poi rimesso per un altro motivo. Questa guida si basa sul testo di Apple, su rifiuti pubblicati da altri sviluppatori e sui miei progetti. Per il quadro generale dei motivi, leggi [perché Apple rifiuta un'app](https://devoria.fr/it/blog/app-rifiutata-da-apple-perche-casi-reali).

## Cosa dice la guideline 2.5.4?

La regola sta in una frase, nella sezione 2 "Performance", parte 2.5 "Software Requirements", delle [App Review Guidelines](https://developer.apple.com/app-store/review/guidelines/#2.5.4): "Multitasking apps may only use background services for their intended purposes: VoIP, audio playback, location, task completion, local notifications, etc."

In pratica: un servizio in background serve solo a ciò per cui esiste. Da qui il titolo "Guideline 2.5.4 - Performance - Software Requirements".

Di default, un'app che passa in background viene sospesa. Per continuare a girare, dichiara uno o più mode nella chiave `UIBackgroundModes` del suo Info.plist. La [documentazione di Apple sui background mode](https://developer.apple.com/documentation/xcode/configuring-background-execution-modes) chiede di usarli con parsimonia, per via della batteria, e di preferire un'altra soluzione quando esiste. **Ogni mode dichiarato è una promessa che il reviewer può verificare.**

## I background mode e il loro uso previsto

| Mode                  | Chiave                | Uso previsto                |
| --------------------- | --------------------- | --------------------------- |
| Audio, AirPlay, PiP   | `audio`               | Audio udibile in background |
| Posizione             | `location`            | Posizione continua          |
| Voice over IP         | `voip`                | Chiamate con CallKit        |
| Background fetch      | `fetch`               | Contenuti di rete regolari  |
| Background processing | `processing`          | Attività pianificate        |
| Notifiche remote      | `remote-notification` | Push di nuovi contenuti     |

Questa tabella riassume la pagina di Apple. Nei rifiuti pubblicati sui forum, `audio`, `location` e `voip` sono i più frequenti.

## Cosa significa il messaggio di rifiuto 2.5.4?

Il messaggio nomina il mode in questione. Due esempi pubblicati da sviluppatori sui forum di Apple:

- **Audio**: "Your app still declares support for audio in the UIBackgroundModes key in your Info.plist but did not include features that require persistent audio." Il seguito precisa che la chiave `audio` è pensata per le app che fanno sentire un contenuto in background, come un lettore musicale. Propone due vie d'uscita: aggiungere questo contenuto o togliere la chiave ([thread del forum](https://developer.apple.com/forums/thread/95216)).
- **Posizione**: in un [thread di dicembre 2024](https://developer.apple.com/forums/thread/771202), Apple non ha trovato nessuna funzione, a parte il tracciamento dei dipendenti, che richieda una posizione continua, e scrive che questo solo uso non è appropriato.

La mia lettura: **il reviewer non legge il tuo codice, cerca una funzione.** Deve poterla avviare, mandare l'app in background e constatare che continua.

Esiste anche il caso opposto. In un [thread di maggio 2026](https://developer.apple.com/forums/thread/826849), un'app di lettura ad alta voce, che usava davvero il mode `audio`, è stata rifiutata più volte: il reviewer non riusciva ad attivare l'audio. Un altro sviluppatore scrive lì che, secondo lui, un video allegato ha sbloccato il suo caso. È una testimonianza, non una regola di Apple.

## Da dove viene la chiave se non l'hai aggiunta tu?

Con Expo, sono i config plugin a riempire l'Info.plist durante il prebuild. **Un background mode può quindi finire nel tuo binario senza che tu l'abbia deciso.**

### Il plugin expo-audio, con le impostazioni di default

La [documentazione di expo-audio](https://docs.expo.dev/versions/latest/sdk/audio/) lo dice: l'opzione `enableBackgroundPlayback` vale `true` di default e, su iOS, aggiunge il mode `audio`. Dichiarare il plugin nella forma breve, `"expo-audio"`, basta quindi a dichiarare il mode.

È quello che ho trovato rileggendo TradaZen prima del primo invio: brevi suoni di interfaccia in primo piano, ma un plugin dichiarato in forma breve. La correzione sta in `app.json`:

```json
{
  "expo": {
    "plugins": [["expo-audio", { "enableBackgroundPlayback": false }]]
  }
}
```

Altri pacchetti aggiungono un mode a modo loro. L'opzione `isIosBackgroundLocationEnabled` di [expo-location](https://docs.expo.dev/versions/latest/sdk/location/) aggiunge `location` solo se la attivi. [expo-background-task](https://docs.expo.dev/versions/latest/sdk/background-task/), invece, aggiunge `processing` al prebuild appena è installato.

### La cartella ios/ che conserva la vecchia chiave

Seconda trappola, vissuta su Solys a luglio 2026. Avevo tolto `audio` da `app.json`, ma la chiave restava in `ios/Solys/Info.plist`, generato in precedenza. Un prebuild senza `--clean` modifica quel progetto invece di ricrearlo, e il plugin aggiunge la chiave senza mai toglierla. Una build locale l'avrebbe inclusa. Una build EAS nel cloud riparte da un prebuild nuovo quando `ios/` è ignorata da git, che era il mio caso.

Prima di ogni build, controllo cosa partirà davvero:

```bash
npx expo config --type introspect --json | grep -o '"UIBackgroundModes":\[[^]]*\]'
npx expo prebuild --clean --platform ios
```

Il primo elenca i mode che il prebuild scriverà nell'Info.plist. Il secondo ricrea il progetto nativo per una build locale, cancellando la cartella `ios/`. Su Solys, il primo mostra `"UIBackgroundModes":["audio"]`, su TradaZen niente: entrambi voluti.

Aggiungere o togliere un mode modifica l'Info.plist, quindi il binario: **serve una nuova build, un aggiornamento remoto non basta.** La [documentazione di EAS Update](https://docs.expo.dev/eas-update/introduction/) mette queste modifiche tra quelle che richiedono un nuovo binario, come per [ITMS-90683](https://devoria.fr/it/blog/itms-90683-missing-purpose-string-expo).

## Solys: un mode audio dichiarato, con un motivo vero

Solys è una sveglia, ma il mode `audio` non serve a far suonare l'allarme: **la suoneria passa da AlarmKit**, il servizio di allarme di Apple disponibile da iOS 26 ([documentazione AlarmKit](https://developer.apple.com/documentation/alarmkit)). È il sistema a suonare, anche in modalità silenziosa, non l'app.

La storia della chiave, perché il ragionamento conta più della riga:

1. **A fine luglio 2026 la tolgo.** Niente riproduceva audio in background: gli effetti sonori dei mini-giochi restano in primo piano, e l'allarme non dipende dall'app.
2. **Due giorni dopo la rimetto**, con l'ascolto della notte. Questa opzione registra i rumori della tua notte col microfono e li analizza sull'iPhone. La registrazione deve continuare a schermo bloccato, e la documentazione di expo-audio indica che anche l'opzione di registrazione in background aggiunge il mode `audio`.

La giustificazione ha cambiato natura: **il mode serve a registrare, non a riprodurre.** Tre paletti, visibili nell'app:

- l'ascolto è un'opzione disattivata di default, che si attiva dalle impostazioni o dal rituale della sera;
- ha una sua schermata di consenso, come richiede la [regola 2.5.14](https://developer.apple.com/app-store/review/guidelines/#2.5.14) per qualsiasi registrazione, e niente lascia il telefono;
- il microfono si chiude dieci minuti prima dell'allarme, così ascolto e suoneria non si intralciano mai.

Non posso garantire che un reviewer accetterà sempre questa dichiarazione. So dire, per ogni elemento, a cosa serve e dove vederlo.

### Le sveglie che tenevano l'app sveglia

Prima di AlarmKit, una sveglia di terze parti non poteva suonare come l'allarme di Apple. Alcune librerie tenevano quindi l'app attiva: la documentazione del pacchetto Flutter [alarm2](https://pub.dev/packages/alarm2) descrive un player audio silenzioso che gira fino all'allarme. Ma un audio muto non fa sentire niente. **Da iOS 26, AlarmKit rende inutile questa scorciatoia.**

## Tenere o togliere il mode: la griglia di decisione

| La tua situazione            | Cosa fare                 |
| ---------------------------- | ------------------------- |
| Suoni brevi in primo piano   | Togliere `audio`          |
| Musica o audiolibro          | Tenerlo, mostrarlo        |
| Registrazione lunga          | Tenerlo + consenso        |
| Sveglia o timer              | AlarmKit (iOS 26)         |
| Posizione ogni tanto         | Cambiamenti significativi |
| Sincronizzazione non urgente | `fetch` o `processing`    |
| Chiamate audio o video       | `voip` con CallKit        |

Per la posizione, la pagina di Apple cita il servizio dei cambiamenti significativi di posizione come alternativa al mode `location`.

## Gli altri commi della 2.5: 2.5.1 e 2.5.2

### 2.5.1: API pubbliche e framework al loro posto

"Apps may only use public APIs and must run on the currently shipping OS." L'app usa solo API pubbliche, gira sulla versione attuale del sistema e abbandona ciò che è deprecato. Come per la 2.5.4, ogni framework serve al suo uso previsto, indicato nella descrizione: HealthKit per la salute, HomeKit per la casa connessa. Se una libreria chiama un'API privata, è la tua app a prendersi il rifiuto.

### 2.5.2: niente codice scaricato che cambia l'app

L'app resta autonoma nel suo pacchetto. Non può "download, install, or execute code which introduces or changes features or functionality of the app". Solo le app educative che insegnano a programmare hanno un'eccezione limitata, con un codice interamente visibile e modificabile dall'utente.

Con Expo, la questione tocca EAS Update, la cui documentazione ricorda che gli aggiornamenti devono rispettare le regole dell'App Store. **Usa gli aggiornamenti remoti per correggere, mai per consegnare una funzione che il reviewer non ha visto.** Una correzione legata alla revisione passa da una nuova build, come spiego nella guida alla [guideline 2.1](https://devoria.fr/it/blog/guideline-2-1-app-store-rifiuto).

## Come rispondere a un rifiuto 2.5.4?

La conversazione si svolge nella sezione App Review della tua app, dove [rispondi al messaggio di App Review](https://developer.apple.com/help/app-store-connect/manage-submissions-to-app-review/reply-to-app-review-messages/). Due casi:

- **Il mode non serve a niente**: toglilo, rifai una build, controlla l'introspection, poi rispondi in due frasi.
- **Il mode serve a una funzione vera**: rispondi col percorso esatto e un breve video, poi riprendi questo testo nelle note di revisione di ogni versione.

Il modello che userei, da adattare (togli la frase sull'allarme se la tua app non ne ha):

```text
Hello,

The "audio" background mode is used only by [feature], an
optional feature that [records / plays] audio while the
device is locked. It is off by default.

How to test:
1. Open [screen] and turn on [feature].
2. Accept the microphone permission if asked.
3. Tap [button], then lock the device.
   [What the reviewer will hear or see.]

Our alarm does not use this mode: it is scheduled with
AlarmKit and rings through the system.

Attached: a short screen recording of these steps.

Best regards,
```

## La checklist 2.5.4 prima dell'invio

- L'introspection di Expo mostra solo i mode voluti, e sai nominare la funzione di ognuno.
- Nessun plugin è dichiarato in forma breve se aggiunge un mode di default, come expo-audio.
- La tua cartella `ios/` locale non conserva nessuna vecchia chiave, oppure compili da un prebuild pulito.
- La funzione si attiva in fretta, senza impostazioni nascoste, e le note di revisione dicono quale mode serve a cosa e come testarlo.
- Ogni registrazione chiede un consenso esplicito e mostra un indicatore visibile. Le regole sulle richieste di autorizzazione sono nella guida alla [guideline 5.1.1](https://devoria.fr/it/blog/guideline-5-1-1-rifiuto-app-store).
- Per una sveglia, la suoneria passa da AlarmKit, non da un audio riprodotto dall'app.

## Controllare il tuo pacchetto prima dell'invio

Il [Review Kit](https://devoria.fr/it/kits/app-review) riunisce la mia checklist pre-invio, modelli di note per il tester e skill di Claude Code che rileggono il tuo progetto. Per uno sguardo umano, [prenota un'ora con me](https://devoria.fr/it/coaching): leggiamo insieme il messaggio di Apple e il tuo Info.plist, in videochiamata. Il percorso completo è nella pagina [app rifiutata da Apple](https://devoria.fr/it/expertise/app-rifiutata-da-apple).

Stai preparando la tua prima uscita? [Fai la tua diagnosi gratuita](https://devoria.fr/it/diagnostic): rimette in ordine i passaggi e ti manda la mia checklist anti-rifiuto Apple.

Nessuno può garantire che Apple accetterà la tua app. Un background mode ben giustificato, però, si difende in trenta secondi.

## Domande frequenti

### Cosa significa "Guideline 2.5.4 - Performance - Software Requirements"?

È il titolo del rifiuto quando Apple ritiene che un background mode del tuo Info.plist non serva al suo uso previsto. Il messaggio nomina il mode e propone di mostrare la funzione che lo usa o di togliere la chiave.

### Serve una nuova build dopo un rifiuto 2.5.4?

Se togli o modifichi un mode, sì: la chiave è nell'Info.plist, quindi nel binario. Se il mode è giustificato, può bastare una risposta col percorso esatto e un video.

### Si può tenere il mode audio per qualche suono di interfaccia?

No. Suoni brevi riprodotti in primo piano non ne hanno bisogno. Con Expo, imposta `enableBackgroundPlayback` su `false` nel plugin expo-audio.

### Un'app sveglia ha bisogno del mode audio?

Non per suonare, se si appoggia ad AlarmKit, disponibile da iOS 26: è il sistema a riprodurre l'allarme. Su Solys, il mode `audio` serve all'ascolto della notte, che registra a schermo bloccato.

### Perché Apple cita la 2.5.4 se non ho dichiarato niente?

Forse l'ha fatto un plugin al posto tuo: expo-audio aggiunge il mode `audio` di default, e una vecchia cartella `ios/` può conservare una chiave tolta dalla tua configurazione. Controlla con `npx expo config --type introspect`.


## Il tuo progetto

[Review Kit](https://devoria.fr/it/kits/app-review): La mia checklist per la review dell'App Store, i rifiuti di Apple che ho risolto, quella di Google Play e tre skill per Claude Code. 49 €.

[iOS & Android Kit](https://devoria.fr/it/kits/ios): Crea la tua app iPhone e Android con Claude Code: il codice di partenza delle mie app, il percorso fino agli store e tutti i kit. 99 €.

[Diagnosi: cosa ti separa dalla tua app per iPhone](https://devoria.fr/it/diagnostic): 7 domande, 60 secondi: scopri cosa ti blocca davvero nel pubblicare la tua app per iPhone, il tuo percorso in 4 tappe e il kit giusto per te.