feat: expose app exit via JS process API

.changes/process-exit-api.md

@@ -0,0 +1,6 @@
+---
+'tauri': 'minor:feat'
+'@tauri-apps/api': 'minor:feat'
+---
+
+Expose app exit as a JS process API backed by the core app exit command.

crates/tauri/build.rs

@@ -158,6 +158,7 @@ const PLUGINS: &[(&str, &[(&str, bool)])] = &[
       ("identifier", true),
       ("app_show", false),
       ("app_hide", false),
+      ("exit", false),
       ("fetch_data_store_identifiers", false),
       ("remove_data_store", false),
       ("default_window_icon", false),

crates/tauri/mobile/android/src/main/java/app/tauri/AppPlugin.kt

@@ -8,10 +8,8 @@ import android.app.Activity
 import android.webkit.WebView
 import androidx.activity.OnBackPressedCallback
 import androidx.appcompat.app.AppCompatActivity
-import app.tauri.annotation.Command
 import app.tauri.annotation.TauriPlugin
 import app.tauri.plugin.Plugin
-import app.tauri.plugin.Invoke
 import app.tauri.plugin.JSObject
 
 @TauriPlugin
@@ -46,9 +44,4 @@ class AppPlugin(private val activity: Activity): Plugin(activity) {
     (activity as AppCompatActivity).onBackPressedDispatcher.addCallback(activity, callback)
   }
 
-  @Command
-  fun exit(invoke: Invoke) {
-    invoke.resolve()
-    activity.finish()
-  }
 }

crates/tauri/permissions/app/autogenerated/reference.md

@@ -128,6 +128,32 @@ Denies the default_window_icon command without any pre-configured scope.
 <tr>
 <td>
 
+`core:app:allow-exit`
+
+</td>
+<td>
+
+Enables the exit command without any pre-configured scope.
+
+</td>
+</tr>
+
+<tr>
+<td>
+
+`core:app:deny-exit`
+
+</td>
+<td>
+
+Denies the exit command without any pre-configured scope.
+
+</td>
+</tr>
+
+<tr>
+<td>
+
 `core:app:allow-fetch-data-store-identifiers`
 
 </td>

crates/tauri/src/app/plugin.rs

@@ -46,6 +46,11 @@ pub fn app_hide<R: Runtime>(app: AppHandle<R>) -> crate::Result<()> {
   Ok(())
 }
 
+#[command(root = "crate")]
+pub fn exit<R: Runtime>(app: AppHandle<R>, exit_code: Option<i32>) {
+  app.exit(exit_code.unwrap_or(0));
+}
+
 #[command(root = "crate")]
 #[allow(unused_variables)]
 pub async fn fetch_data_store_identifiers<R: Runtime>(
@@ -125,6 +130,7 @@ pub fn init<R: Runtime>() -> TauriPlugin<R> {
       identifier,
       app_show,
       app_hide,
+      exit,
       fetch_data_store_identifiers,
       remove_data_store,
       default_window_icon,

packages/api/src/index.ts

@@ -31,6 +31,7 @@ import * as image from './image'
 import * as menu from './menu'
 import * as mocks from './mocks'
 import * as path from './path'
+import * as process from './process'
 import * as tray from './tray'
 import * as webview from './webview'
 import * as webviewWindow from './webviewWindow'
@@ -45,6 +46,7 @@ export {
   menu,
   mocks,
   path,
+  process,
   tray,
   webview,
   webviewWindow,

packages/api/src/process.ts

@@ -0,0 +1,31 @@
+// Copyright 2019-2024 Tauri Programme within The Commons Conservancy
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-License-Identifier: MIT
+
+import { invoke } from './core'
+
+/**
+ * Process-related APIs.
+ *
+ * @module
+ */
+
+/**
+ * Exits the app.
+ *
+ * @param exitCode - The exit code to use. Defaults to `0`.
+ *
+ * @example
+ * ```typescript
+ * import { exit } from '@tauri-apps/api/process';
+ * await exit();
+ * ```
+ *
+ * @since 2.10.0
+ */
+async function exit(exitCode?: number): Promise<void> {
+  const payload = exitCode === undefined ? {} : { exitCode }
+  return invoke('plugin:app|exit', payload)
+}
+
+export { exit }