一、簡(jiǎn)介
隨著 Apple 發(fā)布 iPhone X 之后,各大手機(jī)廠商也開始模仿這種劉海屏的設(shè)計(jì),而且劉海屏手機(jī)的用戶也是越來(lái)越大,前段時(shí)間將項(xiàng)目進(jìn)行了所有主流廠商的劉海屏手機(jī)的適配,以便讓劉海屏手機(jī)的用戶也能有更好的體驗(yàn)。
二、劉海屏造成的 UI 顯示問(wèn)題
劉海屏手機(jī)因?yàn)楸绕匠5氖謾C(jī)多了一塊頂部的遮擋性劉海,所以會(huì)造成頂部 Toolbar 以及搜索框的遮擋,而且有些廠商的手機(jī)(vivo、華為),默認(rèn)是在「無(wú)狀態(tài)欄」的界面將狀態(tài)欄進(jìn)行黑化顯示,這時(shí)候會(huì)導(dǎo)致系統(tǒng)下移,從而導(dǎo)致底部的一些 UI 被截?cái)?。除此之外,一些控件的顯示規(guī)則還會(huì)受到影響,如 PopupWindow 的顯示高度會(huì)在「無(wú)狀態(tài)欄」的界面中比普通手機(jī)低一個(gè)「劉海的高度」,從而遮擋住原先在 PopupWindow 周圍的圖標(biāo)。
1、系統(tǒng)下移造成的底部 UI 截?cái)?/strong>
小說(shuō)頁(yè)碼被截?cái)?/p>
2、劉海擋住標(biāo)題欄和搜索框
劉海擋住標(biāo)題欄和搜索框
3、PopupWindow 顯示異常
PopupWindow 顯示異常
三、通用的適配方案
理論上來(lái)講,通過(guò) Android P 版本提供的劉海屏相關(guān)接口,判斷手機(jī)是否為劉海屏手機(jī),以及進(jìn)行一些相應(yīng)的處理是最合適的方式,但現(xiàn)在使用在國(guó)內(nèi)使用 Android P 的接口是不現(xiàn)實(shí)的,所以只能通過(guò)各大廠商提供的技術(shù)文檔來(lái)進(jìn)行適配,但適配的流程基本是一致的。
劉海屏的適配流程
劉海屏的適配流程
其中需要著重處理的是:
1、應(yīng)用是否已經(jīng)適配劉海屏
2、頁(yè)面是否顯示狀態(tài)欄
3.1 應(yīng)用是否已經(jīng)適配劉海屏
現(xiàn)在國(guó)內(nèi)的主流機(jī)型(華為、vivo、OPPO、小米)在劉海屏的顯示上分為兩個(gè)陣營(yíng):
所以,我們?cè)谶M(jìn)行劉海屏適配的時(shí)候,首先需要通過(guò)一些手段,統(tǒng)一各大廠商的顯示方案,讓所有的劉海屏手機(jī)都利用狀態(tài)欄的界面,「告知系統(tǒng)」我們已經(jīng)適配了劉海屏,確保系統(tǒng)不會(huì)下移我們的應(yīng)用,保留原生體驗(yàn)。
這里主要有兩種方式:
1、設(shè)置屏幕高寬比例
因?yàn)閯⒑F潦謾C(jī)的「寬高比」比之前的手機(jī)大,如果不適配的話,Android 默認(rèn)為最大的寬高比為 1.86,
小于劉海屏手機(jī)的寬高比,因此我們需要申明更高的寬高比來(lái)告訴系統(tǒng),我們應(yīng)用已經(jīng)適配了劉海屏。
只要在 AndroidManifest.xml 中加入如下配置:
<meta-data android:name="android.max_aspect" android:value="2.1"/>
也可以在 Application 添加屬性:
android:maxAspectRatio="ratio_float"
ps:這個(gè)屬性需要 API 26 才支持
2、設(shè)置應(yīng)用支持 resize
我們還可以通過(guò)設(shè)置應(yīng)用支持 resizeable,來(lái)告訴系統(tǒng)我們適配了劉海屏,而且這也是 Google 官方推薦的方式。不過(guò)需要注意的是,使用這個(gè)屬性之后,應(yīng)用也會(huì)跟著支持分屏模式。只需要在 AndroidManifest.xml 中添加:
android:resizeableActivity="true"
3.2 頁(yè)面是否顯示狀態(tài)欄
對(duì)于劉海屏適配,我們將界面分為兩種:
因此,我們進(jìn)行劉海屏適配,其實(shí)針對(duì)的就是沒(méi)有狀態(tài)欄的界面,而有狀態(tài)欄的界面顯示是正常的。對(duì)于沒(méi)有狀態(tài)欄的界面,主要是將對(duì)被劉海遮擋到的控件,設(shè)置對(duì)應(yīng)劉海高度的 MarginTop,從而避免控件被遮擋。而對(duì)于底部可能被截?cái)嗟慕缑?,可以考慮將底部做成 ScrollView 的形式。
四、各廠商的適配方案
現(xiàn)在 Android P 的接口還沒(méi)法用,但各手機(jī)廠商都制定了自己的 API,對(duì)此我們需要對(duì)各大機(jī)型進(jìn)行特殊的適配,這里主要介紹 vivo、OPPO、華為 這三種主流手機(jī)的適配方案。
華為
華為作為國(guó)內(nèi)的手機(jī)廠商大頭,自己仿照 Android P 提供的 API,實(shí)現(xiàn)了一套幾乎差不多的 API,所以我們?nèi)绻胍嬖V系統(tǒng)我們的應(yīng)用適配了劉海屏,最好直接使用華為的 API,這樣才是最保險(xiǎn)的。
以下代碼來(lái)自:華為劉海屏適配官方技術(shù)指導(dǎo)
1、應(yīng)用頁(yè)面設(shè)置使用劉海區(qū)顯示
① 方案一:在 AndroidManifest.xml 中增加 meta-data 屬性,此屬性不僅可以針對(duì) Application 生效,也可以對(duì) Activity 配置生效:
<meta-data android:name="android.notch_support" android:value="true"/>
增加這個(gè)屬性之后,系統(tǒng)就會(huì)對(duì)應(yīng)用進(jìn)行下移處理,從而保證原生體驗(yàn)。
② 方案二:通過(guò)添加窗口 FLAG 的方式設(shè)置界面使用劉海區(qū):
public static void setFullScreenWindowLayoutInDisplayCutout(Window window) { if (window == null) { return; } WindowManager.LayoutParams layoutParams = window.getAttributes(); try { Class layoutParamsExCls = Class.forName("com.huawei.android.view.LayoutParamsEx"); Constructor con=layoutParamsExCls.getConstructor(LayoutParams.class); Object layoutParamsExObj=con.newInstance(layoutParams); Method method=layoutParamsExCls.getMethod("addHwFlags", int.class); method.invoke(layoutParamsExObj, FLAG_NOTCH_SUPPORT); } catch (ClassNotFoundException | NoSuchMethodException | IllegalAccessException |InstantiationException | InvocationTargetException e) { Log.e("test", "hw add notch screen flag api error"); } catch (Exception e) { Log.e("test", "other Exception"); } }
2、判斷該華為手機(jī)是否劉海屏
public static boolean hasNotchInHuawei(Context context) { boolean hasNotch = false; try { ClassLoader cl = context.getClassLoader(); Class HwNotchSizeUtil = cl.loadClass("com.huawei.android.util.HwNotchSizeUtil"); Method hasNotchInScreen = HwNotchSizeUtil.getMethod("hasNotchInScreen"); if(hasNotchInScreen != null) { hasNotch = (boolean) hasNotchInScreen.invoke(HwNotchSizeUtil); } } catch (Exception e) { e.printStackTrace(); } return hasNotch; }
3、獲取劉海的高度
public static int[] getNotchSize(Context context) { int[] ret = new int[]{0, 0}; try { ClassLoader cl = context.getClassLoader(); Class HwNotchSizeUtil = cl.loadClass("com.huawei.android.util.HwNotchSizeUtil"); Method get = HwNotchSizeUtil.getMethod("getNotchSize"); ret = (int[]) get.invoke(HwNotchSizeUtil); } catch (ClassNotFoundException e) { Log.e("test", "getNotchSize ClassNotFoundException"); } catch (NoSuchMethodException e) { Log.e("test", "getNotchSize NoSuchMethodException"); } catch (Exception e) { Log.e("test", "getNotchSize Exception"); } finally { return ret; }
OPPO
OPPO 是主流廠商中的一股清流,學(xué) iPhoneX 是最像的,OPPO 手機(jī)對(duì)于不顯示狀態(tài)欄的界面,采取的是「狀態(tài)欄原先的位置也用于顯示界面」的方案,所以我們只要進(jìn)行相關(guān)控件的位置移動(dòng)就可以了。
以下代碼來(lái)自:OPPO 凹形屏適配說(shuō)明
1、判斷該 OPPO 手機(jī)是否為劉海屏手機(jī)
public static boolean hasNotchInOppo(Context context) { return context.getPackageManager().hasSystemFeature("com.oppo.feature.screen.heteromorphism"); }
2、獲取劉海屏的高度
對(duì)于 OPPO 劉海屏手機(jī)的劉海高度,OPPO 官方的文檔沒(méi)有提供相關(guān)的 API,但官方文檔表示 OPPO 手機(jī)的劉海高度和狀態(tài)欄的高度是一致的,而且我也對(duì)此進(jìn)行了驗(yàn)證,確實(shí)如此。所以我們可以直接獲取狀態(tài)欄的高度,作為 OPPO 手機(jī)的劉海高度。
public static int getStatusBarHeight(Context context) { int statusBarHeight = 0; int resourceId = context.getResources().getIdentifier("status_bar_height", "dimen", "android"); if (resourceId > 0) { statusBarHeight = context.getResources().getDimensionPixelSize(resourceId); } return statusBarHeight ;}
vivo
vivo 提供的技術(shù)文檔對(duì)于開發(fā)者來(lái)說(shuō)是最不友好的,只提供了一個(gè) API 來(lái)進(jìn)行劉海屏的判斷,并沒(méi)有提供劉海高度的獲取方式,我們只能通過(guò)獲取狀態(tài)欄高度來(lái)當(dāng)做劉海的高度,但在某些機(jī)型可能會(huì)有些偏差。
官方文檔: vivo 手機(jī)適配指南
判斷該 vivo 手機(jī)是否為劉海屏手機(jī)
public static boolean hasNotchInVivo(Context context) { boolean hasNotch = false; try { ClassLoader cl = context.getClassLoader(); Class ftFeature = cl.loadClass("android.util.FtFeature"); Method[] methods = ftFeature.getDeclaredMethods(); if (methods != null) { for (int i = 0; i < methods.length; i++) { Method method = methods[i]; if(method != null) { if (method.getName().equalsIgnoreCase("isFeatureSupport")) { hasNotch = (boolean) method.invoke(ftFeature, 0x00000020); break; } } } } } catch (Exception e) { e.printStackTrace(); hasNotch = false; } return hasNotch; }
五、總結(jié)
以上便是在之前在進(jìn)行 Android 劉海屏適配的時(shí)候,所積累的一些經(jīng)驗(yàn)和心得。將其記錄下來(lái),以便自己以后進(jìn)行回顧,同時(shí)也希望這篇文章能對(duì)進(jìn)行劉海屏適配的同學(xué)一些幫助。也希望大家多多支持VEVB武林網(wǎng)。
新聞熱點(diǎn)
疑難解答
圖片精選
網(wǎng)友關(guān)注