實施健康 2.0

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

所有healthd代碼都被重構為 health@2.0-impl 和libhealthservice ,然後修改為實現 health@2.0 HAL。這兩個庫由 health@2.0-service 靜態鏈接,使其能夠完成之前由healthd完成的工作(即運行healthd_mainloop並進行輪詢)。在 init 中, health@2.0-service 將接口IHealth的實現註冊到hwservicemanager 。使用 Android 8.x 供應商映像和 Android 9 框架升級設備時,供應商映像可能不提供 health@2.0 服務。這是由棄用計劃強制執行的。

要解決此問題:

  1. healthdIHealth註冊到hwservicemanager (儘管是系統守護進程)。 IHealth被添加到系統清單中,實例名稱為“backup”。
  2. 框架和storaged通過hwbinder而不是binderhealthd通信。
  3. 框架和storaged的​​代碼被更改為獲取實例“默認”(如果可用),然後是“備份”。
    • C++ 客戶端代碼使用libhealthhalutils中定義的邏輯。
    • Java 客戶端代碼使用HealthServiceWrapper中定義的邏輯。
  4. 在 IHealth/default 廣泛可用且 Android 8.1 供應商映像被棄用後,可以棄用 IHealth/backup 和healthd 。有關更多詳細信息,請參閱棄用 health@1.0

healthd 的特定於板的構建變量

BOARD_PERIODIC_CHORES_INTERVAL_*是用於構建healthd的特定於板的變量。作為系統/供應商構建拆分的一部分,無法為系統模塊定義特定於板的值。在 health@2.0 中,供應商可以在healthd_mode_ops->init中覆蓋這兩個值(通過在health@2.0-service.<device>中刪除libhealthservice依賴並重新實現此功能)。

靜態實現庫

與其他 HAL 實現庫不同,實現庫 health@2.0-impl 是一個靜態庫,health@2.0-service、charger、recovery 和 legacy healthd 鏈接到該庫。

health@2.0.impl 實現瞭如上所述的IHealth ,旨在包裹libbatterymonitorlibhealthd. BOARD 。這些 health@2.0-impl 的用戶不得直接使用BatteryMonitorlibhealthd中的功能;相反,這些調用應替換為對Health類的調用,即IHealth接口的實現。為了進一步概括, healthd_common代碼也包含在 health@2.0-impl 中。新的healthd_common包含 health@2.0-service、charger 和healthd之間的其餘公共代碼,並調用 IHealth 方法而不是 BatteryMonitor。

實施健康 2.0 服務

為設備實現health@2.0服務時,如果默認實現為:

  • 設備夠用,直接使用android.hardware.health@2.0-service
  • 對於設備來說還不夠,請創建android.hardware.health@2.0-service.(device)可執行文件並包括:

    #include <health2/service.h>
    int main() { return health_service_main(); }
    

然後:

  • 如果特定於板的libhealthd:

    • 存在,鏈接。
    • 不存在,為healthd_board_inithealthd_board_battery_update函數提供空實現。
  • 如果板特定的BOARD_PERIODIC_CHORES_INTERVAL_*變量:

    • 已定義,創建一個特定於設備的HealthServiceCommon.cpp (從hardware/interfaces/health/2.0/utils/libhealthservice )並在healthd_mode_service_2_0_init中對其進行自定義。
    • 未定義,靜態鏈接到libhealthservice
  • 如果設備:

    • 應實現getStorageInfogetDiskStats API,在get_storage_infoget_disk_stats函數中提供實現。
    • 不應實現這些 API,靜態鏈接到libstoragehealthdefault
  • 更新必要的 SELinux 權限。

  • 通過將直通實現安裝到恢復映像,在恢復中實現 HAL。例子:

    // Android.bp
    cc_library_shared {
        name: "android.hardware.health@2.0-impl-<device>",
        recovery_available: true,
        relative_install_path: "hw",
        static_libs: [
            "android.hardware.health@2.0-impl",
            "libhealthd.<device>"
            // Include the following or implement device-specific storage APIs
            "libhealthstoragedefault",
        ],
        srcs: [
            "HealthImpl.cpp",
        ],
        overrides: [
            "android.hardware.health@2.0-impl-default",
        ],
    }
    
    // HealthImpl.cpp
    #include <health2/Health.h>
    #include <healthd/healthd.h>
    using android::hardware::health::V2_0::IHealth;
    using android::hardware::health::V2_0::implementation::Health;
    extern "C" IHealth* HIDL_FETCH_IHealth(const char* name) {
        const static std::string providedInstance{"default"};
        if (providedInstance != name) return nullptr;
        return Health::initInstance(&gHealthdConfig).get();
    }
    
    # device.mk
    PRODUCT_PACKAGES += android.hardware.health@2.0-impl-<device>
    

有關詳細信息,請參閱hardware/interfaces/health/2.0/README.md

健康客戶

有關健康 2.1 HAL 的信息,請參閱健康客戶端

SELinux 變化

新的 health@2.0 HAL 包括以下 SELinux 更改:

  • 將 health@2.0-service 添加到file_contexts
  • 允許system_serverstoraged使用hal_health
  • 允許system_server ( BatteryService ) 註冊batteryproperties_service ( IBatteryPropertiesRegistrar )。
  • 允許healthd提供hal_health
  • 刪除允許system_server / storaged通過 binder 調用healthd的規則。
  • 刪除允許healthd註冊batteryproperties_service ( IBatteryPropertiesRegistrar ) 的規則。

對於具有自己實現的設備,可能需要對供應商的 SELinux 進行一些更改。例子:

# device/<manufacturer>/<device>/sepolicy/vendor/file_contexts
/vendor/bin/hw/android\.hardware\.health@2\.0-service.<device> u:object_r:hal_health_default_exec:s0

# device/<manufacturer>/<device>/sepolicy/vendor/hal_health_default.te
# Add device specific permissions to hal_health_default domain, especially
# if it links to board-specific libhealthd or implements storage APIs.

內核接口

請參閱運行狀況 2.1 HAL 的內核接口

測試

Android 9 包含專門為 health@2.0 HAL 編寫的新VTS 測試。如果設備在設備清單中聲明提供 health@2.0 HAL,則它必須通過相應的 VTS 測試。為默認實例(以確保設備正確實現 HAL)和備份實例(以確保healthd在被刪除之前繼續正常運行)編寫測試。

電池信息要求

請參閱電池信息要求