Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Unverified Commit caf02804 authored by David Su's avatar David Su Committed by Kevin F. Haggerty
Browse files

CONFIGURED_NETWORKS_CHANGED_ACTION: update docs since we stop sending WifiConfiguration 

WifiConfiguration contains sensitive location
information, so this extra is no longer included
in the CONFIGURED_NETWORKS_CHANGED_ACTION
broadcast. Update docs to reflect this change.

Bug: 158874479
Test: compiles
Change-Id: I72ba9f75a89519ef136cc2766a8551b606b218c7
parent 7c4ac797

wifi/java/android/net/wifi/WifiManager.java

+16 −7
Original line number Diff line number Diff line
@@ -775,19 +775,26 @@ public class WifiManager { 


    /**

     * Broadcast intent action indicating that the configured networks changed.

     * This can be as a result of adding/updating/deleting a network. If

     * {@link #EXTRA_MULTIPLE_NETWORKS_CHANGED} is set to true the new configuration

     * can be retreived with the {@link #EXTRA_WIFI_CONFIGURATION} extra. If multiple

     * Wi-Fi configurations changed, {@link #EXTRA_WIFI_CONFIGURATION} will not be present.

     * This can be as a result of adding/updating/deleting a network.

     * <br />

     * {@link #EXTRA_CHANGE_REASON} contains whether the configuration was added/changed/removed.

     * {@link #EXTRA_WIFI_CONFIGURATION} is never set starting in Android 11.

     * {@link #EXTRA_MULTIPLE_NETWORKS_CHANGED} is set for backwards compatibility reasons, but

     * its value is always true, even if only a single network changed.

     * <br />

     * The {@link android.Manifest.permission#ACCESS_WIFI_STATE ACCESS_WIFI_STATE} permission is

     * required to receive this broadcast.

     *

     * @hide

     */

    @SystemApi

    public static final String CONFIGURED_NETWORKS_CHANGED_ACTION =

        "android.net.wifi.CONFIGURED_NETWORKS_CHANGE";

    /**

     * The lookup key for a (@link android.net.wifi.WifiConfiguration} object representing

     * The lookup key for a {@link android.net.wifi.WifiConfiguration} object representing

     * the changed Wi-Fi configuration when the {@link #CONFIGURED_NETWORKS_CHANGED_ACTION}

     * broadcast is sent.

     * Note: this extra is never set starting in Android 11.

     * @hide

     */

    @SystemApi
@@ -795,14 +802,16 @@ public class WifiManager { 
    /**

     * Multiple network configurations have changed.

     * @see #CONFIGURED_NETWORKS_CHANGED_ACTION

     *

     * Note: this extra is always true starting in Android 11.

     * @hide

     */

    @SystemApi

    public static final String EXTRA_MULTIPLE_NETWORKS_CHANGED = "multipleChanges";

    /**

     * The lookup key for an integer indicating the reason a Wi-Fi network configuration

     * has changed. Only present if {@link #EXTRA_MULTIPLE_NETWORKS_CHANGED} is {@code false}

     * has changed. One of {@link #CHANGE_REASON_ADDED}, {@link #CHANGE_REASON_REMOVED},

     * {@link #CHANGE_REASON_CONFIG_CHANGE}.

     *

     * @see #CONFIGURED_NETWORKS_CHANGED_ACTION

     * @hide

     */