前言: WiFi热点设置页面的安全性选项在Android 4.x上有“无”、“WPA PSK”、“WPA2 PSK”三个选项,在Android 5.0(含)之后去掉了WPA PSK选项(部分手机厂家会修改ROM,有些手机4.4就没有这个选项了,安全性选项下拉选项是在packages/apps/Settings/res/values/arrays.xml这个文件的wifi_ap_security数组中定义的),当安全性为“无”时连接热点不需要密码,其他两种都是要输入密码才能连接的。本文将讲解用代码自动创建、跳转系统热点设置页手动创建两种方式创建热点,以及当targetSdkVersion设为23以上时如何处理权限问题。
热点的安全性选项对应的Java类是在WifiConfiguration.java中定义的(源码路径:/frameworks/base/wifi/java/android/net/wifi/WifiConfiguration.java,API 25,不同的API内容有差异)
1 public static class KeyMgmt {
2 private KeyMgmt() { }
3
4 /** WPA is not used; plaintext or static WEP could be used. */
5 public static final int NONE = 0;
6 /** WPA pre-shared key (requires {@code preSharedKey} to be specified). */
7 public static final int WPA_PSK = 1;
8 /** WPA using EAP authentication. Generally used with an external authentication server. */
9 public static final int WPA_EAP = 2;
10 /** IEEE 802.1X using EAP authentication and (optionally) dynamically
11 * generated WEP keys. */
12 public static final int IEEE8021X = 3;
13
14 /** WPA2 pre-shared key for use with soft access point
15 * (requires {@code preSharedKey} to be specified).
16 * @hide
17 */
18 @SystemApi
19 public static final int WPA2_PSK = 4;
20 /**
21 * Hotspot 2.0 r2 OSEN:
22 * @hide
23 */
24 public static final int OSEN = 5;
25
26 public static final String varName = "key_mgmt";
27
28 public static final String[] strings = { "NONE", "WPA_PSK", "WPA_EAP", "IEEE8021X",
29 "WPA2_PSK", "OSEN" };
30 }
可以看到,无、WPA PSK、WPA2 PSK这三个选项分别对应到KeyMgmt.NONE、KeyMgmt.WPA_PSK、KeyMgmt.WPA2_PSK,最后一个WPA2_PSK添加了@SystemApi标记,我们不可以直接访问的,怎么创建这三种形式的热点呢?
- 编码实现
添加需要的权限
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
Android并没有公开创建WiFi热点的API,所以我们只能通过反射的方式实现,创建安全性为“无”的代码如下:
1 /**
2 * 自定义wifi热点
3 *
4 * @param enabled 开启or关闭
5 * @return
6 */
7 private boolean setWifiApEnabled(boolean enabled) {
8 boolean result = false;
9 WifiManager wifiManager = (WifiManager) getApplicationContext().getSystemService(Context.WIFI_SERVICE);
10 if (enabled) {
11 //wifi和热点不能同时打开,所以打开热点的时候需要关闭wifi
12 if (wifiManager.isWifiEnabled()) {
13 wifiManager.setWifiEnabled(false);
14 }
15 }
16 try {
17 //热点的配置类
18 WifiConfiguration apConfig = new WifiConfiguration();
19 //配置热点的名称
20 apConfig.SSID = "ap_test";
21 //配置热点的密码,至少八位
22 apConfig.preSharedKey = "";
23 //配置热点安全性选项
24 apConfig.allowedKeyManagement.set(WifiConfiguration.KeyMgmt.NONE);
25 //通过反射调用设置热点
26 Method method = wifiManager.getClass().getMethod("setWifiApEnabled", WifiConfiguration.class, boolean.class);
27 //返回热点打开状态
28 result = (Boolean) method.invoke(wifiManager, apConfig, enabled);
29 if (!result) {
30 Toast.makeText(this, "热点创建失败,请手动创建!", Toast.LENGTH_SHORT).show();
31 openAPUI();
32 }
33 } catch (Exception e) {
34 Toast.makeText(this, "热点创建失败,请手动创建!", Toast.LENGTH_SHORT).show();
35 openAPUI();
36 }
37 return result;
38 }
创建安全性为“WPA PSK”的热点需要修改22、24行,需要注意的是:创建热点后,在不支持WPA_PSK的手机上(Android 4.3以上版本)打开系统热点页面,“安全性”将显示为“无”,看不到密码文本框,但是连接此类热点还是需要输入密码的。
1 //配置热点的密码,至少八位
2 apConfig.preSharedKey = "12345678";
3 //配置热点安全性
4 apConfig.allowedKeyManagement.set(WifiConfiguration.KeyMgmt.WPA_PSK);
创建安全性选项为WPA2 PSK只需将上面代码中第4行改为
apConfig.allowedKeyManagement.set(4);
直接将值指定为4,原因上面讲过,这里还有另外一个坑:在MIUI系统上,WPA2 PSK这个值为6,如果在MIUI上运行需要设为6才可以,我们可以判断一下手机ROM的版本,根据不同的ROM设为4或6。(后面有另外一种判断方式)
1 /**
2 * 判断是否为MIUI系统,参考http://blog.csdn.net/xx326664162/article/details/52438706
3 *
4 * @return
5 */
6 public static boolean isMIUI() {
7 try {
8 String KEY_MIUI_VERSION_CODE = "ro.miui.ui.version.code";
9 String KEY_MIUI_VERSION_NAME = "ro.miui.ui.version.name";
10 String KEY_MIUI_INTERNAL_STORAGE = "ro.miui.internal.storage";
11 Properties prop = new Properties();
12 prop.load(new FileInputStream(new File(Environment.getRootDirectory(), "build.prop")));
13
14 return prop.getProperty(KEY_MIUI_VERSION_CODE, null) != null
15 || prop.getProperty(KEY_MIUI_VERSION_NAME, null) != null
16 || prop.getProperty(KEY_MIUI_INTERNAL_STORAGE, null) != null;
17 } catch (IOException e) {
18 return false;
19 }
20 }
apConfig.allowedKeyManagement.set(isMIUI() ? 6 : 4);
至于MIUI为什么设为6就无从得知了,我尝试在MIUI论坛发帖询问原因,帖子一直没有审核通过,由此可见使用系统非公开API是有一定风险的。
20170914更新
经过研究,可以从WifiConfiguration.KeyMgmt.strings这个数组中读取所有的安全性选项(MIUI的安全性选项为NONE, WPA_PSK, WPA_EAP, IEEE8021X, WAPI_PSK, WAPI_CERT, WPA2_PSK, OSEN,多了WAPI_PSK, WAPI_CERT这两个),我们只要从中找到WPA2_PSK的索引值就可以了,不需要根据ROM类型判断,所以上述代码可以修改为
1 int indexOfWPA2_PSK = 4;
2 //从WifiConfiguration.KeyMgmt数组中查找WPA2_PSK的值
3 for (int i = 0; i < WifiConfiguration.KeyMgmt.strings.length; i++) {
4 if (WifiConfiguration.KeyMgmt.strings[i].equals("WPA2_PSK")) {
5 indexOfWPA2_PSK = i;
6 break;
7 }
8 }
9 apConfig.allowedKeyManagement.set(indexOfWPA2_PSK);
如果自动创建热点失败,我们也可以跳转系统设置页让用户手动创建。 Android同样没有提供跳转热点设置页面的Intent,我们可以打开热点设置页面后,通过使用adb shell actives去查找相应的APP包名、类,打开系统热点设置页的代码如下:
/**
* 打开网络共享与热点设置页面
*/
private void openAPUI() {
Intent intent = new Intent();
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
//打开网络共享与热点设置页面
ComponentName comp = new ComponentName("com.android.settings", "com.android.settings.Settings$TetherSettingsActivity");
intent.setComponent(comp);
startActivity(intent);
}
- 读取热点配置信息
直接贴代码吧,判断热点是否打开可以参考源码中的isWifiApEnabled()方法
1 /**
2 * 读取热点配置信息
3 */
4 private void getWiFiAPConfig() {
5 try {
6 WifiManager wifiManager = (WifiManager) getApplicationContext().getSystemService(Context.WIFI_SERVICE);
7 Method method = wifiManager.getClass().getMethod("getWifiApConfiguration");
8 WifiConfiguration apConfig = (WifiConfiguration) method.invoke(wifiManager);
9 if (apConfig == null) {
10 tvInfo.setText("未配置热点");
11 return;
12 }
13 tvInfo.setText(String.format("热点名称:%s\r\n", apConfig.SSID));
14 tvInfo.append(String.format("密码:%s\n", apConfig.preSharedKey));
15 //使用apConfig.allowedKeyManagement.toString()返回{0}这样的格式,需要截取中间的具体数值
16 //下面几种写法都可以
17 //int index = Integer.valueOf(apConfig.allowedKeyManagement.toString().substring(1, 2));
18 //int index = Integer.valueOf(String.valueOf(apConfig.allowedKeyManagement.toString().charAt(1)));
19 //int index = Integer.valueOf(apConfig.allowedKeyManagement.toString().charAt(1)+"");
20 int index = apConfig.allowedKeyManagement.toString().charAt(1) - '0';
21 //从KeyMgmt数组中取出对应的文本
22 String apType = WifiConfiguration.KeyMgmt.strings[index];
23 tvInfo.append(String.format(Locale.getDefault(), "WifiConfiguration.KeyMgmt:%s\r\n", Arrays.toString(WifiConfiguration.KeyMgmt.strings)));
24 tvInfo.append(String.format(Locale.getDefault(), "安全性:%d,%s\r\n", index, apType));
25 isOpen = isWifiApEnabled();
26 tvInfo.append("是否已开启:" + isOpen);
27 } catch (NoSuchMethodException e) {
28 e.printStackTrace();
29 } catch (IllegalAccessException e) {
30 e.printStackTrace();
31 } catch (InvocationTargetException e) {
32 e.printStackTrace();
33 }
34 }
系统会自动创建一个默认的热点,如果我们不需要自定义热点参数的话,可以直接读取系统的热点参数,请参考源码中的switchWifiApEnabled(boolean enabled)方法
- Android 6.0权限适配
如果APP的targetSdkVersion为23以上,需要在清单文件中添加android.permission.WRITE_SETTINGS权限,并在运行时申请,跳转系统设置页由用户开启。
1 private boolean isHasPermissions() {
2 boolean result = false;
3 if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
4 if (!Settings.System.canWrite(this)) {
5 Toast.makeText(this, "打开热点需要启用“修改系统设置”权限,请手动开启", Toast.LENGTH_SHORT).show();
6
7 //清单文件中需要android.permission.WRITE_SETTINGS,否则打开的设置页面开关是灰色的
8 Intent intent = new Intent(Settings.ACTION_MANAGE_WRITE_SETTINGS);
9 intent.setData(Uri.parse("package:" + this.getPackageName()));
10 //判断系统能否处理,部分ROM无此action,如魅族Flyme
11 if (intent.resolveActivity(getPackageManager()) != null) {
12 startActivity(intent);
13 } else {
14 //打开应用详情页
15 intent = new Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS);
16 intent.setData(Uri.parse("package:" + this.getPackageName()));
17 if (intent.resolveActivity(getPackageManager()) != null) {
18 startActivity(intent);
19 }
20 }
21 } else {
22 result = true;
23 }
24 } else {
25 result = true;
26 }
27 return result;
28 }
项目源码:https://github.com/fly263/APDemo
PS:布局文件使用了ConstraintLayout,如果没有安装,需要在Android Studio中点击File-Settings-System Settings-Android SDK,切换到SDK Tools标签页,下载ConstraintLayout for Android、Solver for ConstraintLayout两个支持库