本頁面由 Cloud Translation API 翻譯而成。

實作 Health 2.0

所有 healthd 程式碼都已重構為 health@2.0-impl 和 libhealthservice，然後修改為實作 health@2.0 HAL。這兩個程式庫會由 health@2.0-service 靜態連結，讓它執行先前由 healthd 執行的工作 (也就是執行 healthd_mainloop 並進行輪詢)。在初始化時，health@2.0-service 會將介面 IHealth 的實作項目註冊至 hwservicemanager。升級搭載 Android 8.x 供應商映像檔和 Android 9 架構的裝置時，供應商映像檔可能不會提供 health@2.0 服務。這項規定是由淘汰時間表強制執行。

解決此問題的方法如下：

healthd 會將 IHealth 註冊至 hwservicemanager (儘管是系統 Daemon)。IHealth 已新增至系統資訊清單，並附上執行個體名稱 "backup"。
架構和 storaged 會透過 hwbinder 與 healthd 通訊，而非 binder。
系統會變更架構和 storaged 的程式碼，以擷取執行個體 "default" (如有)，然後變更 "backup"。
- C++ 用戶端程式碼會使用 libhealthhalutils 中定義的邏輯。
- Java 用戶端程式碼會使用 HealthServiceWrapper 中定義的邏輯。
在 IHealth/預設廣泛提供，且 Android 8.1 供應商映像檔已淘汰後，IHealth/備份和 healthd 也將淘汰。詳情請參閱 Deprecating 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、充電器、復原和舊版 healthd。

health@2.0.impl 會實作上述的 IHealth，並且用於包裝 libbatterymonitor 和 libhealthd.BOARD。Health@2.0-impl 的使用者不得直接使用 BatteryMonitor 或 libhealthd 中的函式；而是應將這些呼叫替換為 Health 類別 (為 IHealth 介面的實作) 的呼叫。為了進一步一般化，Health@2.0-impl 也提供 healthd_common 程式碼。新的 healthd_common 包含 health@2.0-service、充電器和 healthd 之間的其他常見程式碼，並呼叫 IHealth 方法，而非 BatteryMonitor。

實作 Health 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_init 和 healthd_board_battery_update 函式提供空白實作。
如果是特定主機板的 BOARD_PERIODIC_CHORES_INTERVAL_* 變數：
- 已定義，請建立裝置專屬 HealthServiceCommon.cpp (從 hardware/interfaces/health/2.0/utils/libhealthservice 複製)，並在 healthd_mode_service_2_0_init 中自訂。
- 未定義，請將其靜態連結至 libhealthservice。
如果裝置：
- 如果要實作 getStorageInfo 和 getDiskStats API，請在 get_storage_info 和 get_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。

健康用戶

請參閱「Health 用戶端 for Health 2.1 HAL」。

SELinux 異動

新的 health@2.0 HAL 包含下列 SELinux 變更：

將 health@2.0-service 新增至 file_contexts。
允許 system_server 和 storaged 使用 hal_health。
允許 system_server (BatteryService) 註冊 batteryproperties_service (IBatteryPropertiesRegistrar)。
允許 healthd 提供 hal_health。
移除允許 system_server 和 storaged 透過繫結器呼叫 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.

核心介面

請參閱 Health 2.1 HAL 的核心介面。

測試

Android 9 包含專為 health@2.0 HAL 編寫的新 VTS 測試。如果裝置宣告要在裝置資訊清單中提供 health@2.0 HAL，就必須通過相應的 VTS 測試。我們會為預設例項 (確保裝置正確實作 HAL) 和備份例項 (確保 healthd 在移除前繼續正常運作) 撰寫測試。

電池資訊規定

請參閱「電池資訊規定」。