agera 0.1.19

Agera SDK API
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

/*!

Work with the final platform.

# Native platforms

The following items are available when building for native platforms:

- `agera::platforms::tokio` — Alias to the `tokio` crate, an asynchronous runtime for Rust.

# Android platform

The folllowing items are available when building an Agera application
for the Android operating system:

- `agera::platforms::activity` — Alias to the [`android_activity`](https://crates.io/crates/android-activity) crate.
- `agera::platforms::jni` — Alias to the [`jni`](https://crates.io/crates/jni) crate.
- `agera::platforms::application()` — Returns an `agera::platforms::activity::AndroidApp` value
providing access to the Android application.

# Browser

When building an Agera application for the browser, the following dependencies
are internally used:

- [wasm_bindgen](https://rustwasm.github.io/wasm-bindgen/)
- [wasm-bindgen-futures](https://crates.io/crates/wasm-bindgen-futures)
- [js-sys](https://crates.io/crates/js-sys)

The following items are available when building for the browser:

- `agera::platforms::js_bindings` — Alias to the `wasm_bindgen` crate.
- `agera::platforms::js_futures` — Alias to the `wasm_bindgen_futures` crate.
- `agera::platforms::js` — Alias to the `js_sys` crate.
*/

#[allow(unused)]
use crate::common::*;

#[allow(unused)]
use std::sync::RwLock;

/// Expands an item solely if the build target is a native platform.
pub macro if_native_platform {
    ($it:block) => {
        #[cfg(not(target_arch = "wasm32"))]
        $it
    },
    ($($it:item)+) => {
        $(
            #[cfg(not(target_arch = "wasm32"))]
            $it
        )+
    },
}

/// Expands an item solely if the build target is the browser.
pub macro if_browser {
    ($it:block) => {
        #[cfg(target_arch = "wasm32")]
        $it
    },
    ($($it:item)+) => {
        $(
            #[cfg(target_arch = "wasm32")]
            $it
        )+
    },
}

#[allow(unused)]
pub(crate) macro unsupported_platform {
    () => {
        panic!("Unsupported platform");
    },
}

if_native_platform! {
    pub use tokio;
}

#[cfg(target_os = "android")]
pub use ::android_activity as activity;

#[cfg(target_os = "android")]
pub use ::jni;

#[cfg(target_os = "android")]
#[doc(hidden)]
pub static APPLICATION: Lazy<RwLock<Option<activity::AndroidApp>>> = Lazy::new(|| RwLock::new(None));

#[cfg(target_os = "android")]
pub fn application() -> activity::AndroidApp {
    APPLICATION.read().unwrap().as_ref().unwrap().clone()
}

if_browser! {
    pub use wasm_bindgen as js_bindings;
    pub use wasm_bindgen_futures as js_futures;
    pub use js_sys as js;
}