Refactor and optimize PreferencesHelper (see https://github.com/y20k/transistor/pull/359 and Credit to https://github.com/TacoTheDank)

master
y20k 2021-07-02 16:35:27 +02:00
parent c81105186f
commit 1c7e7275bc
No known key found for this signature in database
GPG Key ID: 824D4259F41FAFF6
11 changed files with 81 additions and 94 deletions

View File

@ -53,7 +53,7 @@ class MainActivity : AppCompatActivity() {
super.onCreate(savedInstanceState)
// todo: remove after testing finished
if (BuildConfig.DEBUG && Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
if (BuildConfig.DEBUG && Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
StrictMode.setVmPolicy(
VmPolicy.Builder()
.detectNonSdkApiUsage()
@ -109,7 +109,7 @@ class MainActivity : AppCompatActivity() {
private val sharedPreferenceChangeListener = SharedPreferences.OnSharedPreferenceChangeListener { sharedPreferences, key ->
when (key) {
Keys.PREF_THEME_SELECTION -> {
AppThemeHelper.setTheme(PreferencesHelper.loadThemeSelection(this@MainActivity))
AppThemeHelper.setTheme(PreferencesHelper.loadThemeSelection())
}
}
}

View File

@ -71,7 +71,7 @@ class MapFragment : Fragment(), YesNoDialog.YesNoDialogListener, MapOverlayHelpe
// get current best location
currentBestLocation = LocationHelper.getLastKnownLocation(activity as Context)
// get saved tracking state
trackingState = PreferencesHelper.loadTrackingState(activity as Context)
trackingState = PreferencesHelper.loadTrackingState()
}
@ -319,7 +319,7 @@ class MapFragment : Fragment(), YesNoDialog.YesNoDialogListener, MapOverlayHelpe
when (key) {
Keys.PREF_TRACKING_STATE -> {
if (activity != null) {
trackingState = PreferencesHelper.loadTrackingState(activity as Context)
trackingState = PreferencesHelper.loadTrackingState()
layout.updateRecordingButton(trackingState)
}
}

View File

@ -22,6 +22,7 @@ import android.app.Application
import org.y20k.trackbook.helpers.AppThemeHelper
import org.y20k.trackbook.helpers.LogHelper
import org.y20k.trackbook.helpers.PreferencesHelper
import org.y20k.trackbook.helpers.PreferencesHelper.initPreferences
/*
@ -38,8 +39,10 @@ class Trackbook: Application() {
override fun onCreate() {
super.onCreate()
LogHelper.v(TAG, "Trackbook application started.")
// initialize single sharedPreferences object when app is launched
initPreferences()
// set Dark / Light theme state
AppThemeHelper.setTheme(PreferencesHelper.loadThemeSelection(this))
AppThemeHelper.setTheme(PreferencesHelper.loadThemeSelection())
}

View File

@ -83,9 +83,9 @@ class TrackerService: Service(), SensorEventListener {
/* Overrides onCreate from Service */
override fun onCreate() {
super.onCreate()
gpsOnly = PreferencesHelper.loadGpsOnly(this)
useImperial = PreferencesHelper.loadUseImperialUnits(this)
accuracyMultiplier = PreferencesHelper.loadAccuracyMultiplier(this)
gpsOnly = PreferencesHelper.loadGpsOnly()
useImperial = PreferencesHelper.loadUseImperialUnits()
accuracyMultiplier = PreferencesHelper.loadAccuracyMultiplier()
locationManager = getSystemService(Context.LOCATION_SERVICE) as LocationManager
sensorManager = this.getSystemService(Context.SENSOR_SERVICE) as SensorManager
@ -95,10 +95,10 @@ class TrackerService: Service(), SensorEventListener {
networkProviderActive = LocationHelper.isNetworkEnabled(locationManager)
gpsLocationListener = createLocationListener()
networkLocationListener = createLocationListener()
trackingState = PreferencesHelper.loadTrackingState(this)
trackingState = PreferencesHelper.loadTrackingState()
currentBestLocation = LocationHelper.getLastKnownLocation(this)
track = FileHelper.readTrack(this, FileHelper.getTempFileUri(this))
altitudeValues.capacity = PreferencesHelper.loadAltitudeSmoothingValue(this)
altitudeValues.capacity = PreferencesHelper.loadAltitudeSmoothingValue()
PreferenceManager.getDefaultSharedPreferences(this).registerOnSharedPreferenceChangeListener(
sharedPreferenceChangeListener
)
@ -239,7 +239,7 @@ class TrackerService: Service(), SensorEventListener {
}
// set state
trackingState = Keys.STATE_TRACKING_ACTIVE
PreferencesHelper.saveTrackingState(this, trackingState)
PreferencesHelper.saveTrackingState(trackingState)
// start recording steps and location fixes
startStepCounter()
handler.postDelayed(periodicTrackUpdate, 0)
@ -255,7 +255,7 @@ class TrackerService: Service(), SensorEventListener {
CoroutineScope(IO).launch { FileHelper.saveTempTrackSuspended(this@TrackerService, track) }
// save state
trackingState = Keys.STATE_TRACKING_STOPPED
PreferencesHelper.saveTrackingState(this, trackingState)
PreferencesHelper.saveTrackingState(trackingState)
// reset altitude values queue
altitudeValues.reset()
// stop recording steps and location fixes
@ -272,7 +272,7 @@ class TrackerService: Service(), SensorEventListener {
track = Track()
FileHelper.deleteTempFile(this)
trackingState = Keys.STATE_TRACKING_NOT
PreferencesHelper.saveTrackingState(this, trackingState)
PreferencesHelper.saveTrackingState(trackingState)
stopForeground(true)
}
@ -469,7 +469,7 @@ class TrackerService: Service(), SensorEventListener {
when (key) {
// preference "Restrict to GPS"
Keys.PREF_GPS_ONLY -> {
gpsOnly = PreferencesHelper.loadGpsOnly(this@TrackerService)
gpsOnly = PreferencesHelper.loadGpsOnly()
when (gpsOnly) {
true -> removeNetworkLocationListener()
false -> addNetworkLocationListener()
@ -477,11 +477,11 @@ class TrackerService: Service(), SensorEventListener {
}
// preference "Use Imperial Measurements"
Keys.PREF_USE_IMPERIAL_UNITS -> {
useImperial = PreferencesHelper.loadUseImperialUnits(this@TrackerService)
useImperial = PreferencesHelper.loadUseImperialUnits()
}
// preference "Recording Accuracy"
Keys.PREF_RECORDING_ACCURACY_HIGH -> {
accuracyMultiplier = PreferencesHelper.loadAccuracyMultiplier(this@TrackerService)
accuracyMultiplier = PreferencesHelper.loadAccuracyMultiplier()
}
}
}

View File

@ -47,7 +47,7 @@ class TrackingToggleTileService: TileService() {
override fun onTileAdded() {
super.onTileAdded()
// get saved tracking state
trackingState = PreferencesHelper.loadTrackingState(this)
trackingState = PreferencesHelper.loadTrackingState()
// set up tile
updateTile()
}
@ -62,7 +62,7 @@ class TrackingToggleTileService: TileService() {
override fun onStartListening() {
super.onStartListening()
// get saved tracking state
trackingState = PreferencesHelper.loadTrackingState(this)
trackingState = PreferencesHelper.loadTrackingState()
// set up tile
updateTile()
// register listener for changes in shared preferences
@ -141,7 +141,7 @@ class TrackingToggleTileService: TileService() {
private val sharedPreferenceChangeListener = SharedPreferences.OnSharedPreferenceChangeListener { sharedPreferences, key ->
when (key) {
Keys.PREF_TRACKING_STATE -> {
trackingState = PreferencesHelper.loadTrackingState(this)
trackingState = PreferencesHelper.loadTrackingState()
updateTile()
}
}

View File

@ -77,7 +77,7 @@ object AppThemeHelper {
/* Returns a readable String for currently selected App Theme */
fun getCurrentTheme(context: Context): String {
return when (PreferencesHelper.loadThemeSelection(context)) {
return when (PreferencesHelper.loadThemeSelection()) {
Keys.STATE_THEME_LIGHT_MODE -> context.getString(R.string.pref_theme_selection_mode_light)
Keys.STATE_THEME_DARK_MODE -> context.getString(R.string.pref_theme_selection_mode_dark)
else -> context.getString(R.string.pref_theme_selection_mode_device_default)

View File

@ -62,7 +62,7 @@ object LocationHelper {
/* Tries to return the last location that the system has stored */
fun getLastKnownLocation(context: Context): Location {
// get last location that Trackbook has stored
var lastKnownLocation: Location = PreferencesHelper.loadCurrentBestLocation(context)
var lastKnownLocation: Location = PreferencesHelper.loadCurrentBestLocation()
// try to get the last location the system has stored - it is probably more recent
if (ContextCompat.checkSelfPermission(context, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED) {
val locationManager = context.getSystemService(Context.LOCATION_SERVICE) as LocationManager

View File

@ -18,6 +18,7 @@
package org.y20k.trackbook.helpers
import android.content.Context
import android.content.SharedPreferences
import android.location.Location
import android.location.LocationManager
import androidx.core.content.edit
@ -35,121 +36,104 @@ object PreferencesHelper {
/* Define log tag */
private val TAG: String = LogHelper.makeLogTag(PreferencesHelper::class.java)
/* The sharedPreferences object to be initialized */
private lateinit var sharedPreferences: SharedPreferences
/* Initialize a single sharedPreferences object when the app is launched */
fun Context.initPreferences() {
sharedPreferences = PreferenceManager.getDefaultSharedPreferences(this)
}
/* Loads zoom level of map */
fun loadZoomLevel(context: Context): Double {
// get preferences
val settings = PreferenceManager.getDefaultSharedPreferences(context)
// load zoom level
return settings.getDouble(Keys.PREF_MAP_ZOOM_LEVEL, Keys.DEFAULT_ZOOM_LEVEL)
fun loadZoomLevel(): Double {
return sharedPreferences.getDouble(Keys.PREF_MAP_ZOOM_LEVEL, Keys.DEFAULT_ZOOM_LEVEL)
}
/* Saves zoom level of map */
fun saveZoomLevel(context: Context, zoomLevel: Double) {
// get preferences
val settings = PreferenceManager.getDefaultSharedPreferences(context)
// save zoom level
settings.edit { putDouble(Keys.PREF_MAP_ZOOM_LEVEL, zoomLevel) }
fun saveZoomLevel(zoomLevel: Double) {
sharedPreferences.edit {
putDouble(Keys.PREF_MAP_ZOOM_LEVEL, zoomLevel)
}
}
/* Loads tracking state */
fun loadTrackingState(context: Context): Int {
// get preferences
val settings = PreferenceManager.getDefaultSharedPreferences(context)
fun loadTrackingState(): Int {
// load tracking state
return settings.getInt(Keys.PREF_TRACKING_STATE, Keys.STATE_TRACKING_NOT)
return sharedPreferences.getInt(Keys.PREF_TRACKING_STATE, Keys.STATE_TRACKING_NOT)
}
/* Saves tracking state */
fun saveTrackingState(context: Context, trackingState: Int) {
// get preferences
val settings = PreferenceManager.getDefaultSharedPreferences(context)
// save tracking state
settings.edit { putInt(Keys.PREF_TRACKING_STATE, trackingState) }
fun saveTrackingState(trackingState: Int) {
sharedPreferences.edit {
putInt(Keys.PREF_TRACKING_STATE, trackingState)
}
}
/* Loads length unit system - metric or imperial */
fun loadUseImperialUnits(context: Context): Boolean {
// get preferences
val settings = PreferenceManager.getDefaultSharedPreferences(context)
// load length unit system
return settings.getBoolean(Keys.PREF_USE_IMPERIAL_UNITS, LengthUnitHelper.useImperialUnits())
fun loadUseImperialUnits(): Boolean {
return sharedPreferences.getBoolean(Keys.PREF_USE_IMPERIAL_UNITS, LengthUnitHelper.useImperialUnits())
}
/* Loads length unit system - metric or imperial */
fun loadGpsOnly(context: Context): Boolean {
// get preferences
val settings = PreferenceManager.getDefaultSharedPreferences(context)
// load length unit system
return settings.getBoolean(Keys.PREF_GPS_ONLY, false)
fun loadGpsOnly(): Boolean {
return sharedPreferences.getBoolean(Keys.PREF_GPS_ONLY, false)
}
/* Loads accuracy threshold used to determine if location is good enough */
fun loadAccuracyThreshold(context: Context): Int {
fun loadAccuracyThreshold(): Int {
// get preferences
val settings = PreferenceManager.getDefaultSharedPreferences(context)
// load tracking state
return settings.getInt(Keys.PREF_LOCATION_ACCURACY_THRESHOLD, Keys.DEFAULT_THRESHOLD_LOCATION_ACCURACY)
return sharedPreferences.getInt(Keys.PREF_LOCATION_ACCURACY_THRESHOLD, Keys.DEFAULT_THRESHOLD_LOCATION_ACCURACY)
}
/* Loads state of recording accuracy */
fun loadRecordingAccuracyHigh(context: Context): Boolean {
// get preferences
val settings = PreferenceManager.getDefaultSharedPreferences(context)
// load current setting
return settings.getBoolean(Keys.PREF_RECORDING_ACCURACY_HIGH, false)
fun loadRecordingAccuracyHigh(): Boolean {
return sharedPreferences.getBoolean(Keys.PREF_RECORDING_ACCURACY_HIGH, false)
}
/* Loads current accuracy multiplier */
fun loadAccuracyMultiplier(context: Context): Int {
// get preferences
val settings = PreferenceManager.getDefaultSharedPreferences(context)
// load current setting
val recordingAccuracyHigh: Boolean = settings.getBoolean(Keys.PREF_RECORDING_ACCURACY_HIGH, false)
fun loadAccuracyMultiplier(): Int {
val recordingAccuracyHigh: Boolean = sharedPreferences.getBoolean(Keys.PREF_RECORDING_ACCURACY_HIGH, false)
// return multiplier based on state
return if (recordingAccuracyHigh) 2 else 1
}
/* Load altitude smoothing value */
fun loadAltitudeSmoothingValue(context: Context): Int {
// get preferences
val settings = PreferenceManager.getDefaultSharedPreferences(context)
// load current setting
return settings.getInt(Keys.PREF_ALTITUDE_SMOOTHING_VALUE, Keys.DEFAULT_ALTITUDE_SMOOTHING_VALUE)
fun loadAltitudeSmoothingValue(): Int {
return sharedPreferences.getInt(Keys.PREF_ALTITUDE_SMOOTHING_VALUE, Keys.DEFAULT_ALTITUDE_SMOOTHING_VALUE)
}
/* Loads the state of a map */
fun loadCurrentBestLocation(context: Context): Location {
// get preferences
val settings = PreferenceManager.getDefaultSharedPreferences(context)
val provider: String = settings.getString(Keys.PREF_CURRENT_BEST_LOCATION_PROVIDER, LocationManager.NETWORK_PROVIDER) ?: LocationManager.NETWORK_PROVIDER
fun loadCurrentBestLocation(): Location {
// create location
val provider: String = sharedPreferences.getString(Keys.PREF_CURRENT_BEST_LOCATION_PROVIDER, LocationManager.NETWORK_PROVIDER) ?: LocationManager.NETWORK_PROVIDER
val currentBestLocation: Location = Location(provider)
// load location attributes
currentBestLocation.latitude = settings.getDouble(Keys.PREF_CURRENT_BEST_LOCATION_LATITUDE, Keys.DEFAULT_LATITUDE)
currentBestLocation.longitude = settings.getDouble(Keys.PREF_CURRENT_BEST_LOCATION_LONGITUDE, Keys.DEFAULT_LONGITUDE)
currentBestLocation.accuracy = settings.getFloat(Keys.PREF_CURRENT_BEST_LOCATION_ACCURACY, Keys.DEFAULT_ACCURACY)
currentBestLocation.altitude = settings.getDouble(Keys.PREF_CURRENT_BEST_LOCATION_ALTITUDE, Keys.DEFAULT_ALTITUDE)
currentBestLocation.time = settings.getLong(Keys.PREF_CURRENT_BEST_LOCATION_TIME, Keys.DEFAULT_TIME)
currentBestLocation.latitude = sharedPreferences.getDouble(Keys.PREF_CURRENT_BEST_LOCATION_LATITUDE, Keys.DEFAULT_LATITUDE)
currentBestLocation.longitude = sharedPreferences.getDouble(Keys.PREF_CURRENT_BEST_LOCATION_LONGITUDE, Keys.DEFAULT_LONGITUDE)
currentBestLocation.accuracy = sharedPreferences.getFloat(Keys.PREF_CURRENT_BEST_LOCATION_ACCURACY, Keys.DEFAULT_ACCURACY)
currentBestLocation.altitude = sharedPreferences.getDouble(Keys.PREF_CURRENT_BEST_LOCATION_ALTITUDE, Keys.DEFAULT_ALTITUDE)
currentBestLocation.time = sharedPreferences.getLong(Keys.PREF_CURRENT_BEST_LOCATION_TIME, Keys.DEFAULT_TIME)
return currentBestLocation
}
/* Saves the state of a map */
fun saveCurrentBestLocation(context: Context, currentBestLocation: Location) {
// get preferences
val settings = PreferenceManager.getDefaultSharedPreferences(context)
settings.edit {
fun saveCurrentBestLocation(currentBestLocation: Location) {
sharedPreferences.edit {
// save location
putDouble(Keys.PREF_CURRENT_BEST_LOCATION_LATITUDE, currentBestLocation.latitude)
putDouble(Keys.PREF_CURRENT_BEST_LOCATION_LONGITUDE, currentBestLocation.longitude)
@ -161,22 +145,22 @@ object PreferencesHelper {
/* Load currently selected app theme */
fun loadThemeSelection(context: Context): String {
return PreferenceManager.getDefaultSharedPreferences(context).getString(Keys.PREF_THEME_SELECTION, Keys.STATE_THEME_FOLLOW_SYSTEM) ?: Keys.STATE_THEME_FOLLOW_SYSTEM
fun loadThemeSelection(): String {
return sharedPreferences.getString(Keys.PREF_THEME_SELECTION, Keys.STATE_THEME_FOLLOW_SYSTEM) ?: Keys.STATE_THEME_FOLLOW_SYSTEM
}
/* Checks if housekeeping work needs to be done - used usually in DownloadWorker "REQUEST_UPDATE_COLLECTION" */
fun isHouseKeepingNecessary(context: Context): Boolean {
val settings = PreferenceManager.getDefaultSharedPreferences(context)
return settings.getBoolean(Keys.PREF_ONE_TIME_HOUSEKEEPING_NECESSARY, true)
fun isHouseKeepingNecessary(): Boolean {
return sharedPreferences.getBoolean(Keys.PREF_ONE_TIME_HOUSEKEEPING_NECESSARY, true)
}
/* Saves state of housekeeping */
fun saveHouseKeepingNecessaryState(context: Context, state: Boolean = false) {
val settings = PreferenceManager.getDefaultSharedPreferences(context)
settings.edit { putBoolean(Keys.PREF_ONE_TIME_HOUSEKEEPING_NECESSARY, state) }
fun saveHouseKeepingNecessaryState(state: Boolean = false) {
sharedPreferences.edit {
putBoolean(Keys.PREF_ONE_TIME_HOUSEKEEPING_NECESSARY, state)
}
}
}

View File

@ -51,7 +51,7 @@ class TracklistAdapter(private val fragment: Fragment) : RecyclerView.Adapter<Re
/* Main class variables */
private val context: Context = fragment.activity as Context
private lateinit var tracklistListener: TracklistAdapterListener
private var useImperial: Boolean = PreferencesHelper.loadUseImperialUnits(context)
private var useImperial: Boolean = PreferencesHelper.loadUseImperialUnits()
private var tracklist: Tracklist = Tracklist()

View File

@ -94,7 +94,7 @@ data class MapFragmentLayoutHolder(private var context: Context, private var mar
mapView.setTileSource(TileSourceFactory.MAPNIK)
mapView.setMultiTouchControls(true)
mapView.zoomController.setVisibility(org.osmdroid.views.CustomZoomButtonsController.Visibility.NEVER)
zoomLevel = PreferencesHelper.loadZoomLevel(context)
zoomLevel = PreferencesHelper.loadZoomLevel()
controller.setZoom(zoomLevel)
// set dark map tiles, if necessary
@ -149,8 +149,8 @@ data class MapFragmentLayoutHolder(private var context: Context, private var mar
/* Save current best location and state of map to shared preferences */
fun saveState(currentBestLocation: Location) {
PreferencesHelper.saveCurrentBestLocation(context, currentBestLocation)
PreferencesHelper.saveZoomLevel(context, mapView.zoomLevelDouble)
PreferencesHelper.saveCurrentBestLocation(currentBestLocation)
PreferencesHelper.saveZoomLevel(mapView.zoomLevelDouble)
// reset user interaction state
userInteraction = false
}

View File

@ -137,7 +137,7 @@ data class TrackFragmentLayoutHolder(private var context: Context, private var m
trackManagementViews = rootView.findViewById(R.id.management_icons)
// get measurement unit system
useImperialUnits = PreferencesHelper.loadUseImperialUnits(context)
useImperialUnits = PreferencesHelper.loadUseImperialUnits()
// set dark map tiles, if necessary
if (AppThemeHelper.isDarkModeOn(context as Activity)) {