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 Customer Support.
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 Apperian, 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. 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 Customer Support.
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.