4 Building and Testing Your Apps

You can test your apps using a Web-based simulator or on a phone.

Previewing Your App

You can preview your app in a hosted simulator or on a device at any point after you’ve created its first screen.

The Test tool lets you use the simulator to see how your UI displays live data. You can also test out screen navigation and the actions that you’ve configured for UI components.

Description of the illustration test_tool_designer.png

To preview your app:

1. Click Test ().

3. Test your app’s functions, such as the overall page flow, the behavior of a single field, or the create and back actions. While you’re testing, toggle the orientation and the iOS and Android options on and off. When you’re done, click Back to Designer () to resume your work.

   
   
   Description of the illustration testing_apps_platforms.png
   

4. If you want to continue to work on your app, click Back to Designer (). Otherwise, you’re ready to see how your app works on an actual phone. See Testing Your App to find out more.

Testing Your App

Testing your app on an actual device gives you a better picture of how your app functions on different platforms, operating systems, and device models. It’s where the rubber hits the road, so to speak. Unlike an emulator, which approximates the user experience using a mouse, you can use actual tap and swipe gestures to navigate through your app’s screens when you run it on a real smartphone. You can also find out how your app interacts with actual device services, like the phone or the contact list. You need the MAX App to run your app on a device. To find out more, see Installing the MAX App.

Note:

Before you can begin this real-world testing:

• Install the MAX App onto any device that you’re planning to use. Your test group (that is, anyone who’s participating in the testing) must also have the MAX App installed.

• All app users (app testers and app users alike) must have user accounts.

• You need a test user account to generate the QR code associated with the test version of the app.

To test the app:

1. In the left navbar, click Screen Flow () to make sure that there are no problems.

   
   
   Description of the illustration errors_warnings.png
   
2. Click Test ().

   
   
   Description of the illustration test_tool_designer.png
   

3. If you signed out when you last previewed your app, enter the user name and password for your test user account.

4. Click Test on Phone () and then Build Test Application.

   
   
   Description of the illustration ready_to_build.png
   

   MAX generates a QR code when the build finishes.

   
   
   Description of the illustration qr_code_testing.png
   
5. Click Download to your device or click Show QR Code () to display the QR code.

   Important:

   This QR code is for testing apps that are under development. Share it with your test group. When you publish the app later on, MAX will generate a different QR code, one associated with the published (or finished) version of your app. It’s the one that you’ll use to distribute all versions of your app to its users.
6. On your device, open the MAX App ().

   
   
   Description of the illustration click_max_app.png
   

7. Click Scan ().

   
   
   Description of the illustration max_landing_page1.png
   
8. Point your phone at the test QR code to download the app.

   
   
   Description of the illustration scan_app.png
   
9. Log into the app by entering your user name and password.

   Tip:

   You can also login using your test user name and password.

   The test app appears in the MAX App.

   
   
   Description of the illustration max_landing_page2.png
   
10. Repeat these steps when you’re ready for another round of testing.

    Tip:

    You might see errors if plan to run the both the test and production version of the app on the same phone. To avoid this, delete and then reinstall the MAX App before running the production version of the app. If you’re going to revise the app, then you need to once again delete and reinstall the MAX app before you test a new version of the app.

Installing the MAX App

You can only run your mobile app on an actual device using the MAX App, a container that allows your app to not only display its content and leverage device services, but also behave identically to other apps that were developed specifically for iOS or Android devices. While the MAX App provides a consistent user experience, it also allows users to install your app. Because of this, all of your users (app testers and actual users alike) need to install the MAX app on their devices. You can install the MAX App from both the App Store and from Google Play.

Installing the MAX App on iPhones

To install the MAX App from the App Store:

1. On your iPhone, open the App Store.

2. Search for Oracle MAX App.

   
   
   Description of the illustration max_app_store1.png
   

3. Tap Get and then Install.

   Note:

   You might be prompted to sign into iTunes if you’re not already signed in.

4. When the download completes, tap Open.

5. When prompted, allow MAX to send you notifications.

6. Read through the end user terms and conditions and then tap Agree.

7. Enter your login information:

   • Host

   • Username

   • Password

8. Tap Sign In.

Installing the MAX App on Android Devices

To install the MAX App from Google Play:

1. On your phone, open Google Play.

2. In the Play Store, tap Apps.

3. Search for Oracle MAX App.

4. Tap Install.

5. When prompted, allow MAX to send you notifications.

6. Read through the end user terms and conditions and then tap Agree.

7. Enter your login information:

   • Host

   • Username

   • Password

8. Tap Sign In.

MAX App Quick Reference

To do this...	Do this...
Download an app	Click Scan (). Point your phone at the QR code to download the app. Enter your user name and password. See Testing Your App to find out more.
Delete an app	In the springboard, click Edit. Tap the app (). Click Yes in the Confirm Delete Module dialog. Click Done.
Switch apps	From within an app, click menu (). Click the MAX springboard icon () and then open the app. Description of the illustration max_app_menu.png
Navigate back to the springboard	Click the MAX springboard icon ().

Sharing Your App

To share your app, you need to distribute a QR code to your users along with the name of your app.

For each app, you’ll have two QR codes: one used for testing and one used distributing the published version of your app. These codes reflect your app in its unpublished or published state, respectively. They are dedicated to your app, meaning that they don’t change. Depending on your intent (testing or distributing), you’ll always use one or the other.

Important:

All users must have the following:

• The MAX App installed on their devices. Your mobile app can only run in the MAX App. Both your test group and your user group will install your app and run it using the MAX App. To find out more, see Installing the MAX App.

• User accounts.

Sharing Your App with Your Testing Group

You don’t need to publish an app to test it on a device. As described in Testing Your App, MAX generates a QR code that you use for testing purposes. You can distribute this code by sending a picture of it to your testing group. They will scan this code every time they need to install a new iteration of this app.

Sharing Your App with Your User Group

To get the QR code used for distributing the release version of your app to your user group, you must first publish it. To do this:

1. Click Publish ().

   
   
   Description of the illustration publish_tool_designer.png
   

2. Click the Publish button ().

3. If you’re done testing are now ready to publish the app, click Publish in the confirmation dialog.

   
   
   Description of the illustration confirm_publish.png
   

   MAX generates a QR code for the published app.

   
   
   Description of the illustration publish_qr_code.png
   

4. Click Show QR Code () to display the QR code.

5. Send a picture of this QR code to your user group. They will scan this code to install any new versions of this app.

6. After they launch the MAX APP, your app users click Scan (). When prompted, they allow the MAX app access to the device camera and then focus the scanner to read the QR code. The MAX app then downloads the app to their smartphones. All downloaded apps display in the MAX App springboard.

   
   
   Description of the illustration max_landing_page2.png