4.12.0 Release Notes

Summary:

Features

• [SDL 0230] SPP resource management for Android

• [SDL 0279] Screen Manager Subscribe Buttons

• [SDL 0289] Support for Set Language Separately

• Add a way to set the resumption hash in the managers layer

• Change lock screen logo and ensure correct contrast

Enhancements

• [SDL 0306] Use Taskmaster To Handle Queuing Operations in Managers

• [SDL 0301] SDL Device Listener

• Sdl Android should use the new LifecycleManager

• Deprecate onError for OnRPCResponseListener

• Add ForegroundServiceType Parameter to HelloSdl Project

• Update javadocs for PermissionManager.addListener

• PermissionManager Should send callback when subscribing to listener

• Move textFields / imageFields == null checking from ScreenManager to SystemCapabilityManager

• Change Http to Https

• Move src/java/main/android folder

• Classes that need to be removed in next major release should be deprecated

• OnSdlChoiceChosen contains duplicate class definitions

• The name of setter and getter in OnButtonPress are ambiguous

Bug Fixes

• presentChoiceSet failed with "INVALID_ID, null"

• Android app will not receive the notification of HU when the language is switched on the HU side.

• If an empty array is set for voice commands on the SDLMenuCell the AddCommand is rejected

• Disconnecting a cloud app doesn't free the port

4.11.1 Release Notes

Summary:

Hotfix

• Samsung devices not properly managing notification channels

4.11.0 Release Notes

Summary:

Features

• [SDL 0234] Proxy Library RPC Generation

• [SDL 0124] SDLImageUploadManager

• [SDL 0191] Retry Failed File Uploads

• [SDL 0220] Support for Android custom RouterService

• Use GitHub Actions

Enhancements

• Align SystemCapabilityManager with iOS

• SystemCapabilityManager doesn't fully support capability subscriptions

• Align Video Streaming State with iOS

• SoftButtonObject override Equals method

• Lock Screen Icon is not cached

• Update License to 2020

Bug Fixes

• Inconsistently in ScreenManager behavior if displayCapabilities is null

• Remove left over code in hellosdl

• VideoStreaming does not start during HMI Level "LIMITED".

• Scale Workaround for legacy high-res displays

• Refactor router service's exitForeground logic

• No Overwrite property for SdlFiles

• Deprecate DeviceInfo.DEVICE_OS

• Missing enums

• BaseFileManager UploadFiles handles static icons differently then UploadFile

• USB transport drops remaining data after PSM FINISHED or ERROR state

• Delete notification channel when possible

• Null pointer exception in startStream if hapticSpatialDataSupported is missing

• Issue in VoiceCommandManager.setVoiceCommands()

• Video streaming doesn't start again after closing the app using voice commands

• Potential NPE in TextAndGraphicManager

4.10.1 Release Notes

Hotfix

• Fix issue with video streaming stability
• Fix potential overflow issue in BestRouterComparator
• Fix NPL in TransportBrokerImpl.resetSession()
• Fix some potential NPEs in SystemCapabilityManager
• Fix potential NPEs in BaseMenuManager
• Add AppInfo to RegisterAppInterface RPC

4.10.0 Release Notes

Features

• [SDL 0054] ChangeRegistration Manager was implemented for the Java Suite
• [SDL 0116] Open Menu RPC
• [SDL 0115] CloseApplication RPC
• [SDL 0119] SDL Passenger Mode
• [SDL 0173] Read Generic Network Signal Data
• [SDL 0177] Alert icon
• [SDL 0179] Pixel density and Scale
• [SDL 0184] Cancel Interaction RPC
• [SDL 0186] Template Titles
• [SDL 0199]-Adding-GPS-Shift-support
• [SDL 0207] - RPC message protection
• [SDL 0213]- Remote Control - Radio and Climate Parameter Update
• [SDL 0216] Widget support
• [SDL 0221] Remote Control - Allow Multiple Modules per Module Type
• [SDL 0223] Add Currently Playing Media Image to MediaServiceData
• [SDL 0224] Navigation Subscription Buttons
• [SDL 0225] Update Published App Services
• [SDL 0231] Add Tiles as an Option for Main Menus
• [SDL 0243] Manager Update for DisplayCapability
• [SDL 0246] Add App Services to HMICapabilities
• Add showInOptionalState to LockScreenConfig along with other missing methods
• Make TCP use new transport layers
• FileManager now has getBytesAvailable()
• Added isHighlighted & systemAction setters to SoftButtonState
• SoftButtonObject now let developers set their own ids
• Added prerecordedSpeech to SystemCapabilityManager

Bug Fixes

• Prevent NPE when using Static Icons in the MenuManager
• iSdlProtocol now gets notified when encrypted session is started
• Prevent NPE in TransportBrokerImpl.onHardwareDisconnected(SourceFile_309)
• Prevent NPE in SdlRouterService.java:3220 (handleIncommingClientMessage)
• Fix isStreaming() method in VSM
• Fix issues causing the video stream to not resume after stopping
  • Also see #1150
• Fix an issue that caused the video (NAV) service and stream to not be able to start again after the secondary transport was disconnected and reconnected
• Fix NPE in UsbAccessory.getManufacturer()
• Prevent a runtime exception when service isn't started in the foreground in time
• Dispose main underlying layers when SdlManager is disposed
• Align some RPC response params with RPC spec and make them not mandatory
• Fix an issue where static Icons were not working with the ChoiceManager
• Fix typo issue and register the SdlRouterService Bluetooth broadcast receiver to listen for state changes
• Register legacy Bluetooth broadcast receiver to listen for state changes
• Fix issue where video formats aren't supported, but used to start the video service
• Allow FileManager to start even with certain RPCs aren't allowed, eg ListFiles

Misc

• Fix misc code analyzer issues
• Old proxy classes are now deprecated
• Align lockscreen behavior between platforms

4.9.1 Release Notes

Hotfix

• Fix ChoiceSetManager issue with HUs that require VR for choices

4.9.0 Release Notes

Feature

• [SDL 0157] Mobile Choice Set Manager
• [SDL 0155] Mobile Menu Manager
• [SDL 0210]-Mobile Manager Dynamic Menu Cell Updating
• [SDL 0232] Added Pushing Buffer Support to AudioStreamManager
• Library will dynamically check if head unit requires VR synonyms for Choice items
• VideoStreamingManager now fully supports multi-touch events

Bug Fixes

• Symlinks broken on Windows - Windows user must run a gradle task (buildWindowSymLinks) in order to create the Windows version of symlinks.
• Audio over AOA Issues - Media apps will now wait until an audio output device is ready before connecting over a transport. This can be overwritten by the developer.
• Fixed LeftRearInflatableBelted using the wrong key value in BeltStatus Class
• New Router Service and old USB Transport compatibility issues - Fixed an issue that caused apps not close when a legacy AOA app was chosen by the user.
• Fixed an issue with sendSequentialRPCs where it didn't call onResponse and stoped on first onError

Misc

• Updated library to use the newest BSON library
• Update gradle plugin

4.8.1 Release Notes

Hotfix

• NPE at SdlProtocol.java line 1132 #946
• SdlManager doesn't transition to shutdown state when dispose() is called #1052
• onLegacyModeEnabled no longer implemented #1051
• I can't get the value by getPressureTellTale() #1057
• Fixed JavaEE Hello SDL app with correct constructor usage

4.8.0 Release Notes

Feature

• Renamed repo to sdl_java_suite
• Complete restructure of project to include all Java based projects (Android, JavaSE, and JavaEE). This included creating base source sets for all projects.
• [SDL 0203] Added JavaSE and JavaEE libraries to support embedded, remote, and cloud applications.
• [SDL 0158] Added new SetCloudAppProperties, GetCloudAppProperties, new vehicle data item -cloudAppVehicleID, and retrieval of auth token sent during StartServiceACK for RPC service.
• [SDL 0167] Add the new App Services feature. This includes app service types Media, Weather, and Navigation
• Add support for TemplateImages in ScreenManager
• Added ability to access the RegisterAppInterface Response message from SdlManager
• [SDL 0208]- Allow developers to block old SDL Head Units from Mobile
• [SDL 0197]- Update SetMediaClockTimer Initializers
• [SDL 0196] Add Support for StaticIcons to SDLArtwork

Bug fix

• Duplicate send for ButtonPress on v5+
• Fixed issue where SdlManagerListener.onDestroy() was not being called after transport disconnect when bound to older router services.
• Vastly improve AOA USB connection stability especially during disconnect/reconnect.
• Fix legacy BT disconnect issue that left library listening for BT connection
• Fixed the ScreenManager not being able to clear images
• Fixed issue with ScreenManager where it would not call completion listener if TextAndGraphicManager was not dirty
• Make SystemCapabilityManager query only for queryable capabilities
• Fix potential NPEs in SdlRouterService: 1, 2, 3, 4
• Fixed VirtualDisplayEncoder from sending unexpected buffer at startup
• Fixed issue where SdlRouterService wasn't sending EndSession frame with valid hash ID for protocol version >= 5
• Fixed an issue with the ScreenManager submanagers starting at incorrect time
• Fixed issue with PLAY_PAUSE button not being received from older SDL Core versions
• Fixed issue in ScreenManager where it would miss queued updates

Misc

• Remove unnecessary imports
• Updated incorrect JavaDocs for UpdateTurnList
• Show warning if default SdlRouterService class is used in SdlReceiver.

HotFix

• Improved support for Notifications in router service

4.7.2 Release Notes

Hot Fix

• Fix legacy router service issue #925
  • Addressed issue in TransportBroker that caused previous router service's connection messages to be dropped.
  • Add logic to check router service version and perform appropriate logic.
  • Added check if packet doesn't include a transport record
  • Fixed a parcel issue in the SdlPacket class

Hot Fix

• Fixed SDLC partner security library issue
• Removed inaccurate SdlException throw from send RPC methods

4.7.0 Release Notes

Supports:

Summary

• Manager APIs - The manager APIs will closely align with the iOS SDL Library managers, with a few exceptions to match the native platform.
• Transport layer overhaul - The protocol layer and transport layer have been overhauled to properly match the stack in which they should exist. This also sets up three additional features
  • AOA multiplexing - SDL apps can now use the multiplexing transport with the AOA/USB transport. Multiple apps can then register on a single AOA connection to SDL Core.
  • Primary/Secondary transports - apps can now carry their session over multiple transports with the first transport being primary, and a later connected one being a secondary. This means apps can register over bluetooth, then connect over WiFi when necessary (video/audio streaming).
  • All apps should be using MultiplexingConfig at this point unless debugging with TCP.
• Color Scheme for templates - App developers now have the ability to set color themes for the templates they use
• New Remote Control modules
• Additional vehicle data added
• SdlProxyALM has been deprecated - The SdlProxyALM will still function for this release but it has now moved into maintenance mode and no new features will be added. The manager APIs should be used from this point forward.

New Features

• Add enum for predefinedlayout
• Feature/Listen for responses and capability changes in ISdl
• Add ability for RPCs to be versioned/formatted
• [SDL 0159] Static SDL Icon Names Enum

Transport

• [SDL 0141] Supporting simultaneous multiple transports
• [SDL 0194] Android Transport Layer Overhaul

Manager API

• [SDL 0171] Android Manager APIs
• [SDL 0113] SDLAudioStreamManager

RPC Updates

• Add PLAY_PAUSE to ButtonName enum
• [SDL 0014] Adding Audio File Playback to TTSChunk
• [SDL 0037] Expand Mobile PutFile RPC
• [SDL 0041] Provide AppIcon resumption across app registration requests
• [SDL 0062] Template images
• [SDL 0064] Choice-VR optional
• [SDL 0063] Display name parameter
• [SDL 0163] Make spaceAvailable field non-mandatory
• [SDL 0083] Expandable Design for Proprietary Data Exchange
• [SDL 0085] SubMenu Icon
• [SDL 0109] SetAudioStreamingIndicator RPC
• [SDL 0147] Template Improvements: Color Scheme
• [SDL 0150] Enhancing onHMIStatus with a New Parameter for Video Streaming State
• [SDL 0151] ImageFieldName for SecondaryImage
• [SDL 0153] Support for Short and Full UUID App ID

Remote Control

• [SDL 0099] New modules LIGHT, AUDIO, HMI_SETTINGS and parameter SIS Data
• [SDL 0105] New Seat module
• [SDL 0106] OnRCStatus notification
• [SDL 0160] Radio Parameter Update
• [SDL 0165] Lights modules - More Names and Status Values
• [SDL 0172] Update OnRCStatus with a new allowed parameter
• [SDL 0182] Audio Source AM/FM/XM/DAB

Vehicle Data

• [SDL 0072] FuelRange
• [SDL 0082] EngineOilLife
• [SDL 0097] Tire pressure additions
• [SDL 0102] ElectronicParkBrakeStatus
• [SDL 0107] TurnSignal
• [SDL 0175] Updating DOP value range for GPS notification

Bug Fixes

• SystemCapabilityManager false positive issue
• Optimize video streaming for still graphics
• sdl.router.startservice broadcast is sent twice unexpectedly
• maxBitrate in VIDEO_STREAMING capability is read in wrong unit

Documentation

• Add third_party file

Hot Fix

• Fixed IllegalStateException being thrown during router service discovery

Hot Fix

• Fixed versionName to be correct

4.6.0 Release Notes

Supports:

API New Features & Breaking Changes

• RPCRequestFactory has been deprecated. Please use the desired RPC's constructor instead.
• The Android Annotations Library has been added to the project to better help and inform developers about the SDK.

Enhancements

• The router service foreground lifecycle is improved. The notification should no longer be seen when connecting to non-SDL devices.
• The SDL notification now links to a webpage to explain what the notification is and how to hide it.
• The required intent-filter entries for the SdlBroadcastReceiver has been reduced. It is now only listening for the SDL custom intent, ACL connect, and USB connection if using AOA.
• RPC classes now contain constructors with the required parameters for that RPC.
• Moved project to newer version of Gradle. Updated configurations including from compile to api and implementation.
• SdlProxyBuilder was cleaned up to remove redundant variables between the SdlProxyBuilder.Builder object and the SdlProxyBuilder class.

Bug Fixes

• Fixed touch issues with the video streaming feature. A new module was added to handle touch events much more aligned with Android native views.
• Fixed JavaDoc issue in UnregisterAppInterface.
• Fixed JavaDoc issue in AddCommand.
• Added tags to the string resource xml file to ignore translation
• Temporary fix to the TCP transport to catch NetworkOnTheMainThread exceptions when the connection is closing.
• Fix issue where the SdlBroadcastReceiver was attempting to send implicit intents to ping the SdlRouterService. They are now explicit.
• Fix a potential NPE in the SdlBroadcastReceiver while an app is only using USB and does not include an instance of an SdlRouterService.
• Removed reflection usage in bluetooth transports when operating on systems that are newer than Android Oreo in anticipation of Android P.
• Fix an issue where the SdlBroadcastReceiver would throw a false positive regarding whether or not an app had included the correct intent-filter in their SdlRouterService manifest declaration.

4.5.0 Release Notes

Supports:

API New Features & Breaking Changes

• IMPORTANT: SdlRouterService manifest declarations now require an intent-filter and meta-data tags. These changes can be found in the documentation.
• Now targeting version 26 to make use of new Android Oreo features.
  • Most broadcast intents are now sent explicitly instead of implicitly
• Added methods to send a batch of RPCs. This includes chaining RPC messages or sending them all at once

Enhancements

• Added method calls to retrieve pcmCapabilities from the SystemCapbilityManager
• SdlRouterService had a good deal of refactoring and cleaning up to remove warnings and issues
• Created a new way to retrieve the library version from apps.
• Version checking for SdlRouterService is now performed before starting an actual router service.
• General enhancements and stability fixes to the multiplexing transport feature

Bug Fixes

• Fixed a potential deadlock within the LegacyBluetoothTransport
• Fix issue with video streaming not being able to restart after being stopped
• Fixed issue where OnHMIStatus was ignored if the level was the same, but the AudioStreamingState had changed
• Fixed potential NPE in the SdlProxyBase class when a packet was malformed
• Fixed issue that would incorrectly unregister apps from the module through the router service when apps are being force closed and others register
• Fixed issue in SdlRouterStatusProvider class where the handler wasn't able to obtain a looper.
• Fixed issue in ServiceFinder class where the handler was using a looper than was exiting and therefore not posting the expected runnable
• Fixed an issue that kept the SdlRouterService notification icon showing even if there were no current connects
• Fixed an issue where the SdlRouterService would start regardless of what bluetooth device it connected.
• UsbTransport was given a few fixes around incorrect exiting calls
• Fixed an issue found with some modules where they would return a single SpeechCapability instead of a list

4.4.0 Release Notes

API New Features & Breaking Changes

• Now uses compile version 26 to handle breaking changes in Android Oreo
• MOBILE_PROJECTION added as an app type
• Gesture cancellation was added as a touch even type
• More languages were added to the Language enum
• SystemCapaibilityQuery was added with a new SystemCapabilityManager that can retrieve capabilities
• VideoStreamingCapabilities were added. Includes supported codecs, resolution, etc
• Added constructed payloads using BSON
• SDL Remote Control functionality was added. Supports radio and climate controls.
• Added MetadataType to Show lines
• Spatial data for video streaming apps added with HapticData

Enhancements

• Enhanced video streaming APIs
• Added much more test coverage
• Updated buffer read in sizes and streaming packetizers to use TLS max record size
• Consolidated all references to sdl.router.startservice string into single constant
• Refactored RPC classes to consolidate redundant code for retrieving items from underlying data structures
• MultiplexBluetoothTransport is no longer a singleton
• Improved inline documentation
• h.264 streaming now includes SPS/PPS NAL units with every I frame to match iOS library
• Real-time Transport Protocol (RTP) video streaming is now supported
• Correlation IDs are now set automatically. Can be retrieved or overwritten by developer.
• Introduced new video streaming callback and deprecated used of pipped streams
• Added an internal interface for common functions between different managers

Bug Fixes

• Fixed potential out of bounds exception in BinaryFrameHeader
• Fixed issues with unit tests and TravisCI
• Fixed potential NPE in SdlProxyBasemethod, performBaseCommon()
• Fixed potential NPE in MultiplexTransport constructor
• Fixed potential NPE in SdlRouterServicemethod, handleMessaage() for AltTransportHandler
• Fixed potential NPE in SdlRouterServicemethod, writeBytesToTransport()
• Removed hardcoded androidDebuggable = "true" from manifest
• Added fixes to be compatible with Android Oreo (Does not supported target API level 26 yet)
• Fixed issue where intent from router service was delayed
• Apps now trust themselves as router service hosts
• Removed ambiguous validation call in SdlBroadcastReceiver and unused intent extra
• Cleared all warnings from SdlProxyBase

Meta

• Added integration that will deploy to Bintray
• Issue and pull request templates were added for GitHub
• Codecov integration was added
• Updated README links