从 2025 年 3 月 27 日开始，我们建议使用 android-latest-release 而不是 aosp-main 来构建 AOSP 并为其做贡献。如需了解详情，请参阅对 AOSP 所做的更改。

自动时间检测
使用合集保持井井有条根据您的偏好设置保存内容并对其进行分类。

自动时间检测会接收来自各种来源的时间建议，选择最佳选项，然后在 Android 中设置系统时钟以与之匹配。之前的 Android 版本提供了两种设置日期和时间的方法，即手动按用户设置或通过自动时间检测设置，并通过以下选项之一进行设置

telephony 使用网络标识和时区 (NITZ) 电话信号。
network 使用网络时间协议 (NTP) 时间服务器。

每个选项都需要连接到外部网络，这在 Android Automotive 中并非始终可用。例如，在某些国家/地区，某些汽车可能没有内置电话功能。因此，全球卫星导航系统 (GNSS) 时间被提供为系统时间的来源，供您在网络连接不可用时使用。

即将推出的 Android 版本提供了另外两个选项来自动检测和设置时间

gnss 使用全球卫星导航系统 (GNSS)。
external 使用 VHAL 属性或系统 API。

启用自动时间检测

要启用自动时间检测，请务必选择设置 > 日期和时间 > 自动日期和时间

图 1. 选择“自动日期和时间”

配置时间源

要指定要包含在自动时间检测中的时间源以及应考虑这些时间源的优先级，您必须修改设备的资源配置文件 core/res/res/values/config.xml

<!-- Specifies priority of automatic time sources. Suggestions from higher entries in the list
     take precedence over lower ones. See com.android.server.timedetector.TimeDetectorStrategy for
     available sources. -->
<string-array name="config_autoTimeSourcesPriority">
    <item>telephony</item>
    <item>network</item>
</string-array>

在此示例中，telephony 和 network 在自动时间检测中被考虑，并且 telephony 时间建议的优先级高于 network 时间建议。

一般来说，如果来自较高优先级来源的建议无效或建议过旧，则会被忽略。此外，如果优先级最高的有效建议与设备当前的系统时钟时间在几秒钟内（默认值为两 (2) 秒），则时间不会更改。

下限时间

Android 12 提供了一个新的下限时间，用于验证时间建议。在此功能之前，自动时间检测不会验证建议的传入 UTC 时间。借助此功能，早于下限的时间将被丢弃。

下限值是从构建时间戳派生的日期确定的。这基于一个原则，即有效时间不能早于系统映像的构建时间。Android 不强制执行上限。

GNSS 时间建议

gnss 时间源是 Android 12 的新增功能，由 GPS 信号提供。当 telephony 和 network 不可用时，这是一个可靠的时间源。此选项已添加到 SystemServer 中的新 GnssTimeUpdateService 中，该服务被动地监听位置信息更新。当收到有效位置信息时，GnssTimeUpdateService 会向 TimeDetectorService 提出建议，然后由后者确定是否应更新系统时钟。

默认情况下，gnss 时间源在 AOSP 中未启用，因此必须由合作伙伴启用

<!-- Specifies priority of automatic time sources. Suggestions from higher entries in the list
    take precedence over lower ones.
    See com.android.server.timedetector.TimeDetectorStrategy for available sources. -->
<string-array name="config_autoTimeSourcesPriority">
    <item>telephony</item>
    <item>network</item>
    <item>gnss</item>
</string-array>

<!-- Enables the GnssTimeUpdate service. This is the global switch for enabling Gnss time based
    suggestions to TimeDetector service. See also config_autoTimeSourcesPriority. -->
<bool name="config_enableGnssTimeUpdateService">true</bool>

要启用此功能

更新 config_enableGnssTimeUpdateService。config_enableGnssTimeUpdateService 的值必须设置为 true。
更新 config_autoTimeSourcesPriority。gnss 必须添加到 config_autoTimeSourcesPriority 的项目列表中。gnss 在优先级列表中的位置决定了 GNSS 建议的优先级，相对于来自其他来源的值。

对功耗的影响

GnssTimeUpdateService 被动地监听位置信息更新，这意味着它永远不会主动打开 GPS 以消耗额外电量。因此，启用 GNSS 源时消耗的电量可以忽略不计。这也意味着，除非系统中的另一个应用或服务主动请求位置信息更新，否则 GnssTimeUpdateService 不会获得位置信息更新并建议 GNSS 时间。

测试

兼容性测试套件 (CTS)

提供了一个 CTS 测试，以验证 GNSS 提供的时间是否可用。如需了解详情，请参阅 LocationShellCommand.java。

单元测试

请参阅以下文件中的基本单元测试

atest frameworks/base/services/tests/servicestests/src/com/android/server/timedetector/GnssTimeUpdateServiceTest.java

手动测试

要测试此功能，已向 LocationShellCommand.java 添加了新命令。使用这些命令添加测试提供程序，您可以使用这些提供程序指定位置和关联的 GNSS 时间。GnssTimeUpdateService 监听这些位置信息更新，并定期提出建议。

注意：这些命令的接口可能会在不同版本之间发生变化。

# Enable Master Location Switch in the foreground user (usually user 10 on automotive).
# If you just flashed, this can be done through Setup Wizard.
adb shell cmd location set-location-enabled true --user 10

# Add GPS test provider (this usually fails the first time and will throw a SecurityException
# with "android from <some-uid> not allowed to perform MOCK_LOCATION".)
adb shell cmd location providers add-test-provider gps

# Enable mock location permissions for previous UID
adb shell appops set <uid printed in previous error> android:mock_location allow

# Add GPS test provider (Should work with no errors.)
adb shell cmd location providers add-test-provider gps

# Enable GPS test provider
adb shell cmd location providers set-test-provider-enabled gps true

# Set location with time (time can't be earlier than the limit set by the lower bound.)
adb shell cmd location providers set-test-provider-location gps --location <LATITUDE>,<LONGITUDE> --time <TIME>

外部时间建议

外部时间建议是向 Android 提供自动时间建议的另一种方式。此新选项使您可以向 Android 提供完全自定义的时间建议，这些建议可能来自各种 ECU，而这些 ECU 又可以使用实时时钟、GNSS、NITZ 或任何其他时间源的组合。

Android 12 中提供了以下建议，可将其视为 external 时间建议

VHAL 属性。提供了一个名为 EPOCH_TIME 的新 VHAL 属性。此属性表示自 1970 年 1 月 1 日 UTC 以来经过的毫秒数。其值可以传递到 Android TimeManager 以建议新的系统时间。以下参考实现中提供了更新此属性的 VHAL 示例实现。
系统 API。TimeManager 中提供了一个名为 suggestExternalTime() 的新方法，用于向系统提供外部时间建议。如果系统配置为考虑外部时间建议（使用配置文件中的 config_autoTimeSourcesPriority），则传递给此方法的时间戳将用于设置系统时间，前提是没有更高优先级的时间建议可用。

您可以按如下所述实现外部时间解决方案

更新资源配置文件 (core/res/res/values/config.xml)，然后将值 external 添加到 config_autoTimeSourcesPriority
```
<string-array name="config_autoTimeSourcesPriority>
        <item>external</item>
        <item>gnss</item>
</string-array>
```
这样做会指示 Android 在设置系统时钟时为外部时间建议赋予最高优先级。车辆上的硬件将时间戳建议写入新的 EPOCH_TIME VHAL 属性。
供应商提供的应用读取此属性并调用 TimeManager.suggestExternal()。然后，Android 可以使用提供的时间戳作为新的系统时钟值。

自动时间检测 使用合集保持井井有条 根据您的偏好设置保存内容并对其进行分类。