A partire dal 27 marzo 2025, ti consigliamo di utilizzare android-latest-release anziché aosp-main per compilare e contribuire ad AOSP. Per ulteriori informazioni, vedi Modifiche ad AOSP.

Questa pagina è stata tradotta dall'API Cloud Translation.

Wi-Fi

Il modulo Wi-Fi è aggiornabile, il che significa che può ricevere aggiornamenti delle funzionalità al di fuori del normale ciclo di rilascio di Android. Questo modulo contiene i seguenti componenti.

Componenti del modulo Wi-Fi

Figura 1. Componenti e architettura del modulo Wi-Fi

Il modulo Wi-Fi offre i seguenti vantaggi.

Gli utenti finali usufruiscono di un'esperienza Wi-Fi coerente su tutti i dispositivi Android e di correzioni ai problemi di interoperabilità tramite gli aggiornamenti dei moduli.
Gli sviluppatori di app ottengono una frammentazione della piattaforma ridotta.
Gli OEM possono soddisfare i requisiti degli operatori riducendo al contempo i costi per le personalizzazioni individuali (in quanto non hanno bisogno di implementazioni diverse degli stessi requisiti in modi diversi).

Confine del modulo per Android 12 e Android 13

packages/modules/Wifi
- framework
  - java/
    - android/net/wifi (file da frameworks/base/wifi/java)
  - tests/
    - android/net/wifi (file da frameworks/base/wifi/tests)
  - aidl-export/
  - api/
  - Android.bp
- service/
  - java/
    - com/android/server/wifi (file da frameworks/opt/net/wifi/service/java)
  - tests/
    - com/android/server/wifi (file da frameworks/opt/net/wifi/tests)
  - proto/
  - Android.bp
  - proguard.flags
  - wifi.rc
- OsuLogin/ (file da frameworks/base/packages/OsuLogin)
- ServiceResources/ (novità di Android 12, il manifest APK di overlay è memorizzato qui)
  - res/ (novità di Android 11, configurazioni Wi-Fi estratte da frameworks/base/core/res/res)
  - AndroidManifest.xml
  - Android.bp
- WifiDialog/ (novità di Android 13. L'app per avviare le finestre di dialogo utente richieste dal servizio è archiviata qui).
  - src/
    - com/android/wifi/dialog (Contiene l'attività da cui vengono avviate le finestre di dialogo)
  - AndroidManifest.xml
  - Android.bp

Le directory precedenti contengono anche codice che rimane al di fuori del componente di sistema modulare e nella sua posizione attuale, ad esempio:

wificond interface (classi nel pacchetto android.net.wifi.nl80211, ad esempio WifiNl80211Manager)
App di esempio per l'overlay delle risorse
WifiTrackerLib
libwifi_hal
libwifi_system
libwifi_system_iface

Gli OEM possono utilizzare i comandi di esempio per spostare le patch dalle directory di progetto originali alla nuova directory di progetto.

Sposta una patch da frameworks/base/wifi

Generazione del file patch in root/frameworks/base/wifi

git format-patch -1 commit --stdout > patch-file.txt

Applicazione del file patch a root/packages/modules/Wifi

git am -p2 --directory=framework/ patch-file.txt

Sposta una patch da frameworks/opt/net/wifi

Per spostare la patch da frameworks/opt/net/wifi, sono necessari passaggi complessi perché la gerarchia delle directory è stata modificata durante la migrazione.

In frameworks/opt/net/wifi, dividi il commit in due commit, uno per service/ e uno per tests/.

Migrazione del commit HEAD

git reset HEAD^
git add service/
git commit # Enter your commit message. Call this commit service-commit
git add tests/
git commit # Enter your commit message. Call this commit test-commit

Generazione di due file patch di commit

git format-patch -1 service-commit --stdout > service-patch.txt
git format-patch -1 test-commit --stdout > test-patch.txt

Applicazione delle due patch a pacchetti/moduli/Wi-Fi

git am service-patch.txt
git am -p1 --directory=service/ test-patch.txt

Unione dei due commit in un unico commit

git rebase -i

Modifica l'operazione del secondo commit in squash.

Modifica il messaggio di commit in modo appropriato.

Limite del modulo per Android 11

Il servizio Wi-Fi continua a essere eseguito all'interno del processo del servizio di sistema. Il modulo Wi-Fi include tutto il codice in packages/modules/Wifi, compreso quanto segue.

Classi di servizio e SDK per WifiService, WifiP2pService, WifiAwareService, WifiScannerService e WifiRttService
OsuLogin
ServiceWifiResources

Il modulo esclude i seguenti componenti, che rimangono parte della build AOSP dell'OEM.

Componente nativo wificond in system/connectivity/wificond
Interfaccia wificond (classi nel pacchetto android.net.wifi.nl80211, ad esempio WifiNl80211Manager)
android.net.wifi.SoftApConfToXmlMigrationUtil
android.net.wifi.WifiNetworkScoreCache
android.net.wifi.WifiMigration
WifiTrackerLib
libwifi_hal
libwifi_system
libwifi_system_iface

Android 11 non sposta i file, ma le versioni future potrebbero farlo. Per ridurre lo sforzo necessario per il porting delle modifiche alla posizione dei file, ti consigliamo di eseguire l'upstream di quante più modifiche possibili in AOSP (dopo averle eseguite in Android 11 o aver eseguito il refactoring delle estensioni proprietarie per utilizzare le API Android formali o le estensioni HAL del fornitore per separarle dal codice AOSP.

Formato del modulo

Il modulo Wi-Fi (com.android.wifi) è in formato APEX ed è disponibile per i dispositivi con Android 11 o versioni successive. Il file APEX include i seguenti componenti.

Libreria SDK (framework-wifi.jar)
Libreria dei servizi (service-wifi.jar)
APK OsuLogin (OsuLoginGoogle.apk)
APK risorsa (ServiceWifiResourcesGoogle.apk)
Certificati WFA

Dipendenze del modulo

Il modulo Wi-Fi dipende dai seguenti componenti.

Connettività
Telefonia
Librerie Proto
Componenti di sistema vari
HAL Wi-Fi
wificond
bouncycastle
ksoap2
libnanohttpd

Questo modulo interagisce con il framework utilizzando solo @SystemApi stabili (nessun utilizzo dell'API @hide) ed è firmato con una firma Google anziché con una firma della piattaforma.

Personalizzazione

Il modulo Wi-Fi non supporta la personalizzazione diretta, ma puoi personalizzare la configurazione utilizzando overlay delle risorse di runtime (RRO) o configurazioni dell'operatore.

Personalizzazione del Wi-Fi

Figura 2. Personalizzazione del modulo Wi-Fi

Per piccole personalizzazioni, attiva o disattiva le impostazioni nel RRO config.
Per un maggiore controllo, personalizza i valori di configurazione per qualsiasi chiave di configurazione dell'operatore esposta come @SystemAPI.

Utilizzare le sovrapposizioni delle risorse di runtime

Puoi personalizzare il modulo Wi-Fi sostituendo le configurazioni predefinite utilizzando gli RRO. Per un elenco delle configurazioni sovrapponibili, consulta packages/modules/Wifi/service/ServiceWifiResources/res/values/overlayable.xml. Per i dettagli sul comportamento della configurazione, consulta packages/modules/Wifi/service/ServiceWifiResources/res/values/config.xml. Per un'app di overlay di esempio, consulta device/google/coral/rro_overlays/WifiOverlay/.

Poiché il file device/google/coral/rro_overlays/WifiOverlay/AndroidManifest.xml imposta l'attributo targetPackage su com.android.wifi.resources e l'APK delle risorse fornito dal modulo Wi-Fi ha il nome del pacchetto com.google.android.wifi.resources, devi impostare l'APK di overlay targetPackage su com.google.android.wifi.resources per sovrapporre correttamente le configurazioni Wi-Fi.

Esegui la migrazione del formato di archiviazione della configurazione

Il modulo Wi-Fi può analizzare solo il formato di archiviazione della configurazione Wi-Fi AOSP. Se in precedenza hai modificato il formato di archiviazione della configurazione Wi-Fi (che include l'elenco delle reti salvate dall'utente), devi convertire i dati nel formato AOSP quando esegui l'upgrade di un dispositivo a qualsiasi versione di Android che includa il modulo Wi-Fi. Gli hook necessari per questa conversione si trovano nella classe android.net.wifi.WifiMigration.

Implementa la conversione del formato nei seguenti metodi.

WifiMigration.convertAndRetrieveSharedConfigStoreFile(<storeFileId>)
- Richiamato dal modulo Wi-Fi per recuperare i contenuti del file di archivio condiviso Wi-Fi che sono stati convertiti nel formato AOSP.
- In precedenza (in Android 10), questi file venivano archiviati nella cartella /data/misc/wifi sul dispositivo.
WifiMigration.convertAndRetrieveUserConfigStoreFile(<storeFileId>)
- Richiamato dal modulo Wi-Fi per recuperare i contenuti del file di archiviazione specifici dell'utente Wi-Fi che sono stati convertiti nel formato AOSP.
- In precedenza (in Android 10), questi file venivano archiviati nella cartella /data/misc_ce/<userId>/wifi sul dispositivo.

Accedere alle API Wi-Fi nascoste

I simboli (classi, metodi, campi e così via) annotati con @hide nel modulo Wi-Fi non fanno parte della sua superficie API pubblica e non è possibile accedervi sui dispositivi con il modulo installato. I dispositivi che non includono il modulo Wi-Fi possono continuare a utilizzare le API Wi-Fi @hide seguendo questi passaggi.

Rimuovi le limitazioni di visibilità imposte a framework-wifi alle packages/modules/Wifi/framework/Android.bp modificando l'attributo impl_library_visibility in pubblico.

java_sdk_library {
    name: "framework-wifi",
    ...
    impl_library_visibility: [
       "//visibility:public", // Add this rule and remove others.
    ],
    ...
}

Modifica la regola di build per consentire l'accesso alla libreria @hide API Wi-Fi. Ad esempio, di seguito è riportata una regola di compilazione per un java_library.

java_library {
    name: "foo-lib",

    // no sdk_version attribute defined

    libs: [
        "dependency1",
        "dependency2",
    ],
}

Per consentire l'accesso alla libreria per foo-lib, modifica la regola di compilazione come segue:

java_library {
    name: "foo-lib",

    sdk_version: "core_platform",

    libs: [
        "framework-wifi.impl",
        "framework",
        "dependency1",
        "dependency2",
    ],
}

Assicurati che framework-wifi.impl venga visualizzato prima di framework nell'elenco di libs. L'ordine delle dipendenze nell'attributo libs è significativo.

Accedere alle API framework nascoste

I simboli annotati con @hide al di fuori del modulo Wi-Fi non sono accessibili dal codice all'interno del modulo Wi-Fi. I dispositivi che non includono il modulo Wi-Fi possono continuare a utilizzare le API esterne @hide (ad esempio, di framework.jar) in service-wifi apportando le seguenti modifiche a frameworks/opt/net/wifi/service/Android.bp.

Sia in wifi-service-pre-jarjar che in service-wifi, modifica l'attributo sdk_version in core_platform.
In entrambi wifi-service-pre-jarjar e service-wifi, aggiungi framework e android_system_server_stubs_current all'attributo libs.

Verifica che il risultato sia simile al seguente esempio di codice.

java_library {
    name: "wifi-service-pre-jarjar",
    ...
    sdk_version: "core_platform",
    ...
    libs: [
        ...
        "framework",
        "android_system_server_stubs_current",
    ],
}
...
java_library {
    name: "service-wifi",
    ...
    sdk_version: "core_platform",
    ...
    libs: [
        ...
        "framework",
        "android_system_server_stubs_current",
    ],
}

Test

Android Compatibility Test Suite (CTS) verifica le funzionalità del modulo Wi-Fi eseguendo un insieme completo di test CTS su ogni release del modulo. Puoi anche eseguire i test descritti in Testare, eseguire il debug e ottimizzare il Wi-Fi.