cordova项目适配iPhoneX
iPhoneX适配踩坑浅谈
Apple每次退出新尺寸的iphone都会掀起一番适配风波,这次没有下巴但有刘海的iPhoneX更是如此,网传横屏下的适配动画更是令不少人汗颜.
其实对于Native App来说,适配并不算困难(当然追求酷炫效果另算),官方文档有详细的说明,而对于Web App来说,主要还是依靠打开webview的Native App来适配,而这篇文章主要讨论的是Cordova App要如何适配iPhoneX.
ps: 本文用到的项目模板来自centrual/cordova-template-framework7-vue-webpack
所有设配做出的改动都放到了我fork的funkyLover/cordova-template-framework7-vue-webpack上
先上一开始没有适配的效果(下面截图均来自模拟器)
适配后效果
适配步骤如下
更新cordova插件
首先确认使用的cordova插件有是否包含针对iPhone X的release,例如cordova-plugin-splashscreen, cordova-plugin-statusbar等,而我是用的项目模板的插件版本刚好没有出什么问题,所以我也没有深究具体需要更新到哪些版本.
而如果使用的是Meteor来打包生成Cordova应用的话,则需要更新Meteor到1.6,而之后运行Meteor也会提醒需要更新哪些插件.
更新启动图
这对Native适配非常简单,就加一张图片就好了.对于Cordova也没费多大的事,修改一下config.xml关于ios启动图配置的部分
<platform name="ios"> <!-- 这里只加了针对iphone x的尺寸 1125 * 2436 --> <splash height="2436" src="res/screen/ios/qidong.png" width="1125" /> </platform>
更新HTML viewport meta
这里的改动主要是添加viewport-fit=cover,其他部分可以算是Web App的标准配置了.
<meta name="viewport" content="initial-scale=1, width=device-width, height=device-height, maximum-scale=1, minimum-scale=1, user-scalable=no, viewport-fit=cover">
更新CSS
完成上面的配置之后,现在的显示效果应该是这样的
其实离我们的最终效果已经很近了,观察页面就大概知道是页面的顶部往上顶了,其实上面多出来的区域是iPhoneX特有的,苹果称之为安全区(看对比图三和图二的区别可以看出,上面都有所谓的安全区).
我们要做的其实就是让页面布局在安全区(Safe Area)之外的地方.聪明的小伙伴肯定已经想到了,对页面加个padding-top就可以,但是这个padding值是多少呢?肯定不会hardcode某个具体数值的.对此苹果提供了safe-area-inset-top和safe-area-inset-bottom可用于css来设定具体的安全区域.
// 前两个css规则主要用于完善framework7(模板项目使用UI库),不一定适用其他项目
html, body {
height: 100%;
overflow: hidden;
// box-sizing取决于安全区的padding是加在哪个元素上
box-sizing: border-box;
}
html.with-statusbar-overlay .framework7-root {
padding-top: 0;
}
// 主要起效是这里,当然也不一定是加在body上
body {
padding-top: env(safe-area-inset-top);
padding-bottom: env(safe-area-inset-bottom);
}到这里,Cordova项目应该就已经适配好了
PS
毕竟技术是一直在进步(改变)的,可能到你看到这边文章的时候,我上面的方法又不一定适用了,但是整体思路已经给出,如果再有问题可以根据我文中的描述去搜索,也感谢在评论区贴出新的兼容问题解决方案的小伙伴
以下补充下@神秘博士 发现并解决的问题
- @神秘博士 的确还是有问题，ios11.2 +最新的 xcode9.2，如果你用的是 UIWebview，即使设置了viewport-fit="cover"，即使使用了 Launch Storyboard Image启动图，仍然有上下的白边。 最根本的解决方法是使用 cordova-plugin-wkwebview-engine，但是WkWebview启动的index.html不能访问http/https请求，需要结合cordova-plugin-wkwebview-file-xhr，此插件是oracle开发，拦截所有wkwebview请求，利用原生的方式请求http/https（默认只拦截https，如果需要拦截http，需要config.xml中配置 <preference name="InterceptRemoteRequests" value="all" />）。 还有，模拟器下的wkwebview是可以显示file://路径的本地图片文件的，但是真机下只能显示 Tmp 目录下的图片文件，所以如果你有下载、显示本地图片的，需要更换文件目录为 Tmp目录。 注：Tmp 目录是 file:///var/mobile/Containers/Data/Applications/<GUID of app>/tmp/ 用 cordova.file.tempDirectory 常量可以得到这个目录