供應商介面物件

本文件說明供應商介面物件 (VINTF 物件) 的設計，該物件會匯總裝置相關資訊，並透過可查詢的 API 提供這些資訊。

VINTF 物件設計

VINTF 物件會直接從裝置收集所需的部分資訊。其他方面 (例如資訊清單) 則會在 XML 中以靜態方式描述。

圖 1. 資訊清單、相容性矩陣和可在執行階段收集的資訊。

VINTF 物件設計可為裝置和架構元件提供下列功能：

裝置 適用於架構
  • 定義靜態元件 (裝置資訊清單檔案) 的結構。
  • 新增建構時間支援功能，可為特定裝置定義裝置資訊清單檔案。
  • 在執行階段定義可查詢的 API，用於擷取裝置資訊清單檔案 (以及其他可在執行階段收集的資訊)，並將這些資訊封裝至查詢結果。

VINTF 物件必須可靠，且無論何時要求物件，都能提供相同的完整資訊 (請參閱「注意事項」)。

資訊清單和矩陣

自 Android 8.0 起，執行階段 API 會查詢裝置上的內容，並將該資訊傳送至無線 (OTA) 更新伺服器和其他相關方 (例如 CTS DeviceInfo)。部分資訊會在執行階段擷取，部分資訊則會以靜態方式定義。

  • 裝置資訊清單會說明裝置可向架構提供的靜態元件。
  • 架構相容性矩陣說明 Android 架構對特定裝置的預期需求。矩陣是靜態實體，其組合是在開發 Android 架構的下一個版本時手動決定。
  • 架構資訊清單會說明架構可為裝置提供的高層服務。
  • 裝置相容性矩陣說明供應商映像檔對架構所需的服務。其組合是在裝置開發期間手動決定。

這兩組資訊清單和矩陣必須在 OTA 期間進行調和，以確保裝置可取得與其功能相容的架構更新。一般來說，資訊清單會說明提供的內容，而相容性矩陣則會說明所需的內容。

本節包含以下資訊，說明如何設定資訊清單和矩陣：

  • 「資訊清單」會定義裝置資訊清單、架構資訊清單和資訊清單檔案結構定義。
  • 相容性矩陣定義相容性矩陣的結構定義。
  • FCM 生命週期詳細說明如何淘汰及移除 HIDL HAL，以及如何修改 FCM 檔案，以反映 HAL 版本的狀態。
  • 「DM 開發」一文說明供應商如何在裝置資訊清單中為新裝置定義及宣告目標 FCM 版本，或在為舊裝置升級供應商映像檔時，實作新版 HAL 並增加目標 FCM 版本。
  • 比對規則定義相容性矩陣和資訊清單之間成功比對的規則。