Merge "[WIFI] Open up the getRandomizedMacAddress API"

api/current.txt

@@ -29743,6 +29743,7 @@ package android.net.wifi {
     ctor public WifiConfiguration();
     method public int describeContents();
     method public android.net.ProxyInfo getHttpProxy();
+    method public android.net.MacAddress getRandomizedMacAddress();
     method public boolean isPasspoint();
     method public void setHttpProxy(android.net.ProxyInfo);
     method public void writeToParcel(android.os.Parcel, int);

wifi/java/android/net/wifi/WifiConfiguration.java

@@ -955,9 +955,12 @@ public class WifiConfiguration implements Parcelable {
     }
 
     /**
-     * @hide
      * Returns MAC address set to be the local randomized MAC address.
      * Does not guarantee that the returned address is valid for use.
+     * <p>
+     * Information is restricted to Device Owner, Profile Owner, and Carrier apps
+     * (which will only obtain addresses for configurations which they create). Other callers
+     * will receive a default "02:00:00:00:00:00" MAC address.
      */
     public @NonNull MacAddress getRandomizedMacAddress() {
         return mRandomizedMacAddress;