از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
در اندروید 12 و بالاتر، اندروید می‌تواند به صورت اختیاری از یک سیستم ماهواره‌ای ناوبری جهانی (GNSS) برای پیشنهاد زمان‌های یونیکس به سرویس time_detector استفاده کند. این به طور پیش فرض در AOSP فعال نیست.
وقتی تشخیص زمان GNSS فعال است، سرویس gnss_time_update_service به طور غیر فعال به به‌روزرسانی‌های مکان از منابع GNSS گوش می‌دهد و پیشنهادات GNSS را به سرویس time_detector ارسال می‌کند. سپس سرویس time_detector تعیین می کند که آیا ساعت سیستم را برای مطابقت با پیشنهاد به روز کند یا خیر.
تاثیر بر مصرف برق
AOSP gnss_time_update_service به طور منفعلانه به به‌روزرسانی‌های مکان گوش می‌دهد. این بدان معنی است که هرگز به طور فعال GPS را روشن نمی کند یا انرژی اضافی مصرف نمی کند. این همچنین به این معنی است که مگر اینکه برنامه یا سرویس دیگری در سیستم به‌طور فعال درخواست به‌روزرسانی مکان کند، gnss_time_update_service به‌روزرسانی مکان را دریافت نمی‌کند و زمان GNSS را پیشنهاد نمی‌کند.
پیاده سازی
برای فعال کردن تشخیص زمان GNSS، سازندگان دستگاه باید به صراحت gnss_time_update_service در سرور سیستم فعال کنند.
برای فعال کردن این ویژگی، هر دو مقدار config_enableGnssTimeUpdateService و config_autoTimeSourcesPriority در فایل core/res/res/values/config.xml باید به روز شوند. مقدار config_enableGnssTimeUpdateService را روی true تنظیم کنید و gnss به لیست آیتم برای config_autoTimeSourcesPriority اضافه کنید. موقعیت gnss در لیست اولویت، اولویتی را که به پیشنهادات GNSS نسبت به پیشنهادات سایر منابع داده می شود، تعیین می کند.
فایل زیر نمونه‌ای از فایل core/res/res/values/config.xml است که در آن تشخیص زمان GNSS فعال است و gnss بعد از network و telephony سومین فهرست اولویت‌ها است.
<!-- 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>network</item>
<item>telephony</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>
اشکال زدایی و تست
برای آزمایش تشخیص زمان GNSS، می‌توانید از دستورات adb shell cmd location استفاده کنید. از این دستورات برای اضافه کردن ارائه دهندگان مکان آزمایشی استفاده کنید، جایی که می توانید یک مکان و زمان GNSS مرتبط را مشخص کنید. gnss_time_update_service به این به‌روزرسانی‌های مکان گوش می‌دهد و به‌صورت دوره‌ای پیشنهادهایی ارائه می‌دهد.
در زیر نمونه‌هایی از دستورات adb shell cmd location نشان داده شده است:
#EnableMasterLocationSwitchintheforegrounduser(usuallyuser10onautomotive).Ifyoujustflashed,thiscanbedonethroughsetupwizard.adbshellcmdlocationset-location-enabledtrue--user10#AddGPStestprovider(Thisusuallyfailsthefirsttime.ThrowsaSecurityExceptionwith"android from <SOME_UID> not allowed to perform MOCK_LOCATION".)adbshellcmdlocationprovidersadd-test-providergps#EnablemocklocationpermissionsforpreviousUIDadbshellappopssetUID_PRINTED_IN_PREVIOUS_ERRORandroid:mock_locationallow#AddGPStestprovider(Shouldworkwithnoerrors.)adbshellcmdlocationprovidersadd-test-providergps#EnableGPStestprovideradbshellcmdlocationprovidersset-test-provider-enabledgpstrue#Setlocationwithtime(Timecan'tbelowerthanthelimitsetbythelowerbound.)adbshellcmdlocationprovidersset-test-provider-locationgps--locationLATITUDE,LONGITUDE--timeTIME
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین به‌روزرسانی 2025-08-27 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین به‌روزرسانی 2025-08-27 بهوقت ساعت هماهنگ جهانی."],[],[],null,["In Android 12 and higher, Android can optionally use a\nGlobal Navigation Satellite System (GNSS) to suggest Unix epoch times to the\n[`time_detector`](/docs/core/connect/time#time_detector-service) service.\nThis isn't enabled by default in AOSP.\n\nWhen GNSS time detection is enabled, the `gnss_time_update_service` passively\nlistens to location updates from GNSS sources and submits GNSS suggestions to\nthe `time_detector` service. The `time_detector` service then determines whether\nto update the system clock to match the suggestion.\n\nImpact on power usage\n\nThe AOSP `gnss_time_update_service` passively listens to location updates. This\nmeans that it never actively turns on the GPS or consumes additional power. This\nalso means that unless another app or service in the system is actively\nrequesting location updates, the `gnss_time_update_service` won't get a location\nupdate and suggest a GNSS time.\n\nImplementation\n\nTo enable GNSS time detection, device manufacturers must explicitly enable the\n`gnss_time_update_service` in the system server.\n\nBoth the `config_enableGnssTimeUpdateService` and\n`config_autoTimeSourcesPriority` values in the `core/res/res/values/config.xml`\nfile must be updated to enable this feature. Set the value for\n`config_enableGnssTimeUpdateService` to `true` and add `gnss` to the item list\nfor `config_autoTimeSourcesPriority`. The position of `gnss` in the priority\nlist determines the priority given to GNSS suggestions with respect to those\nfrom other sources.\n\nThe following is an example `core/res/res/values/config.xml` file where GNSS\ntime detection is enabled and `gnss` is third in the priority list after\n`network` and `telephony`. \n\n \u003c!-- Specifies priority of automatic time sources. Suggestions from higher entries in the list\n take precedence over lower ones.\n See com.android.server.timedetector.TimeDetectorStrategy for available sources. --\u003e\n \u003cstring-array name=\"config_autoTimeSourcesPriority\"\u003e\n \u003citem\u003enetwork\u003c/item\u003e\n \u003citem\u003etelephony\u003c/item\u003e\n \u003citem\u003egnss\u003c/item\u003e\n \u003c/string-array\u003e\n\n \u003c!-- Enables the GnssTimeUpdate service. This is the global switch for enabling Gnss time based\n suggestions to TimeDetector service. See also config_autoTimeSourcesPriority. --\u003e\n \u003cbool name=\"config_enableGnssTimeUpdateService\"\u003etrue\u003c/bool\u003e\n\nDebugging and testing **Note:** The interface for these commands might change between releases. Use the `help` flag to see a list of command options.\n\nTo test GNSS time detection, you can use `adb shell cmd location` commands.\nUse these commands to add test location providers where you can specify a\nlocation and the associated GNSS time. The `gnss_time_update_service` listens to\nthese location updates, and makes suggestions periodically.\n\nThe following shows examples of `adb shell cmd location` commands: \n\n # Enable Master Location Switch in the foreground user (usually user 10 on automotive). If you just flashed, this can be done through setup wizard.\n adb shell cmd location set-location-enabled true --user 10\n\n # Add GPS test provider (This usually fails the first time. Throws a SecurityException with \"android from \u003cSOME_UID\u003e not allowed to perform MOCK_LOCATION\".)\n adb shell cmd location providers add-test-provider gps\n\n # Enable mock location permissions for previous UID\n adb shell appops set \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003eUID_PRINTED_IN_PREVIOUS_ERROR\u003c/span\u003e\u003c/var\u003e android:mock_location allow\n\n # Add GPS test provider (Should work with no errors.)\n adb shell cmd location providers add-test-provider gps\n\n # Enable GPS test provider\n adb shell cmd location providers set-test-provider-enabled gps true\n\n # Set location with time (Time can't be lower than the limit set by the lower bound.)\n adb shell cmd location providers set-test-provider-location gps --location \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003eLATITUDE\u003c/span\u003e\u003c/var\u003e,\u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003eLONGITUDE\u003c/span\u003e\u003c/var\u003e --time \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003eTIME\u003c/span\u003e\u003c/var\u003e"]]
