1.问题
通过cordova创建了安卓壳,将h5资源放入该壳打包成apk后,发现http请求一直不通。
cordova版本:为目前最新的11.0.0(2022年7月5日)
E:\personal\projects\cordova\test>cordova -v
11.0.0
2.原因
1.安卓9.0以上版本对http请求有限制
2.cordova默认虚拟成https容器,不能访问http
3.cordova默认localhost访问静态资源文件,会造成跨域问题
3.解决方案
下面两步操作都需要执行
1.放开安卓9.0以上版本对http的限制(解决1)
src/main/AndroidManifest.xml中manifest/application节点加上android:usesCleartextTraffic="true"
2.通过配置使用file///形式访问静态资源(解决2、3)
src/main/res/xml/config.xml中widget节点下添加
<preference name="AndroidInsecureFileModeEnabled" value="true" />
3. 排查思路及过程
1.加上android:usesCleartextTraffic="true"
根据以往经验,混合app请求不通,通常都是因为安卓9.0以上版本限制了http请求
所以在AndroidManifest.xml中的manifest/application节点加上
android:usesCleartextTraffic="true"
出现提醒:Attribute usesCleartextTraffic is only used in API level 23 and higher (current min is 22)(不解决貌似没有影响)
Attribute usesCleartextTraffic is only used in API level 23 and higher (current min is 22)
解决方案:
a.找到[cordova项目目录]\platforms\android\cdv-gradle-config.json,修改MIN_SDK_VERSION为23(默认是22)。
b.执行Refresh Gradle Dependencies
2.https://localhost/和http://localhost/
加上了android:usesCleartextTraffic="true"配置,发现请求依然是不通。
在H5应用首页弹出当前的url
alert(window.location.href);
发现是:
https://localhost/index.html#/
网上搜索了一番,发现了一篇文章:
cordova11 android不支持http请求解决方法_GIS开发者的博客-CSDN博客_cordova http请求
大概意思是cordova将本地虚拟成一个容器(我理解是类似tomcat或者nginx),默认是使用https,当https的页面是不允许访问http接口的。
按照文章的步骤做了修改以后,再次弹出url,变成了:
http://localhost/index.html#/
测试公司环境的某个接口,发现请求可以成功了
仔细看了源码,我并不认同文章作者的粗暴修改方式,cordova本身已经提供了可修改的配置,修改一下配置即可实现。
org.apache.cordova.ConfigXmlParser源码关键部分:
private static String SCHEME_HTTP = "http";
private static String SCHEME_HTTPS = "https"; // 文章作者是粗暴的将此处改成http
private static String DEFAULT_HOSTNAME = "localhost";
private String getLaunchUrlPrefix() {
if (prefs.getBoolean("AndroidInsecureFileModeEnabled", false)) {
return "file:///android_asset/www/";
} else {
// 从配置文件中获取scheme配置的值,
// 如果没有配置,则默认返回SCHEME_HTTPS,即https
String scheme = prefs.getString("scheme", SCHEME_HTTPS).toLowerCase();
String hostname = prefs.getString("hostname", DEFAULT_HOSTNAME);
if (!scheme.contentEquals(SCHEME_HTTP) && !scheme.contentEquals(SCHEME_HTTPS)) {
LOG.d(TAG, "The provided scheme \"" + scheme + "\" is not valid. " +
"Defaulting to \"" + SCHEME_HTTPS + "\". " +
"(Valid Options=" + SCHEME_HTTP + "," + SCHEME_HTTPS + ")");
scheme = SCHEME_HTTPS;
}
// 组合成url前面部分,默认返回https://localhost/
return scheme + "://" + hostname + '/';
}
}
所以解决方案可以替换成:
修改src/main/res/xml/config.xml,在widget节点下添加
<preference name="scheme" value="http" />
来将scheme修改成http
3.http://localhost/和file:///android_asset/www/
将scheme改成了http以后,升级到现场,发现现场请求依然是不通,但是请求公司的接口没有问题(公司请求的和现场请求的是不同的接口)
公司能请求通,理论上请求是能够透壳发出来了,找现场平台确认了,也没有做什么限制,手机浏览器通过访问映射地址,也能正常访问到后台页面,说明网络通道是通的。为何现场请求不通呢?百思不得其解。
看着弹出的localhost,突然想到:公司的接口配置了允许跨域,现场的接口没有配置,再加上localhost,很有可能是由于跨域问题造成现场接口没有调通。
怎么会是localhost呢?以前不是什么asset/www/的形式的吗?
在安卓项目里搜索了一下,发现同样是在org.apache.cordova.ConfigXmlParser里:
private String getLaunchUrlPrefix() {
// 配置了AndroidInsecureFileModeEnabled为true
// 才会返回file:///android_asset/www/这种形式
if (prefs.getBoolean("AndroidInsecureFileModeEnabled", false)) {
return "file:///android_asset/www/";
} else {
String scheme = prefs.getString("scheme", SCHEME_HTTPS).toLowerCase();
String hostname = prefs.getString("hostname", DEFAULT_HOSTNAME);
if (!scheme.contentEquals(SCHEME_HTTP) && !scheme.contentEquals(SCHEME_HTTPS)) {
LOG.d(TAG, "The provided scheme \"" + scheme + "\" is not valid. " +
"Defaulting to \"" + SCHEME_HTTPS + "\". " +
"(Valid Options=" + SCHEME_HTTP + "," + SCHEME_HTTPS + ")");
scheme = SCHEME_HTTPS;
}
return scheme + "://" + hostname + '/';
}
}
同样修改配置文件:
修改src/main/res/xml/config.xml,在widget节点下添加
<preference name="AndroidInsecureFileModeEnabled" value="true" />
打包成apk打开首页,弹出:
file:///android_asset/www/index.html#/
再将apk包发到现场测试,终于测试通过了!!!
跨域问题被解决。
4.为何之前不是localhost?
对比了一下旧版本的cordova(8.1.0),其org.apache.cordova.ConfigXmlParser文件中:
private String launchUrl = "file:///android_asset/www/index.html";
则是直接将加载启动页定义成file:///android_asset/www/index.html
而新版本的launchUrl由launchUrlPrefix + src组成,launchUrlPrefix默认是https://localhost/ (参考上面2、3)
需要修改AndroidInsecureFileModeEnabled才能改为file:///android_asset/www/