建議做法

適用於折疊式和多螢幕裝置的應用程式

一般來說,應用程式不應仰賴靜態 ID 或邏輯,因為這些會依賴某些顯示 ID。在大多數情況下,應用程式應調整大小並在不同螢幕上運作,而系統應控制應用程式的所在位置。例如,為摺疊式裝置打造全新的獨特體驗,並在裝置摺疊時在外部螢幕上啟動特殊應用程式。

在這種情況下,SystemUI (或其他系統元件) 應偵測摺疊情況,判斷其是否適合執行某項操作,然後啟動目標活動,並指定外部螢幕 ID 做為啟動目標。應用程式不應偵測這項動作,也不應在回應中執行任何動作,然後在特定螢幕上執行啟動作業。換句話說,請勿假設在某部裝置上可運作的功能,也會在其他裝置上運作。簡而言之,裝置專屬程式碼會增加分散現象。

限制螢幕存取權

如果裝置設定需要限制一或多個螢幕的存取權,建議您使用 Display#FLAG_PRIVATE 標記將這些螢幕指定為「私人」。這樣一來,除了房東之外,其他人就無法在螢幕上新增內容。除了擁有者以外,任何人嘗試啟動活動或新增視窗,都會導致 SecurityException。如果系統擁有顯示器,則可新增視窗和啟動活動。

此外,放置在螢幕上的實體一律可存取該螢幕。如果擁有者在螢幕上啟動活動,該活動就能在這個螢幕上啟動其他活動。因此,擁有者負責限制存取權和允許可信任的應用程式。

此外,由於任何應用程式都能建立虛擬螢幕,但不必讓使用者看到,因此我們在虛擬螢幕上加入更多限制。如果虛擬螢幕不是由系統所有,則系統只會允許具有 allowEmbedded 的活動,且呼叫端應擁有 ACTIVITY_EMBEDDING 權限。

詳情請參閱:

  • ActivityStackSupervisor#isCallerAllowedToLaunchOnDisplay()
  • ActivityDisplay#isUidPresent()
  • DisplayManagerService#isUidPresentOnDisplay()

如要有條件地控制活動啟動作業,請使用 LaunchParamsController,這項工具會攔截所有活動啟動作業,並允許系統元件修改用於啟動作業的參數。這項功能已在 system_server 推出。

設定顯示視窗設定和系統裝飾

系統裝飾項目可在 DisplayWindowSettings 中針對每個螢幕進行設定。裝置實作項目可在 /data/system/display_settings.xml 中提供預設設定。

這個值會決定系統裝飾項目 (啟動器、桌布、導覽列和其他裝飾視窗) 和輸入法編輯器是否會顯示在螢幕上。詳情請參閱 DisplayWindowSettings#shouldShowSystemDecorsLocked()DisplayWindowSettings#shouldShowImeLocked() 相關說明。

如要識別螢幕,請使用專屬 ID (預設使用 DisplayInfo#uniqueId) 或硬體螢幕的實體埠 ID (請參閱 DisplayInfo#address)。

舉例來說,下列顯示設定範例會在模擬顯示畫面上啟用系統裝飾項目和 IME:

<?xml version='1.0' encoding='utf-8' standalone='yes' ?>
<display-settings>
<config identifier="0" />
<display
  name="overlay:1"
  shouldShowSystemDecors="true"
  shouldShowIme="true" />
</display-settings>

在上述範例中,uniqueId 用於顯示名稱屬性中的顯示裝置識別資訊,模擬顯示裝置則為 overlay:1。對於內建顯示器,範例值可能是 "local:45354385242535243453"。另一個做法是使用硬體埠資訊,並將 identifier="1" 設為對應 DisplayWindowSettings#IDENTIFIER_PORT,然後更新名稱以使用 "port:<port_id>" 格式:

<?xmlversion='1.0' encoding='utf-8' standalone='yes' ?>
<display-settings>
<config identifier="1" />
<display
  name="port:12345"
  shouldShowSystemDecors="true"
  shouldShowIme="true" />
</display-settings>

詳情請參閱「靜態顯示 ID」。

詳情請參閱: