LineageOS/android_packages_modules_Connectivity
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update javadocs for ConnectivityDiagnosticsManager.

Browse Source 
ConnectivityDiagnosticsManager comments for
registerConnectivityDiagnosticsCallback and
unregisterConnectivityDiagnosticsCallback are updated to reflect several
changes.

For register calls, any app will be able to register callbacks, but only
permissioned applications will have their callbacks invoked (and only
for networks managed by the application). Additionally, only the
registering app (uid) will be able to unregister a callback once
registered.

Bug: 143187964
Test: docs change only. compiles.
Change-Id: Ie7ae86a1afccb22d6c84027dbac49d7b8e431e8c
This commit is contained in:
Cody Kesting
2019-12-19 12:36:18 -08:00
parent 73708bff55
commit ad51e01b3c
1 changed files with 4 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
core/java/android/net/ConnectivityDiagnosticsManager.java
View File

@@ -639,8 +639,9 @@ public class ConnectivityDiagnosticsManager {
/** /**
* Registers a ConnectivityDiagnosticsCallback with the System. * Registers a ConnectivityDiagnosticsCallback with the System.
* *
* <p>Only apps that offer network connectivity to the user are allowed to register callbacks. * <p>Only apps that offer network connectivity to the user should be registering callbacks.
* This includes: * These are the only apps whose callbacks will be invoked by the system. Apps considered to
* meet these conditions include:
* *
* <ul> * <ul>
* <li>Carrier apps with active subscriptions * <li>Carrier apps with active subscriptions
@@ -648,8 +649,7 @@ public class ConnectivityDiagnosticsManager {
* <li>WiFi Suggesters * <li>WiFi Suggesters
* </ul> * </ul>
* *
* <p>Callbacks will be limited to receiving notifications for networks over which apps provide * <p>Callbacks registered by apps not meeting the above criteria will not be invoked.
* connectivity.
* *
* <p>If a registering app loses its relevant permissions, any callbacks it registered will * <p>If a registering app loses its relevant permissions, any callbacks it registered will
* silently stop receiving callbacks. * silently stop receiving callbacks.