bevy_ios_safearea

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

bevy_ios_safearea

★ 10 Open GitHub ↗

Bevy plugin to query ios device safe area insets

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# bevy_ios_safearea

[![Following released Bevy versions](https://img.shields.io/badge/Bevy%20tracking-released%20version-lightblue)](https://bevyengine.org/learn/quick-start/plugin-development/#main-branch-tracking)
[![crates.io](https://img.shields.io/crates/v/bevy_ios_safearea.svg)](https://crates.io/crates/bevy_ios_safearea)
[![docs.rs](https://docs.rs/bevy_ios_safearea/badge.svg)](https://docs.rs/bevy_ios_safearea)
[![discord][sh_discord]][lk_discord]

[sh_discord]: https://img.shields.io/discord/1176858176897953872?label=discord&color=5561E6
[lk_discord]: https://discord.gg/rQNeEnMhus

Bevy plugin to query ios device safe area insets.

![demo](https://raw.githubusercontent.com/rustunit/bevy_ios_safearea/main/assets/example.jpg)

## Features

* reads safe area on app start
* easy access via a resource
* noop on non-ios platforms (no `cfg`s needed in your app code)
* pure Rust + objc2 on the iOS side — no Swift Package, no Xcode SPM step

## Instructions

### 1. Add the dependency

Plain `[dependencies]`, not target-gated — that's what "no `cfg`s needed in
your app code" above means. The only iOS-specific bit
([`objc2-ui-kit`](https://docs.rs/objc2-ui-kit)) is gated inside *this*
crate's own `Cargo.toml`, not the consumer's.

```toml
[dependencies]
bevy_ios_safearea = "0.7"
```

### 2. Setup Plugin in Bevy

Initialize Bevy Plugin:

```rust
// request initialisation right on startup
use bevy::prelude::*;
App::new()
    .add_plugins((DefaultPlugins,bevy_ios_safearea::IosSafeAreaPlugin));
```

Accessing it:

```rust
use bevy::prelude::*;
use bevy_ios_safearea::IosSafeArea;

fn bevy_system(safe_area: IosSafeArea) {
    let safe_area_top = safe_area.top();
}
```

## Our Other Crates

- [bevy_debug_log](https://github.com/rustunit/bevy_debug_log)
- [bevy_device_lang](https://github.com/rustunit/bevy_device_lang)
- [bevy_web_popups](https://github.com/rustunit/bevy_web_popups)
- [bevy_libgdx_atlas](https://github.com/rustunit/bevy_libgdx_atlas)
- [bevy_ios_iap](https://github.com/rustunit/bevy_ios_iap)
- [bevy_ios_review](https://github.com/rustunit/bevy_ios_review)
- [bevy_ios_gamecenter](https://github.com/rustunit/bevy_ios_gamecenter)
- [bevy_ios_alerts](https://github.com/rustunit/bevy_ios_alerts)
- [bevy_ios_notifications](https://github.com/rustunit/bevy_ios_notifications)
- [bevy_ios_impact](https://github.com/rustunit/bevy_ios_impact)

## Bevy version support

|bevy|crate|
|----|---|
|0.19|0.6,0.7,main|
|0.18|0.5|
|0.17|0.4|
|0.16|0.3|
|0.15|0.1,0.2|

# License

All code in this repository is dual-licensed under either:

- MIT License (LICENSE-MIT or <http://opensource.org/licenses/MIT>)
- Apache License, Version 2.0 (LICENSE-APACHE or <http://www.apache.org/licenses/LICENSE-2.0>)

at your option. This means you can select the license you prefer.

## Your contributions

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.

bevy_ios_safearea

Today's picks

Was this content helpful?

Recent Feedback

bevy_ios_safearea

Today's picks

Was this content helpful?

Recent Feedback

Download README