[−][src]Crate jni_android_sys
jni-android-sys
Work in progress, only barely kinda partially usable, APIs not yet stabilized
Uses jni-bindgen to export Android's Java APIs to Rust. Only tested against Android API level 28 so far.
Example: example_android_studio Android Studio Example
..\example_android_studio\ | What |
---|---|
app\src\main\java\MainActivity.java | Java Source |
rust\src\lib.rs | Rust Source |
app\build.gradle | App Build Config |
build.gradle | Root Build Config |
Example: Inline
Cargo.toml
[dependencies]
jni-android-sys = { version = "0.0.10", features = ["api-level-28", "android-view-KeyEvent"] }
MainActivity.java
package com.example;
import androidx.appcompat.app.AppCompatActivity;
import android.view.KeyEvent;
public class MainActivity extends AppCompatActivity {
static { System.loadLibrary("example"); }
@Override public native boolean dispatchKeyEvent(KeyEvent keyEvent);
}
main_activity.rs
use jni_sys::{jboolean, jobject, JNI_TRUE}; use jni_glue::{Argument, Env}; use jni_android_sys::android::view::KeyEvent; #[no_mangle] pub extern "system" fn Java_com_example_MainActivity_dispatchKeyEvent( env: &Env, _this: jobject, key_event: Argument<KeyEvent>, ) -> jboolean { let key_event = unsafe { key_event.with_unchecked(env) }; // Unsafe boilerplate not yet autogenerated. // Err = Java exception was thrown. // Ok(None) = Java object is null. // Ok(Some(...)) = Real java object! if let Some(key_event) = key_event { let is_enter = if let Ok(r) = key_event.getKeyCode() { r == KeyEvent::KEYCODE_ENTER } else { false }; let is_down = if let Ok(r) = key_event.getAction() { r == KeyEvent::ACTION_DOWN } else { false }; if is_enter && is_down { println!("ENTER pressed"); // Not that you can see this... } } JNI_TRUE // JNI boilerplate not yet autogenerated }
License
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
Build Features
feature | description |
---|---|
"api-level-7" | Define android APIs as they were defined in API level 7 or greater |
... | ... |
"api-level-28" | Define android APIs as they were defined in API level 28 or greater |
"android-view-KeyEvent" | Define the android.view.KeyEvent class |
"android-view-KeyEvent_Callback" | Define the android.view.KeyEvent.Callback interface |
...thousands of other features... | Define other android.*, androidx.*, dalvik.*, java.*, javax.*, and org.* APIs. |
"all" | Define all the available android/java APIs |
"force-define" | Define android APIs on non-android targets (for use in custom targets, docs, etc.) |
"force-define-x86_64-unknown-linux-gnu" | Define android APIs on x86_64-unknown-linux-gnu specifically (for use in docs.rs) |
"nightly" | Define some stuff which may only work on nightly compilers (right now just for docs.) |
Modules
android | |
androidx | |
dalvik | |
java | |
javax | |
org |