Android14 Settings應用添加有線網開關條目
文章目錄
- Android14 Settings應用添加有線網開關條目
- 一、前言
- 二、適配修改
- 1、network_provider_settings.xml
- 2、NetworkProviderSettings.java
- 3、TurnOnOffEthernetNetworkController.java
- 4、去除有線網提示條目。
- 5、效果UI
- （1）修改前效果
- （2）修改后效果
- 三、其他
- 1、Android Settings應用添加有線網開關條目小結
- （1）主要修改適配的代碼：
- 2、關于不同Android系統版本原生Settings Wifi條目的獲取代碼
- 4、Android13 有線網開關研究
- 5、Android AccessPoint 已連接的wifi信息未顯示處理
一、前言
背景：
Android 原生Settings應用沒有有線網開關條目；
Tv平臺一般是有有線網連接的，如果沒有有線網控制條目是不太方便的；
如果要在原生Settings添加有線網開關和顯示有線網ip，要如何實現呢？
目前主要的商顯TV中，只有我開發的方案中有些原生設置Settings 在某些方案上有修改了原生Settings的添加有線網開關控制，視源、朗國、創維、三星那些都是沒修改的。
本文簡單實現一下，有需要的可以參考修改。
二、適配修改
1、network_provider_settings.xml
在布局文件添加一個有線網開關UI條目控制；
這個布局文件是點擊二級菜單"互聯網"顯示的界面主要包含條目內容：
有線網提示（接入有線網才有），飛行模式提示（開啟飛行模式才有），
Wifi開關、Wifi列表、添加網絡按鍵，網絡偏好設置，已保存的網絡。
Settings\res\xml\network_provider_settings.xml
//原本有的有線網提示<Preferenceandroid:key="connected_ethernet_network"android:title="@string/ethernet"android:summary="@string/to_switch_networks_disconnect_ethernet"android:icon="@drawable/ic_settings_ethernet"/>//新增的有線網開關條目
+ <SwitchPreference
+ android:key="ethernet_turn_off"
+ android:title="@string/ethernet" />//飛行模式提示<PreferenceCategoryandroid:key="provider_model_mobile_network"android:title="@string/summary_placeholder"android:layout="@layout/preference_category_no_label"settings:isPreferenceVisible="@bool/config_show_sim_info"settings:controller="com.android.settings.network.NetworkMobileProviderController"/>//Wifi開關<com.android.settingslib.RestrictedSwitchPreferenceandroid:key="main_toggle_wifi"android:title="@string/wifi"settings:keywords="@string/keywords_wifi"settings:allowDividerAbove="true"/>//已連接的Wifi ？<PreferenceCategoryandroid:key="connected_access_point"android:layout="@layout/preference_category_no_label"/>//保持狀態的Wifi列表 ？<PreferenceCategoryandroid:key="first_access_points"android:layout="@layout/preference_category_no_label"/>//剩余的掃描到的的Wifi列表 ？<PreferenceCategoryandroid:key="access_points"android:layout="@layout/preference_category_no_label"/>//網絡偏好設置<Preferenceandroid:key="configure_network_settings"android:title="@string/network_and_internet_preferences_title"settings:allowDividerAbove="true"android:fragment="com.android.settings.wifi.ConfigureWifiSettings"/>//已保存的網絡<Preferenceandroid:key="saved_networks"android:title="@string/wifi_saved_access_points_label"android:fragment="com.android.settings.wifi.savedaccesspoints2.SavedAccessPointsWifiSettings2"/>res/value 的資源文件：
//英文<string name="to_switch_networks_disconnect_ethernet">To switch networks, disconnect ethernet</string>
//中文<string name="to_switch_networks_disconnect_ethernet" msgid="6615374552827587197">"如要切換網絡，請拔出以太網網線"</string>Android 原生應用沒有有線網開關控制，有線網連接后，
如果正常獲取到有線網ip，是有線使用有線網的，無法正常連接Wifi網絡，
所以會友情提示"如要切換網絡，請拔出有線網".
2、NetworkProviderSettings.java
Wifi開關和Wifi列表顯示都在這個類。
import androidx.preference.PreferenceScreen;
+import androidx.preference.SwitchPreference;/*** UI for Mobile network and Wi-Fi network settings.*/
@SearchIndexable
public class NetworkProviderSettings extends RestrictedSettingsFragment ...{ConnectedEthernetNetworkController mConnectedEthernetNetworkController;+ TurnOnOffEthernetNetworkController mTurnOnOffEthernetNetworkController;private void addPreferences() {
...addConnectedEthernetNetworkController();
+ addTurnOnOffEthernetNetworkController();}//add by liwenzhi ++++ 下面這個方法是添加的//主要就是開關監聽，調用方法private void addTurnOnOffEthernetNetworkController() {if (mTurnOnOffEthernetNetworkController == null) {mTurnOnOffEthernetNetworkController =new TurnOnOffEthernetNetworkController(getContext(), TurnOnOffEthernetNetworkController.KEY);}SwitchPreference switchPreference = (SwitchPreference) findPreference("ethernet_turn_off");mTurnOnOffEthernetNetworkController.updateState(switchPreference);switchPreference.setOnPreferenceChangeListener(new Preference.OnPreferenceChangeListener() {@Overridepublic boolean onPreferenceChange(Preference preference, Object newValue) {boolean isCheck = (boolean) newValue;Log.i(TAG, "onPreferenceChange preference = " + preference + ", isCheck = " + isCheck);mTurnOnOffEthernetNetworkController.onPreferenceChange(preference, newValue);return true;}});}public void onStart() {super.onStart();
+ mTurnOnOffEthernetNetworkController.onStart(); //主要用來廣播監聽 + 更新有線網ip}@Overridepublic void onStop() {
+ mTurnOnOffEthernetNetworkController.onStop(); //停止廣播監聽}}3、TurnOnOffEthernetNetworkController.java
package com.android.settings.network;import static com.android.settings.network.InternetUpdater.INTERNET_ETHERNET;import android.content.Context;
import android.util.Log;
import android.content.BroadcastReceiver;
import android.content.Intent;
import android.content.IntentFilter;
import android.content.ContentResolver;
import android.database.ContentObserver;
import android.net.ConnectivityManager;
import android.net.EthernetManager;
import android.net.LinkAddress;
import android.net.LinkProperties;
import android.net.Network;
import android.net.NetworkInfo;
import android.os.Handler;
import android.provider.Settings;
import android.text.TextUtils;import androidx.preference.Preference;
import androidx.preference.SwitchPreference;import com.android.settings.R;
import com.android.settings.core.BasePreferenceController;import java.net.Inet4Address;
import java.net.InetAddress;
import java.net.NetworkInterface;
import java.net.SocketException;
import java.util.ArrayList;
import java.util.Enumeration;/*** PreferenceController to show the connected ethernet network turn on /off.* 自定義添加的有線網開關*/
public class TurnOnOffEthernetNetworkController extends BasePreferenceController implementsPreference.OnPreferenceChangeListener {private static final String TAG = "TurnOnOffEthernetNetworkController";private static final String NET_CHANGE_ACTION = ConnectivityManager.CONNECTIVITY_ACTION; //所有網絡變化廣播private static final String ETHERNET_STATE_CHANGE = "action.ebsw.eth.status.change"; //底層自定義有線網絡插拔廣播(并非共用的，是底層自己開發的)public static final String KEY = "ethernet_turn_off";private Context mContext;private Preference mPreference;private SettingsValueChangeContentObserver mContentOb; //監聽 Settings ethernet_onpublic TurnOnOffEthernetNetworkController(Context context, String preferenceKey) {super(context, preferenceKey);Log.i(TAG, "TurnOnOffEthernetNetworkController preferenceKey = " + preferenceKey);mContext = context;//注冊監聽Settings.Global.ETHERNET_ON 屬性變化mContentOb = new SettingsValueChangeContentObserver();context.getContentResolver().registerContentObserver(Settings.System.getUriFor("ethernet_on"), true, mContentOb);//注冊監聽}@Overridepublic String getPreferenceKey() {return KEY;}@Overridepublic int getAvailabilityStatus() {return AVAILABLE;}//自定義的，非原生public void updateState(Preference preference) {Log.i(TAG, "updateState preference = " + preference);final boolean settingsOn = isEthernetEnabled(mContext);Log.i(TAG, "updateState settingsOn = " + settingsOn);((SwitchPreference) preference).setChecked(settingsOn);mPreference = preference;//mPreference.setSummary("on/off:" + settingsOn); //testupdateEthernetIp();}//自定義的，非原生public boolean onPreferenceChange(Preference preference, Object newValue) {final boolean settingsOn = (Boolean) newValue;Log.i(TAG, "onPreferenceChange settingsOn = " + settingsOn);return enableEthernet(mContext, settingsOn);}public boolean enableEthernet(Context context, boolean enabled) {Log.i(TAG, "enableEthernet enabled = " + enabled);EthernetManager ethernetManager = (EthernetManager) context.getSystemService(Context.ETHERNET_SERVICE);ethernetManager.setEthernetEnabled(enabled);Settings.Global.putInt(context.getContentResolver(),"ethernet_on", enabled? EthernetManager.ETHERNET_STATE_ENABLED:EthernetManager.ETHERNET_STATE_DISABLED);return true;}public boolean isEthernetEnabled(Context context) {Log.i(TAG, "isEthernetEnabled.");int ethernetSate = 0;final ContentResolver cr = context.getContentResolver();try {ethernetSate = Settings.Global.getInt(cr, "ethernet_on", EthernetManager.ETHERNET_STATE_ENABLED);} catch (Exception e) {ethernetSate = EthernetManager.ETHERNET_STATE_DISABLED;}return ethernetSate == EthernetManager.ETHERNET_STATE_ENABLED;}注意 ：Settings.Global.ETHERNET_ON 屬性在 Android8之后的版本好像就沒有了；
如果需要全局定義可以自己在Settings.java源碼中添加定義；
其實也可以不用定義，直接使用 "etherent_on"字符串就行；也是一樣能監聽變化能記憶能使用；
也可以使用prop屬性記錄有線網開關狀態，不過不方便監聽狀態變化。
4、去除有線網提示條目。
Settings\src\com\android\settings\network\ConnectedEthernetNetworkController.java
@Overridepublic boolean isAvailable() {
- return mInternetType == INTERNET_ETHERNET;
+ //not to show this item ,change by liwenzhi
+ return false;}代碼修改可以動態設置顯示或者隱藏，通過某些狀態或者prop屬性；
如果不想改Java代碼，應該是可以在xml文件中直接去除 key=“connected_ethernet_network” 條目那項。
5、效果UI
（1）修改前效果
未接入有線網的情況的顯示：
這個是最普通的正常情況的顯示。
接入有線網的情況下的顯示：
可以看到這里就提示了讓你拔掉有線網，是不是比較low。
默認情況，wifi和有線網連接是不兼容的，有線網優先級高于wifi，
所以優先連接的是有線網；如果拔出有線網，是會自動連接wifi的；
如果有需求也是可以修改系統源碼，設置有線網和wifi共存，同時連接的。
（2）修改后效果
有線網開關開啟并且接入有線網：
這里查看簡單明了的，顯示了有線網開關和有線網ip地址。
有線網開關關閉：
這里可以看到有線網關閉后，Wif是可以連接的；
如果打開有線網開關，但是未接入有線網插頭，也是能連接wifi的，只是有線網那里并不顯示ip地址。
三、其他
1、Android Settings應用添加有線網開關條目小結
（1）主要修改適配的代碼：
network_provider_settings.xml //有線網開關條目的添加
NetworkProviderSettings.java //有線網開關條目的關聯
TurnOnOffEthernetNetworkController.java //+自定義的有線網控制顯示類
ConnectedEthernetNetworkController.java //有線網默認提示是否顯示
這里是添加有線網開關設置在三級目錄里面，
也可以添加在二級目錄里面，和Wifi、飛行模式、熱點共享同級目錄下；
2、關于不同Android系統版本原生Settings Wifi條目的獲取代碼
查看了Wifi列表獲取的代碼是有較大差異的：
Android9 或者更低的版本使用的是：
List<AccessPoint> accessPoints = mWifiTracker.getAccessPoints();Android11 或者更新的版本獲取Wifi使用的是：
List<WifiEntry> wifiEntries = mWifiPickerTracker.getWifiEntries();因為 AccessPoint 過時了，所以使用的是 WifiEntry；
AccessPoint 是系統SettingsLib包封裝的對象，WifiEntry 是系統framework包的對象；
使用 WifiEntry 對象似乎是為了更容易適配Settings應用的 Preference 布局控件。
無論是AccessPoint還是WifiEntry，都是有暴露 getWifiConfiguration()方法獲取都某個Wifi的配置信息WifiConfiguration對象。
我這里自定義開發的設置應用從Android7開始一直是使用 AccessPoint 那套顯示和連接Wifi，沒啥大問題；
也有一個方案出現過列表不顯示某個已連接的隱藏Wifi的情況，直接修改的SettingsLib源碼解決的。
4、Android13 有線網開關研究
Android13 的api 提供了有線網開關 EthernetManager.setEthernetEnabled(boolean)，
Android9 如果要設置有線網開關，需要自己實現。
https://blog.csdn.net/wenzhi20102321/article/details/131871354
5、Android AccessPoint 已連接的wifi信息未顯示處理
一個wifi列表未顯示已連接的wifi信息問題記錄。
本文最后又原生Settings 的Wifi列表界面顯示分析，有興趣的可以看看。
https://blog.csdn.net/wenzhi20102321/article/details/146536423
