Skip to content

Latest commit

 

History

History
1412 lines (1182 loc) · 107 KB

CHANGELOG.md

File metadata and controls

1412 lines (1182 loc) · 107 KB

Changelog

7.6.1

Testing

  • Xcode 14.3.1
  • iOS 15.7.1 / iOS 16.2.1
  • Core:
    • Manticore (Core v8.2.0, Generic HMI v0.12.0)
    • Ford Sync 3.4 (19353_DEVTEST)
    • Ford Sync 3.4 (19317_DEVTEST)
    • Ford Sync 4.0 (20016_DEVTEST)
    • Core v8.2.0 with sdl_hmi v5.8.0 and generic_hmi v0.13.0

Bug Fixes

  • Fatal Exception: NSRangeException (#2116)
  • SDL App Crash (#2112)

7.6.0

Testing

  • Xcode 14.0
  • iOS 15.7 / iOS 16.0
  • Core:
    • Manticore (Core v8.1.0, Generic HMI v0.12.0)
    • Ford Sync 3.4 (19353_DEVTEST)
    • Ford Sync 3.0 (17276_DEVTEST)
    • Ford Sync 4.0 (20016_DEVTEST)
    • Core v8.2.0-RC with sdl_hmi v5.8.0-RC and generic_hmi v0.13.0-RC

Bug Fixes

  • SDLProtocol message parsing should use a state machine (#17)
  • Default cellID value passed in during openSubMenu method call (#1633)
  • SDLTouchManagerDelegate's didReceivePinchInView is never called in the codebase (#1637)
  • Setting bad data in one T&G field then good data quickly in another can lead to the good data failing (#1781)
  • SystemCapabilityManager screenParams nil, mediaClockFormats empty, and windowID nil when they shouldn't be (#2105)
  • Alert images that are flagged for overwrite fail to display (#2109)
  • Fix iAP write data range error (#2112)

Other

  • Use a script to include public header files based on project settings (#179)
  • Missing a remote control example in example app (#2101)
  • Release Script Bugs (#2098)

7.5.0

Testing

  • Xcode 13.4.1
  • iOS 15.5
  • Core:
    • Core v8.1.0, Generic HMI v0.12.0, SDL HMI v5.7.0
    • Core v7.1.1, Generic HMI v0.10.0, SDL HMI v5.5.0
    • Ford Sync 3.4 (19353_DEVTEST)

Bug Fixes

  • Fix uploading dynamic soft button images on head units that only support static images (#2093)

Other

  • Add a release script to make releases easier (#312)
  • Fix tests not running on Xcode 13.3+ (#2077)
  • Fix failing tests in SDLPresentAlertOperationSpec (#2082)
  • Update testing library dependencies (#2085)

7.4.0

Testing

  • Xcode 13.2/13.3
  • iOS 15.4
  • Core:
    • Core v8.1.0, Generic HMI v0.12.0, SDL HMI v5.7.0
    • Core v7.1.1, Generic HMI v0.10.0, SDL HMI v5.5.0
    • Ford Sync 3.4 (19353_DEVTEST) Ford Sync 3.0 (19353_DEVTEST)

Bug Fixes

  • Fix alert SDLSoftButton not being shown when softButtonCapabilities are missing (#2079)
  • Fix not handling invalid SoftButtonObject configurations (#2067)
  • Fix some race conditions in the SDLLockScreenManager (#2063)
  • Fix not sending error data on security setup failures (#2049)
  • Fix not sending subMenu cell images on RPC connections between v5.0 and v7.0 (#2047)
  • Deprecate SDLVideoStreamingRange.init() because it was confusing (#2050)
  • Fix handling of 0 length incoming security messages (#2054)
  • Fix lockScreen not shown after user dismissal (#2061)

Other

  • Add warning logs when removing invalid voice commands (#2075)

7.3.1

Testing

  • Xcode 13.1
  • iOS 15.1
  • Core:
    • Manticore (Core v7.1.1, Generic HMI v0.10.0)
    • Core v8.0.0, Generic HMI v0.11.0
    • Ford Sync 3.4 (19353_DEVTEST)

Bug Fixes

  • Fix SDLChoiceSetDelegate.userDidSubmitInput called multiple times and SDLChoiceSetDelegate.autocompleteInput called multiple times for each keypress (#2064)

7.3.0 (Since RC 1)

Testing

  • Xcode 13.0 / 13.1
  • iOS 15.0 / 15.1
  • Core:
    • Manticore (Core v7.1.1, Generic HMI v0.10.0)
    • Ford Sync 3.4 (19353_DEVTEST)
    • Ford Sync 3.0 (17276_DEVTEST)
    • Ford Sync 4.0 (20016_DEVTEST)
    • Core v8.0.0-RC with sdl_hmi v5.6.0-RC and generic_hmi v0.11.0-RC

Bug Fixes

  • Fix SDLMenuCell.submenuLayout not being copied to new cells (#2048)

7.3.0 RC 1

Testing

  • Xcode 13.0
  • iOS 15.0
  • Core:
    • Manticore (Core v7.1.1, Generic HMI v0.10.0)
    • Ford Sync 3.4 (19353_DEVTEST)
    • Ford Sync 3.0 (17276_DEVTEST)
    • Ford Sync 4.0 (20016_DEVTEST)
    • Core v8.0.0-RC with sdl_hmi v5.6.0-RC and generic_hmi v0.11.0-RC

Bug Fixes

  • Fix a mismatch in TireStatus vehicle data (#1297)
  • Fix menu updates fail if updates are queues (#1957)
  • Fix Choice Set Manager back to back choice sets can fail (#2018)
  • Fix Choice Set Manager not handling order of operations correctly (#2020)
  • Fix Security handshake doesn't handle errors correctly (#2024)
  • Fix Choice Set Manager loaded cells are not taken into account for uniqueness (#2025)
  • Fix swapping menu items with unique identifiers causes incorrect unique identifiers (#2027)
  • Fix delete / add submenu cells doesn't work properly (#2028)
  • Fix System Capability Manager crashes when removing capabilities (#2033, #2036)
  • Fix file manager can upload the same file multiple times (#2034)
  • Fix rare cases when a completion handler would not be called (#2044)

Other

  • Add ability to manually run CI tests (#2016)
  • Fix code documentation spelling & grammar (#2021)
  • Fix code documentation of capabilities (#2031)
  • Fix example app iOS 15 appearance (#2042)

7.2.0 (Since RC 1)

Testing

  • Xcode 12.5
  • iOS 14.6
  • Core:
    • Manticore (Core v7.1.1, Generic HMI v0.10.0)
    • Ford Sync 3.4 (19353_DEVTEST)
    • Ford Sync 3.0 (17276_DEVTEST)
    • Ford Sync 4.0 (20016_DEVTEST)
    • Core v6.1.2 with sdl_hmi v5.3.0 and generic_hmi v0.8.1

Bug Fixes

  • Fix incompatibility with some other 3rd-party libraries using math.h (#1995)
  • Numerous fixes to SDLVideoStreamingRange (#2012)
  • Fixed menu manager sending secondary image with menuCells when secondary images are not supported (#2014)

Other

  • Fixed random failures in SDLVoiceCommandManagerSpec due to operations being canceled (#2002)

7.2.0 RC 1

Testing

  • Xcode 12.5
  • iOS 14.6
  • Core:
    • Manticore (Core v7.1.1, Generic HMI v0.10.0)
    • Ford Sync 3.4 (19353_DEVTEST)
    • Ford Sync 3.0 (17276_DEVTEST)
    • Ford Sync 4.0 (20016_DEVTEST)
    • Core v6.1.2 with sdl_hmi v5.3.0 and generic_hmi v0.8.1

Bug Fixes

  • Added a workaround for Ford Sync 3.0 not properly sending back MEDIA template capabilities when set with SetDisplayLayout (#1152)
  • Video data that fails to encrypt is now properly handled (#1830)
  • When updating voice commands, any voice commands that are identical will have their handlers updated, but will no longer be deleted and re-uploaded (#1855)
  • Updating the main menu or choice sets now add unique identifiers to primary text based on which text fields and image fields will be displayed on the module (#1940)
  • Fixed preloading choices not properly marking which choices successfully loaded and which failed (#1941)
  • Voice commands with duplicate strings in an individual command will strip the duplicates (#1961)
  • Voice commands that contain duplicates between different commands will now fail early (#1959)
  • Voice commands that contain no strings will be stripped (#1964)
  • Fix file manager returning that files are not uploaded when they are on Core v4.5.0+ (#1978)
  • Fix displayed warnings (#1988)
  • Fix race condition in mutable dictionary (#1996)
  • Fix Ford Sync not properly returning NON-MEDIA template name in RegisterAppInterfaceResponse (#1999)

Other

  • Fix failing haptic manager tests on Xcode 12.5 (#1982)
  • Fixed Obj-C example app not restarting properly when Core is shut down (#1984)
  • Fix missing test files (#1985)
  • Fix example apps button state not matching the image / text state when the app is reopened after exiting (#1991)

7.1.1

Versions

Testing

  • Xcode 12.5
  • iOS 14.5.1
  • Core:
    • Manticore (Core v7.0.0, Generic HMI v0.9.0)
    • Ford Sync 3.4 (19353_DEVTEST)
    • Ford Sync 3.0 (17276_DEVTEST)
    • Ford Sync 4.0 (20016_DEVTEST)
    • Core v6.1.2 with sdl_hmi v5.3.0 and generic_hmi v0.8.1
    • Core v7.1.1 with generic_hmi v0.10.0

Bug Fixes

  • Fixed initial StartServiceACK being timed out too soon with many app connections to module (#1783, #1795, #1847)
  • Fixed RPC encryption fails when RPCs have multi-frame payloads (#1954)
  • Fixed a crash when the head unit sends a StartServiceACK to elevate the RPC service to encryption (#1966)
  • Fixed encrypted RPCs fail without a callback when encryption isn't set up (#1971)
  • Fixed the file manager not sending images when ListFiles is encrypted (#1975)

7.1.0 (Since RC 1)

Versions

Testing

  • Xcode 12.4
  • iOS 13.7 and 14.4.1
  • Core:
    • Manticore (Core v7.0.0, Generic HMI v0.9.0)
    • Ford Sync 3.4 (19353_DEVTEST)
    • Ford Sync 3.0 (17276_DEVTEST)
    • Ford Sync 4.0 (20016_DEVTEST)
    • Core v7.1.0-develop with sdl_hmi v5.5.0-develop and generic_hmi v0.10.0-develop

Enhancements

  • Updated the Swift name of the system info callback from didReceive(systemInfo:) to didReceiveSystemInfo(_:).

Bug Fixes

  • Fixed video streaming apps not resuming when switching between them (#1944)
  • Fixed lock screen not being dismissible when the lock screen display mode is always but enableDismissGesture = YES (#1948)
  • Fixed custom video encoder settings not overriding default video encoder settings (#1950)

Example Apps

  • Updated some coloring of the example apps to use more readable colors.
  • Fixed example app's menu not displaying correctly when the app is exited (#1967).

7.1.0 Release Candidate 1

Versions

Enhancements

  • Added the ability to show menu cells and choice set cells with the same title (#1024)
  • Added the ability to display media time skip buttons instead of the standard track skip buttons, e.g. for podcast apps (#1080)
  • Added the ability to use a numeric keyboard layout, mask input characters, and provide custom keys on a keyboard (#1356)
  • Added the ability to set a custom playback rate for the media clock timer (#1377)
  • Update vehicle data BodyInformation (#1477)
  • Added new vehicle data SeatOccupancy (#1487)
  • Main menu cells and subcells now have additional available text and image properties (#1510)
  • Added new vehicle data ClimateData (#1511)
  • VideoStreamingCapability now allows the module to tell an app its preferred frame rate (#1553)
  • Added the ability to present Alert RPCs through the screen manager (#1579)
  • Added new TextFieldName enums for ShowConstantTBT (#1676)
  • Added the ability for the module and app to declare multiple possible video streaming capabilities so that features like Picture-in-Picture and Split-Screen can be supported (#1730)
  • VideoStreamingCapability parameters will now be merged with the app's preferred streaming settings to use the lowest settings (#1860)
  • Updated ShowConstantTBT RPC description (#1863)
  • Added the ability to disconnect based on received vehicle details, including before the app registers on 7.1+ modules (#1876)
  • Deprecated SDLStaticIcon.auxillaryAudio and add a fixed spelling of SDLStaticIcon.auxilliaryAudio (#1938)

Bug Fixes

  • We changed a ListFiles workaround in SDLFileManager to only activate on RPC v4.3.1 and below connections (#827)
  • Fixed overwriting SDLArtwork in the manager system not working properly (#1117)
  • Fixed soft buttons being delayed on Ford Sync 3.0 and increased SDL CPU usage (#1778)
  • Deprecated SDLKeyboardProperties.autoCompleteText in favor of SDLKeyboardProperties.autoCompleteList (#1784)
  • Setting SDLTouchManager.tapTimeThreshold to 0.0 will no longer cause a crash (#1798)
  • Fixed button notifications not working properly the first button press on Ford Sync 3.0 (#1793)
  • Fixed a number of potential issues around the iAP transport seen on iOS 14 devices (#1799, #1809, #1892, #1893)
  • Fixed cases when the first StartService protocol message is not version 1 (#1837)
  • Refactored the SDLVoiceCommandManager to use queues (#1841)
  • Fixed SDLArtwork with a static icon not copying (#1846)
  • Fixed SDLDisplayCapabilities should be deprecated (#1857)
  • Fixed uploading the blank artwork every time instead of persisting it (#1864)
  • Fixed cases where setting the timeout of an SDLChoiceSet could fail (#1891)
  • We now throw an exception if you try to display two SDLSoftButtonObjects with the same name (#1897)
  • Fixed SDLTextFieldName.timeToDestination documentation (#1915)
  • Fixed uploaded files not being divided into multiple RPCs correctly (#1927)

RPC Generator

  • Fixed generator not adding enum parameter descriptions (#1751)
  • Generator now correctly generates enums with NS_TYPED_ENUM (#1834)
  • Fixed generator creating incorrect struct parameter names (#1905)

Other

  • Fixed example app template resetting when HMI level changes (#1827)
  • Fixed RPC Generator unit tests failing (#1845)
  • Fixed failing unit tests on CI (#1880, #1884, #1925, #1929)
  • Fixed test cases using the OCMock deprecated observerMock (#1913)
  • Removed snapshot test cases (#1921)

7.0.0

Versions

Testing

  • Tested with Xcode 12.0
  • iOS 13.7 and 14.0
  • Core:
    • Manticore (Core v6.1.1, Generic HMI v0.8.1)
    • Ford Sync 3.4 (19353_DEVTEST)
    • Ford Sync 3.0 (17276_DEVTEST)
    • Ford Sync 4.0 (20016_DEVTEST)
    • Core v7.0.0-rc.1 with sdl_hmi v5.3.0-develop and generic_hmi v0.9.0-develop

Enhancements

  • Added main menu RPC support for deeper submenus (#910).
  • Added main menu RPC support for driver distraction limitations to the menu (#926).
  • Updated max URL lengths in SystemRequest to be unlimited (#1110).
  • Added support for new types of character sets (#1139).
  • Added new RPC for SubtleAlert, a notification-like alert (#1355).
  • Added support to Swift Package Manager (#1387).
  • Added new vehicle data StabilityControlsStatus (#1449).
  • Changed fuel-related vehicle data RPCs (#1472).
  • Added new vehicle data HandsOffSteering (#1473).
  • Added new vehicle data WindowStatus (#1508).
  • Added main menu RPC support for pagination and dynamic updating (#1520).
  • Added new vehicle data GearStatus (#1522).
  • Added changeLayout method to SDLScreenManager to change templates, including in a batched update (#1612, #1749).
  • Added support for new WebEngine projection hmi types and templates (note that this is not properly supported in this library outside of the RPCs; look at the JavaScript Suite library for more information) (#1681).
  • Added a reason parameter to protocol NAKs (#1684).
  • Update the minimum required iOS version to 10.0 (#1738).
  • SDLSetDisplayLayout(+Response) is now deprecated (#1785).
  • SDLLockScreenViewController now defaults to modal presentation style .fullScreen (#1794).

Bug Fixes

  • SDLServiceUpdateReason enums are now named properly (#1502).
  • Consolidated serial queue logic (#1614).
  • Consolidated logic for saving the dynamic MTU size (#1615).
  • Fixed example app files not in the proper folder (#1765).
  • Fixed SDLSetGlobalProperties init missing userLocation (#1771).
  • Fixed SDLOnDriverDistraction properties missing nullable (#1813).

RPC Generator

  • Fixed generator not sorting imports (#1720).
  • Fixed generator generating deprecated properties into initializers (#1722).
  • Fixed generator adding incorrect line breaks in documentation (#1723).
  • Fixed generator not generating RPC response initializers correctly (#1734).
  • Fixed generator not generating min/max array size documentation (#1736).
  • Fixed generator should not strip text after "@TODO" (#1744).
  • Fixed generator adding unnecessary #pragma suppressions (#1757).
  • Fixed generator not creating proper history documentation (#1761).
  • Fixed generator not properly generating initializers with float types (#1763).

Other

  • Moved files around to simplify distribution (#568).
  • Fixed warnings in Objective-C example app (#1772).
  • Fixed example apps resetting soft buttons whenever going to HMI FULL (#1782).
  • Cleaned up inline documentation grammar and spelling issues (#1787).
  • Update CI to Xcode 12 and fix screenshot failures (#1801).
  • Fixed unit tests crashing (#1802).
  • README updates to point to testing YAML (#1816).
  • Removed some unnecessary warning suppression (#1819).

6.7.0

Versions

Testing

  • Tested with Xcode 11.6
  • iOS 13.5 and 13.6
  • Core:
    • Manticore (Core v6.1.1, Generic HMI v0.8.1)
    • Ford Sync 3.4 (19353_DEVTEST)
    • Ford Sync 3.0 (17276_DEVTEST)
    • Ford Sync 4.0 (20016_DEVTEST)
    • Core v5.1.0 with sdl_hmi v5.2.0
    • Core v6.1.1

Enhancements

  • Added subscribe button features to the screen manager (#1563).
  • Added a new SDLManager delegate method for updating the HMI and VR language separately (#1593).
  • Added a new initializer to SDLButtonPress because the existing ones were missing a mandatory parameter (#1635).
  • Aligned SDLPermissionManager methods with Java Suite and JavaScript Suite libraries, adding methods for parameter permissions and more (#1661, #1667, #1682).

Bug Fixes

  • Fix the video background when the app goes into the background not always showing when it should (#1620).
  • Improved SDLAudioStreamManager error messages (#1622).
  • Better handling of head units sending a nil displayCapabilities in the SystemCapabilityManager (#1623).
  • Fixed a deadlock that could happen on the lock screen due to some calls being asynchronous but handled synchronously (#1629).
  • Stop and start SDLFocusableItemLocator when the video stream starts and stops (#1631).
  • Fixed turning wifi off and back on causing secondary transport to fail (#1631, #1639).
  • Fixed using the permission manager in Swift would sometimes crash (#1636).
  • Fixed Travis tests failing and moved to Github Actions CI (#1640, #1642, #1678).
  • Fixed sending an empty VR array in an SDLMenuCell would fail (#1648).
  • Fix a launch app should only happen on the main thread (#1662).
  • Fixed some documentation for a permission manager method to be more specific (#1665).
  • Fix the encryption manager not being shut down correctly after a disconnect / reconnect (#1675).
  • Refactor the protocol layer and merge the proxy and lifecycle layers (#1680).
  • Fix video session properties not being re-set upon reconnection (#1683).
  • Fix soft button image uploads failing if the first state has no images but other states do (#1698).
  • Fix a potential race condition in SystemCapabilityManager (#1709).
  • Fix a deadlock that would occur when restarting the SDLManager in the managerDidDisconnect callback (#1710).
  • Fix a crash that would occur when receiving an unknown RPC (#1713).
  • Fix the secondary transport timer starting when a primary transport connects (#1716).
  • Fix protocol delegates not always receiving an EndServiceNAK (#1718).

Other

  • Use an NSTimer wrapper everywhere internally instead of the raw NSTimer (#1611).
  • Add security manager tests to secondary transport unit tests (#1653).
  • Fixed documentation for permission manager subscribe callbacks (#1724).

Example Apps

  • Add icons to example app vehicle data menus (#1580).
  • Fixed some small icons and replaced a few icons (#1581).

6.6.0

Versions

Enhancements

Bug Fixes

Example Apps

6.5.0 (Since RC 1)

Bug Fixes

6.5.0 Release Candidate 1

Bug Fixes

6.4.1

Bug Fixes

6.4.0

Versions

Enhancements

Bug Fixes

Example Apps

6.3.1

Bug Fixes

6.3.0

Versions

Enhancements

Bug Fixes

Example Apps

Dependencies

6.2.3

Versions

Bug Fixes

6.2.2

Versions

Bug Fixes

6.2.1

Versions

Enhancements
Bug Fixes
Example App

6.2.0

Versions

Enhancements

  • Added a screen informing the user what they must do if a video streaming app is not in the foreground on their mobile device (#1058).
  • SDLArtwork added an initializer for static icons, allowing the screen manager to handle displaying static icons in its supported fields (#1062).
  • Added better SetMediaClockTimer initializers (#1071).
  • All received messages are logged in verbose logging (#1133).
  • Added SDLLifecycleConfiguration properties for enforcing minimum protocolVersion and rpcVersion connections to head units, effectively blocking older head units as desired (#1142).
  • Added RPC support for app services, including all three current app service types: media, weather, and navigation (#1147, #1148 #1162).
  • Added support for the cloud app transport, enabling OEM apps to expose endpoints for cloud apps to the system policy table (#1166).
  • Updated Swift example app to Swift 4.2 (#1185).
  • Updated testing dependencies and Travis CI (#1208).
  • Added automatic updates and caching to the System Capability Manager for v5.1+ head units (#1212).

Bug Fixes

  • Fixed IAP-Bluetooth to IAP-USB transport switching (#1079).
  • Fixed an issue where the manager would attempt to reconnect even if the head unit unregistered the app for a reason where the app should not reconnect (#1084, #1097).
  • Fixed duplicate HMI status logs (#1124).
  • Fixed SDLChoiceManager not deleting test choice (#1129).
  • Fixed video streaming reference cycle (#1130).
  • Improved RTC video streaming resumption (#1137).
  • Updated SendLocation API documentation (#1170).
  • Added more informative exception on creation of an invalid SDLSoftButtonState (#1126).
  • Fixed numerous crashes in RELEASE builds when connected to head units that are providing invalid data (DEBUG builds will continue to crash unless the log configuration is altered to disable those assertions in DEBUG as well). (#1153, #1159, #1161, #1198, #1218, #1230)
  • Fixed Swift 4.2 support in SDLPermissionManager by removing some SDLBool specifier protocols from NSNumber callbacks in NSDictionary (#1190).
  • Fix calling single tap callback checks for the hit view in the SDLTouchManager from a background thread. The callback itself will continue to occur on a background thread until the next major version change. (#1207)
  • Fixed max automatic correlation id to match protocol spec max of INT32_MAX instead of UINT16_MAX. (#1214)
  • Fixed some SDLAppInterfaceUnregisteredReason enums not being available in the sdl_ios library. (#1216)
  • Fixed head units that don't support choice set menuName required parameter causing issues. Proper errors will now be thrown. (#1220)
  • Fixed app attempting a reconnect after being unregistered for a PROTOCOL_VIOLATION. (#1223)

6.1.2

Bug Fixes

  • Fix external accessories never reconnecting if connected over both Bluetooth and USB when one transport is disconnected (#1113).

6.1.1

Bug Fixes

  • Fix possible crash when checking text fields in the screen manager (#1122).
  • Fix possible crash when checking language field of RegisterAppInterfaceResponse in SDLLifecycleManager (#1127).

6.1.0 (Since RC 2)

Versions

Changes

  • None

6.1.0 Release Candidate 2

Bug Fixes

  • If a RegisterAppInterface or SetDisplayLayout fail, don't set displayCapabilities to nil in the screen manager #1108.

6.1.0 Release Candidate 1

Enhancements

  • PlayPause button name has been added for subscription #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] #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] #599 #1013 [SDL-0191] #1043.
  • Added the ability for app icons to appear on the head unit without data being transferred after the first connection [SDL-0041] #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] #626.
  • Added a displayName parameter to displayCapabilities and deprecate displayType [SDL-0063] #627.
  • Added new vehicle data: Fuel Range [SDL-0072] #641, Engine Oil Life [SDL-0082] #706, Electronic Park Brake Status [SDL-0102] #761, Tire Pressure [SDL-0097] #748, and Turn Signal [SDL-0107] #791.
  • Add the ability for submenu menu cells to have icons [SDL-0085] #719.
  • Add new vehicle capabilities that can be remotely controlled by an application: Seat Controls [SDL-0105] #792, lights, display settings, and additional audio capabilities [SDL-0099] #755, [SDL-0165] #954, [SDL-0182] #1022.
  • Add the ability to check the status of remote control modules [SDL-0106] #800, [SDL-0172] #990.
  • Add the ability to modify the play / pause button to show either play, pause, stop, or play / pause [SDL-0109] #892.
  • Support both USB / BT and WiFi transports simultaneously when streaming video on supported head units [SDL-0141] #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] #909.
  • Allow checking for the availability of a secondary graphic [SDL-0151] #917.
  • Support short and full appIds [SDL-0153] #942.
  • Allow Perform Interaction Choice Set Choices to not include voice commands [SDL-0064] #943.
  • Add a choice set manager to assist in presenting choice set menus and keyboard interactions [SDL-0157] #970.
  • Add an enum for static icons [SDL-0159] #944.
  • Update TCP transport for production #946.
  • Separate SDL example app code better #1056.

Bug Fixes

  • TCP transport failure is now reported via a notification #911.
  • The Obj-C and Swift example apps can now run without crashing without cleaning #981.
  • Swift Cocoapods subspec will now properly download lock screen assets #1026.
  • The SDLLockScreenConfiguration showInOptionalState being true was not properly preventing dismissal of the lock screen #1070.
  • Fix possible crashes in SDLAsynchronousRPCOperation on cancellation of operations #1076.
  • Fix can't get CarWindow rootViewController #1100.
  • Fix setting CarWindow rootViewController not on main thread #1101.
  • Add audio transcode files to default log module map #1103.

6.0.2

Bug Fixes

  • Video streaming apps put into a phone background state can now properly stop the video streaming when it leaves a streamable HMI state. #1047

6.0.1

Bug Fixes

  • Fixed a crash that could occur in development circumstances if the head unit returns "-1" for an enum
  • Fixed manually sent Show RPCs causing issues when changing layouts.

6.0.0 (Changes since RC1)

  • None

6.0.0 Release Candidate 2 (Changes since RC1)

Bug Fixes

  • Fixes generated file names being too long for some SDL implementations. #976
  • Unauthorized apps will no longer spin in a reconnection loop. #977
  • Fixes needing to clean every time one switches building the example apps. #982
  • Speeds up video streaming resets when app goes from background -> foreground on the phone. #979

6.0.0 Release Candidate 1

Breaking Changes

  • Remove SDLProxy, SDLProtocol, SDLTransport and related classes and protocols. [SDL-0016] #454 [SDL-0017] #525 [SDL-0019] #603

Enhancements

  • Add API documentation #97
  • Added a Swift example app and expanded the Obj-C example app. #620
  • Add System Capability Manager, allowing easier observance of capability changes. [SDL-0088] #916
  • Add Menu Manager, making setting a menu (AddCommand / AddSubmenu) much simpler. [SDL-0155] #927

Bug Fixes

  • Fix CarWindow api should allow app to manually set screen resolution by exposing protocol that should have been exposed. #908
  • Fix notification of hmiLevel change when it has not changed. #918
  • Fix SDLFileManager not calling completion handler when it is shut down before transition to Ready state, causing a memory leak. #919
  • Fix connection retry counter not reset when the accessory is connected. #921
  • Fix SDLTouchManager to handle all touch events in SDLOnTouchEvent. #935
  • Fix SDLCarWindow does not send video after reconnection when lock screen is disabled. #937
  • Simplified Proxy, Protocol, and Transport internals. #948
  • Fix Screen Manager images not sent on reconnection. #953
  • Fix image soft buttons being sent too early. #955
  • Fix custom log modules in Swift. #962
  • Fix graphics not being set after reconnects. #963
  • Fix permission manager not resetting correctly on reconnection. #964
  • Fix SDLShow initializer crashes. #966
  • Fix mediaTrack field on ScreenManager. #968

5.2.0

Enhancements

  • Add a screen manager which currently handles text, graphics, and soft buttons [SDL-0134] #862
    • Add soft button object and states, which allow for declaratively designing soft buttons with multiple states
  • Allow the car window orientation exception to be disabled #867
  • You can now create an SDLArtwork without a name and a name will be generated based on a hash of the data. You can also now upload an artwork through SDLFileManager and have uploaded artwork names passed back to you [SDL-0124] #865
  • You can now batch send RPCs either as a batch, or sequentially, waiting for the previous RPC request to respond before sending the next one. This may be useful for batch sending addCommands or for sending a performInteraction immediately after the createInteraction finishes [SDL-0087] #723
  • There is now a change registration manager for managing language [SDL-0054] #617
  • Allow multiple AppHMITypes [SDL-0129] #851

Bug Fixes

  • Fix single taps often being recognized as a pan; there is now a customizable threshold at which pans will be registered; it defaults to 8px #884
  • Fixed video stream would restart immediately after being stopped while in the background. It will now only restart when brought back into the foreground #858
  • Fixed touch manager views being accessed in on background threads #875
  • Fixed crash when using log files #872
  • Properly stop the audio service in HMI level NONE and BACKGROUND #803
  • Fix EA session not closing on RPC service timeout #869
  • Fix EA session background not always receiving data in background #835
  • Silence an output stream write warning #850
  • Improve SDLAddCommand initializer to fix an iconValue error #846
  • Fix SDLUploadFileOperation not finishing on error #860
  • Fix AudioStreamingState not being notified when LifecycleManager is ready #863
  • Fix some runtime main thread warnings #852
  • Work around a module ListFiles bug on previous SDL Core versions #827
  • CarWindow will no longer crash on iOS 9 #904

5.1.1

Bug Fixes

  • Fixed import statement, allows for Cocoapods release

5.1.0

Enhancements

  • Log unsuccessful RPC responses automatically #811.
  • IAP Transport reconnection optimizations #816.
  • Adds SDLAudioStreamManager that does on-the-fly transcoding of audio files to an SDL compatible PCM format and can send that audio to be played. This is for NAVIGATION applications only [SDL-0113] #795.
  • CarWindow automated ViewController based streaming [SDL-0111] #794.
    • Add automatic video streaming via screenshotting.
    • Update the Lock Screen to use a UIWindow on top of any other UI.
    • SDLStreamingMediaManager now manages framerate more strictly using a CADisplayLink and uses this to sync touch manager and car window updates to the framerate.
    • Several SDLStreamingMediaConfiguration additions to support CarWindow.
    • Update SDLTouchManager to sync callbacks with the framerate, this fixes many issues with drawing at inopportune times. There is a BOOL to retain old behavior.

Bug Fixes

  • Enabled additional Xcode 9 warnings when building the project and fixed many warnings, mainly around implicit casts #814.
  • Fix SDLSlider initializer infinite recursion #808.
  • Fix crash if disconnected while setting up the app icon #833.
  • Force manual IAP session stop calls to run on the main queue #831.
  • Navigation audio stream is no longer viewed as available in HMI NONE #803.

Other

  • Remove an unused testing library from the Cartfile #823.

5.0.0

No changes since RC3

5.0.0 Release Candidate 3 (changes since RC 2)

Bug Fixes

  • Fix a possible crash if the List Files request from the FileManager fails due to disconnection or unregistration.

5.0.0 Release Candidate 2 (changes since RC 1)

Bug Fixes

  • Fixed podspec
  • Focus manager will only activate on iOS 9+, it uses APIs only available on iOS 9+

5.0.0 Release Notes

Breaking Changes

  • SDLProxy.streamingMediaManager is now removed. If you wish to use a streaming media manager, you must use SDLManager.streamingMediaManager. The streaming media manager has been entirely redesigned and now takes into account both phone and head unit app lifecycles SDL-0033. There is now a streaming media configuration added to SDLConfiguration.
  • SDLJingle constants have been removed #7.
  • Public files SDLJsonEncoder.h, SDLJsonDecoder.h, SDLDecoder.h, and SDLEncoder.h have been removed #8.
  • SDLSiphonServer has been removed; if something similar is needed, it may be custom built and inserted into the SDLLogManager #85.
  • RPC array and dictionary properties are now immutable #152.
  • SDLOnWaypointChange, a misspelling of SDLOnWayPointChange has been removed #489.
  • SDLRPCStruct and all RPC subclasses now take an immutable dictionary to decode #122 SDL-0005, SDL-0005.
  • SDL enums are now all stringly typed in Objective-C, and swift enums in Swift #20 SDL-0006.
  • iOS 6 and iOS 7 are no longer supported SDL-0008 SDL-0024.
  • Use nullability annotations throughout the project #73 SDL-0018.
  • Remove SDLRPCRequestFactory, initializers now exist on most RPC classes SDL-0020.
  • SDLTTSChunkFactory was removed, use the initializers on SDLTTSChunk instead SDL-0021.
  • Handler events now provide better parameters instead of generic ones SDL-0027.

Enhancements

  • Most properties are now nonatomic, which should speed up the library significantly #49.
  • SDLLockScreenViewController now uses template images, reducing the size of the library #450.
  • RPC classes now conform to NSCopying SDL-0011.
  • Added convenience methods for pulling out SDL notifications from NSNotification callbacks #553.
  • SDLTouchManager now supports gesture cancellation #673.
  • SDLStreamingMediaManager now supports automatic GetSystemCapability calls #686.
  • SDLRegisterAppInterfaceResponse fixed pcmCapabilities not being exposed #714.
  • Generics have been added for collections throughout the library SDL-0007.
  • SDLFileManager will not stream from a file on disk if possible SDL-0025.
  • SDLFileManager added methods for sending multiple files in one call SDL-0029.
  • Added additional SDLManager delegate methods for all onHMIStatus state changes SDL-0032.
  • Added a handler to SDLPerformAudioPassThru SDL-0035.
  • SDLStreamingMediaManager now supports H.264 + RTP SDL-0048.
  • Added SDL Remote Control baseline SDL-0071.
  • Focusable items can now be sent (to Core 4.4+) and a manager exists that will automatically handle finding and sending those rects if a UIWindow is set in the SDLStreamingMediaConfiguration. They will also be passed back to the developer through the SDLTouchManagerDelegate SDL-0075 SDL-0081 SDL-0090.

Bug Fixes

  • Services are now properly ended with hash ids #661.
  • Constants are now unified into one style #711.
  • Fix streaming media manager always assumed 30fps streaming; it can now be custom set by developers in the video encoding dictionary #717.

Example App

Other

  • SDL constants are now constants instead of #define #3.
  • Some protocol property and enum names were incorrect but now fixed #275.
  • Internal getters and setters on RPC classes no longer repeat code everywhere #493.
  • SDLOnLockScreenStatus does not use constants for property keys #497.
  • Removed deprecated methods #679.

4.7.4 Release Notes

Bug Fixes

  • Fix for connecting video streaming on Core 4.4.0 (to be released) and above.

4.7.3 Release Notes

Bug Fixes

  • Performance fixes for streaming video.
  • Fixes for background connection on IAP transports.

4.7.2 Release Notes

Bug Fixes

  • Fixes some head units not connecting properly due to the start service payload length not being set properly.

4.7.1 Release Notes

Breaking Changes

  • This bumps up the minimum supported version to 7.0 due to Xcode 9 changes. The upcoming v5.0.0 will raise the minimum version to 8.0.

Bug Fixes

  • Fixes the possibility of timers not being appropriately deallocated #382.

Tests

  • Any tests must now be run on Xcode 9.
  • The travis config file has been updated to run on Xcode 9.

4.7.0 Release Notes (since RC 1)

Bug Fixes

  • Fixed payloads being created with nil data causing a crash #715.
  • Fixed documentation warnings.

4.7.0 Release Candidate 1

Enhancements

  • This library implements RPC Spec v4.5.0, Protocol Spec v5.0.0.
  • Added App type enum: PROJECTION, for an app that uses video streaming for its interface yet is not a navigation app SDL-0031.
  • Added new TouchType enum for touch canceled SDL-0049.
  • Expanded the SyncMsgVersion struct on Register App Interface Response to include a patch version SDL-0050.
  • Support new protocol spec with constructed control frame payloads SDL-0052 SDL-0078.
  • Added GetSystemCapability RPC request for retrieving additional capabilities. This also expanded the HMICapabilities struct in the RegisterAppInterfaceResponse SDL-0055 SDL-0058.
  • Added language enums for various additional languages SDL-0060 and SDL-0076.
  • Expanded the Show RPC to include metadata types for text fields SDL-0073.
  • Added SendHapticData RPC to send rectangles of touchable buttons in video streaming. This allows the head units with haptic interface devices (such as a selection wheel) to highlight selectable areas SDL-0075.
  • Support IAP multisession with a new protocol string com.smartdevicelink.multisession SDL-0080. Please check the README and add the new protocol string to your apps! This is improve your successful connection rate.

Bug Fixes

  • Added background task handling for IAP connections, fixes a possible bug with connections #591.
  • Fixed a deadlock that could occassionally occur on control session disconnections #643.
  • Fixed library crash when in DEBUG mode on normal shutdown sequences #637.
  • Fixed IAP control session not always being cleaned up #648.
  • Fix a rare crash on disconnection that could occur when the response dispatcher was not cleared properly #666.
  • Fix some blocks holding retain cycles #665.
  • Updated proxy to no longer throw an exception when unknown protocol headers are received. This resolves an issue with corrupted protocol headers #671.

Other

  • Added a note to the documentation regarding file name length maximums #640.

4.6.1 Release Notes

Bug Fixes

  • Fixes a bug where an app would crash if connected while the app is foregrounded and the vehicle is already in motion.

Example App

  • Now compiles correctly.

4.6.0 Release Notes (since RC 2)

Example App

  • Added a command to send a GetVehicleData.

Known Issues

  • On DEBUG builds of an app, if a connected Sync Gen 3 head unit goes through a normal shut down sequence (key out, door open), the app will crash. This will not occur on RELEASE builds.

4.6.0 Release Candidate 2 Release Notes (since RC 1)

Bug Fixes

  • Altered the connection timeframe from 0-10 seconds to 1.5-9.5 seconds to improve connection reliability. (SDL-0067)

Example App

  • Fixes a bug causing a crash upon unexpected IAP disconnection and reconnection.

4.6.0 Release Candidate 1 Release Notes

Bug Fixes

  • Fix setting lifecycle configuration appType to nil.
  • If an array would return NSNull, return an empty array instead.
  • Removed uses of @import for compatibility issues.
  • Added some Xcode 8.3 compatibility fixes.
  • Fixed reconnection attempts unable to be stopped, or it would crash.
  • Fix SDLMenuParams initWithMenuParams:parentId:position: improperly setting position.
  • IAP transport now does read/writes on a background thread.

Other

  • We now use a new podspec: "SmartDeviceLink", and deprecated the current one ("SmartDeviceLink-iOS"), please update your podfiles. This will be necessary for some features in v5.0.

Known Issues

  • When an app is connected over USB, the USB is disconnected, then reconnected, the app will crash.

4.5.5 Release Notes

Bug Fixes

  • Added a check for if SDLManager is already started and prevent starting it again.
  • Prevent infinite loops in IAP transport.

Example App

  • Fixed incorrectly setting button state on disconnect.

4.5.4 Release Notes

Bug Fixes

  • Streaming video will not crash if data is unexpectedly NULL.
  • SDL now compiles on Xcode 8.3.
  • Lockscreen will now appear appropriately when it's remote HMI is in the background.
  • Internal state machines now throw more descriptive exceptions.

4.5.3 Release Notes

Bug Fixes

  • SDLManager's delegate method hmiLevel:didChangeToLevel: now only triggers when the HMI level changes, instead of whenever an onHMIStatus is received.
  • Fixed a few crashes in SDLStreamingMediaManager for navigation video streaming.

4.5.2 Release Notes

Bug Fixes

  • Fixed unhandled Register App Interface Response warnings causing the manager to disconnect.
  • Fixed SDLManager stop not actually stopping SDL.
  • Fixed SDLDebugTool resetting its logs on disconnection.
  • Fixed SDLManager auto-reconnection sometimes causing a crash.

Example Project

  • Connect / Disconnect button appearance fixed.

4.5.1 Release Notes

Bug Fixes

  • Fixed large file transfers not properly setting their offset.
  • Check for nil before attempting to send an RPC request.

4.5.0 Release Notes (Since Beta 2)

Bug Fixes

  • Fixed an issue attempting to upload an app icon when the head unit does not support images.

4.5.0 Beta 2 Release Notes

Bug Fixes

  • Fixed an issue with printing incorrect Frame Data when logging.
  • Fixed an issue with SDLLocationDetails' properties being incorrectly stored.
  • Added in nil-checks for SDLStreamingMediaManager's startSession completionHandlers.
  • Fixed an issue with a SDLPerformInteraction initializer causing an infinite loop.
  • Fixed an issue with uploading a nil SDLFile would cause an infinite loop.

4.5.0 Beta 1 Release Notes

Bug Fixes

  • Altered how Security libraries get the app id so they can start downloads faster.
  • Fixed a number of RPC initializers to have correct number sizes.
  • Fixed a video session crash in rare instances when the compression session was NULL.
  • Fixed waypoint RPCs missing response and notification dispatchers and incorrect spelling on some classes (the old classes are deprecated).

4.4.1 Release Notes

Bug Fixes

  • Subscribing to waypoints should now work (new feature & RPC in v4.4.0).

Other

  • Fixes a few failing tests that were overlooked.
  • SDLUploadFileOperations now use the built-in cancel mechanism instead of its own internal flag.

4.4.0 Release Notes

Features

  • [SDL-0003] Adds SendLocation and associated data types.
  • [SDL-0004] Adds Waypointing as a feature for Last Mile Navigation.
  • Adds DisplayType Generic, please continue to not use the DisplayType to know when features are available.

Bug Fixes

  • Fixes the completion handler of a file upload being called twice when a file failed to upload (which fixes a crash in the example project).

Tests

  • Fixes an issue where tests would fail to compile.

4.3.0 Release Notes (Since RC 6 + Highlights)

Highlights

  • Adds a lifecycle manager to replace SDLProxy and manages much more of the lifecycle based on a declarative SDLConfiguration.
  • Adds a file manager to streamline uploading and deleting files.
  • Adds a lock screen manager to streamline lock screens and also provides a customizable default lock screen.
  • Adds a permission manager to streamline knowing when RPCs are available for use.
  • Adds the ability to use blocks to be notified about RPC responses.
  • Adds the ability to use blocks to be notified about certain RPC notifications (such as button presses).

(Since RC 6)

Features

  • Added an SDLProxy property to SDLManager to allow for edge cases in v4.3. This property will be removed in v5.0.

Deprecations

  • SDLRPCRequestFactory is now deprecated. The methods have been replaced as initialzers on the respective RPC methods. These intiailizers have been improved as well.
  • SDLTTSChunkFactory is now deprecated. The methods have been replaced as initialzers on the respective RPC methods.

Bug Fixes

  • Fixed a bug where a non-existent file could attempt to upload, causing havoc.
  • Fix some test framework stuff related to Xcode 8.
  • No longer crashes when RegisterAppInterfaceResponse errors.
  • RegisterAppInterface no longer crashes when attempting to connect a navigation app to a non-navigation capable head unit.

Example App

  • The example app now shows some example Permission Manager usage and logs to console a few permission manager observer blocks.

4.3.0 Release Candidate 6 Release Notes (Since RC 5)

Bug Fixes

  • Fixed several bugs and improved error messaging around what should happen if File Manager fails to start, for example because the head unit does not support files.

4.3.0 Release Candidate 5 Release Notes (Since RC 4)

Bug Fixes

  • Fixed an issue where "SmartDeviceLink.h" would not be available through cocoapods.

4.3.0 Release Candidate 4 Release Notes (Since RC 3)

Bug Fixes

  • Notification constants should now be compatible both with Swift 3 and with iOS 6/7.
  • Fixed a few issues with the lock screen and iOS 6/7 support.
  • Fixed a layout issue with the lock screen on iPhone 4S-sized phones.

Other

  • CI builds now run on Xcode 8.
  • Removed xctest testing framework, now just uses xcodebuild.
  • Explicitly specify which headers are public in Cocoapods spec.

4.3.0 Release Candidate 3 Release Notes (Since RC 2)

Bug Fixes

  • Fixed a bug where large putfiles would crash.

Other

  • Updated to base v4.2.4

4.3.0 Release Candidate 2 Release Notes (Since RC 1)

Bug Fixes

  • Updated project to Xcode 8 settings and turn on additional warnings and analyzer settings.
  • Fixed SDLConsoleController not using NSLocalizedString macro.
  • Fixed example app declaring a UIModalPresentationStyle enum as UIModalTransitionStyle causing a build error in Xcode 8.
  • Update testing deps to work with Xcode 8.

Example App

  • Add iTunes file sharing to the example app to allow for easier file log retrieval.

4.3.0 Release Candidate 1 Release Notes (Since Beta 4)

Enhancements

  • Removed all usages of NSLog. Now all logs can be turned on or off.
  • SDL logs are now off by default in the default lifecycle configuration, console logs are on by default in the debug lifecycle configuration.
  • SDLLockScreenViewController is now public and may be subclassed and used as a custom view controller. If subclassed, the vehicleIcon property will be set if the remote system sends one.

Bug Fixes

  • Fixed an issue with dynamic frameworks accessing the default lock screen resources.
  • Fixed a crash relating to an OnAppInterfaceUnregistered notification.

Example App

  • Fixed initial data being sent multiple times.
  • Fixed CreateInteractionChoiceSet being sent multiple times and sometimes not working.
  • Fixed implementing a delegate method that no longer exists.
  • Fixed UI buttons not updating upon connecting.
  • Added a soft button.

4.3.0 Beta 4 Release Notes (Since Beta 3)

Enhancements

  • Fix resource bundle not being included via cocoapods, causing a failure on the default lock screen. Also added better failure messages. The resource bundle will still have to be manually added to your app's copy resources build phase.
  • Reduced resource bundle size by optimizing lock screen images.
  • RPC handlers are no longer readonly and can now be set outside of the init.
  • Improved the example app with additional code and features to see how the new dev api works. Stay tuned for a few additional features.

4.3.0 Beta 3 Release Notes (Since Beta 2)

Breaking Changes

  • resumeHash is now a configuration property and is not automatically handled.
  • SDLFile and SDLArtwork initializers no longer contain "ephemeral", these are renamed to simply start with "file" since they are the default case.
  • SDLManagerDelegate no longer has the method managerDidBecomeReady. Use the ready block on start instead.
  • SDLManagerDelegate parameters are now nonnull.
  • SDLLockScreenConfiguration showInOptional is now showInOptionalState.
  • SDLLifecycleConfiguration port is now a UInt16 instead of a NSString.
  • Many block parameters changed names to be more consistent and descriptive.

Enhancements

  • The OnKeyboardInput RPC notification is now properly included and sent.
  • SDLLifecycleManager now only sends the "Ready" notification if registration succeeded.
  • SDLManagerDelegate hmiLevel:didChangeToLevel: is now sent right after becoming ready with the current HMI level.
  • SDLLifecycleConfiguration ipAddress is now null_resettable.
  • SDLLifecycleConfiguration can now contain security managers which will properly be added to the internal SDLProxy as appropriate.
  • SDLLifecycleConfiguration now has a logFlags parameter which can be set to alter how SDL logs out data or to prevent it from doing so at all.
  • If RegisterAppInterfaceResponse returns WARNINGS or RESUME_FAILED still successfully connect, but set the error properly of the ready block with the relevant information.
  • Added backward compatible NSNotification subclasses to more clearly describe what type of object it contains.
  • Documentation enhancements.

Bug Fixes

  • SDLFileManager deleteRemoteFileWithName:completionHandler: no longer crashes if no completion handler is set.
  • SDLFileManager uploadRemoteFileWithName:completionHandler: no longer crashes if no completion handler is set.
  • SDLFileManager will more efficiently clean up temporary files.
  • Remove some unneeded methods from SDLLockScreenViewController.
  • Properly send AppHMIType and TTSName set in SDLLifecycleConfiguration to the RegisterAppInterface.
  • Strong / weak dance bugs fixed.
  • Unit test fixes.

Internal enhancements

  • SDLStateMachine now has some public keys to help accessing data internally.
  • SDLResponseDispatcher updates: fixing a method name, fixing an enum equality check, clarity updates.
  • SDLLifecycleManager remove stateTransitionNotificationName.
  • Some NSOperation subclass code was shifted to an intermediate superclass.
  • Fixed some instance variables not having generics.
  • Updated code to match v4.2.3.

4.3.0 Beta 2 Release Notes (Since Beta 1)

Enhancements

  • Starting up SDLManager now requires a block which will pass back an error if it failed.
  • SDLManager now provides a method to call in AppDelegate applicationWillTerminate: that will prevent killed apps from being unable to re-register.

Bug Fixes

  • Fixed a memory leak caused by the strong / weak block dance.

Other

  • Currently removed automatic resumption. Resumption will return in a future build as a manual configuration pass in.

4.3.0 Beta 1 Release Notes (Since Alpha 1)

Breaking Changes

  • State machine transition names are no longer public to allow for behind the scenes changes without minor or major version changes.

Enhancements

  • SDLFile, if initialized with NSData, will no longer write that data to disk, instead, it is stored in RAM. SDLFiles initialized with a file URL will continue to keep that data on disk until needed.
  • The default lock screen text is now localized into Spanish, French, German, Japenese, and Chinese.

Bug Fixes

  • If the lifecycle manager or any of its consituent managers fail to start, the lifecycle manager will disconnect or unregister and an error will be logged.
  • SDLLockScreenManager should use less RAM.
  • Fixed test failures.

4.3.0 Alpha 1 Release Notes

Deprecations

  • Deprecate SDLProxy in favor of SDLManager. A future major release will remove and alter many public APIs, but they will not be deprecated in this release because they will not be replaced in this release.

Enhancements

  • Release a whole new way of reasoning about interacting with SDL. This new high-level API, and it is largely modular with "managers" for various aspects of SDL. This will be extended as time goes on with various new managers based on aspects of SDL and app development (https://www.github.com/smartdevicelink/sdl_ios/issues/223, https://www.github.com/smartdevicelink/sdl_ios/issues/241, https://www.github.com/smartdevicelink/sdl_ios/issues/298). @joeljfischer, @adein, @justinjdickow, @asm09fsu
    • Add a new set of configurations that will be set before startup and allows the manager to take care of quite a bit of setup boilerplate on its own.
    • Release a Permission Manager that allows a developer to check which SDL RPCs are avaiable to use and monitor the ability to use them.
    • Release a File Manager that abstracts the process of tracking files on the remote head unit, uploading, and deleting files.
    • Release a Lock Screen Manager that tracks appropriate times to show a lock screen and comes with a default lock screen view controller that allows for some customizability.
    • All RPCs sent through the primary manager (SDLManager) are tracked and can have a block called with the request and response when the response is returned from the remote head unit.
    • All RPCs sent will have their correlation ids managed by the SDL library.
    • Particular RPCs can now have an additional block used with them that can be called under certain conditions. For example, RPCs that create buttons (such as soft buttons) can have a block handler that will be called when an event occurs on the button.
    • Underlying the new high-level API are a few dispatchers, particularly the Notification Dispatcher which sends many notifications when new RPC notifications and responses are sent from the remote head unit. This may be used by the developer now, but will become less useful as more managers are released.

4.2.4 Release Notes

Bug Fixes

  • Fixed Touch Manager not always firing single touches.

Other

  • Updated testing frameworks to support Xcode 8.
  • Updated example app to support Xcode 8.

4.2.3 Release Notes

Bug Fixes

4.2.2 Release Notes

Bug Fixes

4.2.1 Release Notes

Bug Fixes

4.2.0 Release Notes (since Beta 1)

Enhancements

  • The Streaming Media Manager will now provide a CVPixelBufferPool with default settings so that you don't have to create one yourself.
  • Modified Streaming Media Manager videoSessionAuthenticated to be videoSessionEncrypted and modify the value based on the Start Session ACK encryption flag.

Bug Fixes

  • Make sure to release some C objects in Streaming Media Manager

Other

  • Documentation updates.

4.2.0 Beta 1 Release Notes

Enhancements

Bug Fixes

4.1.5 Release Notes

Bug Fixes

  • Since Apple is disallowing virtually all HTTP requests in Jan. 2017, SDLURLSession will now take all HTTP requests and attempt them over HTTPS. Some cars off the line still have HTTP URLs hardcoded into them, therefore this is a necessary precaution.

4.1.4 Release Notes

Bug Fixes

  • Fixed exception causing app to crash when SDL Core disconnects in TCP debug mode. Warning: The app may enter an undefined connection state as there is currently no retry strategy in TCP debug mode.

Other

  • Update test frameworks

4.1.3 Release Notes

Enhancements

Bugfixes

Other

4.1.2 Release Notes

Bugfixes

  • Enable additional static analyzer rules for Xcode 7.3, fix an associated nullability issue.

Other

  • New .gitignore rule to help carthage submodule users.

4.1.1 Release Notes

Bug Fixes

  • Fixed passing in wrong type, causing SDL Protocol v1 to fail.
  • Fix SDLRPCStruct subclasses generating an incorrect description when logged.

Other

  • Some repository files are now linked into the Xcode project.
  • Updated testing dependencies for Xcode 7.3 compatibility.

4.1.0 Release Notes

Enhancements

  • The LAUNCH_APP system request was implemented.
  • The proxy now tracks application state and relays that information to the Head Unit on v4 and above.

Bug Fixes

  • [SDLProxyListener onProxyOpened] will only be called when the RPC service starts, instead of any service.
  • Sending heartbeat has been deprecated. The iOS proxy will now only respond to heartbeats.
  • SYSTEM_REQUEST RPC now properly uploads and returns data.
  • SDLStreamingMediaManager's version check now correctly compares versions

Other

  • Updates to the README with "Getting Started" code, and updated information on testing.
  • License copyright updated to 2016.
  • All testing frameworks are removed from the repository and must be bootstrapped when wanted.

Deprecations

  • Methods relating to sending heartbeat have been deprecated. This should not affect your app in any way. These lower-level classes will be removed in future versions.

4.0.3 Release Notes

Enhancements

  • Implement HTTP System Requests for policy updates

Bug Fixes

  • Revert the reachability code in TCP. If you were having trouble with connecting to SDL Core, this should fix that particular bug.

Other

  • Fixed numerous broken tests
  • Moved templates and CONTRIBUTING to .github
  • Enable code coverage by default when testing

4.0.2 Release Notes

Bug Fixes

  • Debug logging is a bit better designed and is faster, and file logging happens on a separate queue.
  • IAP code no longer causes an unnecessary 3 minute background timer to be set. External Accessory applications already get all the background time they need.
  • SDLProxyListener delegate callbacks had some misnamed parameters 'request' should be 'response'.
  • SDLProxyListener was marking the wrong type for a passed delegate object. onOnLockScreenNotification: now correctly passes a type SDLOnLockScreenStatus instead of an SDLLockScreenStatus.
  • Return nil if an object was never set to an RPC. This fixes many unit tests.
  • Don't allow SDLRPCStruct to initialize with a nil backing store. This fixes unit tests.
  • MTU size has been fixed to be base 8 based instead of base 10.

Other

  • Apple broke SDL's app launching scheme in iOS 9.0, so this code has been removed from the project. Apple fixed a bug in iOS 9.2 that alleviates much of the missing functionality.
  • The example app no longer has video and audio code, and its app type is now MEDIA instead of NAVIGATION.
  • Travis CI builds are fixed
  • Pull-Request and Issue templates have been added

4.0.1 Release notes

Bug Fixes

  • Fixed some implicit self captures with blocks.

4.0.0 Release Notes (pre-release)

Final Release (2015-10-5)

  • Example app plist updated with required ATS keys.

Release Candidate 2 (2015-09-23)

  • Fix a warning for passing in an NSUInteger to an int parameter.

Release Candidate 1 (2015-09-19)

Enhancements

  • Lock screen icon is now fetched
  • Hex string parsing is now roughly twice as fast.

Bug Fixes

  • Web request delegates weren't always called.
  • Streaming audio fixes.
  • Large chunks of data passed over TCP no longer uses far too much memory.
  • Xcode 7 warnings fixed.
  • Test frameworks updated for Swift 2.0.
  • Build server fixes.

Alpha 4 (2015-09-08)

Enhancements

  • Documentation update to SDLHMILevel.
  • Formatted files.
  • SDLChangeRegistration RPC updated with new parameters.
  • Heartbeat is now implemented for v3 head units and greater.
  • Callback methods in SDLProxyListener protocol implemented for new RPCs.
  • Buffer size for transport greatly increased for v3 and greater.
  • Now compatible with iOS 6+ instead of just iOS 7+ using Cocoapods.
  • Video and Audio streaming is now implemented. Video Streaming is iOS 8+ only. The object will reject you if you are using an older version at runtime.

Bugfixes

  • Properly reset the timer for IAP transport.

Alpha 3 (2015-06-22)

Bug Fixes

  • Prevent NULL pointer calls on SDLPolicyDataParser, SDLV1ProtocolHeader, and SDLV2ProtocolHeader
  • Fix transport not connecting if the app is launched after the device is connected to a head unit.

Alpha 2 (2015-06-04)

API Breaking Changes

  • 28 header files moved to 'project' scope, making them unavailable to developers.
  • Headers now use class forwarding (@class) instead of full imports whenever possible.
  • SDLDebugToolConsole is given its own file
  • SDLRPCStruct is given its own file
  • SDLHMIZoneCapablities, SDLVRCapabilities, SDLVRHelpItem letter case fixed
  • Fixed 'persistent' spelling and removed 'sync' in +[SDLRPCRequestFactory buildPutFileWithFileName:fileType:persistentFile:correlationID:]
  • Removed unused ISDLProxy protocol and file
  • SDLHMILevel enum names altered to match the rest of the enums
  • Fixed spelling of SDLProxyListener onEncodedSyncPDataResponse: method
  • SDLRPCRequestFactory buildRegisterAppInterfaceWithAppName:ttsName:vrSynonyms:isMediaApp:languageDesired:hmiDisplayLanguageDesired:appID: to take immutable arrays instead of mutable arrays, to match all the other methods
  • Removed SDLTransport protocol and file
  • Removed SDLInterfaceProtocol protocol and file

Enhancements

  • Completely new project structure. This will enable future support for optional packages through Cocoapods (via subspecs) and frameworks
  • Cocoapods distribution support
  • Carthage distribution support
  • Add a very basic example app
  • Unit tests, using Quick, Nimble, and OCMock third party libraries (only used for unit testing)
  • Partial documentation coverage
  • Enable static analysis
  • Initializers now return instancetype
  • SDLEnums store values in an immutable NSArray
  • Add initializers to SDLObjectWithPriority
  • Add a .clang-format file
  • Add SDLHMICapabilities struct
  • Add new enum values for TextFieldName, ImageFieldName, KeyboardEvent, Result, and RequestType
  • Add SDLSendLocation RPC
  • Add SDLDialNumber RPC
  • Add quicklook support to SDLEnum objects
  • Protocols now conform to NSObject
  • Add new RegisterAppInterfaceResponse parameters
  • Add support for SDL 4.0 app launching
  • Refactor IAP transport
  • Add thread index to log format

Bugfixes