Deprecations

From Resco's Wiki
Jump to: navigation, search
Releases

This page lists all Resco features that are currently being deprecated.

Introduction

Wikipedia logo
Wikipedia has an article on the same subject:

The Resco platform supports a wide variety of devices, operating systems, or browsers. To support newer standards and technologies, sometimes we must give up support for older things. This allows us to improve performance, security, and streamline hardware and software requirements of Resco solutions – ultimately providing more powerful, efficient, and consistent experience to you, our customers and partners.

The deprecation of a feature starts on the announcement date for the deprecation. The feature will continue to function until the end of the deprecation period (often one year or four quarterly releases). Once the deprecation period has elapsed, the feature will be disabled.

Active deprecations

This section lists all features that are currently being deprecated.

Restricted ability to invoke native methods from JS Bridge in Mobile CRM

Final retirement date March 2021 (version 14.0)
Categories Breaking Change, Security, JS Bridge
Affected apps/modules Resco Mobile CRM and derived apps (Inspections, Routes, branded apps)
Any custom code using JS Bridge
Affected platforms Android, iOS, Windows Desktop, Windows Store

As part of a continuous effort to make Resco platform more secure, we are implementing restrictions on using some of JSBridge APIs that allow executing potentially unsafe code from Mobile CRM. Once this restriction will be enforced, it will only be possible to invoke a limited set of pre-approved native methods.

This change may impact your JavaScript custom code if it relies on one of the following API objects and functions:

  • MobileCRM.Bridge methods: invokeMethodAsync, invokeStaticMethodAsync, invokeMethodPromise, invokeStaticMethodPromise, exposeObjectAsync.
  • MobileCRM.ExposedObject methods: invokeMethodAsync, invokeMethodPromise, exposeObjectAsync.

Rollout plan

  • Version 13.0 (January 2020) - No breaking change. If you use APIs to invoke restricted methods, the JSBridge log file will contain warning "Unsupported method invoke: [method_name]".
  • Version 13.2 (September 2020) - Breaking change. Invocations of restricted methods will lead to a runtime exception. The exception can be suppressed by using Woodford and enabling the option Allow legacy low-security JS Bridge APIs in the project configuration.
  • Version 14.0 (March 2021) – Final feature retirement. Invocations of restricted methods will always lead to a runtime exception. The option Allow legacy low-security JS Bridge APIs will no longer be respected by the app and removed from Woodford.

Recommended action

If you use custom JavaScript code using JS Bridge, as soon as possible scan devices running your production code for the presence of Unsupported method invoke warning in JSBridge log files. Review your findings and assess if the functionality can be alternatively achieved using:

If you don’t see any alternative to achieve functionality, please don’t hesitate to contact our support for advice.

Mobile CRM for Windows Desktop no longer supports 32-bit Windows

Final retirement date September 2020 (Release 13.2)
Categories Breaking Change, Windows Desktop
Affected apps/modules Resco Mobile CRM and derived apps (Inspections, Routes, branded apps)
Affected platforms Windows Desktop

Latest versions of some of the dependencies essential for Resco Mobile CRM for Desktop are no longer available in 32-bit versions, we are forced to deprecate support for 32-bit versions of Windows with Resco Mobile CRM.

Rollout plan

  • Version 13.0.3 (March 2020) – was the latest version of MobileCRM for Desktop which can be installed on Windows 32-bit. All subsequent versions can only be installed on 64-bit versions of Windows.

Recommended action

If you want to stay up-to-date with feature improvements and security updates of Resco platform, you have the following options:

  • switch to the Windows 10 app which will still support 32-bit devices in foreseeable future
  • or upgrade Windows on your devices to a 64-bit version

Internet Explorer becomes legacy browser option in Mobile CRM for Windows Desktop

Final retirement date March 2021 (Release 14.0)
Categories Windows Desktop, Offline HTML
Affected apps/modules Resco Mobile CRM and derived apps (Inspections, Routes, branded apps)
IFrames, Offline HTML, Custom code using JS Bridge
Affected platforms Windows Desktop

Since Internet Explorer is already declared legacy by Microsoft, Resco will follow suit and switch to a more modern Chromium-based browser as default HTML rendering engine in the Desktop edition of Mobile CRM. IE will become a legacy option. It will not go away, but it will eventually cease to be supported by JS Bridge and HTML-based controls used in the Mobile CRM app.

Rollout plan

  • Version 13.2 (September 2020) – Chromium will become the default HTML rendering engine. Starting with this version, the configuration option Use Chromium Browser in Woodford will have a new default value set to True. This means that all projects published with Woodford version 13.2 or later will be automatically switched to use Chromium unless the administrator explicitly sets this option to False.
  • Version 14.0 (March 2021) – This will be the last version for which Resco will fully support IE as an HTML rendering engine. After this version, Resco will no longer ensure that components provided as part of the platform are compatible with Internet Explorer. This includes (but is not limited to) JS Bridge library, Charts, Rich Text Editor, Process Control, Route Planner, Scheduler, and Timeline Control. It will still be possible to use IE in Resco as a legacy option, but we will not be providing support for running any HTML based content using this rendering engine.

Recommended action

  • Make sure that any HTML based content (online or offline) used in your customizations is compatible with the Chromium browser before it goes out of support.
  • If you must use IE with version 13.2 or later, make sure to manually set the option Use Chromium Browser to False when publishing app projects.

Minimum supported version of Android for Mobile CRM raised to 5.0

Final retirement date September 2020 (Release 13.2)
Categories Android
Affected apps/modules Resco Mobile CRM and derived apps (Inspections, Routes, branded apps)
Affected platforms Android

Latest versions of some of the dependencies essential for Resco Mobile CRM for Android no longer support Android 4.4, so we are forced to deprecate support for version 4.4. and raise the minimum Android version to 5.0.

Rollout plan

  • Version 13.1.3 (July 2020) – the latest version of MobileCRM which can be installed on Android 4.4.
  • Version 13.2 (September 2020) – this version can only be installed on Android 5.0 or later.

Recommended action

Upgrade Android on your devices to version 5.0. If the OS upgrade is not supported on your devices, replace them with Android 5.0 compatible ones.

Call Import feature retired from Mobile CRM for Android

Final retirement date September 2020 (Release 13.2)
Categories Android, Call Log
Affected apps/modules Resco Mobile CRM and derived apps (Inspections, Routes, branded apps)
Affected platforms Android

In December 2018 (version 11.3), Google didn’t approve READ_CALL_LOG permission for Mobile CRM application because it only allows it for apps where it is considered a core functionality, which according to Google is not the case for Mobile CRM. Older versions of Mobile CRM can still use this functionality when configured in Woodford. Starting with Mobile CRM version 12.3, we retire this feature and it won’t be available in Woodford anymore.

Rollout plan

  • Version 11.2 (September 2018) – the latest version of Mobile CRM which can use Call Import feature on Android.
  • Version 13.2 (September 2020) – in this version, the possibility to configure Call Import on the Home screen will be removed.

Recommended action

To safely remove Call Import from the Home screen, just open the Home configuration in Woodford and save it.

If you need to retain Call Import because you still use a legacy version of Mobile CRM, you must not save the Home configuration with Woodford 13.2 or later. If you need to change the Home menu and still retain the Call Import, please contact our support.

Use Legacy iOS WebView option in Mobile CRM retired due to Apple Store Policy

Final retirement date December 2020 (Release 13.3)
Categories iOS, Offline HTML, JS Bridge
Affected apps/modules Resco Mobile CRM and derived apps (Inspections, Routes, branded apps)
IFrames, Offline HTML, Custom code using JS Bridge
Affected platforms iOS

As part of the retirement of the legacy WebView, Apple will no longer accept apps using legacy UIWebView as of December 2020. Because of this, MobileCRM 13.2 (September 2020) will be the last version which will offer the possibility to switch to legacy web view for iOS using Woodford’s option Use Legacy iOS WebView.

If you are still relying on legacy web view for OfflineHTML or custom JavaScript code, we strongly advise you to migrate to the new WKWebView which is known to have many incompatibilities with legacy WebView, mostly due to tightened security model.

Rollout plan

  • Version 13.2 (September 2020) – the latest version of Mobile CRM which still supports legacy UIWebView.
  • Version 13.3 (December 2020) – starting with this version, Mobile CRM will always use new WKWebView, regardless of the value of setting Use Legacy iOS WebView in your App Project.
  • Version 14.3 (December 2021) – with this version, the setting Use Legacy iOS WebView will be removed from Woodford, and thus it will not be possible to enable this setting even for older versions of Mobile CRM.

Recommended action

If you rely on serving online web pages, Offline HTML or use custom JavaScript code in Mobile CRM on iOS, we strongly recommend to disable the option Use Legacy iOS WebView in your project configuration and thoroughly test the impact. Be sure to inspect the JSBridge log files for any errors or warnings. When testing in a sandbox environment, please make sure to test your JavaScript code against real data volumes as used in production to avoid any surprises.

If you encounter any problems, do not hesitate to contact our support for advice.

You can continue to use legacy WebView if you stay with MobileCRM version 13.2 until December 2021, when the option will be removed from Woodford. By that time you should complete any adjustments needed for compatibility of your custom HTML and JavaScript with WKWebView.