native.requestExit()

Type Function
Library native.*
Return value none
Revision Current Public Release (2014.2393)
Keywords
Sample code /CoronaSDK/SampleCode/
See also os.exit()

Overview

Closes the application window on Android gracefully without terminating the process.

This is a non-blocking function call. This means that all code below this function call will be executed before the application window is closed.

It is highly recommended that you call this function instead of os.exit(). The os.exit() function call terminates the application process immediately, which can be interpretted by an app reviewer as a crash. It would also clear all scheduled notifications and notification in the status bar on Android, which require the application process to be alive in the background to manage them.

Syntax

native.requestExit()

Gotchas

This function is only supported on Android.

This function is not supported and will do nothing on iOS or in the Corona Simulator.