RealTime is a reliable time library for Android. Just initialize the current time using one of several time providers like GPS, NTP servers, or your own server and get current reliable time impervious to device clock changes by the user until the next device boot.
RealTime.introduction.mp4
- RealTime provides 3 different time providers:
- Location providers [Using GPS]
- NTP servers [Network Time Protocol servers]
- Your custom defined server [Using date header]
- RealTime detects device reboot and will reinitialize dateTime automatically after rebooting
- RealTime will detect network detection status changes and location provider ON/OFF changes and requests for current time if it has not initialized yet
Step 1. Add the JitPack repository to your build.gradle file
allprojects {
repositories {
maven { url 'https://jitpack.io' }
}
}Step 2. Add the dependency
dependencies {
implementation 'com.github.homayoonahmadi:RealTime:1.2.4'
}Add this to onCreate method of your Application class:
RealTime.builder(this)
.withGpsProvider()
.withNtpServer("time.nist.gov")
.withNtpServer("time.google.com")
.withNtpServer("time.windows.com")
.withTimeServer("https://bing.com")
.withTimeServer("https://google.com")
.setLoggingEnabled(BuildConfig.DEBUG)
.setSyncBackoffDelay(30, TimeUnit.SECONDS)
.build(date -> Log.d(TAG, "RealTime is initialized, current dateTime: " + date));
Then everywhere you need reliable time first you need to check if RealTime is initialized or not:
SimpleDateFormat simpleDateFormat = new SimpleDateFormat("EEE, dd MMMM yyyy HH:mm:ss z", Locale.ENGLISH);
if (RealTime.isInitialized()) {
binding.txtDateTime.setText(simpleDateFormat.format(RealTime.now()));
} else {
binding.txtDateTime.setText("RealTime is not initialized yet.");
}
- If you want to use custom server you need to make sure that server's time is correct and reliable.
- RealTime tries to get time using a retry with delay strategy if current network doesn't have internet connection yet.
- RealTime will not add location permissions to manifest automatically. If you want to use GPS provider, add required permissions to your manifest:
<manifest ... >
<!-- Always include this permission -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- Include only if your app benefits from precise location access. -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
</manifest>
NTP servers tested:
time.nist.gov
time-a.nist.gov
time.google.com
time.windows.com
1.us.pool.ntp.org
ir.pool.ntp.org
- RealTime class methods
| method | description |
|---|---|
| withNtpServer(String ntpHost) | This function will enable and set the url of NTP server. |
| withTimeServer(String serverHost) | This function will enable and set the url of custom server. |
| withGpsProvider() | This function enables gps provider if required permissions exist in manifest. |
| setLoggingEnabled(boolean enabled) | Sets if logs needs to be logged in. |
| build() | Starts to initialize RealTime using enabled providers. |
| build(OnRealTimeInitializedListener listener) | Starts to initialize RealTime using enabled providers and will call onInitializedListener's onInitialized(Date date) interface. |
| isInitialized() | Returns true if RealTime is initialized or false otherwise. |
| now() | Returns current reliable datetime if the class has initialized. |
| clearCachedInfo() | This function clears all cached data so RealTime tries to initialize dateTime again. |