Developer

Older Releases

Important note:

The TomTom Digital Cockpit SDK is not available for general use. Please contact us for more information.

Release 1.0.7312-4099 - 23 May 2024, 05:50

Release notes

  • Added a configuration to allow filtering of contacts and recent calls.

API References

Compatibility reports

Security reports

Release 1.0.7303-4092 - 21 May 2024, 13:04

Release notes

  • In the bug report stack trace, we can see that TTDC's GuidanceFragment onCreate first calls super.onCreate, leading to a crash since NavApp's NextInstructionPanelFragment cannot be instantiated. The reason for that is that at that point the fragment factory for it has not been added yet.

API References

Compatibility reports

Security reports

Release 1.0.7287-4077 - 14 May 2024, 13:10

Release notes

  • AnyIviServiceBase is marked as deprecated. Use IviServiceBase instead.

API References

Compatibility reports

Security reports

Release 1.0.7264-4057 - 03 May 2024, 13:51

Release notes

API References

Compatibility reports

Security reports

Release 1.0.7251-4043 - 01 May 2024, 08:48

Release notes

  • Fix for phone number formatting.

API References

Compatibility reports

Security reports

Release 1.0.7168-3986 - 10 Apr 2024, 23:55

Release notes

  • Gradle updated to 8.7.
    • This release has embedded Kotlin version 1.9.22, which is a dependency for TTDC SDK gradleplugins.

API References

Compatibility reports

Release 1.0.7027-3878 - 14 Mar 2024, 18:05

Release notes

API References

Compatibility reports

Release 1.0.7006-3862 - 13 Mar 2024, 05:53

Release notes

  • Allow to disable low-resolution artwork upscaling to avoid pixelized images. Can be used for Bluetooth artwork.
    • Add a new isArtworkUpscalingSupported property in media SourceDefinitionPolicy to disable upscaling artwork per source.
    • Add a new isArtworkUpscalingSupported property in MediaPlaybackViewModel.
    • Add a new media static configuration forceUpscaleArtworkConfigKey to force upscaling the artwork for all the sources. This should be set to false to use the source policy isArtworkUpscalingSupported property instead.

API References

Compatibility reports

Release 1.0.6982-3841 - 07 Mar 2024, 05:48

Release notes

API References

Compatibility reports

Release 1.0.6910-3780 - 22 Feb 2024, 09:47

Release notes

  • Fix the calculated text height for the input phone number in Dial Pad is incorrect. The text can be cut-off when the custom text size is too small.

API References

Compatibility reports

Release 1.0.6886-3763 - 17 Feb 2024, 06:10

Release notes

  • Custom NavApp Color theme is not applied correctly. Due to the IDs used to match theme stylables do not match, the custom theme style resource is applied before the stock navapp color theme. Hence the custom NavApp color theme never works. With the fix, only the custom NavApp color style resource presents in the style resources.

API References

Compatibility reports

Release 1.0.6878-3759 - 16 Feb 2024, 05:48

Release notes

  • Adding documentation on mocking the availability of BluetoothConnectivityService.

API References

Compatibility reports

Release 1.0.6872-3751 - 14 Feb 2024, 05:49

Release notes

  • Added VehicleHvacService.cabinTargetTemperature: Temperature, and its setter VehicleHvacService.setCabinTargetTemperature(zone: VehicleZone<SeatArea>, temperature: Temperature),  to allow better unit conversions using com.tomtom.tools.android.api.quantity.Temperature.
    • The original property VehicleHvacService.cabinTargetTemperatureCelsius: Float and its setter VehicleHvacService.setCabinTargetTemperature(zone: VehicleZone<SetArea>, temperature: Float) have both been deprecated.

API References

Compatibility reports

Release 1.0.6853-3737 - 08 Feb 2024, 06:46

Release notes

  • Remove scaleType from ImageView. The source image for ProcessPanel header image keeps its aspect ration, instead of cropping.

API References

Compatibility reports

Release 1.0.6843-3728 - 07 Feb 2024, 06:43

Release notes

  • Add com.tomtom.ivi.platform.navappcomponents.api.common.util.NavAppResourceExtractor to make it easy to specify a custom keystore and base map to the application. Just add to the assets a map.zip containing a map, and a keystore.zip with that map's keystore file, and they will be made available on first run to the navigation engine.

API References

Compatibility reports

Release 1.0.6819-3709 - 30 Jan 2024, 06:07

Release notes

  • In this release, we have upgraded the Android Gradle Plugin to version 8.2.1. Please note that this plugin requires a minimum Gradle version of 8.2. If your project is currently using an older version of Gradle, you will need to update it accordingly. This improvement aims to enhance your development experience with the latest features and optimizations. Do ensure to verify compatibility with your project dependencies for a seamless transition.
    • Also note, that the Android Gradle Plugin 8.2.1 requires at least Android Studio Hedgehog (2023.1.1) or higher.

API References

Compatibility reports

Release 1.0.6815-3704 - 27 Jan 2024, 06:02

Release notes

  • Add support to mark properties, functions, event interfaces, and event interface functions of IVI services as deprecated with the @Deprecated annotation.
  • Add a new VehiclePowerStateService interface.

API References

Compatibility reports

Release 1.0.6790-3687 - 23 Jan 2024, 05:55

Release notes

  • Removed visual cues feature. The following modules are no longer available: appsuite_navigation_api_common_visualcuesattributes, appsuite_navigation_api_service_visualcues, appsuite_navigation_api_service_visualcuessettings, appsuite_navigation_api_theming_themepreview, appsuite_navigation_api_theming_visualcuesstock, appsuite_navigation_plugin_frontend_visualcues, appsuite_navigation_plugin_frontendextension_visualcuesdebugtab, appsuite_navigation_plugin_service_visualcues, appsuite_navigation_plugin_service_visualcuessettings.
  • Android Compile SDK updated to 34.

API References

Compatibility reports

Release 1.0.6781-3681 - 20 Jan 2024, 05:48

Release notes

  • Update Alexa locales even when Alexa engines have not been started yet.
  • Greatly reduced the time between launching the application and showing the splash screen.
    • Modified error reporter service API to accept extra attributes to add custom details to error reports: added 
    • addErrorReportInformation(info: Map<String, String>) to com.tomtom.ivi.platform.errorreporter.api.service.errorreporter.ErrorReporterService.
    • Also modified Bugsee configuration API to accept extra attributes: added
    • com.tomtom.ivi.appsuite.bugsee.api.common.config.ErrorReporterConfig.addCustomAttributes()
  • Moved package com.tomtom.ivi.platform.localization.api.common.settings. Functions setClockTimeFormat getClockTimeFormat and enum TimeFormat for timekeeping format configuration, and method setSystemLocale to change locales, have all been moved to the existing com.tomtom.ivi.platform.localization.api.service.settings.LocalizationSettingsService. The extension function Context.restartActivity was removed.

API References

Compatibility reports

Release 1.0.6778-3676 - 19 Jan 2024, 05:42

Release notes

  • Android Gradle Plugin updated to 8.1.2. Version of AGP is published with version catalog. If client app uses version of AGP from TTDC's version catalog it might be a breaking change, as some of Android Gradle Plugin APIs has breaking changes. Please refer to Google documentation on how to proceed with AGP update.

API References

Compatibility reports

Release 1.0.6733-3635 - 06 Jan 2024, 06:36

Release notes

  • Alexa: Improved the way of starting and stopping the AACS (Alexa Auto Client Service) to enhance robustness and reduce susceptibility to bugs.
    • Additionally, introduced a backup mechanism to automatically restart AACS if some components are not configured properly.

API References

Compatibility reports

Release 1.0.6719-3625 - 03 Jan 2024, 13:55

Release notes

  • Improved documentation about how the IVI configuration framework can be used to customize how to manage upgrades of settings from IVI setting services.
  • Communications: Added a user setting that can be used to ignore messages from unknown senders.

API References

Compatibility reports

Release 1.0.6708-3616 - 29 Dec 2023, 06:36

Release notes

  • TTDC is migrated to JFrog Artifactory Gradle plugin 5.1.12 (from 4.x).
    • Major version upgrade for JFrog Gradle plugin, which brings DSL improvements and support of Gradle configuration cache. Note, API changes are breaking.
    • TTDC publishes version catalog with version of the plugin it uses as jfrogArtifactory, and library of the plugin implementation as gradlePluginArtifactory.
    • If your project uses the JFrog Artifactory Gradle plugin version from TTDC's published version catalog, this upgrade becomes a breaking change for your project as well.
    • For more information, please refer to the release notes: https://github.com/jfrog/artifactory-gradle-plugin/releases

API References

Compatibility reports

Release 1.0.6696-3602 - 22 Dec 2023, 13:39

Release notes

  • kotlinx-coroutines library patch upgrade 1.7.3

API References

Compatibility reports

Release 1.0.6677-3590 - 20 Dec 2023, 06:31

Release notes

  • Fixed turning off the Bluetooth adapter when the platform shuts down.

API References

Compatibility reports

Release 1.0.6664-3580 - 16 Dec 2023, 06:30

Release notes

API References

Compatibility reports

Release 1.0.6631-3557 - 11 Dec 2023, 16:58

Release notes

  • Fixed Bluetooth control bar icon visibility and Bluetooth service availability when starting TTDC with Bluetooth adapter turned off.
  • The HVAC icons have been updated to use tt_surface_content_color_emphasis_high so that they will get the correct themed color when used in a notification. When these icons are also used in the control center, one has to apply tinting attributes to use control center colors, such as ttivi_controlcenter_content_color_emphasis_high.

API References

Compatibility reports

Release 1.0.6614-3541 - 07 Dec 2023, 06:32

Release notes

API References

Compatibility reports

Release 1.0.6605-3534 - 06 Dec 2023, 11:11

Release notes

  • Show an empty state to the dialpad when Bluetooth profile for calling is disabled/disconnected on platform side.

API References

Compatibility reports

Release 1.0.6520-3498 - 19 Nov 2023, 12:28

Release notes

  • Changing the artwork size in the now playing view panel in the media app due to Bluetooth image size limitation.

API References

Compatibility reports

Release 1.0.6504-3487 - 16 Nov 2023, 09:06

Release notes

  • Added the possibility to include waypoints in the intents used automate the triggering of trip planning
    •  

API References

Compatibility reports

Release 1.0.6473-3468 - 08 Nov 2023, 08:15

Release notes

  • The default notification fragment has become adaptive. It will change to the new 'wide' configuration when its width is greater than the ttivi_notification_breakpoint_width attribute.

API References

Compatibility reports

Release 1.0.6434-3450 - 30 Oct 2023, 21:52

Release notes

  • Communications: Fixed animation glitches of spinners shown in the contacts panels.
  • Communication tabs: Show the relevant empty state when phone book contact synchronization is not enabled.
  • Upgrade Kotlin to 1.9.10.
  • Communications: Show an animated spinner while the phone book is getting synchronized.
  • Upgrade Gradle to 8.4. The Kotlin version embedded in Gradle has been updated to Kotlin 1.9.10. This means that Gradle plugins offered by TTDC SDK are build with Kotlin 1.9.10.

API References

Compatibility reports

Release 1.0.6336-3423 - 12 Oct 2023, 21:59

Release notes

API References

Compatibility reports

Release 1.0.6303-3400 - 09 Oct 2023, 15:36

Release notes

  • Communications: Fix the dialpad layout issue in landscape mode when the UI scaling factor is 1.0.
  • Communications: fixed phonebook synchronisation status.
  • Communications: Fix the dialpad layout when making a call in portrait mode.

API References

Compatibility reports

Release 1.0.6239-3372 - 27 Sep 2023, 13:47

Release notes

  • Communications: Add a configurable timeout for phonebook synchronization stalled.
  • Communications: Show information about the fact that phonebook synchronization is in progress.

API References

Compatibility reports

Release 1.0.6195-3339 - 19 Sep 2023, 08:50

Release notes

  • Communications: Added new status to PhonebookSynchronizationHelper to reflect the fact that synchronisation is in progress.
  • Communications: Fixed an issue that the recent calls were not always shown in combination with a large amount of contacts.
  • API Compatibility reports for Android Tools are now available in the Release Notes section.
  • Switched all modules to non-transitive resources, as recommended by the Google Android team, to achieve better performance of assembling the project.
    • This requires developers to manually import resources from the package those are located in. It applies to Java and Kotlin source files, and also to XML layouts.
    • For example, to access R.attr.tt_surface_content_color_emphasis_high, it is now necessary to import com.tomtom.tools.android.core.theme.R (and it is recommended to use import aliases to be able to import resources from different packages at the same time).
  • Remove deprecated API: RemoteDrawable and RemoteDrawableResolver

API References

Compatibility reports

Release 1.0.6166-3321 - 14 Sep 2023, 16:24

Release notes

  • Communications: Fix for the call notification panel shown twice for one call.

API References

Compatibility reports

Release 1.0.6081-3283 - 31 Aug 2023, 11:56

Release notes

  • Migration to Android Gradle Plugin 8.0.2. Dependent project must also migrate to AGP 8.0.+. This brings many breaking changes. For the migration instructions see release notes.

API References

Compatibility reports

Release 1.0.6037-3260 - 23 Aug 2023, 07:28

Release notes

  • Style attribute ttivi_systemui_taskpanel_topbar_height is renamed to ttivi_taskpanel_topbar_height.

API References

Compatibility reports

Release 1.0.6030-3256 - 21 Aug 2023, 17:44

Release notes

API References

Compatibility reports

Release 1.0.5937-3175 - 02 Aug 2023, 06:30

Release notes

  • ttivi_mapdisplay_placeholder_color is moved to TTDC.platformNavappcomponentsApiCommonAttributes
  • Extended BluetoothConnectivityStatus with connectedProfilesthe list of the connected Bluetooth profiles provided by the remote Bluetooth device.

API References

Compatibility reports

Release 1.0.5925-3165 - 27 Jul 2023, 07:40

Release notes

  • The media configuration useTextForCollectionPlayPauseButtonConfigKey is now set to false by default.

API References

Compatibility reports

Release 1.0.5918-3157 - 25 Jul 2023, 13:47

Release notes

  • Include generated source code files of the configuration keys to the published artifacts.

API References

Compatibility reports

Release 1.0.5915-3155 - 25 Jul 2023, 06:26

Release notes

  • Added the CameraModeOverrideFrontendExtension API that allows to override the map camera mode for the MapDisplayFrontend.

API References

Compatibility reports

Release 1.0.5890-3138 - 20 Jul 2023, 08:16

Release notes

  • Enable flavorized publication of modules to support different navigation engines. Because of this, it is now needed on the integrator side to specify which flavor to use. This can be achieved with this code snippet in your main build.gradle.kts file.

API References

Compatibility reports

Release 1.0.5876-3125 - 18 Jul 2023, 14:14

Release notes

  • Update KotlinX Coroutines library version to 1.7.2

API References

Compatibility reports

Release 1.0.5864-3119 - 17 Jul 2023, 15:19

Release notes

  • Navappcomponents specific styles are moved from libraries.platformThemingApiStockTheme to libraries.platformNavappcomponentsApiThemingStock.
  • The source logo is shown at the top right corner of the media mini-player. The media static configuration  hasMiniPlayerSourceLogoConfigKey can be used to not show the source logo.

API References

Compatibility reports

Release 1.0.5824-3080 - 05 Jul 2023, 14:49

Release notes

  • Fix media search field is not locked when isTextInputRestrictedBySafetyLockConfigKey is false.

API References

Compatibility reports

Release 1.0.5805-3067 - 01 Jul 2023, 17:05

Release notes

  • Fix the negative remaining time shown at the end of the song in the media application.
  • MediaControl drawable property is now nullable.
  • Contact search is allowed when safety lock is enabled and text input restriction configuration is disabled.
  • Added a configuration to the communications frontend to allow pairing a Bluetooth device when safety lock is enabled.
  • Testing tools API changes:
    • Removed platform_tools_api_testing_lifecycle module, mockObserverFor moved to com.tomtom.ivi.platform.tools.api.testing.unit and marked as IviTestInternal.
    • Removed platform_tools_api_testing_shadow module.
    • platform_tools_api_testing_viewcomparison marked as IviTestInternal.

API References

Compatibility reports

Release 1.0.5789-3052 - 27 Jun 2023, 18:13

Release notes

  • Test API changes:
    • New IviTestInternal annotation.
    • Removed TestCaseBase and platform_tools_api_testing_testcase.
    • Marked IviTestCase, CoroutineTestRule and TestScope.advanceTimeBy as IviTestInternal.
    • Made CustomSdkRobolectricGlobalConfigProvider, LoggingTestWatcher and MockkRetryTestRule not public.
    • Remove com.tomtom.ivi.platform.tools.api.testing.unit.iviServiceFunResult extension functions.
  • Gradle plugin com.tomtom.ivi.platform.tools.version is decommissioned.

API References

Compatibility reports

Release 1.0.5774-3039 - 24 Jun 2023, 07:09

Release notes

  • Updated the Java JVM used for building artifacts to JDK 17.
  • Update androidx.lifecycle dependency to v2.6.1

API References

Compatibility reports

Release 1.0.5747-3017 - 20 Jun 2023, 07:00

Release notes

  • TomTom Digital Cockpit SDK is now built on JDK 17 instead of JDK 11. Please see Develop with the SDK for more instructions.
  • Initialize recent connected devices when BluetoothAdapter is turned ON.
  • Align the top of the navigation panel and settings button.

API References

Compatibility reports

Release 1.0.5727-3005 - 16 Jun 2023, 12:36

Release notes

  • Media API changes:
    • SourceClient.setErrorCallback is replaced by mediaErrors Flow, which returns a new MediaError sealed class hierarchy. ErrorCallback class is removed, also removed errorCallback property from MediaFrontendContext.
    • All public methods of the SourceClient hierarchy are marked to be called on @MainThread.
    • Add mediaErrors to MediaTaskPanel.
    • Removed Options.mediaCoroutineDispatcher

API References

Compatibility reports

Release 1.0.5715-2999 - 14 Jun 2023, 18:48

Release notes

  • TomTom Digital Cockpit SDK artifacts are now also available on Artifactory Edge Node, next to Nexus. Nexus will be decommissioned by the end of September. If you are currently evaluating TomTom Digital Cockpit, we will contact you about migration to Artifactory Edge Node.

API References

Compatibility reports

Release 1.0.5666-2967 - 09 Jun 2023, 07:54

Release notes

  • Update androidx.appcompat to version 1.6.1

API References

Release 1.0.5648-2961 - 08 Jun 2023, 06:54

Release notes

  • Fix the switch to the media Bluetooth source from an already playing source.

API References

Release 1.0.5610-2939 - 01 Jun 2023, 18:49

Release notes

  • Fix to allow Bluetooth pairing while SafetyLock is on.
  • Digital Cockpit SDK upgraded to Android SDK 32 (Android 12L), and new emulators are available. Have a look at Run the Application on an Emulator track to install new emulator images.
    • An emulator image for ARM64 CPU architectures is available now as well, next to the x86_64 emulator image that we already supported.

API References

Release 1.0.5594-2927 - 30 May 2023, 07:48

Release notes

  • Update Fragment libraries to version 1.5.7
  • Fix for the contacts scrollbar position when the fragment has been re-created.

API References

Release 1.0.5577-2918 - 25 May 2023, 13:27

Release notes

  • Add a new useStickyHeaderForCollectionListConfigKey media static configuration.

API References

Release 1.0.5552-2905 - 19 May 2023, 10:24

Release notes

  • API change: constructor of PanelContainerViewModelStore changed from public to internal.
  • API changes:
    • Added AacsMessage:
    • Removed AlexaMessageData.kt
    • Added AacsMessageBuildHelpers.kt
    • Changes to AacsSenderWrapper:
    • Updated sendMessage()
    • Removed sendRequestWithNoPayload()use the new sendMessage() instead
    • Added sendReplyMessage().
    • Changes to AlexaHandlerService:
    • Updated onMessageReceived().

API References

Release 1.0.5522-2888 - 12 May 2023, 11:44

Release notes

  • Fixing media artwork is not reset when switching from existing artwork to a placeholder artwork. Tint color and background image are now reset.
    • Removing placeholder resource @drawable/ttivi_media_mediacontrol_icon_artwork_placeholder and keep only
    • @drawable/ttivi_media_icon_noalbumcover resource for placeholder.

API References

Release 1.0.5516-2885 - 11 May 2023, 14:10

Release notes

  • Add a ttCrossFadingDurationMs BindingAdapter to ImageView for a cross-fading transition.
  • Add a Drawable extension function getBrightnessAdjustedDominantColor to extract the dominant color.
  • Deprecated Activity.onBackPressed() is replaced with Activity.onBackPressedDispatcher.
  • Communications: Don't close contact list panel on outgoing call.

API References

Release 1.0.5474-2860 - 08 May 2023, 07:46

Release notes

API References

Release 1.0.5401-2816 - 24 Apr 2023, 08:46

Release notes

  • Moving MediaDashboardPanelBase under the panels package and adding MiniPlayerMainProcessPanelBase, NowPlayingTaskProcessPanelBase and ExpandedNowPlayingPanelBase to allow fragment replacement.

API References

Release 1.0.5387-2807 - 21 Apr 2023, 09:36

Release notes

  • SonarQube Gradle plugin version is upgraded to "4.0.0.2929" in published versions catalog (in the artifact  "dependencies-catalog").
  • Expose the layout height of the dialpad input, allowing customising the text box size.

API References

Release 1.0.5341-2784 - 17 Apr 2023, 13:46

Release notes

  • Updated ByteBuddy library dependency from v1.14.2 to v.1.14.4

API References

Release 1.0.5329-2779 - 14 Apr 2023, 06:54

Release notes

  • Moved the com.example.ivi.example keystore files from keystore to resources/keystore.
  • Communications: RecentCallsService.recentCalls has been replaced by a IviDataSource to support paging.

API References

Release 1.0.5293-2758 - 06 Apr 2023, 19:41

Release notes

  • Reduce the time that Android Studio needs for importing the SDK project.

API References

Release 1.0.5286-2756 - 05 Apr 2023, 22:51

Release notes

  • Upgrade ThreeTen Android Backport to 1.4.6. This upgrade includes time zone data 2023c(gtz).
  • Moved the privapp-permissions-tomtom-ivi.xml file from permissions to resources/permissions.
  • Replace the media attribute ttivi_media_breakpoint_width_large_minimum with ttivi_media_breakpoint_width_wide_minimum, ttivi_media_breakpoint_height_tall_minimum for switching between media horizontal and vertical layout.
  • Media API changes:
    • New public SourcePickerView component to implement custom media dashboard.
    • New theme attributes ttivi_mediasourcepicker_style and ttivi_mediasourcepickerlist_style, which by default set to TtiviMediaSourcePicker and TtiviMediaSourcePickerList. To customize the new SourcePickerView.
    • ttivi_media_player_dashboard_item_spacing renamed to ttivi_media_sourcepicker_item_spacing.

API References

Release 1.0.5256-2725 - 29 Mar 2023, 09:51

Release notes

  • The devices.xml file has moved to resources/emulator.
  • Communications: Back button removed from bluetooth discovery modal panel.

API References

Release 1.0.5242-2710 - 27 Mar 2023, 09:08

Release notes

  • Media API changes:
    • IntentUserFlow returns UserFlowResult and does not take lifecycleOwner and onCompletedCallback.
    • RenamedMediaFrontendContext.Panels to MediaFrontendContext.MediaFrontendNavigation
    • In the MediaFrontendNavigation:
    • Removed openActivityPanel and replaced it with openSource and openSettings.
    • Renamed backToDashboard to goBackToSourceSelection.
    • openExpandedNowPlayingPanel does not take transitionSource.
  • Communications: safety lock switch is handled in contacts search.
  • Icon used for browsable content in the media app has been updated to match the rest of the applications.
  • Communications: Prevent flickering of contact images in process panel and notifications.

API References

Release 1.0.5189-2678 - 18 Mar 2023, 07:22

Release notes

  • Localization API:
    • Introduced API which allows to switch vehicle HVAC temperature display units between Celsius, Fahrenheit and Kelvin.
  • Communications: Add static configuration key suppressCallTaskProcessPanelConfigKey.

API References

Release 1.0.5180-2669 - 17 Mar 2023, 08:49

Release notes

  • Android Gradle Plugin update to version 7.4.2 (from 7.4.1).
  • Renaming TtiviApptileView method ttTextMargin to ttTextMarginTop and adding support for ttTextMarginStart and ttTextMarginEnd.
  • Localization API:
    • Introduced an API that allows switching vehicle distance display units between Miles, Kilometers, Meters, and Millimeters.
  • New API ActiveRouteInformationService.upcomingPlannedChargingStopInfo is available (in experimental form). Used to obtain information about a planned electric vehicle charging stop.
  • Panel sub-containers that require dynamic enter and exit animations can set a SubContainerAnimationProvider.
    • For the TaskPanelStackContainer the extendable stock TaskPanelSubContainerAnimationProvider is available that simplifies creating a sub-container animation provider that differs only on specific points from the stock animation provider.
  • Communications: Add a horizontal layout for the dial pad when the screen does not have enough height to fit the vertical layout.

API References

Release 1.0.5107-2615 - 07 Mar 2023, 07:38

Release notes

  • Restructured the Getting Started section on the Developer Portal.
  • Move DismissalState from platform.systemui.api.common.systemuihost to platform.frontend.api.common.frontend.panels.
    • Changed GenericDismissablePanel.isBeingDismissed: LiveData<Boolean> to dismissalState: LiveData<DismissalState>.
    • Added a GenericPanel.requestsRemoval field. A Frontend will remove a panel that requests to be removed.

API References

Release 1.0.5091-2604 - 03 Mar 2023, 16:14

Release notes

  • Transitive third-party dependencies from TomTom Android Tools libraries were declared as API dependencies. It is now fixed and properly declared as implementation dependencies. With this change, client code could still be relying on implicitly included dependencies and may now not compile. To fix this you need to add explicit Gradle dependencies for the libraries you use in your code.
  • Fix a crash in recent calls.
  • Provide TtiviAppTileView customization API.
  • Communications: SMS content can now be played on all platforms by using TTS engine.
  • Removal of obsolete resources ttivi_applauncher_apptile_highlight_color_top, ttivi_applauncher_apptile_highlight_color_bottom, ttivi_applauncher_apptile_vertical_inset, ttivi_applauncher_downloadapps_button_width

API References

Release 1.0.5076-2593 - 28 Feb 2023, 06:43

Release notes

  • Communications: Connect the empty state to the safety lock service. Disabling pairing a phone when in safety lock.
  • A new MediaDashboardPanelBase is available to allow its fragment replacement using CustomFragmentRule.
  • Media CollectionPolicy: successful results of browser actions returned by getFollowCollectionAction and getUnfollowCollectionAction may now contain a message to be displayed to a user.
  • Fixed some issues with TtiviActivityView on Android 12:
    • Keyboard input occasionally not reaching an EditText in the virtual display.
    • Removed launch animation.
    • Brief display of map's surfaceView when closing the TtiviActivityView.
    • Long delay when last activity in the task stack is removed.
    • Task stack listener is not unregistered when closing activityview.

API References

Release 1.0.5057-2578 - 24 Feb 2023, 09:56

Release notes

  • Communications: Relative time of recent calls is updated when frontend remains visible.

API References

Release 1.0.5039-2566 - 22 Feb 2023, 06:48

Release notes

  • Communications: Close search panel when dialpad is selected from main process panel.
  • CompositeStringResolver: Add support for embedded FlowStringResolvers
  • MenuService.showMenuItemCaptions is replaced by MenuService.menuItemLabelVisibility, which now has three states rather than the two boolean values.
    • MenuService.toggleLabelVisibility is replaced by MenuService.setLabelVisibility
    • The visibility of the menu item labels can be set to VISIBLE, GONE and ADAPTIVE, where VISIBLE matches the previous value true and GONE the previous value false. The value ADAPTIVE can be used to indicate the layout that it should use its default, which may behave adaptive depending on for instance available screen size.

API References

Release 1.0.5020-2552 - 18 Feb 2023, 06:49

Release notes

  • New platform debug tabs; Contacts and Recent Calls. Removed appsuite Communications debug tab.

API References

Release 1.0.5012-2546 - 16 Feb 2023, 23:28

Release notes

  • Support iHeartRadio followPlaylistRadio action. The minimum version supported for iHeartRadio is now 10.8.0.

API References

Release 1.0.4994-2534 - 16 Feb 2023, 06:43

Release notes

  • Additions to Media test API: Add thatIsEmptyState and waitForDisplayedEmptyState BrowsingInteractions.
  • New string resolver: FlowStringResolver. A self updating string resolver.

API References

Release 1.0.4980-2520 - 14 Feb 2023, 06:55

Release notes

  • Communications: Move dial pad button's secondary text (e.g. + ) next to primary text.
  • Communications: Add themable styles for the Dial Pad.

API References

Release 1.0.4970-2513 - 13 Feb 2023, 13:06

Release notes

  • Platform Upgrade:
    • Android Gradle Plugin updated from 7.3.1 to 7.4.1.
  • Platform upgrade:
    • Updated Kotlin version from 1.7.21 to 1.8.10

API References

Release 1.0.4957-2505 - 09 Feb 2023, 14:52

Release notes

  • Fix notification panel re-attachment after an Android configuration change. This fixes a crash when the RecyclerView item view is reused for another notification later.
  • Communications: Non-alphabetic contact names are now shown as part of the last section of the contacts list.
  • applicationContext field is added to FrontendContext.
  • Renaming testing API PlaylistPanelInteractions to CollectionPanelInteractions:
    • thatIsPlaylistContainer to thatIsCollectionContainer
    • thatIsPlaylistPanelTogglePlayButton to thatIsCollectionPanelTogglePlayButton
    • tapPlaylistPanelTogglePlay to tapCollectionPanelTogglePlay
    • waitForDisplayedPlaylistPanel to waitForDisplayedCollectionPanel
    • waitForPlaylistPanelPlaybackControl to waitForCollectionPanelPlaybackControl
  • Fixed the problem when rotating the screen leads to contacts not being shown.
  • Add support for play/pause collection button configuration. It is now possible to show an icon or a text using useTextForCollectionPlayPauseButtonConfigKey.
  • Contacts which only have the company name provided are not part of the non-alphabetic section in the contact list, but are now shown in the correct section.
  • Communications: Add new Favorites tab, showing only the favorites. Favorites show as regular contacts in the Contacts tab.

API References

Release 1.0.4890-2462 - 31 Jan 2023, 06:48

Release notes

  • Update to Android Compile SDK 33 (Android 13)

API References

Release 1.0.4866-2431 - 27 Jan 2023, 06:38

Release notes

  • Media API changes:
    • IsPlaylistItemPolicy is replaced by CollectionPolicy.
    • PolicyProvider.isPlaylistPolicy is replaced by collectionPolicy, new DefaultCollectionPolicy is used as a default value.

API References

Release 1.0.4854-2421 - 26 Jan 2023, 12:02

Release notes

  • Exclude the debug and test build-time configuration groups in the release build by default.
    • The Gradle plugins API IviDefaultsGroupsSelectionConfigurator.includeDefaultGroups is marked as deprecated.
    • Usages can be replaced with two approaches. Use:
    • IviDefaultsGroupsSelectionConfigurator.includeDefaultPlatformGroups and IviDefaultsGroupsSelectionConfigurator.includeDefaultAppsuiteGroups.
    • Or use IviDefaultsGroupsSelectionConfigurator.includeDefaultPlatformGroups and explicitly opt-in to all desired app suite groups with IviDefaultsGroupsSelectionConfigurator.include.
    • Please note that the debug configuration group is not included by default in release builds.
    • More information can be found in this tutorial.
  • The list ttButtonViewModels has been replaced by two dedicated viewModels, ttPrimaryButtonViewModel and ttSecondaryButtonViewModel. Where ttPrimaryButtonViewModel replaces the first index of the old list.
  • Platform update:
    • Upgraded Kotlin Version from 1.7.10 to 1.7.21
  • API changes:
    • CallDetails::subtitle renamed to CallDetails::state;
    • CallDetails::description added.
  • Improved the stability of the Alexa Privacy Mode feature.
    • Enabling/disabling Alexa Privacy Mode works faster.
    • Functionalities that include Alexa voice (e.g. audio instructions during navigation, reading of messages) now work while in Privacy Mode.
  • The media source that was active last in the previous session (e.g. before a reboot) will be active again in the current session.

API References

Release 1.0.4806-2388 - 19 Jan 2023, 14:23

Release notes

  • Add support for the media browser actions:
    • Added BrowserAction and BrowserActionResult.
    • Added coLaunchBrowserAction to SourceClient, RootSourceClient, ItemSourceClient, and SearchSourceClient.
  • Fix crash when system UI is restored with a panel stack of more than two panels and the panels were added at once.
  • Fixed a crash if the system UI is restored while a destroyed panel was animating out.
  • Improved the error message when restoring a view hierarchy and a panel container is missing in the system UI layout.
  • Communications Frontend: Show unhold call button in process panel when there is only a single call which is on hold.
  • Communications frontend: Improve scrolling performance on large number of contacts.
  • Platform update:
    • Upgraded Gradle version from 7.5.1 to 7.6.
  • Fix Media controls are tinted with incorrect colors.

API References

Release 1.0.4773-2372 - 13 Jan 2023, 13:15

Release notes

  • Fix artwork blinks when metadata is updated.
  • A panel may now be attached multiple times at the same time. This allows for system UI transitions where a panel is moved from one panel container to another. This allows the removal of ignoreUntilDetached in custom SystemUiViewModel classes.
  • StockRecentCallsService: Improve loading time on large number of recent calls.
  • AddResetFrontendOnMenuItemClickFrontendCoordinationRule: a FrontendCoordinationRule to reset a frontend's state when the active frontend is selected again from the menu. This rule needs to be added to the list of FrontendCoordinationRules: it is a parameter of the FrontendCoordinator, set when creating the System UI ViewModel.
  • Added support for communications frontend customization.
    • The communications frontend can now be configured by providing a CommunicationsPolicyFrontendExtension that defines the behavior for a specific phone account ID by assigning to it a CallDetailsPolicy. Such policies offer a way to customize the user interface, like adjusting the call icon, call title, etc.
    • See CommunicationsFrontendConfiguration API reference for more information.

API References

Release 1.0.4735-2353 - 07 Jan 2023, 05:54

Release notes

  • Communications frontend: Add the swap calls button to process panel.

API References

Release 1.0.4729-2347 - 06 Jan 2023, 08:05

Release notes

  • Telecom: Added phoneAccountId property to the Call class. The phoneAccountId property identifies the phone account from which the call originates, and can be used by service clients to differentiate between standard phone calls and other (e.g. VoIP) call types.

API References

Release 1.0.4711-2334 - 04 Jan 2023, 14:07

Release notes

  • Fix for a race condition which can cause a "Unable to start activity" crash after a configuration change due to a corrupt fragment manager state.
  • Add collation support for contacts search ( Élisé can be found by Elise).
  • ContactDataSourceQuery: add groupBy parameter to group the results.
    • ContactDataSourceQuery: remove selection parameter, this was always All.
  • The back button is not shown for the media source root panel if the dashboard shortcut button is present. See the recently added hasDashboardButtonConfigKey.
  • ContactsDataSourceQuery: add support to combine multiple filters.
  • Fix for showing a native android dialog when the phone number used for dialing is empty.
  • Implementation of Alexa Preview Mode feature.
    • This mode gives users access to a restricted set of Alexa features without requiring a login with an Amazon account.
    • To be able to use this, AlexaPreviewModeService must be implemented by the OEM. This service is responsible for handling communication with AVS (Alexa Voice Service) to enable or disable Alexa Preview Mode using the InstantDeviceRegistration API.
    • This mode can be enabled by passing the ANONYMOUS authentication type to the VpaMediatorService.logIn function.

API References

Release 1.0.4680-2328 - 27 Dec 2022, 14:43

Release notes

  • ContactsDataSourceQuery: Remove the map lambda. This is replaced by map in mapPagingData
  • Changes following Android Gradle Plugin update to 7.3.1:
    • Logic change to support setting package name from build.gradle namespace attribute.
    • See here for Android documentation

API References

Release 1.0.4668-2320 - 23 Dec 2022, 06:03

Release notes

  • Added standalone testing application to generate recent calls.
  • When browsing to a media source that has paused content, that source will now be made active, and thus usable in the media process panel. This does not happen if another source is playing.

API References

Release 1.0.4665-2317 - 22 Dec 2022, 06:01

Release notes

  • ContactsDataSourceQuery: Selection of contacts are separated from filtering.

API References

Release 1.0.4651-2302 - 17 Dec 2022, 05:55

Release notes

  • Communications API changes:
    • Split PlatformContactsHelper into PlatformHelperContacts and PlatformHelperRecentCalls.
    • Add PlatformHelperRecentCalls to platform_recentcalls_api_common_debug.
  • Fixed ContactsSettingsService crash during the service startup.

API References

Release 1.0.4648-2299 - 16 Dec 2022, 05:56

Release notes

  • Fixed a crash which happened during a connection/disconnection when having more then one phone paired.
  • Removed automatically starting to play playlists, albums, podcasts while browsing in the Media UI when not already playing any music.
  • Fix to show toast message for media playback state errors.
    • IviPlaybackState enum type is changed to a sealed class.

API References

Release 1.0.4616-2281 - 13 Dec 2022, 05:50

Release notes

  • Media API changes:
    • Added backToDashboard to MediaFrontendContext.Panel.
    • Removed clearStack parameter from MediaFrontendContext.Panel.openMediaTaskPanel.
    • A new button was added to media panels allowing a quick return to the media dashboard panel. Use the new hasDashboardButtonConfigKey to disable it if needed.

API References

Release 1.0.4603-2274 - 10 Dec 2022, 05:58

Release notes

  • Prevent crash when a recent call with a future time is present in the recent calls.
  • TelecomService API: Changed setMute() to mute() and unmute()
    • TelecomService API: Changed setCallOnHold() to hold() and unhold()
    • Call: Replaced canChangeHoldState by Call.capabilities
  • Add new APIs to BluetoothConnectivityService:
    • turnBluetoothOn: Turns on the Bluetooth adapter.
    • turnBluetoothOff: Turns off the Bluetooth adapter.
    • bluetoothState: Indicates the current state of Bluetooth allowing the client to determine whether the Bluetooth is on.

API References

Release 1.0.4568-2253 - 07 Dec 2022, 05:58

Release notes

  • Localization API:
    • Implemented an API for changing between 12-hour and 24-hour clock time format in Android

API References

Release 1.0.4558-2244 - 02 Dec 2022, 06:07

Release notes

  • Communications: Fix duplicate favorite contacts

API References

Release 1.0.4531-2229 - 30 Nov 2022, 13:47

Release notes

  • The dial pad button animation background color now matches the surface subdued color.
  • Communications API change: Removed queryAllContacts(order: ContactItemOrder) from ContactUtil.

API References

Release 1.0.4520-2219 - 29 Nov 2022, 05:59

Release notes

  • Fixed an issue where previous discovered Bluetooth devices where not shown after re-opening the discovery modal panel.
  • Pressing the dial pad button on the process panel will select the dial pad when communications panel is opened.

API References

Release 1.0.4509-2211 - 26 Nov 2022, 05:56

Release notes

  • Various improvements of Developer Portal content.
  • Fix visual glitch that the tab bar indicator is still moving after opening the communications frontend
  • Communications frontend transition animation is from main menu when opening from main process panel.

API References

Release 1.0.4508-2210 - 25 Nov 2022, 13:03

Release notes

  • Reverted the build logic in repositories.gradle.kts to fix a build error in the dependency resolution.

API References

Release 1.0.4499-2200 - 24 Nov 2022, 10:29

Release notes

  • Localization API:
    • Implemented an API for changing System Language Setting in Android.
  • MediaContentView and MediaGroupItem are not part of public API anymore.

API References

Release 1.0.4491-2189 - 22 Nov 2022, 05:55

Release notes

  • Replying using a conversation quick reply now marks the conversation as read.
  • Move module platform.messaging.api.service.messagingapp to appsuite

API References

Release 1.0.4485-2184 - 21 Nov 2022, 12:43

Release notes

  • Newer version of the Android Gradle Plugin 7.3.1 is integrated. See release notes: https://developer.android.com/studio/releases/gradle-plugin#7-3-0
    • Change in published version catalog: plugin implementation reference gradlePluginNavuiEmulators is replaced with gradlePluginNavappEmulators.
    • Plugin com.tomtom.navui.emulators-plugin is superseded with com.tomtom.navapp.emulators-plugin.
    • Android Gradle Plugin 7.3.1 require Android Studio Dolphin | 2021.3.1 or newer.
  • Dial pad height restricted to provide better user experience on vertical screens.
  • Dial pad initial number entry does not cause layout change.

API References

Release 1.0.4472-2174 - 18 Nov 2022, 05:55

Release notes

  • Communication with Alexa is disabled when a user is not logged in.
    • The corresponding frontend should accompany this rule by disabling the push-to-talk/tap-to-talk button, as well as the possibility for users to change the wake-up word setting if a user is not logged in.

API References

Release 1.0.4460-2169 - 16 Nov 2022, 15:06

Release notes

  • When VehicleElectricEngineService::batteryChargeLevel.max is null, it will no longer automatically be converted to 0. Instead, for electric vehicle functionality, only a non-null value will be considered.
  • Add standalone testing tool to generate contacts
  • Apply the assigned font family to the text on TtSwitch UI control
  • Remove ContactId from Contact
    • Remove FindContactByContactId from ContactsDataSourceQuery

API References

Release 1.0.4451-2166 - 15 Nov 2022, 16:12

Release notes

  • Changes to Bluetooth Connectivity:
    • Improved the BluetoothConnectivityService.deviceInformation updates when forgetting a Bluetooth device.
    • API change: Renamed BluetoothConnectivityService.forgetPairedDevice to BluetoothConnectivityService.removeBond.

API References

Release 1.0.4443-2159 - 15 Nov 2022, 05:52

Release notes

  • Settings Panel launch crash fix
  • Set Contact.image to null for contacts with no image
  • When allowing/disallowing a Bluetooth profile, the Bluetooth profile must connect/disconnect.
  • Integrated Alexa Auto SDK 4.1.1 Hotfix #1.
  • Naming convention change:
    • Changed all instances of Copilot to Front Passenger in codebase going forward.

API References

Release 1.0.4428-2155 - 10 Nov 2022, 09:54

Release notes

  • Fixed BluetoothConnectivityStatus.lastBondStateChangeReason being set to null right after a bond state change occurred. This resulted into the problem that the pairing retry panel was not always shown.
  • Fix iHeartRadio low resolution thumbnails.

API References

Release 1.0.4404-2137 - 05 Nov 2022, 05:45

Release notes

  • Logging of SettingsManagementService is disabled.

API References

Release 1.0.4395-2126 - 04 Nov 2022, 05:47

Release notes

API References

Release 1.0.4384-2117 - 02 Nov 2022, 05:48

Release notes

  • Added the IEC_62196_TYPE_1_OUTLET and IEC_62196_TYPE_3_CONNECTOR_CABLE_ATTACHED plug types in VehicleEvChargingConnector.ChargingStationConnectorType.
  • Alexa Media: use 30s icon for skip backward/forward controls.

API References

Release 1.0.4373-2104 - 01 Nov 2022, 13:46

Release notes

  • Fix a crashing bug in release 1.0.4333-2078, where a exception is thrown with the message: "Current charge has not been set".
  • Use high resolution photos of contacts in communications app.
  • Retrieve the contact's photo when opening non-favorite contact details
  • Fix media login flow for Android 8.1.

API References

Release 1.0.4333-2078 - 21 Oct 2022, 17:18

Release notes

  • Improves the Navkit2 configuration providers, so that integration with TomTom online services is made easier.
  • Fix progress bar tint color in the media ExpandedProcessPanel.

API References

Release 1.0.4306-2049 - 19 Oct 2022, 09:56

Release notes

  • Breaking code change:
    • Rename UX strings libraries names to com.tomtom.uxstrings:ivi-xxx.
    • Rename UX strings library reference in exported version catalog to tomtomUxStringsIviXxx.
  • Add new flag: SourceAttributionFormat.preferPresentation: Boolean. The stock Media app dashboard will use it to retrieve a logo for the source selection panel: support for this flag should be added at least in fun MediaSourceAttributionPolicy.getLogo().
    • Add new resources:
    • @drawable/ttivi_media_amazonmusic_logo_presentation
    • @drawable/ttivi_media_bluetooth_logo_presentation
    • @drawable/ttivi_media_iheartradio_logo_presentation
    • @drawable/ttivi_media_spotify_logo_presentation
    • @drawable/ttivi_media_tunein_logo_presentation
    • These can all be overridden to change the appearance of the icons representing these media sources when the logo is prominently presented along with others of the same type: that is the source selection screen in the stock Media application.

API References

Release 1.0.4286-2022 - 13 Oct 2022, 16:16

Release notes

  • Fix a crash in the Alexa TTS service.
  • Allow for VpaMediatorSettingsSevice.updateDefaultVpa() to accept null as parameter, to indicate that no VPA is the default VPA.
Release 1.0.4269-1995 - 12 Oct 2022, 18:53

Release notes

  • Fix for pairing pin codes which are less then 6 characters where not padded with leading zero.
  • Fix alignment of header items in recent calls tab.
  • In ContactServiceApi replace the contact property by an IviDataSource to support larger contact list.
Release 1.0.4247-1978 - 04 Oct 2022, 17:20

Release notes

  • Contacts are sorted alphabetically within a section.
  • Add activeQueueItemIndex field to MediaService, tracking the current index in a music queue.
  • Add support for map zoom in/out with Alexa.
    • It's now possible to say: "Alexa, zoom in / out the map"
  • Fixed received SMS is not shown again after reconnecting the specific Bluetooth phone.
  • Contact details shows all phone numbers and all addresses associated to a contact. It is possible to scroll to see all loaded data.
  • Added empty state to dial pad when no phone is connected.
  • Ensure that contacts and messages are only uploaded to Alexa if they are originating from a phone that was allowed for upload by the user.
Release 1.0.4221-1956 - 30 Sep 2022, 09:05

Release notes

  • New map Settings Panel introduced
Release 1.0.4213-1952 - 28 Sep 2022, 18:13

Release notes

  • Fixes paired phones briefly shown in discovery panel after being forgotten.
  • Fix the incorrect scrollbar handle dimension when switching between views.
  • Added clarification in documentation on how to call service methods from frontends in order to handle service unavailability.
Release 1.0.4192-1921 - 21 Sep 2022, 21:37

Release notes

  • The TomTom Digital Cockpit SDK is now published on GitHub (follow the link above).
    • The publication to Nexus is deprecated, but will remain for a few months.
Release 1.0.4173-1902 - 16 Sep 2022, 13:25

Release notes

  • Add static configuration key ignoredMediaBrowserPackageListConfigKey, of type string list.
    • This lets customers hide unwanted media applications from the media app. To add a new exclusion, create an XML resource with:
    • <string-array name="ignoredMediaBrowserPackageListConfigKey">
    • <item>first.android.package.name.to.ignore</item>
    • <item>another.android.package.name.to.ignore</item>
    • </string-array>
  • Added SourceDefinitionPolicy, a new media policy to define generic traits of a media source. The first of such traits is allowing to define whether a media source requires an internet connection or not.
    • This allows, for example, to improve error reporting to the user when something goes wrong.
  • Add to media policy SourceDefinitionPolicy a string resolver to allow customizing the safety lock message when attempting to login to a media source while driving.
Release 1.0.4146-1883 - 13 Sep 2022, 12:49

Release notes

  • Mini-map implementation.
Release 1.0.4144-1882 - 12 Sep 2022, 18:58

Release notes

  • Fix media playlist crash for Android 8.1.
  • Fix for showing an empty state view merged with contacts entries.
Release 1.0.4117-1864 - 08 Sep 2022, 11:10

Release notes

  • Fix issue where it was not possible to reply to an SMS message on some hardware platforms.
  • Fix issue where SMS message notifications were not being displayed on some hardware platforms.
  • Adds new ttHeaderListItemViewLayout view property to TtListRecyclerView which allows a custom list header layout to be specified.
Release 1.0.4116-1863 - 07 Sep 2022, 10:38

Release notes

  • VpaMediatorService has been extended with a new field, alerts, that contains all known VPA alerts, and with two functions:
    • removeAllAlerts() which clears all active and pending alerts.
    • stopActiveAlerts() which stops all the active alerts.
  • Fix for not showing information on progress panel about a phone call which is on hold.
  • These changes introduce a renaming for the ProcessPanel and the ProcessPanel template classes:
    • Panel renaming:
    • ProcessPanelto MainProcessPanel
    • Template classes renaming:
    • ProcessViewModelBase to CompactProcessViewModel
    • ProcessViewModel to MainCompactProcessViewModel
    • ProcessFragment to MainCompactProcessFragment
    • ProcessFragmentBase to CompactProcessFragment
    • TaskProcessFragment to TaskCompactProcessFragment
    • TaskProcessViewModel to TaskCompactProcessViewModel
    • ProcessBindingAdapters to CompactProcessBindingAdapters
    • ProcessControlList to CompactProcessControlList
    • ProcessControlViewModel to CompactProcessControlViewModel
    • ProcessMetadataViewModel to CompactProcessMetadataViewModel
  • Integration of the Alexa Auto SDK version 4.1.1.
    • Starting from version 4.1.0, Alexa LVC (Local Voice Control) APK is deprecated in favor of a new library that can be directly used in the app.
Release 1.0.4103-1849 - 31 Aug 2022, 07:38

Release notes

  • Fix for showing the correct initial Bluetooth panel after forgetting all paired devices.
Release 1.0.4100-1847 - 30 Aug 2022, 09:08

Release notes

  • Fix for Android 12 Bluetooth devices getting stuck while pairing.
  • Extended messaging service API to include the source (e.g. the phone from where the messages were downloaded) of a conversation:
    • Added ConversationSource abstract class;
    • Added BluetoothDeviceConversationSource class;
    • Conversation is extended with a property of type ConversationSource;
    • ConversationCache::withUpdatedConversation() updates Conversation::source as well;
    • MessagingService::getOrCreateConversationId() includes the source parameter;
    • MessagingProviderHelper::findConversation() includes the source parameter;
    • MessagingProviderHelper::findOrCreateConversation() includes the source parameter;
Release 1.0.4085-1834 - 25 Aug 2022, 11:29

Release notes

  • Reattempt to pair a Bluetooth device after canceling the previous Bluetooth pairing request is fixed
Release 1.0.4081-1830 - 24 Aug 2022, 12:24

Release notes

  • Fixed for unpaired devices which where still being shown in the paired device list of the Bluetooth modal panel after the device was unpaired by using the forget functionality.
  • Fixed dismissing SMS notification after 10 seconds timeout when paired phone gets his Bluetooth connection disconnected and then reconnected.
  • Removed the function useDefaults for iviInstance and service within the ivi block in the build.gradle.kts. The more robust alternative applyGroups in combination with includeDefaultGroups should be used instead. In addition, within the applyGroups opt-in plugin groups can be added with include and default plugin groups can be removed with exclude.
  • Media API changes:
    • Add isExplicit field to IviMediaItem and corresponding withIsExplicit method to IviMediaItemBuilder.
    • Remove EXTRA_CONTENT_IS_EXPLICIT from MediaBundleExtras.
Release 1.0.4033-1779 - 11 Aug 2022, 13:44

Release notes

  • Removed MediaPlaybackViewModel.artUri in favor of MediaPlaybackViewModel.art.
  • Changes:
    • UserFlowActionPolicy and MediaTaskPanelPolicy have been merged into UserFlowPolicy.
    • IsSearchItemPolicy removed.
  • Flickering of the recent calls list is fixed. When a new recents are added the list entries are inserted instead of adding and redrawing all items.
Release 1.0.4013-1755 - 04 Aug 2022, 12:31

Release notes

  • Moves the navigation panel to a GuidancePanel in a separate frontend. This provides more modular control over the navigation experience and lets the system UI manage the container of the navigation panel.
  • Upgraded Kotlin to version "1.6.21". Kotlin Symbol Processing and kotlinx.serialization were also upgraded to the compatible versions with Kotlin "1.6.21".
  • Added API LiveData<ProcessPanel?>.takeIfPriorityIsAtLeast(minimumPriority: ProcessPanel.Priority) to module platform_systemui_api_common_frontendcoordinator, allowing a custom system UI implementation to not display any ProcessPanels under a minimum set priority level.
Release 1.0.3999-1740 - 01 Aug 2022, 14:33

Release notes

  • Add getStyle in MediaSourceAttributionPolicy giving the possibility to override source accent color.
    • Adding accent color theme attribute for each MediaPolicyFrontendExtension to override the source accent color if needed:
    • ttivi_media_amazonmusic_accent_color
    • ttivi_media_spotify_accent_color
    • ttivi_media_iheartradio_accent_color
    • ttivi_media_tunein_accent_color
    • Note that the source accent color is only visible in the play button of the Spotify playlist view in the stock media frontend implementation.
  • Fixes Android 8 PAN and PBAN related crashes.
  • Contacts API: Add the source property to the Contact class. This property identifies the device or service from which the contact originates. For example, if the contact originates from a paired phone, source will identify the phone from which the contact was synchronized.
Release 1.0.3982-1720 - 27 Jul 2022, 08:52

Release notes

  • Add IviActivityTestCase.extendUiDeviceForEmbeddedActivities() to help access embedded 3rd-party activities in integration tests.
  • Added support for the Alexa TrafficDetailsTemplate, which is a display card with helpful travel information such as distance and time to some POI (Point Of Interest). The display card can be triggered by asking Alexa something like: "Alexa, how long will it take me to get to Paris?".
  • Added the ability to specify the priority in which a frontend is created, by splitting FrontendCreationPolicy.CREATE_AT_STARTUP into CREATE_AT_STARTUP and CREATE_AFTER_STARTUP.
  • Add Frontend.isReady, a way for a frontend to define whether it is ready to be presented to the user. It's one of the building blocks of the upcoming splash screen.
  • Added support for ProcessPanel to change their ProcessPanel.Priority at runtime when the priority of a process changes.
    • The ProcessPanel.priority field was changed to a LiveData of a UniquePriority (a Comparable type).
    • This type contains a ProcessPanel.Priority and an unique progressive ID to determine priority unambiguously, even with panels with the same priority.
    • Process panels can now call ProcessPanel.setPriority() to change their process priority.
  • Update of the ProcessMetadataViewModel class:
    • Rename primaryTextArea and secondaryTextArea properties to primaryText, secondaryText and convert them to a LiveData<StringResolver?>.
    • Add a logo property (LiveData<DrawableResolver?>).
  • Add Media API UserFlowActionPolicy for a media source's PolicyProvider a to customize what happens when the user selects a source which needs to be logged in to, and what happens when the a source's settings must be shown.
  • Added a new type of panel ExpandedProcessPanel.
Release 1.0.3934-1671 - 15 Jul 2022, 15:55

Release notes

  • Fix for not being able to connect and disconnect Bluetooth devices when running on an Android 8.1 platform.
Release 1.0.3930-1663 - 15 Jul 2022, 08:41

Release notes

  • A new query called FindContactsByDisplayNames is added to find contacts based on display names.
Release 1.0.3897-1637 - 11 Jul 2022, 14:45

Release notes

  • Added support for sending NavApp navigation favorites to Alexa. This allows the user to say: "Alexa, navigate to Work / Home / Favorite name".
    • Favorites are only sent to Alexa if the user has provided his consent ("Sync Vehicle Navigation Favorites" toggle in Alexa debug tab).
    • Known issues: this currently only works when offline due to issues with the Alexa SDK.
Release 1.0.3894-1635 - 11 Jul 2022, 11:00

Release notes

  • Fix for crash in libmapdisplay-clientlib during rotation.
  • Fixed a crash which happens when (dis)connecting the HID Bluetooth device profile.
  • Reworked the media domain testing API. All ViewInteractions, ViewMatchers and waiters are now grouped inside multiple kotlin objects, to group them by the type of panel in the stock media frontend they belong with.
    • The objects are:
    • BrowsingInteractions
    • DashboardInteractions
    • ExpandedProcessPanelInteractions
    • MediaFrontendInteractions
    • PlaylistPanelInteractions
    • ProcessPanelInteractions
    • SearchPanelInteractions
    • TaskProcessPanelInteractions
    • Multiple API calls were removed due to being not relevant for customer testing, and some new useful ones were added.
Release 1.0.3880-1630 - 06 Jul 2022, 13:24

Release notes

  • Extended Alexa example app to show addition and usage of Car Control custom assets.
  • Add a new contacts query that allows frontend to find a contact based on a ContactId.
  • Media API changes:
    • Removed MediaItemDataExtractionPolicy and MediaItemData.
    • Added MediaItemMappingPolicy.
    • In PolicyProvider: MediaItemDataExtractionPolicy is renamed to MediaItemMappingPolicy, PolicyProvider::extractItemDataPolicy is renamed to PolicyProvider::itemMappingPolicy.
    • MediaEntryGroupItem uses IviMediaItem instead of MediaItemData, and MediaEntryGroupItem::itemData is renamed to MediaEntryGroupItem::item.
    • Secondary constructor added to IviMediaItemBuilder to copy and modify an existing IviMediaItem.
  • Added to media domain testing API the MediaControl testing helper classes: SingleActionMediaControlVerifier, MultipleActionMediaControlVerifier, ToggleActionMediaControlVerifier.
    • Add to media domain testing API the frontend panel testing helper classes FakeMediaControlContext, createMediaConfiguration,  and FakeSourceInfo.
Release 1.0.3863-1614 - 01 Jul 2022, 05:37

Release notes

  • Adds functionality to install/uninstall Android apps from the App Store debug menu.
Release 1.0.3860-1612 - 30 Jun 2022, 08:24

Release notes

  • Changes:
    • Removed MediaSettingsService from public API.
    • Improved Media API documentation.
Release 1.0.3855-1607 - 29 Jun 2022, 05:35

Release notes

  • Alexa Notification Indicator showed as a badge on top of the Alexa Hands-free indicator when there are available Alexa notifications.
    • VpaMediatorService API extended with hasPendingNotifications property.
Release 1.0.3849-1603 - 28 Jun 2022, 05:36

Release notes

  • Incoming calls are using new Contacts DataSource API: resolving a phone number is based on a query applied to the contacts data source.
Release 1.0.3845-1596 - 24 Jun 2022, 15:17

Release notes

  • MediaPlaybackViewModel.iconArtUri: LiveData<Uri?> has been replaced with MediaPlaybackViewModel.iconArt: LiveData<RemoteDrawableResolver>
  • Refactored global tokens and introduced generic attributes for size, spacing, radius and icon size categories.
    • The mentioned categories use a baseline attribute which is identified as tt_category_1.
    • The postfix value indicates the multiplication factor, e.g. when tt_size_1 is 8dp then tt_size_4 becomes 32dp.
Release 1.0.3841-1590 - 23 Jun 2022, 12:48

Release notes

  • The active media source will stay active, even on error, to prevent the UI changing between sources unpredictably.
Release 1.0.3836-1585 - 23 Jun 2022, 05:34

Release notes

  • All Media domain API were changed to use java.time.Duration whenever a time duration is involved. This helps the media domain API be more uniform and in line with the rest of the platform, makes unit conversions much easier, and simplifies using the API.
Release 1.0.3832-1584 - 22 Jun 2022, 05:37

Release notes

  • Media process panel use process panel adaptive layout.
    • Remove open now playing button from media process panel.
Release 1.0.3830-1580 - 21 Jun 2022, 05:34

Release notes

  • Privacy Mode feature for Alexa:
    • Introduce a new API, enablePrivacyMode, as part of the VpaMediatorSettingsService.
    • When enabled, a user cannot invoke Alexa and Alexa will not proactively start a conversation or send any notifications to the user.
    • This can be used in restricted modes such as valet or for guest drivers.
    • When enabled, all Alexa functionalities are completely disabled as well as all functionalities that include Alexa voice (e.g. audio instructions during navigation, reading of messages).
Release 1.0.3828-1579 - 20 Jun 2022, 13:54

Release notes

  • Since the adaptive behavior of the process panel was introduced, the process bar panel was not always a bar any more, so that part of the name was removed.
    • The following has been renamed:
    • Renamed ProcessBarPanel to ProcessPanel.
    • Renamed TaskProcessBarPanel to Process.
    • Renamed platform_frontend_api_fragment_processbar to platform_frontend_api_template_processpanel.
    • Renamed platform_frontend_api_fragment_modal to platform_frontend_api_template_modalpanel.
    • Renamed platform_frontend_api_fragment_notification to platform_frontend_api_template_notificationpanel.
    • Renamed platform_frontend_api_testing_processbar to platform_frontend_api_testing_processpanel.
    • Renamed platform_frontend_api_testing_modal to platform_frontend_api_testing_modalpanel.
  • The dial pad can be opened from the process panel.
    • The dial pad will be the default tab when opening the communication frontend if there is an ongoing call.
  • Add a Dial Pad tab to the communication frontend. With the dial pad a phone number can be manually entered to be called. And it can be used to send DTMF tones during a call to navigate menus.
Release 1.0.3810-1559 - 16 Jun 2022, 05:33

Release notes

  • Adds a switch to the App Store tab of the debug menu allowing display of Android apps to be toggled on and off.
  • Add the list of countries supported by a VPA to the VpaProperties, exposed by the VpaMediatorService.
  • Added Android 8.1 compatibility for BluetoothProfile.getConnectionPolicy.
  • Changes:
    • Recent calls is using IviDataSource: Finding call log contacts based on phone number query.
    • Process bar is using IviDataSource: Showing contacts details on the process bar based on phone number query.
Release 1.0.3806-1554 - 15 Jun 2022, 05:41

Release notes

  • Changes:
    • Add progress bar to process panel template
    • Renaming ttivi_media_player_progressbar_height to ttivi_processpanel_progressbar_height.
  • Alexa's search and navigation capabilities have been extended to the offline use case.
    • It is now possible to ask similar questions as in the online case:
    • "Alexa, show me nearby Asian restaurants"
    • "Alexa, take me to Starbucks"
    • "Alexa, what's the address of Chase Bank in San Francisco?"
    • "Alexa, what's the best way to 2795 Augustine Drive?"
    • "Alexa, give me directions to Seattle"
    • This feature is only available if the application is configured to use onboard map visualization.
Release 1.0.3791-1534 - 09 Jun 2022, 05:40

Release notes

  • Process panel template could be now reused in task process panel:
    • ProcessBarFragment is renamed to ProcessFragmentBase and offers two abstract classes to implement: ProcessFragment and TaskProcessFragment.
    • ProcessBarViewModel is renamed to ProcessViewModelBase and offers two abstract classed to implement: ProcessViewModelBase and TaskProcessViewModel.
    • Choose suitable variant depending on the panel.
  • Add a safety lock static configuration in module platform_safetylock_api_common_configuration
  • Improve performance of trace events.
  • New media domain API SetRatingAction. This type of standard action allows giving a rating to the currently played media.
Release 1.0.3770-1513 - 01 Jun 2022, 12:44

Release notes

  • Reduce vertical padding within the main menu overflow panel.
  • Fix issue during media playback where the seeking controls could be incorrectly enabled.
    • The media API TouchTrackViewModel was changed to clarify its usage:
    • Constructor parameter TouchTrackViewModel.isSeekActionSupported: LiveData<Boolean> is not a public value anymore but just a parameter.
    • Public value TouchTrackViewModel.isSeekingAvailable: LiveData<Boolean> has been introduced.
  • Dismiss login and settings panels if the safety lock is activated.
    • API change: MediaFrontendContext.Panels.openActivityPanel: onFinishedCallback is always called if the activity panel is dismissed by any reason.
  • When there are several quick replies available to the user, only the selected one is shown as sent.
  • The AppTileView UI control has been promoted from being internal to being public and IviExperimental.
Release 1.0.3712-1453 - 13 May 2022, 12:40

Release notes

  • Changes in media API:
    • The MediaPolicyFrontendExtension constructor takes a package name and an optional class name instead of a SourceId. This allows policies to be applied to the entire media source package.
    • The constructor and fields of MediaConfiguration are no longer public. The asMediaConfiguration function is now public and is intended to create MediaConfiguration objects. Use the existing getPolicyProvider method to access policy providers.
  • TomTom Digital Cockpit now uses type-safe properties for quantities in its APIs to expose physical units such as time duration, distance, energy, power, etc. Property names no longer have an unit suffix, for example, batteryChargeLevelKwh became batteryChargeLevel.
  • Introduce a new contacts API that supports paging. The MirrorableMap contacts API will be marked as deprecated and then removed.
    • The new contacts API uses IviDataSource, that expose a page of contacts without requiring the full data set to be loaded in memory. It also allows querying and sorting contacts.
Release 1.0.3699-1437 - 09 May 2022, 15:51

Release notes

  • Modifications to MenuService API so it no longer exposes a map combining menu items and state (ordering and selected state) but instead exposes an ordered list of menu items and a separate property indicating the selected menu item (or null if no item is selected).
    • Also, the menu item registration APIs have been removed from the MenuService API as menu item registration is now the responsibility of MenuItemProviderService implementations.
  • Add a PanelTransitionDestination parameter in the removeSubContainer method of TaskPanelSubContainerManager. This allows to specify the destination the TaskPanel should transition to when going out of view.
  • Fixed Companion App communication via Bluetooth Low Energy. Some Android phones could not be reconnected when connection is lost.
Release 1.0.3671-1412 - 04 May 2022, 05:39

Release notes

  • Introduce new media domain APIs in MediaSourceAttributionPolicy to allow changing the tab icons shown in the Now Playing View panel.
Release 1.0.3637-1373 - 22 Apr 2022, 19:28

Release notes

  • SourceClient rootMetadata field from media API is now a LiveData.
Release 1.0.3629-1363 - 21 Apr 2022, 12:50

Release notes

  • Allow configuration generator Gradle plugin to be used in combination with build product flavors. Fixes build error: Task with path 'preDebugBuild' not found in project.
  • Fixed an Android Bluetooth phone disconnect problem. Disconnecting a Bluetooth phone triggered from the Digital Cockpit platform, sometimes resulted in the Bluetooth phone not being disconnected.
Release 1.0.3593-1327 - 14 Apr 2022, 13:00

Release notes

  • Let the Alexa Auto Client Service (AACS) handle timezone synchronization from platform to Alexa, and from Alexa to platform.