Application

Key indicating that the terminal is entering a proximity region.

Key indicating that the terminal is exiting a proximity region.

The registration has failed. See message parameter to get details of the failure.

The device is registered in the OS Push Notification server.

The registration has changed the device registration unique Identifier.

The device has been unregistered from the server.

Black or Dark theme

White or Light theme

Do not override this constructor.
Do not call this constructor.

Try or Ask to exit the application.

Not supported on iOS.
com.neomades.mad.TargetInfo#HAS_EXIT_FEATURE TargetInfo.HAS_EXIT_FEATURE could be used to put a condition around usage of this method.

The controller will check whether the application is authorized to exit, by calling onBeforeExit(Controller) method and the response of this method will authorize to exit or not.

Gets the registered content manager.

Returns the current instance of the application.

Returns the Application name.

Returns the main package name of the application.

Be careful with the returned value and the URS Application identifier. This package could be different at runtime from the source code if an Application identifier is set in the URS file.

Returns if the Application has been created.

Returns if the Application has started and should be ready to show to a screen

Attempts to open the resource at the specified URL.

If the URL is a "resource" on the World Wide Web, the application will open the browser at the specified URL.

If the url starts with file://, it will try to open the file installed at the path specified after file:// using the default application that can open the file depending on its extension.

Sets a specific application delegate. Setting an ApplicationDelegate might be useful in very specific case when the application uses the NeoMAD specific code feature. This will enable to access the native application instance in the specific code.

Use this method inside your application's onCreate(Controller) method.

Sets the badge number displayed over the application icon (iOS)

Starts a voice call to a phone number.

To use this method, the PHONE_CALL permission must be declared in the URS file.

Called when the application will be activated (after onStart(Controller)).

Called when the application goes in background.

Override this method to provide a behavior when the application is about to exit. For example save the state of the application or ask confirmation.

Called before onStart(Controller) method.

The onStart(Controller) is not necessary called after this method. For example, a click over Notification could launch the application.

 public MyApplication extends Application implements PushServiceListener, PushMessageListener {
 
 	protected void onCreate(Controller controller) {
 		PushServiceManager pushService = PushServiceManager.getDefault();
 		
 		// Register the push service if not registered
 		pushService.register();
 	}
 
 	protected void onPushMessageReceived(PushMessage message) {
 		// called when a push notification is clicked by the end-user
 	}
 
 	protected void onPushRegistrationChanged(int status, String message) {
 		if (status == REGISTERED) {
 			// the push service is ready
 
 			// send to the application server the current ID 
 			// by HTTP
 			String id = message; 
 			// After now, the service currentID could be get also by PushServiceManager.getDefault().getCurrentID();
 			// ...
 		} else if (status == SERVICE_CHANGED_ID) {
 			// the push service has changed the ID
 			String newId = message;
 			
 		} else if (status == UNREGISTERED) {
 			// the push service has unregistered this device
 			
 		} else if (status == FAILURE) {
 			String details = message;
 			
 		}
 	}
 
 }
 
 

Warning: This method is called before onStart(Controller). The application could be started by a Push-Notification or by the end-user. The onStart(Controller) method is called after only if the user has launched manually the application.

Called when the application will be deactivated.

Called when the application exits (just before the process is killed by the system).

Called when the application goes in foreground.

Handles a Push-Notification message received from the server before showing it.

This handler replaces the default android visual Notification in the notification Bar.

NB. if the notification has a "notification" section (see PushMessage), this callback will not be called.

Limitation

Only called in android.

Automatically called when the end-user clicks on a local Notification.

This method will be called when proximity to registered coordinates is detected. It could be called if the terminal enters or exits the given ProximityRegion. Override this method in your Application class to make the required treatments A proximity event could also wake up a not-running application on Android and iOS platforms.

Called when the end-user has clicked a Push-Notification.

Called when the push registration status has changed.

• If the status is PUSH_REGISTERED, the message contains the service currentID (same value as getCurrentID())
• If the status is PUSH_SERVICE_CHANGED_ID, the message contains the new service currentID (same value as getCurrentID())
• If the status is PUSH_UNREGISTERED, the message contains the details of the state
• If the status is PUSH_FAILURE, the message contains the details of the failure

Override this method to provide a behavior when starting the application : for example push the main screen in this method

Set the android ActionBar mode enabled or not.

By default, the action bar is enabled.

Sets a native theme type (light or dark) to use in the action bar for this application.

This method should be call at the beginning of the onStart(Controller) method.

Replaces the "Back" button text.

This method must be called into onStart(Controller) method in order to keep the same back button text during the navigation.

Cross Platform Considerations

On iOS it changes the left back button of the navigation bar.

On Android this method does nothing.

Changes the "Back" button text color.

This method must be called into onStart(Controller) method in order to keep the same back button text color during the navigation.

Cross Platform Considerations

On iOS it changes the left back button text color of the navigation bar.

On Android this method does nothing.

Sets a native theme type (light or dark) to use for this application.

This method should be call at the beginning of the onStart(Controller) method.

Limitation

Not supported on iOS platform.

Forces the application to be in portrait and/or landscape mode. This method does nothing if the device cannot handle orientation changing.

By default, the requested orientation is AUTO which means PORTRAIT and LANDSCAPE

Cross Platform Considerations

On some platforms, the orientation cannot be changed once a screen has been pushed to the display. So, this method should be called before any screen is pushed (at the beginning of the Application.onStart() for example).

Sets the title bar background.

This method must be called into onStart(Controller) method.

Sets the title bar background color.

This method must be called into onStart(Controller) method.

Sets the title bar background image.

This method must be called into onStart(Controller) method.

Sets the title bar background image.

This method must be called into onStart(Controller) method.

Sets the title text color.

This method must be called into onStart(Controller) method.

Sets the title font.

This method must be called into onStart(Controller) method.