Struct NativeActivity

pub struct NativeActivity { /* private fields */ }

An ANativeActivity *

This is either provided in ANativeActivity_onCreate, or accessible in android_native_app_glue’s android_app.

Implementations

impl NativeActivity

pub unsafe fn from_ptr(ptr: NonNull<ANativeActivity>) -> Self

Create a NativeActivity from a pointer

By calling this function, you assert that it is a valid pointer to a native ANativeActivity.

pub fn ptr(&self) -> NonNull<ANativeActivity>

The pointer to the native ANativeActivity

impl NativeActivity

Methods that relate to fields of the struct itself

The relevant NDK docs can be found here.

pub fn sdk_version(&self) -> i32

The platform’s SDK version code

pub fn internal_data_path(&self) -> &CStr

Path to this application’s internal data directory

pub fn external_data_path(&self) -> &CStr

Path to this application’s external (removable, mountable) data directory

pub fn asset_manager(&self) -> AssetManager

This app’s asset manager, which can be used to access assets from the .apk file.

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

Instance data associated with the activity

pub unsafe fn set_instance(&mut self, data: *mut c_void)

Set the instance data associated with the activity

This can invalidate assumptions held by android_native_app_glue, as well as cause data races with concurrent access to the instance data.

pub fn vm(&self) -> JavaVM

This process’s JavaVM object.

let vm = native_activity.vm();
let env = vm.attach_current_thread();
// Do JNI with env ...

pub fn activity(&self) -> JObject<'_>

The android.app.NativeActivity instance

In the JNI, this is named clazz; however, as the docs say, “it should really be named ‘activity’ instead of ‘clazz’, since it’s a reference to the NativeActivity instance.

pub unsafe fn obb_path(&self) -> &CStr

Path to the directory with the application’s OBB files.

Only available as of Honeycomb (Android 3.0+, API level 11+)

impl NativeActivity

Methods that relate to ANativeActivity_* functions.

The relevant NDK docs can be found here.

pub fn finish(&self)

Sends a destroy event to the activity and stops it.

pub fn show_soft_input(&self, force: bool)

Shows the IME (the on-screen keyboard).

If force is true, the SHOW_FORCED flag is used; otherwise, the SHOW_IMPLICIT flag is used. Depending on the value of this flag, the hide_soft_input method with behave differently. See the relevant javadoc for more information.

pub fn hide_soft_input(&self, not_always: bool)

Hides the IME (the on-screen keyboard).

If not_always is true, the HIDE_NOT_ALWAYS flag is used; otherwise, the HIDE_IMPLICIT_ONLY flag is used. Depending on the value of this flag and the way the IME was shown, it may or may not be hidden. See the relevant javadoc for more information.

Trait Implementations

impl Debug for NativeActivity

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

Formats the value using the given formatter.

impl Send for NativeActivity

impl Sync for NativeActivity