User Interface Options
When you create a hybrid app, you can make the following choices to control the app's user interface:
- Show navigation bar at bottom of web view (iOS and Android): If you select this option, a navigation bar will appear in the web view. For iOS, the navigation bar includes Back, Forward, and Reload Page buttons. For Android, the navigation options appear in a menu at the top right, and do not include a Back button. Backward navigation is controlled by the device's back button.
window.openmethod; other types of links will open in the current tab. For developer details on creating links with this method, see Window open() Method.
Allow app to open files in other apps (iOS and Android): If you select this option, users can tap on links in the hybrid app to open files in other apps. For example, if the app links to a PDF file, the user will be able to choose from a menu to open that file in any PDF viewer app available on the device. If you do not enable this option, the hybrid app will instead attempt to open the file directly in the webview. Note that in a hybrid Android app, the webview cannot open PDF files, so you should enable this option if the app includes links to that file type.
With iOS, this feature supports multiple file types. With Android, it currently supports PDF files only. If you want your hybrid Android app to open different files types in other apps, please contact firstname.lastname@example.org.
URL Access Lists (Whitelists and Blacklists)
When you create a hybrid app, you can define a whitelist and/or blacklist to control a user's access to URLs while working in the application. A whitelist authorizes access to a specific list of URLs; when users are using the app, they cannot access any URLs that do not match entries in the whitelist. A blacklist blocks access to a specific list of URLs, even if those URLs are in the whitelist. When you enable access lists, you also provide the URL for a page to which users will be redirected when they try to access an unauthorized page.
For example, an administrator creates a hybrid app for the Example Company Portal web site at He enables access lists to specify that users of the app can access everything in
http://*.example.* except for pages under
For additional considerations, review the following guidelines. For instructions on adding a hybrid app to Apperian, see Add an Application.
Consider these additional guidelines when creating and managing a hybrid app in Apperian:
When you add a Hybrid iOS App, Apperian creates a new native iOS app. When you add a Hybrid Android App, Apperian creates a new native Android application. In the Applications list, the hybrid app is listed as an Android app or an iOS app—not as a hybrid app.
Both iOS and Android apps need to be signed before they can be distributed to your App Catalog users, therefore you need to sign the hybrid app after you add it. You cannot enable the app until it is signed. You can sign apps directly through the Apperian Portal. For more information, see About Signing.
If you do not want to sign the app directly through Apperian, you can that includes the app's IPA or APK file. Note, however, that if you use the signing package to sign the app outside of EASE, you will need to add a new app to upload the app after it is signed; you will not be able to edit the app that you added in order to upload the signed version. You can avoid this additional step by signing with the Admin Portal.
When you edit an iOS or Android app that was created by adding a hybrid app, you can specify to rebuild the hybrid application. Rebuilding is required if you want to change the web URL for the hybrid app, or modify its user interface options or access lists (whitelist and blacklist). You may also choose to rebuild the app's binary for other reasons. For example, you may want to rebuild the hybrid app using an update of the Apperian Admin Portal that takes advantage of more recent system architectures. If you have any questions about when a rebuild may be recommended, contact email@example.com.
The following options can only be modified when the Rebuild option is selected:
- Web URL
- Show navigation bar at bottom of web view
- Allow links to open new tabs
- Allow app to open files in other apps
- Enable access lists
- Version Number
For instructions on editing and rebuilding a hybrid app, see Edit or Update an Application.