WifiSettings.java revision c2d8110a86bffc9b9f3bdd1bb60074abcd82c890 
1/*
2 * Copyright (C) 2010 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 *      http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17package com.android.settings.wifi;
18
19import android.app.Activity;
20import android.app.Dialog;
21import android.app.admin.DevicePolicyManager;
22import android.content.BroadcastReceiver;
23import android.content.ComponentName;
24import android.content.ContentResolver;
25import android.content.Context;
26import android.content.Intent;
27import android.content.IntentFilter;
28import android.content.pm.PackageManager;
29import android.content.pm.PackageManager.NameNotFoundException;
30import android.content.res.Resources;
31import android.net.ConnectivityManager;
32import android.net.NetworkInfo;
33import android.net.NetworkInfo.State;
34import android.net.wifi.WifiConfiguration;
35import android.net.wifi.WifiManager;
36import android.net.wifi.WpsInfo;
37import android.nfc.NfcAdapter;
38import android.os.Bundle;
39import android.os.HandlerThread;
40import android.os.Process;
41import android.provider.Settings;
42import android.support.v7.preference.Preference;
43import android.support.v7.preference.PreferenceManager;
44import android.support.v7.preference.PreferenceViewHolder;
45import android.text.Spannable;
46import android.text.TextUtils;
47import android.text.style.TextAppearanceSpan;
48import android.util.Log;
49import android.view.ContextMenu;
50import android.view.ContextMenu.ContextMenuInfo;
51import android.view.Menu;
52import android.view.MenuInflater;
53import android.view.MenuItem;
54import android.view.View;
55import android.widget.ProgressBar;
56import android.widget.TextView;
57import android.widget.TextView.BufferType;
58import android.widget.Toast;
59import com.android.internal.logging.MetricsLogger;
60import com.android.internal.logging.MetricsProto.MetricsEvent;
61import com.android.settings.LinkifyUtils;
62import com.android.settings.R;
63import com.android.settings.RestrictedSettingsFragment;
64import com.android.settings.SettingsActivity;
65import com.android.settings.dashboard.SummaryLoader;
66import com.android.settings.location.ScanningSettings;
67import com.android.settings.search.BaseSearchIndexProvider;
68import com.android.settings.search.Indexable;
69import com.android.settings.search.SearchIndexableRaw;
70import com.android.settingslib.RestrictedLockUtils;
71import com.android.settingslib.wifi.AccessPoint;
72import com.android.settingslib.wifi.AccessPoint.AccessPointListener;
73import com.android.settingslib.wifi.AccessPointPreference;
74import com.android.settingslib.wifi.WifiStatusTracker;
75import com.android.settingslib.wifi.WifiTracker;
76
77import java.util.ArrayList;
78import java.util.Collection;
79import java.util.List;
80
81import static android.os.UserManager.DISALLOW_CONFIG_WIFI;
82
83/**
84 * Two types of UI are provided here.
85 *
86 * The first is for "usual Settings", appearing as any other Setup fragment.
87 *
88 * The second is for Setup Wizard, with a simplified interface that hides the action bar
89 * and menus.
90 */
91public class WifiSettings extends RestrictedSettingsFragment
92        implements Indexable, WifiTracker.WifiListener, AccessPointListener,
93        WifiDialog.WifiDialogListener {
94
95    private static final String TAG = "WifiSettings";
96
97    /* package */ static final int MENU_ID_WPS_PBC = Menu.FIRST;
98    private static final int MENU_ID_WPS_PIN = Menu.FIRST + 1;
99    private static final int MENU_ID_ADVANCED = Menu.FIRST + 4;
100    private static final int MENU_ID_SCAN = Menu.FIRST + 5;
101    private static final int MENU_ID_CONNECT = Menu.FIRST + 6;
102    private static final int MENU_ID_FORGET = Menu.FIRST + 7;
103    private static final int MENU_ID_MODIFY = Menu.FIRST + 8;
104    private static final int MENU_ID_WRITE_NFC = Menu.FIRST + 9;
105    private static final int MENU_ID_CONFIGURE = Menu.FIRST + 10;
106
107    public static final int WIFI_DIALOG_ID = 1;
108    /* package */ static final int WPS_PBC_DIALOG_ID = 2;
109    private static final int WPS_PIN_DIALOG_ID = 3;
110    private static final int WRITE_NFC_DIALOG_ID = 6;
111
112    // Instance state keys
113    private static final String SAVE_DIALOG_MODE = "dialog_mode";
114    private static final String SAVE_DIALOG_ACCESS_POINT_STATE = "wifi_ap_state";
115    private static final String SAVED_WIFI_NFC_DIALOG_STATE = "wifi_nfc_dlg_state";
116
117    protected WifiManager mWifiManager;
118    private WifiManager.ActionListener mConnectListener;
119    private WifiManager.ActionListener mSaveListener;
120    private WifiManager.ActionListener mForgetListener;
121
122    private WifiEnabler mWifiEnabler;
123    // An access point being editted is stored here.
124    private AccessPoint mSelectedAccessPoint;
125
126    private WifiDialog mDialog;
127    private WriteWifiConfigToNfcDialog mWifiToNfcDialog;
128
129    private ProgressBar mProgressHeader;
130
131    // this boolean extra specifies whether to disable the Next button when not connected. Used by
132    // account creation outside of setup wizard.
133    private static final String EXTRA_ENABLE_NEXT_ON_CONNECT = "wifi_enable_next_on_connect";
134    // This string extra specifies a network to open the connect dialog on, so the user can enter
135    // network credentials.  This is used by quick settings for secured networks.
136    private static final String EXTRA_START_CONNECT_SSID = "wifi_start_connect_ssid";
137
138    // should Next button only be enabled when we have a connection?
139    private boolean mEnableNextOnConnection;
140
141    // Save the dialog details
142    private int mDialogMode;
143    private AccessPoint mDlgAccessPoint;
144    private Bundle mAccessPointSavedState;
145    private Bundle mWifiNfcDialogSavedState;
146
147    private WifiTracker mWifiTracker;
148    private String mOpenSsid;
149
150    private HandlerThread mBgThread;
151
152    private AccessPointPreference.UserBadgeCache mUserBadgeCache;
153    private Preference mAddPreference;
154
155    private MenuItem mScanMenuItem;
156
157    /* End of "used in Wifi Setup context" */
158
159    public WifiSettings() {
160        super(DISALLOW_CONFIG_WIFI);
161    }
162
163    @Override
164    public void onViewCreated(View view, Bundle savedInstanceState) {
165        super.onViewCreated(view, savedInstanceState);
166        final Activity activity = getActivity();
167        if (activity != null) {
168            mProgressHeader = (ProgressBar) setPinnedHeaderView(R.layout.wifi_progress_header);
169        }
170    }
171
172    @Override
173    public void onCreate(Bundle icicle) {
174        super.onCreate(icicle);
175        getPreferenceManager().setPreferenceComparisonCallback(
176                new PreferenceManager.SimplePreferenceComparisonCallback());
177        addPreferencesFromResource(R.xml.wifi_settings);
178        mAddPreference = new Preference(getContext());
179        mAddPreference.setIcon(R.drawable.ic_menu_add_inset);
180        mAddPreference.setTitle(R.string.wifi_add_network);
181
182        mUserBadgeCache = new AccessPointPreference.UserBadgeCache(getPackageManager());
183
184        mBgThread = new HandlerThread(TAG, Process.THREAD_PRIORITY_BACKGROUND);
185        mBgThread.start();
186    }
187
188    @Override
189    public void onDestroy() {
190        mBgThread.quit();
191        super.onDestroy();
192    }
193
194    @Override
195    public void onActivityCreated(Bundle savedInstanceState) {
196        super.onActivityCreated(savedInstanceState);
197
198        mWifiTracker =
199                new WifiTracker(getActivity(), this, mBgThread.getLooper(), true, true, false);
200        mWifiManager = mWifiTracker.getManager();
201
202        mConnectListener = new WifiManager.ActionListener() {
203                                   @Override
204                                   public void onSuccess() {
205                                   }
206                                   @Override
207                                   public void onFailure(int reason) {
208                                       Activity activity = getActivity();
209                                       if (activity != null) {
210                                           Toast.makeText(activity,
211                                                R.string.wifi_failed_connect_message,
212                                                Toast.LENGTH_SHORT).show();
213                                       }
214                                   }
215                               };
216
217        mSaveListener = new WifiManager.ActionListener() {
218                                @Override
219                                public void onSuccess() {
220                                }
221                                @Override
222                                public void onFailure(int reason) {
223                                    Activity activity = getActivity();
224                                    if (activity != null) {
225                                        Toast.makeText(activity,
226                                            R.string.wifi_failed_save_message,
227                                            Toast.LENGTH_SHORT).show();
228                                    }
229                                }
230                            };
231
232        mForgetListener = new WifiManager.ActionListener() {
233                                   @Override
234                                   public void onSuccess() {
235                                   }
236                                   @Override
237                                   public void onFailure(int reason) {
238                                       Activity activity = getActivity();
239                                       if (activity != null) {
240                                           Toast.makeText(activity,
241                                               R.string.wifi_failed_forget_message,
242                                               Toast.LENGTH_SHORT).show();
243                                       }
244                                   }
245                               };
246
247        if (savedInstanceState != null) {
248            mDialogMode = savedInstanceState.getInt(SAVE_DIALOG_MODE);
249            if (savedInstanceState.containsKey(SAVE_DIALOG_ACCESS_POINT_STATE)) {
250                mAccessPointSavedState =
251                    savedInstanceState.getBundle(SAVE_DIALOG_ACCESS_POINT_STATE);
252            }
253
254            if (savedInstanceState.containsKey(SAVED_WIFI_NFC_DIALOG_STATE)) {
255                mWifiNfcDialogSavedState =
256                    savedInstanceState.getBundle(SAVED_WIFI_NFC_DIALOG_STATE);
257            }
258        }
259
260        // if we're supposed to enable/disable the Next button based on our current connection
261        // state, start it off in the right state
262        Intent intent = getActivity().getIntent();
263        mEnableNextOnConnection = intent.getBooleanExtra(EXTRA_ENABLE_NEXT_ON_CONNECT, false);
264
265        if (mEnableNextOnConnection) {
266            if (hasNextButton()) {
267                final ConnectivityManager connectivity = (ConnectivityManager)
268                        getActivity().getSystemService(Context.CONNECTIVITY_SERVICE);
269                if (connectivity != null) {
270                    NetworkInfo info = connectivity.getNetworkInfo(
271                            ConnectivityManager.TYPE_WIFI);
272                    changeNextButtonState(info.isConnected());
273                }
274            }
275        }
276
277        registerForContextMenu(getListView());
278        setHasOptionsMenu(true);
279
280        if (intent.hasExtra(EXTRA_START_CONNECT_SSID)) {
281            mOpenSsid = intent.getStringExtra(EXTRA_START_CONNECT_SSID);
282            onAccessPointsChanged();
283        }
284    }
285
286    @Override
287    public void onDestroyView() {
288        super.onDestroyView();
289
290        if (mWifiEnabler != null) {
291            mWifiEnabler.teardownSwitchBar();
292        }
293    }
294
295    @Override
296    public void onStart() {
297        super.onStart();
298
299        // On/off switch is hidden for Setup Wizard (returns null)
300        mWifiEnabler = createWifiEnabler();
301    }
302
303    /**
304     * @return new WifiEnabler or null (as overridden by WifiSettingsForSetupWizard)
305     */
306    /* package */ WifiEnabler createWifiEnabler() {
307        final SettingsActivity activity = (SettingsActivity) getActivity();
308        return new WifiEnabler(activity, activity.getSwitchBar());
309    }
310
311    @Override
312    public void onResume() {
313        final Activity activity = getActivity();
314        super.onResume();
315        removePreference("dummy");
316        if (mWifiEnabler != null) {
317            mWifiEnabler.resume(activity);
318        }
319
320        mWifiTracker.startTracking();
321        activity.invalidateOptionsMenu();
322    }
323
324    @Override
325    public void onPause() {
326        super.onPause();
327        if (mWifiEnabler != null) {
328            mWifiEnabler.pause();
329        }
330
331        mWifiTracker.stopTracking();
332    }
333
334    @Override
335    public void onCreateOptionsMenu(Menu menu, MenuInflater inflater) {
336        // If the user is not allowed to configure wifi, do not show the menu.
337        if (isUiRestricted()) return;
338
339        addOptionsMenuItems(menu);
340        super.onCreateOptionsMenu(menu, inflater);
341    }
342
343    /**
344     * @param menu
345     */
346    void addOptionsMenuItems(Menu menu) {
347        final boolean wifiIsEnabled = mWifiTracker.isWifiEnabled();
348        mScanMenuItem = menu.add(Menu.NONE, MENU_ID_SCAN, 0, R.string.menu_stats_refresh);
349        mScanMenuItem.setEnabled(wifiIsEnabled)
350               .setShowAsAction(MenuItem.SHOW_AS_ACTION_NEVER);
351        menu.add(Menu.NONE, MENU_ID_ADVANCED, 0, R.string.wifi_menu_advanced)
352                .setShowAsAction(MenuItem.SHOW_AS_ACTION_NEVER);
353        menu.add(Menu.NONE, MENU_ID_CONFIGURE, 0, R.string.wifi_menu_configure)
354                .setIcon(R.drawable.ic_settings_24dp)
355                .setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
356    }
357
358    @Override
359    protected int getMetricsCategory() {
360        return MetricsEvent.WIFI;
361    }
362
363    @Override
364    public void onSaveInstanceState(Bundle outState) {
365        super.onSaveInstanceState(outState);
366
367        // If the dialog is showing, save its state.
368        if (mDialog != null && mDialog.isShowing()) {
369            outState.putInt(SAVE_DIALOG_MODE, mDialogMode);
370            if (mDlgAccessPoint != null) {
371                mAccessPointSavedState = new Bundle();
372                mDlgAccessPoint.saveWifiState(mAccessPointSavedState);
373                outState.putBundle(SAVE_DIALOG_ACCESS_POINT_STATE, mAccessPointSavedState);
374            }
375        }
376
377        if (mWifiToNfcDialog != null && mWifiToNfcDialog.isShowing()) {
378            Bundle savedState = new Bundle();
379            mWifiToNfcDialog.saveState(savedState);
380            outState.putBundle(SAVED_WIFI_NFC_DIALOG_STATE, savedState);
381        }
382    }
383
384    @Override
385    public boolean onOptionsItemSelected(MenuItem item) {
386        // If the user is not allowed to configure wifi, do not handle menu selections.
387        if (isUiRestricted()) return false;
388
389        switch (item.getItemId()) {
390            case MENU_ID_WPS_PBC:
391                showDialog(WPS_PBC_DIALOG_ID);
392                return true;
393                /*
394            case MENU_ID_P2P:
395                if (getActivity() instanceof SettingsActivity) {
396                    ((SettingsActivity) getActivity()).startPreferencePanel(
397                            WifiP2pSettings.class.getCanonicalName(),
398                            null,
399                            R.string.wifi_p2p_settings_title, null,
400                            this, 0);
401                } else {
402                    startFragment(this, WifiP2pSettings.class.getCanonicalName(),
403                            R.string.wifi_p2p_settings_title, -1, null);
404                }
405                return true;
406                */
407            case MENU_ID_WPS_PIN:
408                showDialog(WPS_PIN_DIALOG_ID);
409                return true;
410            case MENU_ID_SCAN:
411                MetricsLogger.action(getActivity(), MetricsEvent.ACTION_WIFI_FORCE_SCAN);
412                mWifiTracker.forceScan();
413                return true;
414            case MENU_ID_ADVANCED:
415                if (getActivity() instanceof SettingsActivity) {
416                    ((SettingsActivity) getActivity()).startPreferencePanel(
417                            AdvancedWifiSettings.class.getCanonicalName(), null,
418                            R.string.wifi_advanced_titlebar, null, this, 0);
419                } else {
420                    startFragment(this, AdvancedWifiSettings.class.getCanonicalName(),
421                            R.string.wifi_advanced_titlebar, -1 /* Do not request a results */,
422                            null);
423                }
424                return true;
425            case MENU_ID_CONFIGURE:
426                if (getActivity() instanceof SettingsActivity) {
427                    ((SettingsActivity) getActivity()).startPreferencePanel(
428                            ConfigureWifiSettings.class.getCanonicalName(), null,
429                            R.string.wifi_configure_titlebar, null, this, 0);
430                } else {
431                    startFragment(this, ConfigureWifiSettings.class.getCanonicalName(),
432                            R.string.wifi_configure_titlebar, -1 /* Do not request a results */,
433                            null);
434                }
435                return true;
436
437        }
438        return super.onOptionsItemSelected(item);
439    }
440
441    @Override
442    public void onCreateContextMenu(ContextMenu menu, View view, ContextMenuInfo info) {
443            Preference preference = (Preference) view.getTag();
444
445            if (preference instanceof LongPressAccessPointPreference) {
446                mSelectedAccessPoint =
447                        ((LongPressAccessPointPreference) preference).getAccessPoint();
448                menu.setHeaderTitle(mSelectedAccessPoint.getSsid());
449                if (mSelectedAccessPoint.isConnectable()) {
450                    menu.add(Menu.NONE, MENU_ID_CONNECT, 0, R.string.wifi_menu_connect);
451                }
452
453                WifiConfiguration config = mSelectedAccessPoint.getConfig();
454                // Some configs are ineditable
455                if (isEditabilityLockedDown(getActivity(), config)) {
456                    return;
457                }
458
459                if (mSelectedAccessPoint.isSaved() || mSelectedAccessPoint.isEphemeral()) {
460                    // Allow forgetting a network if either the network is saved or ephemerally
461                    // connected. (In the latter case, "forget" blacklists the network so it won't
462                    // be used again, ephemerally).
463                    menu.add(Menu.NONE, MENU_ID_FORGET, 0, R.string.wifi_menu_forget);
464                }
465                if (mSelectedAccessPoint.isSaved()) {
466                    menu.add(Menu.NONE, MENU_ID_MODIFY, 0, R.string.wifi_menu_modify);
467                    NfcAdapter nfcAdapter = NfcAdapter.getDefaultAdapter(getActivity());
468                    if (nfcAdapter != null && nfcAdapter.isEnabled() &&
469                            mSelectedAccessPoint.getSecurity() != AccessPoint.SECURITY_NONE) {
470                        // Only allow writing of NFC tags for password-protected networks.
471                        menu.add(Menu.NONE, MENU_ID_WRITE_NFC, 0, R.string.wifi_menu_write_to_nfc);
472                    }
473                }
474            }
475    }
476
477    @Override
478    public boolean onContextItemSelected(MenuItem item) {
479        if (mSelectedAccessPoint == null) {
480            return super.onContextItemSelected(item);
481        }
482        switch (item.getItemId()) {
483            case MENU_ID_CONNECT: {
484                if (mSelectedAccessPoint.isSaved()) {
485                    connect(mSelectedAccessPoint.getConfig());
486                } else if (mSelectedAccessPoint.getSecurity() == AccessPoint.SECURITY_NONE) {
487                    /** Bypass dialog for unsecured networks */
488                    mSelectedAccessPoint.generateOpenNetworkConfig();
489                    connect(mSelectedAccessPoint.getConfig());
490                } else {
491                    showDialog(mSelectedAccessPoint, WifiConfigUiBase.MODE_CONNECT);
492                }
493                return true;
494            }
495            case MENU_ID_FORGET: {
496                forget();
497                return true;
498            }
499            case MENU_ID_MODIFY: {
500                showDialog(mSelectedAccessPoint, WifiConfigUiBase.MODE_MODIFY);
501                return true;
502            }
503            case MENU_ID_WRITE_NFC:
504                showDialog(WRITE_NFC_DIALOG_ID);
505                return true;
506
507        }
508        return super.onContextItemSelected(item);
509    }
510
511    @Override
512    public boolean onPreferenceTreeClick(Preference preference) {
513        if (preference instanceof LongPressAccessPointPreference) {
514            mSelectedAccessPoint = ((LongPressAccessPointPreference) preference).getAccessPoint();
515            if (mSelectedAccessPoint == null) {
516                return false;
517            }
518            /** Bypass dialog for unsecured, unsaved, and inactive networks */
519            if (mSelectedAccessPoint.getSecurity() == AccessPoint.SECURITY_NONE &&
520                    !mSelectedAccessPoint.isSaved() && !mSelectedAccessPoint.isActive()) {
521                mSelectedAccessPoint.generateOpenNetworkConfig();
522                connect(mSelectedAccessPoint.getConfig());
523            } else if (mSelectedAccessPoint.isSaved()) {
524                showDialog(mSelectedAccessPoint, WifiConfigUiBase.MODE_VIEW);
525            } else {
526                showDialog(mSelectedAccessPoint, WifiConfigUiBase.MODE_CONNECT);
527            }
528        } else if (preference == mAddPreference) {
529            onAddNetworkPressed();
530        } else {
531            return super.onPreferenceTreeClick(preference);
532        }
533        return true;
534    }
535
536    private void showDialog(AccessPoint accessPoint, int dialogMode) {
537        if (accessPoint != null) {
538            WifiConfiguration config = accessPoint.getConfig();
539            if (isEditabilityLockedDown(getActivity(), config) && accessPoint.isActive()) {
540                RestrictedLockUtils.sendShowAdminSupportDetailsIntent(getActivity(),
541                        RestrictedLockUtils.getDeviceOwner(getActivity()));
542                return;
543            }
544        }
545
546        if (mDialog != null) {
547            removeDialog(WIFI_DIALOG_ID);
548            mDialog = null;
549        }
550
551        // Save the access point and edit mode
552        mDlgAccessPoint = accessPoint;
553        mDialogMode = dialogMode;
554
555        showDialog(WIFI_DIALOG_ID);
556    }
557
558    @Override
559    public Dialog onCreateDialog(int dialogId) {
560        switch (dialogId) {
561            case WIFI_DIALOG_ID:
562                AccessPoint ap = mDlgAccessPoint; // For manual launch
563                if (ap == null) { // For re-launch from saved state
564                    if (mAccessPointSavedState != null) {
565                        ap = new AccessPoint(getActivity(), mAccessPointSavedState);
566                        // For repeated orientation changes
567                        mDlgAccessPoint = ap;
568                        // Reset the saved access point data
569                        mAccessPointSavedState = null;
570                    }
571                }
572                // If it's null, fine, it's for Add Network
573                mSelectedAccessPoint = ap;
574                mDialog = new WifiDialog(getActivity(), this, ap, mDialogMode,
575                        /* no hide submit/connect */ false);
576                return mDialog;
577            case WPS_PBC_DIALOG_ID:
578                return new WpsDialog(getActivity(), WpsInfo.PBC);
579            case WPS_PIN_DIALOG_ID:
580                return new WpsDialog(getActivity(), WpsInfo.DISPLAY);
581            case WRITE_NFC_DIALOG_ID:
582                if (mSelectedAccessPoint != null) {
583                    mWifiToNfcDialog = new WriteWifiConfigToNfcDialog(
584                            getActivity(), mSelectedAccessPoint.getConfig().networkId,
585                            mSelectedAccessPoint.getSecurity(),
586                            mWifiManager);
587                } else if (mWifiNfcDialogSavedState != null) {
588                    mWifiToNfcDialog = new WriteWifiConfigToNfcDialog(
589                            getActivity(), mWifiNfcDialogSavedState, mWifiManager);
590                }
591
592                return mWifiToNfcDialog;
593        }
594        return super.onCreateDialog(dialogId);
595    }
596
597    /**
598     * Shows the latest access points available with supplemental information like
599     * the strength of network and the security for it.
600     */
601    @Override
602    public void onAccessPointsChanged() {
603        // Safeguard from some delayed event handling
604        if (getActivity() == null) return;
605        if (isUiRestricted()) {
606            if (!isUiRestrictedByOnlyAdmin()) {
607                addMessagePreference(R.string.wifi_empty_list_user_restricted);
608            }
609            getPreferenceScreen().removeAll();
610            return;
611        }
612        final int wifiState = mWifiManager.getWifiState();
613
614        switch (wifiState) {
615            case WifiManager.WIFI_STATE_ENABLED:
616                // AccessPoints are automatically sorted with TreeSet.
617                final Collection<AccessPoint> accessPoints =
618                        mWifiTracker.getAccessPoints();
619
620                boolean hasAvailableAccessPoints = false;
621                int index = 0;
622                cacheRemoveAllPrefs(getPreferenceScreen());
623                for (AccessPoint accessPoint : accessPoints) {
624                    // Ignore access points that are out of range.
625                    if (accessPoint.getLevel() != -1) {
626                        String key = accessPoint.getBssid();
627                        if (TextUtils.isEmpty(key)) {
628                            key = accessPoint.getSsidStr();
629                        }
630                        hasAvailableAccessPoints = true;
631                        LongPressAccessPointPreference pref = (LongPressAccessPointPreference)
632                                getCachedPreference(key);
633                        if (pref != null) {
634                            pref.setOrder(index++);
635                            continue;
636                        }
637                        LongPressAccessPointPreference
638                                preference = new LongPressAccessPointPreference(accessPoint,
639                                getPrefContext(), mUserBadgeCache, false, this);
640                        preference.setKey(key);
641                        preference.setOrder(index++);
642
643                        if (mOpenSsid != null && mOpenSsid.equals(accessPoint.getSsidStr())
644                                && !accessPoint.isSaved()
645                                && accessPoint.getSecurity() != AccessPoint.SECURITY_NONE) {
646                            onPreferenceTreeClick(preference);
647                            mOpenSsid = null;
648                        }
649                        getPreferenceScreen().addPreference(preference);
650                        accessPoint.setListener(this);
651                    }
652                }
653                removeCachedPrefs(getPreferenceScreen());
654                if (!hasAvailableAccessPoints) {
655                    setProgressBarVisible(true);
656                    Preference pref = new Preference(getContext()) {
657                        @Override
658                        public void onBindViewHolder(PreferenceViewHolder holder) {
659                            super.onBindViewHolder(holder);
660                            // Show a line on each side of add network.
661                            holder.setDividerAllowedBelow(true);
662                        }
663                    };
664                    pref.setSelectable(false);
665                    pref.setSummary(R.string.wifi_empty_list_wifi_on);
666                    pref.setOrder(0);
667                    getPreferenceScreen().addPreference(pref);
668                    mAddPreference.setOrder(1);
669                    getPreferenceScreen().addPreference(mAddPreference);
670                } else {
671                    mAddPreference.setOrder(index++);
672                    getPreferenceScreen().addPreference(mAddPreference);
673                    setProgressBarVisible(false);
674                }
675                if (mScanMenuItem != null) {
676                    mScanMenuItem.setEnabled(true);
677                }
678                break;
679
680            case WifiManager.WIFI_STATE_ENABLING:
681                getPreferenceScreen().removeAll();
682                setProgressBarVisible(true);
683                break;
684
685            case WifiManager.WIFI_STATE_DISABLING:
686                addMessagePreference(R.string.wifi_stopping);
687                setProgressBarVisible(true);
688                break;
689
690            case WifiManager.WIFI_STATE_DISABLED:
691                setOffMessage();
692                setProgressBarVisible(false);
693                if (mScanMenuItem != null) {
694                    mScanMenuItem.setEnabled(false);
695                }
696                break;
697        }
698    }
699
700    private void setOffMessage() {
701        if (isUiRestricted()) {
702            if (!isUiRestrictedByOnlyAdmin()) {
703                addMessagePreference(R.string.wifi_empty_list_user_restricted);
704            }
705            getPreferenceScreen().removeAll();
706            return;
707        }
708
709        TextView emptyTextView = getEmptyTextView();
710        if (emptyTextView == null) {
711            return;
712        }
713
714        final CharSequence briefText = getText(R.string.wifi_empty_list_wifi_off);
715
716        // Don't use WifiManager.isScanAlwaysAvailable() to check the Wi-Fi scanning mode. Instead,
717        // read the system settings directly. Because when the device is in Airplane mode, even if
718        // Wi-Fi scanning mode is on, WifiManager.isScanAlwaysAvailable() still returns "off".
719        final ContentResolver resolver = getActivity().getContentResolver();
720        final boolean wifiScanningMode = Settings.Global.getInt(
721                resolver, Settings.Global.WIFI_SCAN_ALWAYS_AVAILABLE, 0) == 1;
722
723        if (!wifiScanningMode) {
724            // Show only the brief text if the user is not allowed to configure scanning settings,
725            // or the scanning mode has been turned off.
726            emptyTextView.setText(briefText, BufferType.SPANNABLE);
727        } else {
728            // Append the description of scanning settings with link.
729            final StringBuilder contentBuilder = new StringBuilder();
730            contentBuilder.append(briefText);
731            contentBuilder.append("\n\n");
732            contentBuilder.append(getText(R.string.wifi_scan_notify_text));
733            LinkifyUtils.linkify(emptyTextView, contentBuilder, new LinkifyUtils.OnClickListener() {
734                @Override
735                public void onClick() {
736                    final SettingsActivity activity =
737                            (SettingsActivity) WifiSettings.this.getActivity();
738                    activity.startPreferencePanel(ScanningSettings.class.getName(), null,
739                            R.string.location_scanning_screen_title, null, null, 0);
740                }
741            });
742        }
743        // Embolden and enlarge the brief description anyway.
744        Spannable boldSpan = (Spannable) emptyTextView.getText();
745        boldSpan.setSpan(
746                new TextAppearanceSpan(getActivity(), android.R.style.TextAppearance_Medium), 0,
747                briefText.length(), Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);
748        getPreferenceScreen().removeAll();
749    }
750
751    private void addMessagePreference(int messageId) {
752        TextView emptyTextView = getEmptyTextView();
753        if (emptyTextView != null) emptyTextView.setText(messageId);
754        getPreferenceScreen().removeAll();
755    }
756
757    protected void setProgressBarVisible(boolean visible) {
758        if (mProgressHeader != null) {
759            mProgressHeader.setVisibility(visible ? View.VISIBLE : View.GONE);
760        }
761    }
762
763    @Override
764    public void onWifiStateChanged(int state) {
765        switch (state) {
766            case WifiManager.WIFI_STATE_ENABLING:
767                addMessagePreference(R.string.wifi_starting);
768                setProgressBarVisible(true);
769                break;
770
771            case WifiManager.WIFI_STATE_DISABLED:
772                setOffMessage();
773                setProgressBarVisible(false);
774                break;
775        }
776    }
777
778    @Override
779    public void onConnectedChanged() {
780        changeNextButtonState(mWifiTracker.isConnected());
781    }
782
783    /**
784     * Renames/replaces "Next" button when appropriate. "Next" button usually exists in
785     * Wifi setup screens, not in usual wifi settings screen.
786     *
787     * @param enabled true when the device is connected to a wifi network.
788     */
789    private void changeNextButtonState(boolean enabled) {
790        if (mEnableNextOnConnection && hasNextButton()) {
791            getNextButton().setEnabled(enabled);
792        }
793    }
794
795    @Override
796    public void onForget(WifiDialog dialog) {
797        forget();
798    }
799
800    @Override
801    public void onSubmit(WifiDialog dialog) {
802        if (mDialog != null) {
803            submit(mDialog.getController());
804        }
805    }
806
807    /* package */ void submit(WifiConfigController configController) {
808
809        final WifiConfiguration config = configController.getConfig();
810
811        if (config == null) {
812            if (mSelectedAccessPoint != null
813                    && mSelectedAccessPoint.isSaved()) {
814                connect(mSelectedAccessPoint.getConfig());
815            }
816        } else if (configController.getMode() == WifiConfigUiBase.MODE_MODIFY) {
817            mWifiManager.save(config, mSaveListener);
818        } else {
819            mWifiManager.save(config, mSaveListener);
820            if (mSelectedAccessPoint != null) { // Not an "Add network"
821                connect(config);
822            }
823        }
824
825        mWifiTracker.resumeScanning();
826    }
827
828    /* package */ void forget() {
829        MetricsLogger.action(getActivity(), MetricsEvent.ACTION_WIFI_FORGET);
830        if (!mSelectedAccessPoint.isSaved()) {
831            if (mSelectedAccessPoint.getNetworkInfo() != null &&
832                    mSelectedAccessPoint.getNetworkInfo().getState() != State.DISCONNECTED) {
833                // Network is active but has no network ID - must be ephemeral.
834                mWifiManager.disableEphemeralNetwork(
835                        AccessPoint.convertToQuotedString(mSelectedAccessPoint.getSsidStr()));
836            } else {
837                // Should not happen, but a monkey seems to trigger it
838                Log.e(TAG, "Failed to forget invalid network " + mSelectedAccessPoint.getConfig());
839                return;
840            }
841        } else {
842            mWifiManager.forget(mSelectedAccessPoint.getConfig().networkId, mForgetListener);
843        }
844
845        mWifiTracker.resumeScanning();
846
847        // We need to rename/replace "Next" button in wifi setup context.
848        changeNextButtonState(false);
849    }
850
851    protected void connect(final WifiConfiguration config) {
852        MetricsLogger.action(getActivity(), MetricsEvent.ACTION_WIFI_CONNECT);
853        mWifiManager.connect(config, mConnectListener);
854    }
855
856    protected void connect(final int networkId) {
857        MetricsLogger.action(getActivity(), MetricsEvent.ACTION_WIFI_CONNECT);
858        mWifiManager.connect(networkId, mConnectListener);
859    }
860
861    /**
862     * Called when "add network" button is pressed.
863     */
864    /* package */ void onAddNetworkPressed() {
865        MetricsLogger.action(getActivity(), MetricsEvent.ACTION_WIFI_ADD_NETWORK);
866        // No exact access point is selected.
867        mSelectedAccessPoint = null;
868        showDialog(null, WifiConfigUiBase.MODE_CONNECT);
869    }
870
871    @Override
872    protected int getHelpResource() {
873        return R.string.help_url_wifi;
874    }
875
876    @Override
877    public void onAccessPointChanged(AccessPoint accessPoint) {
878        ((LongPressAccessPointPreference) accessPoint.getTag()).refresh();
879    }
880
881    @Override
882    public void onLevelChanged(AccessPoint accessPoint) {
883        ((LongPressAccessPointPreference) accessPoint.getTag()).onLevelChanged();
884    }
885
886    public static final SearchIndexProvider SEARCH_INDEX_DATA_PROVIDER =
887        new BaseSearchIndexProvider() {
888            @Override
889            public List<SearchIndexableRaw> getRawDataToIndex(Context context, boolean enabled) {
890                final List<SearchIndexableRaw> result = new ArrayList<>();
891                final Resources res = context.getResources();
892
893                // Add fragment title
894                SearchIndexableRaw data = new SearchIndexableRaw(context);
895                data.title = res.getString(R.string.wifi_settings);
896                data.screenTitle = res.getString(R.string.wifi_settings);
897                data.keywords = res.getString(R.string.keywords_wifi);
898                result.add(data);
899
900                // Add saved Wi-Fi access points
901                final Collection<AccessPoint> accessPoints =
902                        WifiTracker.getCurrentAccessPoints(context, true, false, false);
903                for (AccessPoint accessPoint : accessPoints) {
904                    data = new SearchIndexableRaw(context);
905                    data.title = accessPoint.getSsidStr();
906                    data.screenTitle = res.getString(R.string.wifi_settings);
907                    data.enabled = enabled;
908                    result.add(data);
909                }
910
911                return result;
912            }
913        };
914
915    /**
916     * Returns true if the config is not editable through Settings.
917     * @param context Context of caller
918     * @param config The WiFi config.
919     * @return true if the config is not editable through Settings.
920     */
921    static boolean isEditabilityLockedDown(Context context, WifiConfiguration config) {
922        return !canModifyNetwork(context, config);
923    }
924
925    /**
926     * This method is a stripped version of WifiConfigStore.canModifyNetwork.
927     * TODO: refactor to have only one method.
928     * @param context Context of caller
929     * @param config The WiFi config.
930     * @return true if Settings can modify the config.
931     */
932    static boolean canModifyNetwork(Context context, WifiConfiguration config) {
933        if (config == null) {
934            return true;
935        }
936
937        final DevicePolicyManager dpm = (DevicePolicyManager) context.getSystemService(
938                Context.DEVICE_POLICY_SERVICE);
939
940        // Check if device has DPM capability. If it has and dpm is still null, then we
941        // treat this case with suspicion and bail out.
942        final PackageManager pm = context.getPackageManager();
943        if (pm.hasSystemFeature(PackageManager.FEATURE_DEVICE_ADMIN) && dpm == null) {
944            return false;
945        }
946
947        boolean isConfigEligibleForLockdown = false;
948        if (dpm != null) {
949            final ComponentName deviceOwner = dpm.getDeviceOwnerComponentOnAnyUser();
950            if (deviceOwner != null) {
951                final int deviceOwnerUserId = dpm.getDeviceOwnerUserId();
952                try {
953                    final int deviceOwnerUid = pm.getPackageUidAsUser(deviceOwner.getPackageName(),
954                            deviceOwnerUserId);
955                    isConfigEligibleForLockdown = deviceOwnerUid == config.creatorUid;
956                } catch (NameNotFoundException e) {
957                    // don't care
958                }
959            }
960        }
961        if (!isConfigEligibleForLockdown) {
962            return true;
963        }
964
965        final ContentResolver resolver = context.getContentResolver();
966        final boolean isLockdownFeatureEnabled = Settings.Global.getInt(resolver,
967                Settings.Global.WIFI_DEVICE_OWNER_CONFIGS_LOCKDOWN, 0) != 0;
968        return !isLockdownFeatureEnabled;
969    }
970
971    private static class SummaryProvider extends BroadcastReceiver
972            implements SummaryLoader.SummaryProvider {
973
974        private final Context mContext;
975        private final WifiManager mWifiManager;
976        private final WifiStatusTracker mWifiTracker;
977        private final SummaryLoader mSummaryLoader;
978
979        public SummaryProvider(Context context, SummaryLoader summaryLoader) {
980            mContext = context;
981            mSummaryLoader = summaryLoader;
982            mWifiManager = context.getSystemService(WifiManager.class);
983            mWifiTracker = new WifiStatusTracker(mWifiManager);
984        }
985
986        private CharSequence getSummary() {
987            if (!mWifiTracker.enabled) {
988                return mContext.getString(R.string.wifi_disabled_generic);
989            }
990            if (!mWifiTracker.connected) {
991                return mContext.getString(R.string.disconnected);
992            }
993            return mWifiTracker.ssid;
994        }
995
996        @Override
997        public void setListening(boolean listening) {
998            if (listening) {
999                IntentFilter filter = new IntentFilter();
1000                filter.addAction(WifiManager.WIFI_STATE_CHANGED_ACTION);
1001                filter.addAction(WifiManager.NETWORK_STATE_CHANGED_ACTION);
1002                filter.addAction(WifiManager.RSSI_CHANGED_ACTION);
1003                mSummaryLoader.registerReceiver(this, filter);
1004            }
1005        }
1006
1007        @Override
1008        public void onReceive(Context context, Intent intent) {
1009            mWifiTracker.handleBroadcast(intent);
1010            mSummaryLoader.setSummary(this, getSummary());
1011        }
1012    }
1013
1014    public static final SummaryLoader.SummaryProviderFactory SUMMARY_PROVIDER_FACTORY
1015            = new SummaryLoader.SummaryProviderFactory() {
1016        @Override
1017        public SummaryLoader.SummaryProvider createSummaryProvider(Activity activity,
1018                                                                   SummaryLoader summaryLoader) {
1019            return new SummaryProvider(activity, summaryLoader);
1020        }
1021    };
1022}
1023