bevy_ios_toolkit 0.3.0

Native iOS integrations for Bevy as ECS resources and messages: StoreKit IAP, Google AdMob ads, App Tracking Transparency, Game Center, review prompts, haptics and safe-area — each behind a feature, over a polled C-ABI Swift bridge with a testable desktop fake.
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

//! The device's safe-area insets (notch / Dynamic Island, home indicator,
//! rounded corners), in points.
//!
//! Returns the raw insets, or `0.0` when unavailable (off-iOS, or before the key
//! window exists). The caller owns the fallback policy — a layout typically
//! clamps to a notch-class constant when an inset reports `0.0` and adds its own
//! breathing-room margin.

/// The four safe-area insets, in points. A portrait game usually needs only
/// [`top`](Self::top); landscape games and bottom-anchored HUD/toasts want all
/// four (home indicator, rounded corners).
#[derive(Clone, Copy, Debug, Default, PartialEq)]
pub struct Insets {
    /// Notch / Dynamic Island edge.
    pub top: f32,
    /// Home-indicator edge.
    pub bottom: f32,
    /// Left rounded-corner / sensor edge (landscape).
    pub left: f32,
    /// Right rounded-corner / sensor edge (landscape).
    pub right: f32,
}

#[cfg(target_os = "ios")]
pub fn insets() -> Insets {
    unsafe extern "C" {
        fn platform_safe_top() -> f32;
        fn platform_safe_bottom() -> f32;
        fn platform_safe_left() -> f32;
        fn platform_safe_right() -> f32;
    }
    unsafe {
        Insets {
            top: platform_safe_top(),
            bottom: platform_safe_bottom(),
            left: platform_safe_left(),
            right: platform_safe_right(),
        }
    }
}

#[cfg(not(target_os = "ios"))]
pub fn insets() -> Insets {
    Insets::default()
}

/// The top safe-area inset alone — a convenience for the common portrait case.
/// Equivalent to `insets().top`, but a single FFI call.
#[cfg(target_os = "ios")]
pub fn top() -> f32 {
    unsafe extern "C" {
        fn platform_safe_top() -> f32;
    }
    unsafe { platform_safe_top() }
}

#[cfg(not(target_os = "ios"))]
pub fn top() -> f32 {
    0.0
}