cacao/appkit/src/app/mod.rs

119 lines
4.4 KiB
Rust
Raw Normal View History

2020-02-28 13:34:34 +11:00
//! A wrapper for `NSApplicationDelegate` on macOS. Handles looping back events and providing a very janky
//! messaging architecture.
use objc_id::Id;
use objc::runtime::Object;
2020-02-28 13:34:34 +11:00
use objc::{class, msg_send, sel, sel_impl};
use crate::foundation::{id, AutoReleasePool};
use crate::constants::APP_PTR;
2020-02-28 13:34:34 +11:00
use crate::menu::Menu;
mod class;
use class::register_app_class;
mod controller;
use controller::register_app_controller_class;
pub mod enums;
pub mod traits;
pub use traits::{AppController, Dispatcher};
2020-02-28 13:34:34 +11:00
/// A wrapper for `NSApplication`. It holds (retains) pointers for the Objective-C runtime,
/// which is where our application instance lives. It also injects an `NSObject` subclass,
/// which acts as the Delegate, looping back into our Vaulthund shared application.
pub struct App<T = (), M = ()> {
pub inner: Id<Object>,
pub objc_delegate: Id<Object>,
pub delegate: Box<T>,
pub pool: AutoReleasePool,
2020-02-28 13:34:34 +11:00
_t: std::marker::PhantomData<M>
}
impl App {
/// Sets a set of `Menu`'s as the top level Menu for the current application. Note that behind
/// the scenes, Cocoa/AppKit make a copy of the menu you pass in - so we don't retain it, and
/// you shouldn't bother to either.
pub fn set_menu(menus: Vec<Menu>) {
unsafe {
let menu_cls = class!(NSMenu);
let main_menu: id = msg_send![menu_cls, new];
let item_cls = class!(NSMenuItem);
for menu in menus.iter() {
let item: id = msg_send![item_cls, new];
let _: () = msg_send![item, setSubmenu:&*menu.inner];
let _: () = msg_send![main_menu, addItem:item];
}
let cls = class!(RSTApplication);
let shared_app: id = msg_send![cls, sharedApplication];
let _: () = msg_send![shared_app, setMainMenu:main_menu];
}
}
}
impl<T, M> App<T, M> where M: Send + Sync + 'static, T: AppController + Dispatcher<Message = M> {
2020-02-28 13:34:34 +11:00
/// Creates an NSAutoReleasePool, configures various NSApplication properties (e.g, activation
/// policies), injects an `NSObject` delegate wrapper, and retains everything on the
/// Objective-C side of things.
pub fn new(_bundle_id: &str, delegate: T) -> Self {
// set_bundle_id(bundle_id);
let pool = AutoReleasePool::new();
2020-02-28 13:34:34 +11:00
let inner = unsafe {
let app: id = msg_send![register_app_class(), sharedApplication];
let _: () = msg_send![app, setActivationPolicy:0];
Id::from_ptr(app)
};
let app_delegate = Box::new(delegate);
let objc_delegate = unsafe {
let delegate_class = register_app_controller_class::<T>();
2020-02-28 13:34:34 +11:00
let delegate: id = msg_send![delegate_class, new];
let delegate_ptr: *const T = &*app_delegate;
(&mut *delegate).set_ivar(APP_PTR, delegate_ptr as usize);
let _: () = msg_send![&*inner, setDelegate:delegate];
Id::from_ptr(delegate)
};
App {
objc_delegate: objc_delegate,
inner: inner,
delegate: app_delegate,
pool: pool,
2020-02-28 13:34:34 +11:00
_t: std::marker::PhantomData
}
}
/// Dispatches a message by grabbing the `sharedApplication`, getting ahold of the delegate,
/// and passing back through there. All messages are currently dispatched on the main thread.
pub fn dispatch(message: M) {
let queue = dispatch::Queue::main();
queue.exec_async(move || unsafe {
let app: id = msg_send![register_app_class(), sharedApplication];
let app_delegate: id = msg_send![app, delegate];
let delegate_ptr: usize = *(*app_delegate).get_ivar(APP_PTR);
let delegate = delegate_ptr as *const T;
(&*delegate).on_message(message);
});
}
2020-02-28 13:34:34 +11:00
/// Kicks off the NSRunLoop for the NSApplication instance. This blocks when called.
/// If you're wondering where to go from here... you need an `AppController` that implements
2020-02-28 13:34:34 +11:00
/// `did_finish_launching`. :)
pub fn run(&self) {
unsafe {
let current_app: id = msg_send![class!(NSRunningApplication), currentApplication];
let _: () = msg_send![current_app, activateWithOptions:1<<1];
2020-02-28 13:34:34 +11:00
let shared_app: id = msg_send![class!(RSTApplication), sharedApplication];
let _: () = msg_send![shared_app, run];
self.pool.drain();
2020-02-28 13:34:34 +11:00
}
}
}