Determining the wrapping mode

Ivanti provides two modes of wrappers: the Generation 1 wrapper and the Generation 2 wrapper. The type of app and the features that it uses determine the required wrapper Generation mode and wrapper release version. The app types are defined in Apps that you can wrap. When you submit an app for wrapping, you must specify:

  • whether to use the Generation 1 or Generation 2 wrapper
  • the release version of the wrapper

To wrap an app with a version of the Secure Apps wrapper that is no longer available in the AppConnect Wrapping Portal or wrapping tool, contact Ivanti Technical Support.

Consider the following in making your selection:

  • For the most comprehensive feature support, select the latest Generation 2 wrapper. Ivanti recommends that you use the Generation 2 wrapper.

  • Select Generation 2 wrapper if the app supports scoped storage and your target SDK is 30.

  • Apps wrapped with the wrapper version X.Y.Z require Secure Apps Manager X.Y.Z. The same is true for Secure Apps Manager for AppStation.

  • The Secure Apps Manager and the Secure Apps Manager for AppStation support apps wrapped with Generation 1 and 2 wrapper versions as listed in the AppConnect for Android Release Notes and Upgrade Guide.

    Each version of the Secure Apps Manager and the Secure Apps Manager for AppStation supports apps wrapped with previous wrapper versions. Therefore, you can upgrade your Secure Apps Manager and still deploy apps wrapped with previous wrapper versions.

  • Starting from the Android Gradle tool plugin version 4.2+, the Android Asset Packaging Tool (AAPT2) resource compiler was replaced with Java Virtual Machine (JVM) resource compiler. All resource XML files now have obfuscated names and paths.

  • Select the Generation 1 wrapper if the app was previously wrapped with the Generation 1 wrapper and deployed. Upgrading a Generation 1 wrapped app to a Generation 2 wrapped version of the app is not supported.

  • Select the Generation 1 wrapper if the app requires support for the Android DocumentsProvider API.

    Apps wrapped with the Generation 2 wrapper can run, but DocumentsProvider API functionality is not supported.

The following table summarizes the Generation 1 and 2 wrapper support for:

  • the various app types
  • AppTunnel with HTTP/S or TCP tunneling
  • Certificate authentication with AppTunnel with TCP tunneling

For more information about capabilities and limitations of apps wrapped with the Generation 1 and 2 wrappers, see Capabilities and limitations of apps you can wrap.

Table 6.   Generation 1 and 2 wrapper support for app types and AppTunnel

 

Generation 1 wrapper

Generation 2 wrapper

Apps that you previously wrapped with the Generation 1 wrapper and deployed.

Supported

Not supported

Java apps

Supported

Supported

Xamarin apps

Not supported

Supported

Java apps with C or C++ code

Not supported

Supported

Hybrid web apps, including Cordova apps

Not supported

Supported

React Native apps

Not supported

 

Supported

AppTunnel with HTTP/S tunneling in Java apps using supported HTTP/S APIs* for network connections

Supported

Supported

AppTunnel with HTTP/S tunneling in Xamarin apps using supported HTTP/S APIs* for network connections

Not supported

Supported

AppTunnel with TCP tunneling

  • in hybrid web apps, including Cordova apps
  • in React Native apps
  • in Xamarin apps using unsupported HTTP/S APIs
  • in Java apps using the following for network connections:
    • unsupported HTTP/S APIs
    • C or C++ code

Not supported

Supported

Certificate authentication with AppTunnel with TCP tunneling

  • in hybrid web apps, including Cordova apps
  • in React Native apps
  • in Xamarin apps
  • in Java apps using the following for network connections:
    • unsupported HTTP/S APIs
    • C or C++ code

Not supported

Supported

*The supported HTTP/S Java APIs are listed in AppTunnel with HTTP/S tunneling.