1 unstable release
new 0.1.0 | Oct 28, 2024 |
---|
#5 in #listen
122 downloads per month
16KB
229 lines
Tauri Plugin app-events
A plugin for tauri@v2 to listen some events on iOS and Android.
Platform Supported
Platform | Supported |
---|---|
Linux | ❌ |
Windows | ❌ |
macOS | ❌ |
Android | ✅ |
iOS | ✅ |
For desktop platforms, please use @tauri-apps/api/event or the JavaScript method keydown event.
Setup
Install the app-events
plugin to get started.
-
Run the following command in the
src-tauri
folder to add the plugin to the project’s dependencies inCargo.toml
:cargo add tauri-plugin-app-events@0.1 --target 'cfg(any(target_os = "android", target_os = "ios"))'
-
Modify
lib.rs
to initialize the plugin:#[cfg_attr(mobile, tauri::mobile_entry_point)] pub fn run() { tauri::Builder::default() .setup(|app| { + #[cfg(mobile)] + let _ = app.handle().plugin(tauri_plugin_app_events::init()); Ok(()) }) .run(tauri::generate_context!()) .expect("error while running tauri application"); }
-
Install the JavaScript Guest bindings using your preferred JavaScript package manager:
pnpm add tauri-plugin-app-events-api@0.1
-
Modify
src-tauri/capabilities/default.json
to Allow the frontend to execute the exit_app command.{ "$schema": "../gen/schemas/desktop-schema.json", "identifier": "default", "description": "Capability for the main window", "windows": ["main"], "permissions": [ "core:default", + "app-events:default" ] }
-
If you want to support key event listeners on the Android platform, you'll need to modify the
MainActivity.kt
file located atsrc-tauri/gen/android/app/src/main/java/com/tauri/dev/MainActivity.kt. The content should be updated as follows
:package com.tauri.dev import android.view.KeyEvent import android.webkit.WebView class MainActivity : TauriActivity() { private lateinit var wv: WebView override fun onWebViewCreate(webView: WebView) { wv = webView } private val keyEventMap = mapOf( KeyEvent.KEYCODE_BACK to "back", KeyEvent.KEYCODE_MENU to "menu", KeyEvent.KEYCODE_SEARCH to "search", KeyEvent.KEYCODE_VOLUME_DOWN to "volume_down", KeyEvent.KEYCODE_VOLUME_UP to "volume_up" ) override fun onKeyDown(keyCode: Int, event: KeyEvent?): Boolean { val jsCallbackName = keyEventMap[keyCode] wv.evaluateJavascript( """ try { window.__tauri_android_on_${if (jsCallbackName != null) "${jsCallbackName}_" else ""}key_down__(${if (jsCallbackName != null) "" else keyCode}) } catch (_) { true } """.trimIndent() ) { result -> run { if (result != "false") { super.onKeyDown(keyCode, event) } } } return true } }
Usage
Api Support
Api | Android | iOS |
---|---|---|
onResume | ✅ | ✅ |
onPause | ✅ | ✅ |
onBackKeyDown | ✅ | ❌ |
onMenuKeyDown | ✅ | ❌ |
onSearchKeyDown | ✅ | ❌ |
onVolumeDownKeyDown | ✅ | ❌ |
onVolumeUpKeyDown | ✅ | ❌ |
onKeyDown | ✅ | ❌ |
Import Apis
import {
onResume,
onPause,
onBackKeyDown,
onMenuKeyDown,
onSearchKeyDown,
onVolumeDownKeyDown,
onVolumeUpKeyDown,
onKeyDown,
} from "tauri-plugin-app-events-api";
Note
All listener APIs only support a single callback, so repeated calls will cause the previous listener to be overridden.
Therefore, if you want to cancel the listener, you can pass an empty parameter in functions like onResume()
.
In keydown event
listeners of Android, if the callback function returns false
, the default handling logic will be prevented. If it returns any other value or doesn't return anything, the default handling logic will continue.
onResume
The resume
event fires when the system pulls the application out from the background.
onResume(() => {
console.log("App resume");
});
onPause
The pause
event fires when the system puts the application into the background, typically when the user switches to a different application.
onResume(() => {
console.log("App pause");
});
onBackKeyDown
The event fires when the user presses the back button on Android.
onBackKeyDown(() => {
console.log("Back key triggered");
return false;
});
onMenuKeyDown
The event fires when the user presses the menu button on Android.
onMenuKeyDown(() => {
console.log("Menu key triggered");
return false;
});
onSearchKeyDown
The event fires when the user presses the search button on Android.
onSearchKeyDown(() => {
console.log("Search key triggered");
return false;
});
onVolumeDownKeyDown
The event fires when the user presses the volume down button on Android.
onVolumeDownKeyDown(() => {
console.log("Volume down key triggered");
return false;
});
onVolumeUpKeyDown
The event fires when the user presses the volume up button on Android.
onVolumeUpKeyDown(() => {
console.log("Volume up key triggered");
return false;
});
onKeyDown
If you want to listen for the events of pressing other buttons, you can use onKeyDown
. Note that this does not include the aforementioned button events.
onKeyDown((keyCode) => {
console.log(`Key ${keyCode} triggered`);
return false;
});
Regarding keyCode
, you can refer to the Android documentation.
Permission description
Dependencies
~17–61MB
~896K SLoC