From 4572b7bf6fa035db0b5da4d1c05a95eccdc44459 Mon Sep 17 00:00:00 2001
From: "Nate(Qiang) Jiang" <qiangjiang@google.com>
Date: Mon, 13 Jan 2020 16:33:42 -0800
Subject: [PATCH] Deprecate WifiManager passpoint API's

We prefer app to use suggestion API to add passpoint network.

Bug: 142424092
Test: atest android.net.wifi
Change-Id: I030efc2eeecef16ce7d5650136f168a44fad864e
---
 wifi/java/android/net/wifi/WifiManager.java | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/wifi/java/android/net/wifi/WifiManager.java b/wifi/java/android/net/wifi/WifiManager.java
index ec3de43ee85a4..bf973aba64ac9 100644
--- a/wifi/java/android/net/wifi/WifiManager.java
+++ b/wifi/java/android/net/wifi/WifiManager.java
@@ -1948,6 +1948,15 @@ public class WifiManager {
      * @param config The Passpoint configuration to be added
      * @throws IllegalArgumentException if configuration is invalid or Passpoint is not enabled on
      *                                  the device.
+     *
+     * Deprecated for general app usage - except DO/PO apps.
+     * See {@link WifiNetworkSuggestion.Builder#setPasspointConfig(PasspointConfiguration)} to
+     * create a passpoint suggestion.
+     * See {@link #addNetworkSuggestions(List)}, {@link #removeNetworkSuggestions(List)} for new
+     * API to add Wi-Fi networks for consideration when auto-connecting to wifi.
+     * <b>Compatibility Note:</b> For applications targeting
+     * {@link android.os.Build.VERSION_CODES#R} or above, except for system of DO/PO apps, this API
+     * will throw {@link IllegalArgumentException}
      */
     public void addOrUpdatePasspointConfiguration(PasspointConfiguration config) {
         try {