0df436901a
* First name consistency pass. More to come! * Remove multitouch variable (hopefully this compiles!) * Remove CreationError::NotSupported * Add new error handling types * Remove `get_` prefix from getters. This is as per the Rust naming conventions recommended in https://rust-lang-nursery.github.io/api-guidelines/naming.html#getter-names-follow-rust-convention-c-getter * Make changes to Window position and size function signatures * Remove CreationError in favor of OsError * Begin updating iOS backend * Change MonitorHandle::outer_position to just position * Fix build on Windows and Linux * Add Display and Error implementations to Error types * Attempt to fix iOS build. I can't actually check that this works since I can't cross-compile to iOS on a Windows machine (thanks apple :/) but this should be one of several commits to get it working. * Attempt to fix iOS errors, and muck up Travis to make debugging easier * More iOS fixins * Add Debug and Display impls to OsError * Fix Display impl * Fix unused code warnings and travis * Rename set_ime_spot to set_ime_position * Add CHANGELOG entry * Rename set_cursor to set_cursor_icon and MouseCursor to CursorIcon * Organize Window functions into multiple, categorized impls * Improve clarity of function ordering and docs in EventLoop
114 lines
2.7 KiB
Rust
114 lines
2.7 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 Suspended(false)
|
|
//! - applicationWillResignActive is Suspended(true)
|
|
//! - applicationWillTerminate is LoopDestroyed
|
|
//!
|
|
//! Keep in mind that after LoopDestroyed event is received every attempt to draw with
|
|
//! opengl will result in segfault.
|
|
//!
|
|
//! Also note that app may not receive the LoopDestroyed event if suspended; it might be SIGKILL'ed.
|
|
|
|
#![cfg(target_os = "ios")]
|
|
|
|
// TODO: (mtak-) UIKit requires main thread for virtually all function/method calls. This could be
|
|
// worked around in the future by using GCD (grand central dispatch) and/or caching of values like
|
|
// window size/position.
|
|
macro_rules! assert_main_thread {
|
|
($($t:tt)*) => {
|
|
if !msg_send![class!(NSThread), isMainThread] {
|
|
panic!($($t)*);
|
|
}
|
|
};
|
|
}
|
|
|
|
mod app_state;
|
|
mod event_loop;
|
|
mod ffi;
|
|
mod monitor;
|
|
mod view;
|
|
mod window;
|
|
|
|
use std::fmt;
|
|
|
|
pub use self::event_loop::{EventLoop, EventLoopProxy, EventLoopWindowTarget};
|
|
pub use self::monitor::MonitorHandle;
|
|
pub use self::window::{
|
|
PlatformSpecificWindowBuilderAttributes,
|
|
Window,
|
|
WindowId,
|
|
};
|
|
|
|
#[derive(Debug, Copy, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
|
|
pub struct DeviceId {
|
|
uiscreen: ffi::id,
|
|
}
|
|
|
|
impl DeviceId {
|
|
pub unsafe fn dummy() -> Self {
|
|
DeviceId {
|
|
uiscreen: std::ptr::null_mut(),
|
|
}
|
|
}
|
|
}
|
|
|
|
unsafe impl Send for DeviceId {}
|
|
unsafe impl Sync for DeviceId {}
|
|
|
|
#[derive(Debug)]
|
|
pub enum OsError {}
|
|
|
|
impl fmt::Display for OsError {
|
|
fn fmt(&self, _: &mut fmt::Formatter) -> fmt::Result {
|
|
match self {
|
|
_ => unreachable!()
|
|
}
|
|
}
|
|
}
|