PureWeb 4.3 Release Notes

These Release Notes apply to all 4.3.x releases of the PureWeb SDK.

Release History

New in PureWeb 4.3

  • Enhanced security: The versions of JQuery, logback, Tomcat, Spring Framework and Spring Security used by the PureWeb server have been upgraded, to ensure that they are up-to-date with the latest security patches.
  • Enhancements to the APIs:
    • C++: A new method has been added to the API, to simplify string conversions. The method, ToStdUtf8, can be found in the String class. For more information, see String Conversions in C++.
    • iOS: The API libraries and the sample applications now support iOS 10, Xcode 8, Swift 3 and .CocoaPods 1.1.x.
    • HTML5: A new method has been added to facilitate the cleanup of views once they are not needed anymore. For more information, see the documentation for the view.dispose() method.
    • Flex: The API libraries and the sample applications now support Flex 4.15.
  • Enhancements to the sample applications: All the samples now include performance metrics (encoder format, latency, bandwidth, and frames per second).
  • Enhancements to the documentation: The developer documentation underwent a complete overhaul, to improve the content structure and simplify navigation.

Known Issues and Recommendations

The following issues have been identified as expected behavior, or are due to limitations in a third-party application:

  • When running a client application in multiple windows, some extensions for the Google Chrome browser could interfere and cause the application to crash, If this happen, disable the extension in the browser (PWEB-6813).
  • Flex clients sometimes do not work in the Microsoft Edge browser: either they do not load properly, or they load but do not connect to the PureWeb server. (PWEB-6626)

    Workaround is to close and restart the Edge browser and/or restart the PureWeb server.

  • Flash clients may exhibit poor performance when running in Firefox on Windows 7. (PWEB‑4345)
  • HTML5 client logging — browser-specific peculiarities (PWEB‑3532)

     

    The PureWeb HTML5 client SDK performs a degree of internal logging. By design, developers creating PureWeb client applications see only the messages logged when there is an unexpected operation within the PureWeb SDK, while the low-level messages logged under normal operation are not visible to them.

    The visible messages are normally logged to the JavaScript console in the browser, but developers should be aware of the following peculiarities that have been found to exist in some versions of the browsers:

    • Firebug: the logging messages will not appear in the Firebug console, but rather will be sent to the default JavaScript console in Firefox.

    • Google Chrome: When using multiple user profiles within Google Chrome, logging messages will only appear in the window of the first profile that was accessed. This issue is not present when using only the default profile.

Deprecated

The following features are deprecated:

  • Default Process (deprecated since 4.1)

    The default process mechanism is deprecated. This mechanism allows for instances of the specified process to be automatically started by the PureWeb server in all available user sessions.

  • Flex Client SDK (deprecated since 4.1)

    If you are currently using a Flex client, we recommend that you migrate to one of the other supported clients (HTML5, iOS, Android).

  • Clustering (deprecated since 4.0)

    While the current clustering mechanism is still supported for small multi-server environments (2 to 3 servers), it is recommended that a load balancer be used for such environments instead.

    A solution to improve management and scalability of multi-server environments is currently being developed for a future release of PureWeb.

For details on deprecated API methods, refer to the Upgrade Notes.

Removed

  • The Java Swing client SDK was deprecated in 4.0, and has now been officially discontinued. The SDK is not included with the 4.3 release.
  • The following platforms/browsers are no longer supported:
    • HTML5: Firefox ESR

    • iOS: Xcode 7, iOS 8 and Swift 2.x, and versions of Cocoapods below 1.1
    • Android: Versions of Android below 5.x, API levels below 21, and versions of Android Studio below 2.x
    • Ubuntu 12.04 LTS and Mac OS X 10.10

See the Requirements for a list of currently supported versions.