DocumentsUI

DocumentsUI 模組會控管元件對特定檔案的存取權，這些元件會處理文件權限 (例如將檔案附加至電子郵件)。這個模組可更新，也就是說，即使不在正常的 Android 發布週期內，也能接收功能更新。

將儲存空間存取權和權限設為模組，可提升使用者的隱私權和安全性，同時讓 Android 合作夥伴透過執行階段資源疊加 (RRO) 自訂應用程式的功能和主題。模組格式可確保所有裝置都提供相同的 DocumentsUI 體驗，讓開發人員瞭解使用者看到的相關聯 API。

DocumentsUI 模組會處理下列動作。

  • 僅透過穩定的 @SystemApi API 與架構互動 (不使用 @hide API)。

  • 公開啟用 Android 合作夥伴自訂功能和主題的機制。

  • 使用簽章權限保護 MANAGE_DOCUMENTS 權限。

顯示「檔案」啟動器圖示

在 Android 10 中，DocumentsUI 模組會使用 is_launcher_enabled 判斷是否應在應用程式匣中顯示「檔案」啟動器圖示。在 Android 11 以上版本中，模組會使用 component-override 套件判斷「檔案」啟動器圖示是否顯示在應用程式匣中。

根據預設，圖示會啟用。如要停用這項功能，請將下列 XML 新增至 /etc/sysconfig。

<?xml version="1.0" encoding="utf-8"?>
<config>
  <component-override package="com.android.documentsui" >
    <component class="com.android.documentsui.LauncherActivity" enabled="false" />
  </component-override>
</config>

要求使用者資料

DocumentsUI 模組會實作 GET_CONTENT 動作，讓應用程式要求存取使用者的其他資料。

模組格式

DocumentsUI 模組 (com.android.documentsui) 會以 APK 檔案形式提供，適用於搭載 Android 10 以上版本的裝置。

模組依附元件

DocumentsUI 模組依附於受簽章權限保護的 MANAGE_DOCUMENTS 權限；額外權限類別可確保裝置上只有一個應用程式擁有 MANAGE_DOCUMENTS 權限。