Merge "Clarify documentation for getActiveNetworkInfo and friends" am: b1016fbf14

am: bc4e495705

Change-Id: I339bb71182723907ed078e8be739c4d4ea2d1da5
This commit is contained in:
Chalard Jean
2018-03-30 08:51:38 +00:00
committed by android-build-merger

View File

@@ -861,6 +861,10 @@ public class ConnectivityManager {
* You should always check {@link NetworkInfo#isConnected()} before initiating * You should always check {@link NetworkInfo#isConnected()} before initiating
* network traffic. This may return {@code null} when there is no default * network traffic. This may return {@code null} when there is no default
* network. * network.
* Note that if the default network is a VPN, this method will return the
* NetworkInfo for one of its underlying networks instead, or null if the
* VPN agent did not specify any. Apps interested in learning about VPNs
* should use {@link #getNetworkInfo(android.net.Network)} instead.
* *
* @return a {@link NetworkInfo} object for the current default network * @return a {@link NetworkInfo} object for the current default network
* or {@code null} if no default network is currently active * or {@code null} if no default network is currently active
@@ -1018,7 +1022,11 @@ public class ConnectivityManager {
* which you're interested. * which you're interested.
* @return a {@link NetworkInfo} object for the requested * @return a {@link NetworkInfo} object for the requested
* network type or {@code null} if the type is not * network type or {@code null} if the type is not
* supported by the device. * supported by the device. If {@code networkType} is
* TYPE_VPN and a VPN is active for the calling app,
* then this method will try to return one of the
* underlying networks for the VPN or null if the
* VPN agent didn't specify any.
* *
* @deprecated This method does not support multiple connected networks * @deprecated This method does not support multiple connected networks
* of the same type. Use {@link #getAllNetworks} and * of the same type. Use {@link #getAllNetworks} and