mirror of
https://github.com/rust-windowing/winit.git
synced 2026-06-26 22:53:15 -04:00
a232f7bc77
This commit moves WindowId to winit-core and replaces its inner type with a platform-agnostic `u64`. This required some changes to many of the backend in order to accommodate this new system. Signed-off-by: John Nunley <dev@notgull.net>
112 lines
3.0 KiB
Rust
112 lines
3.0 KiB
Rust
//! iOS support
|
|
//!
|
|
//! # Building app
|
|
//! To build ios app you will need rustc built for this targets:
|
|
//!
|
|
//! - armv7-apple-ios
|
|
//! - armv7s-apple-ios
|
|
//! - i386-apple-ios
|
|
//! - aarch64-apple-ios
|
|
//! - x86_64-apple-ios
|
|
//!
|
|
//! Then
|
|
//!
|
|
//! ```
|
|
//! cargo build --target=...
|
|
//! ```
|
|
//! The simplest way to integrate your app into xcode environment is to build it
|
|
//! as a static library. Wrap your main function and export it.
|
|
//!
|
|
//! ```rust, ignore
|
|
//! #[no_mangle]
|
|
//! pub extern fn start_winit_app() {
|
|
//! start_inner()
|
|
//! }
|
|
//!
|
|
//! fn start_inner() {
|
|
//! ...
|
|
//! }
|
|
//! ```
|
|
//!
|
|
//! Compile project and then drag resulting .a into Xcode project. Add winit.h to xcode.
|
|
//!
|
|
//! ```ignore
|
|
//! void start_winit_app();
|
|
//! ```
|
|
//!
|
|
//! Use start_winit_app inside your xcode's main function.
|
|
//!
|
|
//!
|
|
//! # App lifecycle and events
|
|
//!
|
|
//! iOS environment is very different from other platforms and you must be very
|
|
//! careful with it's events. Familiarize yourself with
|
|
//! [app lifecycle](https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIApplicationDelegate_Protocol/).
|
|
//!
|
|
//!
|
|
//! This is how those event are represented in winit:
|
|
//!
|
|
//! - applicationDidBecomeActive is Resumed
|
|
//! - applicationWillResignActive is Suspended
|
|
//! - applicationWillTerminate is LoopExiting
|
|
//!
|
|
//! Keep in mind that after LoopExiting event is received every attempt to draw with
|
|
//! opengl will result in segfault.
|
|
//!
|
|
//! Also note that app may not receive the LoopExiting event if suspended; it might be SIGKILL'ed.
|
|
|
|
#![cfg(ios_platform)]
|
|
#![allow(clippy::let_unit_value)]
|
|
|
|
mod app_state;
|
|
mod event_loop;
|
|
mod ffi;
|
|
mod monitor;
|
|
mod uikit;
|
|
mod view;
|
|
mod window;
|
|
|
|
use std::fmt;
|
|
|
|
use crate::event::DeviceId as RootDeviceId;
|
|
|
|
pub(crate) use self::{
|
|
event_loop::{
|
|
EventLoop, EventLoopProxy, EventLoopWindowTarget, OwnedDisplayHandle,
|
|
PlatformSpecificEventLoopAttributes,
|
|
},
|
|
monitor::{MonitorHandle, VideoModeHandle},
|
|
window::{PlatformSpecificWindowBuilderAttributes, Window},
|
|
};
|
|
pub(crate) use crate::cursor::NoCustomCursor as PlatformCustomCursor;
|
|
pub(crate) use crate::cursor::NoCustomCursor as PlatformCustomCursorBuilder;
|
|
pub(crate) use crate::icon::NoIcon as PlatformIcon;
|
|
pub(crate) use crate::platform_impl::Fullscreen;
|
|
|
|
/// There is no way to detect which device that performed a certain event in
|
|
/// UIKit (i.e. you can't differentiate between different external keyboards,
|
|
/// or wether it was the main touchscreen, assistive technologies, or some
|
|
/// other pointer device that caused a touch event).
|
|
#[derive(Debug, Copy, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
|
|
pub struct DeviceId;
|
|
|
|
impl DeviceId {
|
|
pub const unsafe fn dummy() -> Self {
|
|
DeviceId
|
|
}
|
|
}
|
|
|
|
pub(crate) const DEVICE_ID: RootDeviceId = RootDeviceId(DeviceId);
|
|
|
|
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
|
|
pub struct KeyEventExtra {}
|
|
|
|
#[derive(Debug)]
|
|
pub enum OsError {}
|
|
|
|
impl fmt::Display for OsError {
|
|
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
|
|
write!(f, "os error")
|
|
}
|
|
}
|