SDK migration from 14r2 to 15r1

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

Content

Compatibility Statement
General statement to compatibility of the Apps in 14r2 and 15r1 environments.
Visual Studio Project Upgrade
Visual Studio Project upgrade from 14r2 to 15r1 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
Releasenotes
Here you can find all notes to the 15r1 SDK

Compatibility Statement

You need to upgrade your App Platform to a version 12xxxx, before deploying your 15r1 App to App Platform

The Apps compiled with 15r1 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 15r1 App Platform Manager. So no problem for your existing Apps (prior 15r1).

The 14r2 Apps intended to communicate with 14r2 PBX are also compatible to 15r1 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 14 are not valid for major releases 15. This means the customers without SSA have to acquire the App licenses for the version 15.

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 15r1, you need to ensure that the latest 15r1 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\...)