SDK migration from 14r1 to 14r2

This article describes changes in the SDK and APIs between the major software releases 14r1 and 14r2.

Content

Compatibility Statement
General statement to compatibility of the Apps in 14r1 and 14r2 environments.
Visual Studio Project Upgrade
Visual Studio Project upgrade from 14r1 to 14r2 SDK.
License Upgrade
App License upgrade policy.
API changes
Changes in the APIs of the SDK Libraries, PBX and Apps.
Building changes
Changes on building and compiling the App

Compatibility Statement

You need to upgrade your App Platform to a version 12xxxx, before deploying your 14r2 App to App Platform

The Apps compiled with 14r2 SDK are no longer compatible with App Platform Images version 11xxxx or below due to a major update of the used OpenSSL library, as the old 1.1 version is deprecated.

The Apps compiled with 14r1 SDK are compatible to 14r2 App Platform Manager. So no problem for your existing Apps (prior 14r2).

The 14r1 Apps intended to communicate with 14r1 PBX are also compatible to 14r2 PBX APIs in most cases. The possible incompatibilities are listed in the chapter "API changes" below.

Visual Studio Project Upgrade

Prior upgrading the VisualStudio project to a new SDK version the local SDK version must be updated using the "innovaphone SDK Setup". The "innovaphone SDK Setup" is available for download on the App Store under "Software" tab.

The current version of the SDK used in the Visual Studio Project is stored in the file common/sdk.version.

The innovaphone Visual Studio plugin will detect an older version of the SDK in the project and will ask for upgrade. The manual update via "Tools" -> "innovaphone SDK" -> "Install/Update SDK" is available too.

License Upgrade

The App licenses issued for major version 13 are not valid for major releases 14. This means the customers without SSA have to acquire the App licenses for the version 14.

API changes

SDK Client Library innovaphone.lib.js is deprecated and is removed

The library innovaphone.lib.js is removed since 14r1 SDK. The projects started with 13r2 SDK should not be affected. Older projects should migrate to innovaphone.lib1.js library.

Building changes

JS-SDK: Removed httpfiles.zip => Usage of Bindfiles

With the 14R2 SDK we removed the generation of the httpfiles.zip for the Javascript SDK. The content of the httpfiles is now encrypted by building and attached to the binary of the generic App.

If you migrate your app to 14R2, you need to ensure that the latest 14R2 SDK is installed and that the newest versions of build-release.bat and build.ps1 are located in your project's folder.

You can find them in the Installationpath of the SDK. (Usualy C:\innovaphone\sdk\vs-templates\...)