native.requestExit()

Type Function
Library native.*
Return value none
Revision Current Public Release (2014.2511)
Keywords requestExit, exit
See also os.exit()

Overview

Closes the application window on Android or Windows Phone 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 and Windows Phone. It is not supported on iOS or in the Corona Simulator.