Merge "[Wi-Fi] Add object comments for WifiTrackerLib migration" into rvc-dev am: 71b353352c

Change-Id: Ie798a4182e284c9b2ac9ec5cfe42669b32a46e11

src/com/android/settings/wifi/ConfigureAccessPointFragment.java

@@ -38,6 +38,9 @@ import com.android.settingslib.wifi.AccessPoint;
  *
  * The AccessPoint should be saved to the argument when launching this class in order to properly
  * render this page.
+ *
+ * Migrating from Wi-Fi SettingsLib to to WifiTrackerLib, this object will be removed in the near
+ * future, please develop in {@link ConfigureWifiEntryFragment}.
  */
 public class ConfigureAccessPointFragment extends InstrumentedFragment implements WifiConfigUiBase {
 

src/com/android/settings/wifi/ConnectedAccessPointPreference.java

@@ -27,7 +27,10 @@ import com.android.settings.R;
 import com.android.settingslib.wifi.AccessPoint;
 
 /**
- * An AP preference for the currently connected AP
+ * An AP preference for the currently connected AP.
+ *
+ * Migrating from Wi-Fi SettingsLib to to WifiTrackerLib, this object will be removed in the near
+ * future, please develop in {@link ConnectedWifiEntryPreference}.
  */
 public class ConnectedAccessPointPreference extends LongPressAccessPointPreference implements
         View.OnClickListener {

src/com/android/settings/wifi/LongPressAccessPointPreference.java

@@ -23,6 +23,12 @@ import androidx.preference.PreferenceViewHolder;
 import com.android.settingslib.wifi.AccessPoint;
 import com.android.settingslib.wifi.AccessPointPreference;
 
+/**
+ * An AP preference for the currently connected AP.
+ *
+ * Migrating from Wi-Fi SettingsLib to to WifiTrackerLib, this object will be removed in the near
+ * future, please develop in {@link com.android.settingslib.wifi.LongPressWifiEntryPreference}.
+ */
 public class LongPressAccessPointPreference extends AccessPointPreference {
 
     private final Fragment mFragment;

src/com/android/settings/wifi/WifiConfigController.java

@@ -86,6 +86,9 @@ import java.util.stream.Collectors;
 /**
  * The class for allowing UIs like {@link WifiDialog} and {@link WifiConfigUiBase} to
  * share the logic for controlling buttons, text fields, etc.
+ *
+ * Migrating from Wi-Fi SettingsLib to to WifiTrackerLib, this object will be removed in the near
+ * future, please develop in {@link WifiConfigController2}.
  */
 public class WifiConfigController implements TextWatcher,
         AdapterView.OnItemSelectedListener, OnCheckedChangeListener,

src/com/android/settings/wifi/WifiConfigUiBase.java

@@ -22,6 +22,9 @@ import android.widget.Button;
 
 /**
  * Foundation interface glues between Activities and UIs like {@link WifiDialog}.
+ *
+ * Migrating from Wi-Fi SettingsLib to to WifiTrackerLib, this object will be removed in the near
+ * future, please develop in {@link WifiConfigUiBase2}.
  */
 public interface WifiConfigUiBase {
 
@@ -56,4 +59,4 @@ public interface WifiConfigUiBase {
     public Button getSubmitButton();
     public Button getForgetButton();
     public Button getCancelButton();
-}
+}

src/com/android/settings/wifi/WifiDialog.java

@@ -19,7 +19,6 @@ package com.android.settings.wifi;
 import android.annotation.StyleRes;
 import android.content.Context;
 import android.content.DialogInterface;
-import android.content.Intent;
 import android.os.Bundle;
 import android.view.View;
 import android.widget.Button;
@@ -33,6 +32,12 @@ import com.android.settingslib.RestrictedLockUtils;
 import com.android.settingslib.RestrictedLockUtilsInternal;
 import com.android.settingslib.wifi.AccessPoint;
 
+/**
+ * Dialog for users to edit a Wi-Fi network.
+ *
+ * Migrating from Wi-Fi SettingsLib to to WifiTrackerLib, this object will be removed in the near
+ * future, please develop in {@link WifiDialog2}.
+ */
 public class WifiDialog extends AlertDialog implements WifiConfigUiBase,
         DialogInterface.OnClickListener {
 

src/com/android/settings/wifi/WifiSettings.java

@@ -90,6 +90,9 @@ import java.util.List;
  *
  * The second is for Setup Wizard, with a simplified interface that hides the action bar
  * and menus.
+ *
+ * Migrating from Wi-Fi SettingsLib to to WifiTrackerLib, this object will be removed in the near
+ * future, please develop in {@link WifiSettings2}.
  */
 @SearchIndexable
 public class WifiSettings extends RestrictedSettingsFragment

src/com/android/settings/wifi/details/AddDevicePreferenceController.java

@@ -25,11 +25,14 @@ import androidx.preference.Preference;
 
 import com.android.settings.core.BasePreferenceController;
 import com.android.settings.wifi.dpp.WifiDppUtils;
-
 import com.android.settingslib.wifi.AccessPoint;
 
 /**
- * {@link BasePreferenceController} that launches Wi-Fi Easy Connect configurator flow
+ * {@link BasePreferenceController} that launches Wi-Fi Easy Connect configurator flow.
+ *
+ * Migrating from Wi-Fi SettingsLib to to WifiTrackerLib, this object will be removed in the near
+ * future, please develop in
+ * {@link com.android.settings.wifi.details2.AddDevicePreferenceController2}.
  */
 public class AddDevicePreferenceController extends BasePreferenceController {
 

src/com/android/settings/wifi/details/WifiDetailPreferenceController.java

@@ -99,6 +99,10 @@ import java.util.stream.Collectors;
 /**
  * Controller for logic pertaining to displaying Wifi information for the
  * {@link WifiNetworkDetailsFragment}.
+ *
+ * Migrating from Wi-Fi SettingsLib to to WifiTrackerLib, this object will be removed in the near
+ * future, please develop in
+ * {@link com.android.settings.wifi.details2.WifiDetailPreferenceController2}.
  */
 public class WifiDetailPreferenceController extends AbstractPreferenceController
         implements PreferenceControllerMixin, WifiDialogListener, LifecycleObserver, OnPause,

src/com/android/settings/wifi/details/WifiMeteredPreferenceController.java

@@ -31,7 +31,11 @@ import com.android.settings.wifi.WifiDialog;
 import com.android.settingslib.core.AbstractPreferenceController;
 
 /**
- * {@link AbstractPreferenceController} that controls whether the wifi network is metered or not
+ * {@link AbstractPreferenceController} that controls whether the wifi network is metered or not.
+ *
+ * Migrating from Wi-Fi SettingsLib to to WifiTrackerLib, this object will be removed in the near
+ * future, please develop in
+ * {@link com.android.settings.wifi.details2.WifiMeteredPreferenceControlle2}.
  */
 public class WifiMeteredPreferenceController extends BasePreferenceController implements
         Preference.OnPreferenceChangeListener, WifiDialog.WifiDialogListener {

src/com/android/settings/wifi/details/WifiNetworkDetailsFragment.java

@@ -46,6 +46,10 @@ import java.util.List;
  *
  * <p>The AccessPoint should be saved to the intent Extras when launching this class via
  * {@link AccessPoint#saveWifiState(Bundle)} in order to properly render this page.
+ *
+ * Migrating from Wi-Fi SettingsLib to to WifiTrackerLib, this object will be removed in the near
+ * future, please develop in
+ * {@link com.android.settings.wifi.details2.WifiNetworkDetailsFragment2}.
  */
 public class WifiNetworkDetailsFragment extends DashboardFragment implements
         WifiDialog.WifiDialogListener {

src/com/android/settings/wifi/details/WifiPrivacyPreferenceController.java

@@ -33,7 +33,11 @@ import com.android.settingslib.core.AbstractPreferenceController;
 
 /**
  * {@link AbstractPreferenceController} that controls whether the wifi network is mac randomized
- * or not
+ * or not.
+ *
+ * Migrating from Wi-Fi SettingsLib to to WifiTrackerLib, this object will be removed in the near
+ * future, please develop in
+ * {@link com.android.settings.wifi.details2.WifiPrivacyPreferenceController2}.
  */
 public class WifiPrivacyPreferenceController extends BasePreferenceController implements
         Preference.OnPreferenceChangeListener, WifiDialog.WifiDialogListener {

src/com/android/settings/wifi/savedaccesspoints/SavedAccessPointsPreferenceController.java

@@ -35,6 +35,10 @@ import java.util.stream.Collectors;
 
 /**
  * Controller that manages a PreferenceGroup, which contains a list of saved access points.
+ *
+ * Migrating from Wi-Fi SettingsLib to to WifiTrackerLib, this object will be removed in the near
+ * future, please develop in
+ * {@link com.android.settings.wifi.savedaccesspoints2.SavedAccessPointsPreferenceController2}.
  */
 public class SavedAccessPointsPreferenceController extends BasePreferenceController implements
         Preference.OnPreferenceClickListener {

src/com/android/settings/wifi/savedaccesspoints/SavedAccessPointsWifiSettings.java

@@ -34,6 +34,10 @@ import com.android.settingslib.wifi.AccessPointPreference;
 
 /**
  * UI to manage saved networks/access points.
+ *
+ * Migrating from Wi-Fi SettingsLib to to WifiTrackerLib, this object will be removed in the near
+ * future, please develop in
+ * {@link com.android.settings.wifi.savedaccesspoints2.SavedAccessPointsWifiSettings2}.
  */
 public class SavedAccessPointsWifiSettings extends DashboardFragment {
 

src/com/android/settings/wifi/savedaccesspoints/SubscribedAccessPointsPreferenceController.java

@@ -24,6 +24,10 @@ import java.util.stream.Collectors;
 
 /**
  * Controller that manages a PreferenceGroup, which contains a list of subscribed access points.
+ *
+ * Migrating from Wi-Fi SettingsLib to to WifiTrackerLib, this object will be removed in the near
+ * future, please develop in
+ * {@link com.android.settings.wifi.savedaccesspoints2.SubscribedAccessPointsPreferenceController2}.
  */
 public class SubscribedAccessPointsPreferenceController extends
         SavedAccessPointsPreferenceController {