Android App Resources

Android App Resources — Damoov developer documentation.

Override only the resources you need in the host Android application. Application resources take precedence over resources packaged with the SDK.

Tracking Permissions Wizard

The resources in this section customize TrackingPermissionsWizardActivity, TrackingPermissionsWizardStatusDialogFragment, and TrackingPermissionsWizardStatusDialog.

Strings

Add string overrides to res/values/strings.xml. The values below are the SDK defaults.

<resources>
    <!-- Foreground location page -->
    <string name="tracking_permissions_wizard_location_title">Turn on location</string>
    <string name="tracking_permissions_wizard_location_body">Android will ask about your location next. Choose Precise and \"While using the app\" so trips can be detected.</string>
    <string name="tracking_permissions_wizard_location_hint">Precise · While using the app</string>

    <!-- Background location page -->
    <string name="tracking_permissions_wizard_background_location_title">Keep location on in the background</string>
    <string name="tracking_permissions_wizard_background_location_body">Next, allow location all the time so trips can keep recording when the app is closed.</string>
    <string name="tracking_permissions_wizard_background_location_hint">Allow all the time</string>

    <!-- Physical Activity page -->
    <string name="tracking_permissions_wizard_activity_title">Allow physical activity</string>
    <string name="tracking_permissions_wizard_activity_body">Android will ask about physical activity next. Allow it so trip detection and driving score calculations stay accurate.</string>
    <string name="tracking_permissions_wizard_activity_hint">Allow</string>

    <!-- Battery optimization page -->
    <string name="tracking_permissions_wizard_battery_title">Ignore battery optimizations</string>
    <string name="tracking_permissions_wizard_battery_body">One last Android prompt will ask whether the app can run without battery optimization. Allow it for reliable background tracking.</string>
    <string name="tracking_permissions_wizard_battery_hint">Allow</string>

    <!-- Device location services page -->
    <string name="tracking_permissions_wizard_gps_title">Turn on device location</string>
    <string name="tracking_permissions_wizard_gps_body">Device location is currently off. Turn it on so tracking can receive GPS updates.</string>
    <string name="tracking_permissions_wizard_gps_hint">Turn on location services</string>

    <!-- Common page controls -->
    <string name="tracking_permissions_wizard_continue">Continue</string>
    <string name="tracking_permissions_wizard_hint_lead">ON THE NEXT SCREEN, TAP:</string>

    <!-- Status screen -->
    <string name="tracking_permissions_wizard_status_title">You\'re almost there</string>
    <string name="tracking_permissions_wizard_status_attention_title">Permissions need attention</string>
    <string name="tracking_permissions_wizard_status_body">A few permissions still need switching on so %1$s can track your trips accurately. Let\'s sort them in a tap.</string>
    <string name="tracking_permissions_wizard_status_location">Enable location</string>
    <string name="tracking_permissions_wizard_status_background_location">Location in background</string>
    <string name="tracking_permissions_wizard_status_activity">Physical activity</string>
    <string name="tracking_permissions_wizard_status_battery">Battery optimization</string>
    <string name="tracking_permissions_wizard_status_gps">Device location</string>
    <string name="tracking_permissions_wizard_status_location_allowed">Precise &#183; While using</string>
    <string name="tracking_permissions_wizard_status_background_location_allowed">Allow all the time</string>
    <string name="tracking_permissions_wizard_status_activity_allowed">Granted</string>
    <string name="tracking_permissions_wizard_status_battery_allowed">Ignored</string>
    <string name="tracking_permissions_wizard_status_gps_allowed">Enabled</string>
    <string name="tracking_permissions_wizard_status_location_denied">Tap to fix</string>
    <string name="tracking_permissions_wizard_status_background_location_denied">Tap to set Always</string>
    <string name="tracking_permissions_wizard_status_activity_denied">Tap to allow</string>
    <string name="tracking_permissions_wizard_status_battery_denied">Tap to fix</string>
    <string name="tracking_permissions_wizard_status_gps_denied">Tap to turn on</string>
    <string name="tracking_permissions_wizard_status_helper">Tap any item above to finish its setup</string>
    <string name="tracking_permissions_wizard_exit">Skip for now</string>

    <!-- App settings fallback dialog -->
    <string name="tracking_permissions_wizard_settings_dialog_title">Open settings?</string>
    <string name="tracking_permissions_wizard_settings_dialog_body">This permission cannot be requested from the system dialog right now. Open app settings and enable it manually.</string>
    <string name="tracking_permissions_wizard_settings_dialog_positive">Open settings</string>
    <string name="tracking_permissions_wizard_settings_dialog_negative">Not now</string>

    <!-- Full wizard close confirmation -->
    <string name="tracking_permissions_wizard_close_dialog_title">Close wizard?</string>
    <string name="tracking_permissions_wizard_close_dialog_body">Required permissions are not fully enabled yet. Close the wizard anyway?</string>
    <string name="tracking_permissions_wizard_close_dialog_positive">Close</string>
    <string name="tracking_permissions_wizard_close_dialog_negative">Stay</string>
</resources>

Keep the %1$s application-name placeholder in tracking_permissions_wizard_status_body.

Light theme colors

Add color overrides to res/values/colors.xml.

<resources>
    <!-- Screen background gradient -->
    <color name="tracking_permissions_wizard_light_gradient_start">#F6F7F9</color>
    <color name="tracking_permissions_wizard_light_gradient_end">#F6F7F9</color>

    <!-- Main text and controls -->
    <color name="tracking_permissions_wizard_light_title">#211D4F</color>
    <color name="tracking_permissions_wizard_light_body">#4F5C73</color>
    <color name="tracking_permissions_wizard_light_primary">#211D4F</color>
    <color name="tracking_permissions_wizard_light_secondary">#E9EDF4</color>
    <color name="tracking_permissions_wizard_light_button_text">#FFFFFF</color>
    <color name="tracking_permissions_wizard_light_caption">#9AA1AC</color>

    <!-- Cards and instruction hint icon -->
    <color name="tracking_permissions_wizard_light_card">#FFFFFF</color>
    <color name="tracking_permissions_wizard_light_hint_icon_background">#E8F1FF</color>
    <color name="tracking_permissions_wizard_light_hint_icon">#1A73E8</color>

    <!-- Status row title -->
    <color name="tracking_permissions_wizard_status_title_text">#0B0B14</color>
</resources>

Dark theme colors

<resources>
    <!-- Screen background gradient -->
    <color name="tracking_permissions_wizard_dark_gradient_start">#14152A</color>
    <color name="tracking_permissions_wizard_dark_gradient_end">#090A17</color>

    <!-- Main text and controls -->
    <color name="tracking_permissions_wizard_dark_title">#FFFFFF</color>
    <color name="tracking_permissions_wizard_dark_body">#E0E3EA</color>
    <color name="tracking_permissions_wizard_dark_primary">#FFFFFF</color>
    <color name="tracking_permissions_wizard_dark_secondary">#2E3147</color>
    <color name="tracking_permissions_wizard_dark_button_text">#15162D</color>
    <color name="tracking_permissions_wizard_dark_caption">#A7ADBC</color>

    <!-- Cards and instruction hint icon -->
    <color name="tracking_permissions_wizard_dark_card">#25283A</color>
    <color name="tracking_permissions_wizard_dark_hint_icon_background">#263452</color>
    <color name="tracking_permissions_wizard_dark_hint_icon">#8AB4F8</color>

    <!-- Status row title -->
    <color name="tracking_permissions_wizard_dark_status_title_text">#FFFFFF</color>
</resources>

Shared status colors

These colors are used by both Light and Dark themes.

<resources>
    <!-- Status icons and text -->
    <color name="tracking_permissions_wizard_success">#2FBF4E</color>
    <color name="tracking_permissions_wizard_warning">#FF9F0A</color>
    <color name="tracking_permissions_wizard_status_success_text">#2A9D4B</color>
    <color name="tracking_permissions_wizard_status_warning_text">#D98200</color>
    <color name="tracking_permissions_wizard_status_text">#FFFFFF</color>

    <!-- Status row borders -->
    <color name="tracking_permissions_wizard_status_warning_border">#8CF5A623</color>
    <color name="tracking_permissions_wizard_status_success_border">#12211D4F</color>
</resources>

Color roles:

  • gradient_start and gradient_end define the screen background.
  • title, body, and caption control the main text hierarchy.
  • primary, secondary, and button_text control primary actions and supporting controls.
  • card controls cards and dialogs.
  • hint_icon_background and hint_icon control the instruction hint.
  • success, warning, status_*_text, and status_*_border control granted and missing status rows.

Drawables

Override these resources in the host application's res/drawable directory:

Drawable resourceUsed for
ic_tracking_pw_location_outlineForeground location and device location services.
ic_tracking_pw_location_filledBackground location.
ic_tracking_pw_motion_fitnessPhysical Activity.
ic_tracking_pw_batteryBattery optimization.
ic_tracking_pw_status_check_squareHeader icon on the completed/status screen.
ic_tracking_pw_tap_hintTap instruction shown on permission pages.
ic_tracking_pw_chevron_rightNavigation indicator for a missing item on the status screen.
ic_tracking_pw_checkGranted-item indicator on the status screen.
ic_tracking_pw_warningMissing-item indicator on the status screen.

The first four resources are large permission-page images. The remaining resources are smaller instruction and status icons. The wizard applies theme colors as tint, so replacement assets should use a transparent background and a single opaque foreground color. Vector drawables are recommended.

Application name

The SDK uses the host application's app_name resource where an application name is required.

<resources>
    <string name="app_name">Tracking</string>
</resources>

Notification resources

Override these strings to customize the SDK foreground notification and its notification channel.

<resources>
    <string name="tracking_notification_title">Tracking</string>
    <string name="tracking_notification_is_work">Your trip is being scored.</string>
    <string name="tracking_notification_is_not_work">Trip not in progress.</string>
    <string name="tracking_notification_tracking_disabled">Tracking is disabled.</string>
    <string name="tracking_notification_gps_disabled">GPS is disabled. Tap the notification to enable GPS and grant permissions.</string>
    <string name="tracking_notification_location_disabled">Location permission is disabled. Tap the notification to grant permissions.</string>
    <string name="tracking_notification_background_location_disabled">Background location permission is disabled. Tap the notification to grant permissions.</string>
    <string name="tracking_notification_activity_recognition_disabled">Activity recognition permission is disabled. Tap the notification to grant permissions.</string>
    <string name="tracking_notification_battery_optimization_enabled">Battery optimization is enabled. Tap the notification to disable optimization.</string>
    <string name="tracking_notification_power_saving_enabled">Trips may not be recorded while battery saver is enabled.</string>
    <string name="tracking_notification_looking_for_tracks_upload">Waiting for trip upload.</string>
    <string name="tracking_notification_waiting_for_manual_start">Waiting for manual trip start.</string>
    <string name="tracking_notification_processing">Processing…</string>
    <string name="tracking_notification_unknown_state">Tracking status is unavailable.</string>
    <string name="tracking_notification_channel_name">Tracker service</string>
</resources>

Other SDK and legacy wizard strings

The dialog_telematics_ and wizard_telematics_* resources below customize only the deprecated View-based Permissions Wizard. They do not customize the new Compose wizard.

<resources>
    <string name="dialog_telematics_location">Grant Location Permission</string>
    <string name="dialog_telematics_location_background">Grant Background Location Permission</string>
    <string name="dialog_telematics_battery">Enable Background Tracking</string>
    <string name="dialog_telematics_activity_recognition">Enable Activity Recognition</string>
    <string name="dialog_telematics_gps">Enable GPS</string>
    <string name="dialog_telematics_wifi">Enable Wi-Fi</string>
    <string name="dialog_telematics_bluetooth">Enable Bluetooth</string>
    <string name="dialog_telematics_mobile_data">Enable Mobile Data</string>
    <string name="dialog_telematics_data_turn_on">Enable Telematics Data</string>
    <string name="dialog_telematics_data_desc">To collect accurate data and operate correctly, the app needs access to the following features:</string>
    <string name="dialog_telematics_notifications">Enable Notifications</string>
    <string name="dialog_telematics_notification_channel">Enable Notification Channel</string>

    <string name="dialog_telematics_permission_denied">Permission Denied</string>
    <string name="dialog_telematics_notification_channel_disabled">Notification Channel Disabled</string>
    <string name="dialog_telematics_settings">Settings</string>
    <string name="dialog_telematics_not_now">Not Now</string>
    <string name="dialog_telematics_instructions_permission">This required permission has not been granted. To score trips, all required permissions must be accepted. Open app settings and grant this permission.</string>
    <string name="dialog_telematics_instructions_notification_channel">The required \"Tracker service\" notification channel is disabled. To score trips, this channel must be enabled. Open app settings and enable this channel.</string>

    <string name="wizard_telematics_attention">Attention Required</string>

    <!-- Wizard storage section -->
    <string name="wizard_telematics_storage_desc">Next, you will see a prompt to allow access to <b>phone storage</b> so the app can temporarily store trip data.\n\n
        Select <b>Allow</b> in the next prompt.
    </string>
    <string name="wizard_telematics_attention_dialog_storage_before">Allow</string>
    <string name="wizard_telematics_attention_dialog_storage_after">to\naccess photos, media,\nand files on your\ndevice?</string>

    <!-- Wizard location section -->
    <string name="wizard_telematics_location_desc">Next, you will see a prompt to grant <b>location</b> permission.\n\n
        The app uses your location data to automatically record trips in the background, determine when trips start and end, and calculate your driving score.\n\n
        The app will not work without this permission.\n\n
        Select <b>Allow</b> in the next prompt.
    </string>

    <string name="wizard_telematics_background_location_desc">
        Next, grant <b>background location</b> access.\n\n
        The app uses your location data to automatically record trips in the background, determine when trips start and end, and calculate your driving score.\n\n
        The app will not work without this permission.\n\n
        Open app settings and select <b>Allow all the time</b> on the location permission screen.</string>

    <!-- Android 11 only -->
    <string name="wizard_telematics_location_additional_description"><small>This app needs access to your location all the time, even when you\'re not using it. <font color="#a7c7f9"><u>Allow in settings.</u></font></small></string>

    <string name="wizard_telematics_attention_dialog_location_before">Allow</string>
    <string name="wizard_telematics_attention_dialog_location_after">to\naccess this device\'s location?</string>

    <string name="wizard_telematics_attention_dialog_background_location_before">Change location access for </string>
    <string name="wizard_telematics_attention_dialog_background_location_after">\?</string>

    <string name="wizard_telematics_location_additional_keep">Keep \'While using the app\'</string>


    <!-- Wizard activity recognition section -->
    <string name="wizard_telematics_activity_recognition_desc">Next, you will see a prompt to grant access to your <b>physical activity</b>.\n\n
        The app uses this information to calculate your driving score.\n\n
        Select <b>Allow</b> in the next prompt.
    </string>
    <string name="wizard_telematics_attention_dialog_activity_recognition_before">Allow</string>
    <string name="wizard_telematics_attention_dialog_activity_recognition_after">to\naccess your physical activity?</string>

    <!-- Wizard gps services section -->
    <string name="wizard_telematics_gps_google_desc">Next, you will see a prompt to turn on <b>device location</b>, which uses Google\'s location service.\n\n
        Select <b>OK</b> for the app to work correctly.
    </string>
    <string name="wizard_telematics_attention_dialog_gps_google">For a better experience, turn on device location, which uses Google\'s location service.</string>
    <string name="dialog_telematics_attention_dialog_gps_google_ok">OK</string>
    <string name="dialog_telematics_attention_dialog_gps_google_no">No, thanks</string>

    <!-- Wizard background/battery section -->
    <string name="wizard_telematics_ignore_system_battery_optimization_desc">Next, you will see a prompt to ignore <b>battery optimizations</b>.\n\n
        Select <b>ALLOW</b> for the app to work correctly.
    </string>
    <string name="wizard_telematics_attention_dialog_battery"><small><b>Let the app always run in the background?</b>\n\nAllowing the app to always run in the\nbackground may reduce battery life.\n\nYou can change this later in\nSettings > Apps &amp; notifications.</small></string>
    <string name="dialog_telematics_attention_dialog_battery_ok">ALLOW</string>
    <string name="dialog_telematics_attention_dialog_battery_no">DENY</string>

    <!-- Wizard manufacturers power management section -->
    <string name="wizard_telematics_extra_power_management_desc">Tap <b>Proceed</b> to open settings and configure <b>power management</b>.\n
    Disable power management for the app to work correctly.
    </string>

    <!-- Wizard mi autostart section -->
    <string name="wizard_telematics_extra_autostart_desc">Tap <b>Proceed</b> to open settings and configure <b>autostart</b>.\n
    Enable autostart for the app to work correctly.</string>

    <!-- Wizard mi notifications section -->
    <string name="wizard_telematics_extra_notifications_desc">Tap <b>Proceed</b> to open settings and configure <b>notifications</b>.\n
    Enable all notifications for the app to work correctly.</string>

    <string name="wizard_telematics_show_request">Proceed</string>
    <string name="wizard_telematics_deny">Deny</string>
    <string name="wizard_telematics_do_not_allow">Don\'t allow</string>
    <string name="wizard_telematics_allow">Allow</string>
    <string name="wizard_telematics_allow_all_time">Allow all the time</string>
    <string name="wizard_telematics_allow_while_using">Allow only while using the app</string>
    <string name="wizard_telematics_step" formatted="false">Step %1s of %2s</string>
    <string name="wizard_telematics_please_grant">Please grant all required permissions.</string>

    <!-- Android 11 -->
    <string name="wizard_telematics_while_using_11">While using the app</string>
    <string name="wizard_telematics_only_this_time">Only this time</string>
    <string name="wizard_telematics_ask_every_time">Ask every time</string>

    <!-- Synchronization -->
    <string name="sync_notification_body">Data is being synchronized.</string>

    <string name="change_to_precise_location">Change to precise location</string>

    <string name="wizard_telematics_location_desc_precise">Next, you will see a prompt to grant app access to <b>location services</b>.\n\n
        The app uses your location data to automatically record trips in the background, determine when trips start and end, and calculate your driving score.\n\n
        The app will not work without this permission.\n\n
        Select <b>Change to precise location</b> in the next prompt.
    </string>

    <string name="wizard_telematics_bluetooth_desc">Next, you will see a prompt to grant access to <b>Bluetooth</b>.\n\n
        Select <b>Allow</b> in the next prompt.
    </string>

    <string name="wizard_telematics_attention_dialog_bluetooth_before">Allow</string>
    <string name="wizard_telematics_attention_dialog_bluetooth_after">to find, connect to, and determine the relative position of nearby devices?</string>

</resources>

values-v29

<resources>
    <string name="wizard_telematics_location_desc">Next, you will see a prompt to grant <b>location</b> permission.\n\n
        The app uses your location data to automatically record trips in the background, determine when trips start and end, and calculate your driving score.\n\n
        The app will not work without this permission.\n\n
        Select <b>Allow all the time</b> in the next prompt.
    </string>

    <string name="wizard_telematics_attention_dialog_storage_after">to access photos, media, and files on your device?</string>
    <string name="wizard_telematics_attention_dialog_location_after">to access this device\'s location?</string>
    <string name="wizard_telematics_attention_dialog_activity_recognition_after">to access your physical activity?</string>
</resources>

values-v30

<resources>
    <string name="wizard_telematics_location_desc">Next, you will see a prompt to grant app access to <b>location services</b>.\n\n
        The app uses your location data to automatically record trips in the background, determine when trips start and end, and calculate your driving score.\n\n
        The app will not work without this permission.\n\n
        Select <b>While using the app</b> in the next prompt.
    </string>
</resources>

values-v31

<resources>

    <string name="wizard_telematics_attention_dialog_background_location_before">Allow </string>
    <string name="wizard_telematics_attention_dialog_background_location_after">to access this device\'s location?</string>

    <string name="wizard_telematics_location_desc">Next, you will see a prompt to grant app access to <b>location services</b>.\n\n
        The app uses your location data to automatically record trips in the background, determine when trips start and end, and calculate your driving score.\n\n
        The app will not work without this permission.\n\n
        Select <b>Precise</b> and <b>While using the app</b> in the next prompt.
    </string>

</resources>


Did this page help you?