Struct android_activity::AndroidApp

pub struct AndroidApp { /* private fields */ }

The top-level state and interface for a native Rust application

AndroidApp provides an interface to query state for the application as well as monitor events, such as lifecycle and input events, that are marshalled between the Java thread that owns the Activity and the native thread that runs the android_main() code.

Implementations

impl AndroidApp

pub fn native_window(&self) -> Option<NativeWindow>

Queries the current NativeWindow for the application.

This will only return Some(window) between MainEvent::InitWindow and MainEvent::TerminateWindow events.

pub fn vm_as_ptr(&self) -> *mut c_void

Returns a pointer to the Java Virtual Machine, for making JNI calls

This returns a pointer to the Java Virtual Machine which can be used with the jni crate (or similar crates) to make JNI calls that bridge between native Rust code and Java/Kotlin code running within the JVM.

If you use the jni crate you can wrap this as a JavaVM via:

let vm = unsafe { JavaVM::from_raw(app.vm_as_ptr()) };

pub fn activity_as_ptr(&self) -> *mut c_void

Returns a JNI object reference for this application’s JVM Activity as a pointer

If you use the jni crate you can wrap this as an object reference via:

let activity = unsafe { JObject::from_raw(app.activity_as_ptr()) };

JNI Safety

Note that the object reference will be a JNI global reference, not a local reference and it should not be deleted. Don’t wrap the reference in an AutoLocal which would try to explicitly delete the reference when dropped. Similarly, don’t wrap the reference as a GlobalRef which would also try to explicitly delete the reference when dropped.

pub fn poll_events<F>(&self, timeout: Option<Duration>, callback: F)where F: FnMut(PollEvent<'_>),

Polls for any events associated with this AndroidApp and processes those events (such as lifecycle events) via the given callback.

It’s important to use this API for polling, and not call ALooper_pollAll directly since some events require pre- and post-processing either side of the callback. For correct behavior events should be handled immediately, before returning from the callback and not simply queued for batch processing later. For example the existing NativeWindow is accessible during a MainEvent::TerminateWindow callback and will be set to None once the callback returns, and this is also synchronized with the Java main thread. The MainEvent::SaveState event is also synchronized with the Java main thread.

Panics

This must only be called from your android_main() thread and it may panic if called from another thread.

pub fn create_waker(&self) -> AndroidAppWaker

Creates a means to wake up the main loop while it is blocked waiting for events within AndroidApp::poll_events().

pub fn config(&self) -> ConfigurationRef

Returns a (cheaply clonable) reference to this application’s ndk::configuration::Configuration

pub fn content_rect(&self) -> Rect

Queries the current content rectangle of the window; this is the area where the window’s content should be placed to be seen by the user.

pub fn asset_manager(&self) -> AssetManager

Queries the Asset Manager instance for the application.

Use this to access binary assets bundled inside your application’s .apk file.

pub fn set_window_flags( &self, add_flags: WindowManagerFlags, remove_flags: WindowManagerFlags )

Change the window flags of the given activity.

Note that some flags must be set before the window decoration is created, see <https://developer.android.com/reference/android/view/Window#setFlags(int,%20int)>.

pub fn enable_motion_axis(&self, axis: Axis)

Enable additional input axis

To reduce overhead, by default only input::Axis::X and input::Axis::Y are enabled and other axis should be enabled explicitly.

pub fn disable_motion_axis(&self, axis: Axis)

Disable input axis

To reduce overhead, by default only input::Axis::X and input::Axis::Y are enabled and other axis should be enabled explicitly.

pub fn show_soft_input(&self, show_implicit: bool)

Explicitly request that the current input method’s soft input area be shown to the user, if needed.

Call this if the user interacts with your view in such a way that they have expressed they would like to start performing input into it.

pub fn hide_soft_input(&self, hide_implicit_only: bool)

Request to hide the soft input window from the context of the window that is currently accepting input.

This should be called as a result of the user doing some action that fairly explicitly requests to have the input window hidden.

pub fn input_events<F>(&self, callback: F)where F: FnMut(&InputEvent<'_>) -> InputStatus,

Query and process all out-standing input event

callback should return InputStatus::Unhandled for any input events that aren’t directly handled by the application, or else InputStatus::Handled. Unhandled events may lead to a fallback interpretation of the event.

Applications are generally either expected to call this in-sync with their rendering or in response to a MainEvent::InputAvailable event being delivered. Note though that your application is will only be delivered a single MainEvent::InputAvailable event between calls to this API.

To reduce overhead, by default only input::Axis::X and input::Axis::Y are enabled and other axis should be enabled explicitly via Self::enable_motion_axis.

pub fn sdk_version() -> i32

The user-visible SDK version of the framework

Also referred to as Build.VERSION_CODES

pub fn internal_data_path(&self) -> Option<PathBuf>

Path to this application’s internal data directory

pub fn external_data_path(&self) -> Option<PathBuf>

Path to this application’s external data directory

pub fn obb_path(&self) -> Option<PathBuf>

Path to the directory containing the application’s OBB files (if any).

Trait Implementations

impl Clone for AndroidApp

fn clone(&self) -> AndroidApp

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AndroidApp

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Hash for AndroidApp

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq<AndroidApp> for AndroidApp

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for AndroidApp