/* * Copyright (C) 2020 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package com.android.settings.development; import android.app.Activity; import android.app.Dialog; import android.app.settings.SettingsEnums; import android.content.BroadcastReceiver; import android.content.Context; import android.content.Intent; import android.content.IntentFilter; import android.debug.AdbManager; import android.debug.IAdbManager; import android.debug.PairDevice; import android.os.Build; import android.os.Bundle; import android.os.RemoteException; import android.os.ServiceManager; import android.provider.Settings; import android.util.Log; import androidx.preference.Preference; import androidx.preference.PreferenceCategory; import com.android.settings.R; import com.android.settings.SettingsActivity; import com.android.settings.core.SubSettingLauncher; import com.android.settings.dashboard.DashboardFragment; import com.android.settings.search.BaseSearchIndexProvider; import com.android.settings.widget.SwitchBarController; import com.android.settingslib.core.AbstractPreferenceController; import com.android.settingslib.core.lifecycle.Lifecycle; import com.android.settingslib.development.DevelopmentSettingsEnabler; import com.android.settingslib.search.SearchIndexable; import com.android.settingslib.widget.FooterPreference; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; /** * Fragment shown when clicking in the "Wireless Debugging" preference in * the developer options. */ @SearchIndexable public class WirelessDebuggingFragment extends DashboardFragment implements WirelessDebuggingEnabler.OnEnabledListener { private static final String TAG = "WirelessDebuggingFrag"; // Activity result from clicking on a paired device. static final int PAIRED_DEVICE_REQUEST = 0; static final String PAIRED_DEVICE_REQUEST_TYPE = "request_type"; static final int FORGET_ACTION = 0; // Activity result from pairing a device. static final int PAIRING_DEVICE_REQUEST = 1; static final String PAIRING_DEVICE_REQUEST_TYPE = "request_type_pairing"; static final int SUCCESS_ACTION = 0; static final int FAIL_ACTION = 1; static final String PAIRED_DEVICE_EXTRA = "paired_device"; static final String DEVICE_NAME_EXTRA = "device_name"; static final String IP_ADDR_EXTRA = "ip_addr"; // UI components private static final String PREF_KEY_ADB_DEVICE_NAME = "adb_device_name_pref"; private static final String PREF_KEY_ADB_IP_ADDR = "adb_ip_addr_pref"; private static final String PREF_KEY_PAIRING_METHODS_CATEGORY = "adb_pairing_methods_category"; private static final String PREF_KEY_ADB_CODE_PAIRING = "adb_pair_method_code_pref"; private static final String PREF_KEY_PAIRED_DEVICES_CATEGORY = "adb_paired_devices_category"; private static final String PREF_KEY_FOOTER_CATEGORY = "adb_wireless_footer_category"; private static AdbIpAddressPreferenceController sAdbIpAddressPreferenceController; private final PairingCodeDialogListener mPairingCodeDialogListener = new PairingCodeDialogListener(); private WirelessDebuggingEnabler mWifiDebuggingEnabler; private Preference mDeviceNamePreference; private Preference mIpAddrPreference; private PreferenceCategory mPairingMethodsCategory; private Preference mCodePairingPreference; private PreferenceCategory mPairedDevicesCategory; private PreferenceCategory mFooterCategory; private FooterPreference mOffMessagePreference; // Map of paired devices, with the device GUID is the key private Map mPairedDevicePreferences; private IAdbManager mAdbManager; private int mConnectionPort; private IntentFilter mIntentFilter; private AdbWirelessDialog mPairingCodeDialog; private final BroadcastReceiver mReceiver = new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { String action = intent.getAction(); if (AdbManager.WIRELESS_DEBUG_PAIRED_DEVICES_ACTION.equals(action)) { Map newPairedDevicesList = (HashMap) intent.getSerializableExtra( AdbManager.WIRELESS_DEVICES_EXTRA); updatePairedDevicePreferences(newPairedDevicesList); } else if (AdbManager.WIRELESS_DEBUG_STATE_CHANGED_ACTION.equals(action)) { int status = intent.getIntExtra(AdbManager.WIRELESS_STATUS_EXTRA, AdbManager.WIRELESS_STATUS_DISCONNECTED); if (status == AdbManager.WIRELESS_STATUS_CONNECTED || status == AdbManager.WIRELESS_STATUS_DISCONNECTED) { sAdbIpAddressPreferenceController.updateState(mIpAddrPreference); } } else if (AdbManager.WIRELESS_DEBUG_PAIRING_RESULT_ACTION.equals(action)) { Integer res = intent.getIntExtra( AdbManager.WIRELESS_STATUS_EXTRA, AdbManager.WIRELESS_STATUS_FAIL); if (res.equals(AdbManager.WIRELESS_STATUS_PAIRING_CODE)) { String pairingCode = intent.getStringExtra( AdbManager.WIRELESS_PAIRING_CODE_EXTRA); if (mPairingCodeDialog != null) { mPairingCodeDialog.getController().setPairingCode(pairingCode); } } else if (res.equals(AdbManager.WIRELESS_STATUS_SUCCESS)) { removeDialog(AdbWirelessDialogUiBase.MODE_PAIRING); mPairingCodeDialog = null; } else if (res.equals(AdbManager.WIRELESS_STATUS_FAIL)) { removeDialog(AdbWirelessDialogUiBase.MODE_PAIRING); mPairingCodeDialog = null; showDialog(AdbWirelessDialogUiBase.MODE_PAIRING_FAILED); } else if (res.equals(AdbManager.WIRELESS_STATUS_CONNECTED)) { int port = intent.getIntExtra(AdbManager.WIRELESS_DEBUG_PORT_EXTRA, 0); Log.i(TAG, "Got pairing code port=" + port); String ipAddr = sAdbIpAddressPreferenceController.getIpv4Address() + ":" + port; if (mPairingCodeDialog != null) { mPairingCodeDialog.getController().setIpAddr(ipAddr); } } } } }; class PairingCodeDialogListener implements AdbWirelessDialog.AdbWirelessDialogListener { @Override public void onDismiss() { Log.i(TAG, "onDismiss"); mPairingCodeDialog = null; try { mAdbManager.disablePairing(); } catch (RemoteException e) { Log.e(TAG, "Unable to cancel pairing"); } } } @Override public void onAttach(Context context) { super.onAttach(context); use(AdbQrCodePreferenceController.class).setParentFragment(this); } @Override public void onActivityCreated(Bundle savedInstanceState) { super.onActivityCreated(savedInstanceState); final SettingsActivity activity = (SettingsActivity) getActivity(); mWifiDebuggingEnabler = new WirelessDebuggingEnabler(activity, new SwitchBarController(activity.getSwitchBar()), this, getSettingsLifecycle()); } @Override public void onCreate(Bundle icicle) { super.onCreate(icicle); addPreferences(); mIntentFilter = new IntentFilter(AdbManager.WIRELESS_DEBUG_PAIRED_DEVICES_ACTION); mIntentFilter.addAction(AdbManager.WIRELESS_DEBUG_STATE_CHANGED_ACTION); mIntentFilter.addAction(AdbManager.WIRELESS_DEBUG_PAIRING_RESULT_ACTION); } private void addPreferences() { mDeviceNamePreference = (Preference) findPreference(PREF_KEY_ADB_DEVICE_NAME); mIpAddrPreference = (Preference) findPreference(PREF_KEY_ADB_IP_ADDR); mPairingMethodsCategory = (PreferenceCategory) findPreference(PREF_KEY_PAIRING_METHODS_CATEGORY); mCodePairingPreference = (Preference) findPreference(PREF_KEY_ADB_CODE_PAIRING); mCodePairingPreference.setOnPreferenceClickListener(preference -> { showDialog(AdbWirelessDialogUiBase.MODE_PAIRING); return true; }); mPairedDevicesCategory = (PreferenceCategory) findPreference(PREF_KEY_PAIRED_DEVICES_CATEGORY); mFooterCategory = (PreferenceCategory) findPreference(PREF_KEY_FOOTER_CATEGORY); mOffMessagePreference = new FooterPreference(mFooterCategory.getContext()); final CharSequence title = getText(R.string.adb_wireless_list_empty_off); mOffMessagePreference.setTitle(title); mFooterCategory.addPreference(mOffMessagePreference); } @Override public void onDestroyView() { super.onDestroyView(); mWifiDebuggingEnabler.teardownSwitchController(); } @Override public void onResume() { super.onResume(); getActivity().registerReceiver(mReceiver, mIntentFilter); } @Override public void onPause() { super.onPause(); removeDialog(AdbWirelessDialogUiBase.MODE_PAIRING); getActivity().unregisterReceiver(mReceiver); } @Override public void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode, resultCode, data); if (requestCode == PAIRED_DEVICE_REQUEST) { handlePairedDeviceRequest(resultCode, data); } else if (requestCode == PAIRING_DEVICE_REQUEST) { handlePairingDeviceRequest(resultCode, data); } } @Override public int getMetricsCategory() { return SettingsEnums.SETTINGS_ADB_WIRELESS; } @Override public int getDialogMetricsCategory(int dialogId) { return SettingsEnums.ADB_WIRELESS_DEVICE_PAIRING_DIALOG; } @Override public Dialog onCreateDialog(int dialogId) { Dialog d = AdbWirelessDialog.createModal(getActivity(), dialogId == AdbWirelessDialogUiBase.MODE_PAIRING ? mPairingCodeDialogListener : null, dialogId); if (dialogId == AdbWirelessDialogUiBase.MODE_PAIRING) { mPairingCodeDialog = (AdbWirelessDialog) d; try { mAdbManager.enablePairingByPairingCode(); } catch (RemoteException e) { Log.e(TAG, "Unable to enable pairing"); mPairingCodeDialog = null; d = AdbWirelessDialog.createModal(getActivity(), null, AdbWirelessDialogUiBase.MODE_PAIRING_FAILED); } } if (d != null) { return d; } return super.onCreateDialog(dialogId); } @Override protected int getPreferenceScreenResId() { return R.xml.adb_wireless_settings; } @Override protected List createPreferenceControllers(Context context) { return buildPreferenceControllers(context, getActivity(), this /* fragment */, getSettingsLifecycle()); } private static List buildPreferenceControllers( Context context, Activity activity, WirelessDebuggingFragment fragment, Lifecycle lifecycle) { final List controllers = new ArrayList<>(); sAdbIpAddressPreferenceController = new AdbIpAddressPreferenceController(context, lifecycle); controllers.add(sAdbIpAddressPreferenceController); return controllers; } @Override protected String getLogTag() { return TAG; } @Override public void onEnabled(boolean enabled) { if (enabled) { showDebuggingPreferences(); mAdbManager = IAdbManager.Stub.asInterface(ServiceManager.getService( Context.ADB_SERVICE)); try { Map newList = mAdbManager.getPairedDevices(); updatePairedDevicePreferences(newList); mConnectionPort = mAdbManager.getAdbWirelessPort(); if (mConnectionPort > 0) { Log.i(TAG, "onEnabled(): connect_port=" + mConnectionPort); } } catch (RemoteException e) { Log.e(TAG, "Unable to request the paired list for Adb wireless"); } sAdbIpAddressPreferenceController.updateState(mIpAddrPreference); } else { showOffMessage(); } } private void showOffMessage() { mDeviceNamePreference.setVisible(false); mIpAddrPreference.setVisible(false); mPairingMethodsCategory.setVisible(false); mPairedDevicesCategory.setVisible(false); mFooterCategory.setVisible(true); } private void showDebuggingPreferences() { mDeviceNamePreference.setVisible(true); mIpAddrPreference.setVisible(true); mPairingMethodsCategory.setVisible(true); mPairedDevicesCategory.setVisible(true); mFooterCategory.setVisible(false); } private void updatePairedDevicePreferences(Map newList) { // TODO(joshuaduong): Move the non-UI stuff into another thread // as the processing could take some time. if (newList == null) { mPairedDevicesCategory.removeAll(); return; } if (mPairedDevicePreferences == null) { mPairedDevicePreferences = new HashMap(); } if (mPairedDevicePreferences.isEmpty()) { for (Map.Entry entry : newList.entrySet()) { AdbPairedDevicePreference p = new AdbPairedDevicePreference(entry.getValue(), mPairedDevicesCategory.getContext()); mPairedDevicePreferences.put( entry.getKey(), p); p.setOnPreferenceClickListener(preference -> { AdbPairedDevicePreference pref = (AdbPairedDevicePreference) preference; launchPairedDeviceDetailsFragment(pref); return true; }); mPairedDevicesCategory.addPreference(p); } } else { // Remove any devices no longer on the newList mPairedDevicePreferences.entrySet().removeIf(entry -> { if (newList.get(entry.getKey()) == null) { mPairedDevicesCategory.removePreference(entry.getValue()); return true; } else { // It is in the newList. Just update the PairDevice value AdbPairedDevicePreference p = entry.getValue(); p.setPairedDevice(newList.get(entry.getKey())); p.refresh(); return false; } }); // Add new devices if any. for (Map.Entry entry : newList.entrySet()) { if (mPairedDevicePreferences.get(entry.getKey()) == null) { AdbPairedDevicePreference p = new AdbPairedDevicePreference(entry.getValue(), mPairedDevicesCategory.getContext()); mPairedDevicePreferences.put( entry.getKey(), p); p.setOnPreferenceClickListener(preference -> { AdbPairedDevicePreference pref = (AdbPairedDevicePreference) preference; launchPairedDeviceDetailsFragment(pref); return true; }); mPairedDevicesCategory.addPreference(p); } } } } private void launchPairedDeviceDetailsFragment(AdbPairedDevicePreference p) { // For sending to the device details fragment. p.savePairedDeviceToExtras(p.getExtras()); new SubSettingLauncher(getContext()) .setTitleRes(R.string.adb_wireless_device_details_title) .setDestination(AdbDeviceDetailsFragment.class.getName()) .setArguments(p.getExtras()) .setSourceMetricsCategory(getMetricsCategory()) .setResultListener(this, PAIRED_DEVICE_REQUEST) .launch(); } void handlePairedDeviceRequest(int result, Intent data) { if (result != Activity.RESULT_OK) { return; } Log.i(TAG, "Processing paired device request"); int requestType = data.getIntExtra(PAIRED_DEVICE_REQUEST_TYPE, -1); PairDevice p; switch (requestType) { case FORGET_ACTION: try { p = (PairDevice) data.getParcelableExtra(PAIRED_DEVICE_EXTRA); mAdbManager.unpairDevice(p.getGuid()); } catch (RemoteException e) { Log.e(TAG, "Unable to forget the device"); } break; default: break; } } void handlePairingDeviceRequest(int result, Intent data) { if (result != Activity.RESULT_OK) { return; } int requestType = data.getIntExtra(PAIRING_DEVICE_REQUEST_TYPE, -1); switch (requestType) { case FAIL_ACTION: showDialog(AdbWirelessDialogUiBase.MODE_PAIRING_FAILED); break; default: Log.d(TAG, "Successfully paired device"); break; } } private String getDeviceName() { // Keep device name in sync with Settings > About phone > Device name String deviceName = Settings.Global.getString(getContext().getContentResolver(), Settings.Global.DEVICE_NAME); if (deviceName == null) { deviceName = Build.MODEL; } return deviceName; } public static final BaseSearchIndexProvider SEARCH_INDEX_DATA_PROVIDER = new BaseSearchIndexProvider(R.xml.adb_wireless_settings) { @Override protected boolean isPageSearchEnabled(Context context) { return DevelopmentSettingsEnabler.isDevelopmentSettingsEnabled(context); } }; }