v6.1.0 Release

[joeljfischer]

Risk

This PR makes minor API changes.

Testing Plan

Unit tests and smoke tests

Summary

v6.1 brings new features and enhancements to the library including a choice set manager and additional template customization features.

It supports SDL RPC Spec 5.0.0 and SDL Protocol Spec 5.1.0.

Changelog

Enhancements

• PlayPause button name has been added for subscription (Add PLAY_PAUSE to ButtonName enum #246).
• Added the ability to play an audio file (such as a jingle) through TTSChunk, which may be used in an Alert or Speak RPC, for example [SDL-0014] ([SDL 0014] Adding Audio File Playback to TTSChunk #524).
• Added CRC checksums to data transfers (such as images or files) and automatic retrying of failed transfers, customizable via a new SDLFileManagerConfiguration [SDL-0037] ([SDL 0037] Expand Mobile putfile RPC #599) (App icon upload fails on reconnection to the head unit #1013) [SDL-0191] ([SDL 0191] Retry Failed File Uploads #1043).
• Added the ability for app icons to appear on the head unit without data being transferred after the first connection [SDL-0041] ([SDL 0041] Provide AppIcon resumption across app registration requests #600).
• Added the ability to send an image as "template", this is a single color image that can be re-colored by the head unit automatically to fit with the background. e.g. on a white background the image will appear black, and on a black background, white [SDL-0062] ([SDL 0062] Template Images #626).
• Added a displayName parameter to displayCapabilities and deprecate displayType [SDL-0063] ([SDL 0063] Display name parameter #627).
• Added new vehicle data: Fuel Range [SDL-0072] ([SDL 0072] New vehicle data - FuelRange #641), Engine Oil Life [SDL-0082] ([SDL 0082] New vehicle data - EngineOilLife #706), Electronic Park Brake Status [SDL-0102] ([SDL 0102] New vehicle data - ElectronicParkBrakeStatus #761), Tire Pressure [SDL-0097] ([SDL 0097] Tire pressure additions #748), and Turn Signal [SDL-0107] ([SDL 0107] New vehicle data - TurnSignal #791).
• Add the ability for submenu menu cells to have icons [SDL-0085] ([SDL 0085] SubMenu Icon #719).
• Add new vehicle capabilities that can be remotely controlled by an application: Seat Controls [SDL-0105] ([SDL 0105] Remote Control - Seat #792), lights, display settings, and additional audio capabilities [SDL-0099] ([SDL 0099] New remote control modules (LIGHT, AUDIO, HMI_SETTINGS) and parameters (SIS Data) #755), SDL-0165, SDL-0182.
• Add the ability to check the status of remote control modules [SDL-0106] ([SDL 0106] Remote Control - OnRCStatus notification #800), [SDL-0172] ( [SDL 0172] Remote Control - Update OnRCStatus with a new allowed parameter #990).
• Add the ability to modify the play / pause button to show either play, pause, stop, or play / pause [SDL-0109] ([SDL 0109] SetAudioStreamingIndicator RPC #892).
• Support both USB / BT and WiFi transports simultaneously when streaming video on supported head units [SDL-0141] ([SDL 0141] Supporting simultaneous multiple transports #900).
• Allow apps to alter template primary, secondary, and tertiary colors while connected to a supported head unit through the RegisterAppInterface and SetDisplayLayout APIs [SDL-0147] ([SDL 0147] Template Improvements: Color Scheme #909).
• Allow checking for the availability of a secondary graphic [SDL-0151] ([SDL 0151] ImageFieldName for SecondaryImage #917).
• Support short and full appIds [SDL-0153] ([SDL 0153] Support for Short and Full UUID App ID #942).
• Allow Perform Interaction Choice Set Choices to not include voice commands [SDL-0064] ([SDL 0064] Choice-VR optional #943).
• Add a choice set manager to assist in presenting choice set menus and keyboard interactions [SDL-0157] ([SDL 0157] Mobile Choice Set Manager #970).
• Add an enum for static icons [SDL-0159] ([SDL 0159] Static SDL Icon Names Enum #944).
• Update TCP transport for production (TCP Transport Rewrite #946).
• Separate SDL example app code better (Separate Example App Code into Separate Folders #1056).

Bug Fixes

• TCP transport failure is now reported via a notification (SDLTCPTransport.m - connect method should report failure to the application #911).
• The Obj-C and Swift example apps can now run without crashing without cleaning (Example apps crash if the build folder is not cleaned #981).
• Swift Cocoapods subspec will now properly download lock screen assets (Assets are not downloaded when using .../Swift to install library via CocoaPods #1026).
• The SDLLockScreenConfiguration showInOptionalState being true was not properly preventing dismissal of the lock screen (The lock screen configuration's showInOptionalState does not work as expected #1070).
• Fix possible crashes in SDLAsynchronousRPCOperation on cancellation of operations (Crash NSRangeException #1076).
• Fix can't get CarWindow rootViewController (Getter for StreamingMediaManager rootViewController always returns nil #1100).
• Fix setting CarWindow rootViewController not on main thread (Setter for rootViewController for CarWindow needs to be run on the main thread #1101).
• Add audio transcode files to default log module map (Log Module Map is missing audio transcoder classes #1103).
• If a RegisterAppInterface or SetDisplayLayout fail, don't set displayCapabilities to nil in the screen manager (If SetDisplayLayout fails, the Screen Manager is broken #1108).

Tasks Remaining:

• Additional Implementation
• Smoke Tests

CLA

• I have signed the CLA