alex/cacao
1
0
Fork 0
Code Issues Pull requests Packages Projects Releases Wiki Activity
fork of https://github.com/ryanmcgrath/cacao
35 commits 1 branch 0 tags 1.1 MiB
Rust 100%
Go to file
Ryan McGrath 8d490b3e33
Further work on docs
2020-03-27 20:13:51 -07:00
examples Fix up the repo so examples work as they should 2020-03-26 18:06:11 -07:00
src Further work on docs 2020-03-27 20:13:51 -07:00
.gitignore Moving to a model where ther are actual examples, since the handler logic is finally ironed out well. 2020-03-19 20:07:44 -07:00
build.rs Fix up the repo so examples work as they should 2020-03-26 18:06:11 -07:00
Cargo.toml Fix up the repo so examples work as they should 2020-03-26 18:06:11 -07:00
clippy.toml Initial commit 2020-02-27 18:34:34 -08:00
code_of_conduct.md Initial commit 2020-02-27 18:34:34 -08:00
CONTRIBUTING.md Initial commit 2020-02-27 18:34:34 -08:00
LICENSE-MIT.md Initial commit 2020-02-27 18:34:34 -08:00
LICENSE-MPL.md Initial commit 2020-02-27 18:34:34 -08:00
README.md Initial commit 2020-02-27 18:34:34 -08:00

README.md

Rust Bindings for AppKit on macOS

This repository contains some very exploratory, experimental bindings for AppKit on macOS. They aim to enable writing native macOS applications in pure Rust. There are currently no guarantees for anything, but you're welcome to clone and tinker.

  • It relies on the Objective C runtime, so you should consider this a bridge and not "the way forward". With that said, something like this needs to exist to jumpstart things. Down the road I could totally see this being superseded. It could also be cool to see something like this used as a layer for rendering in other frameworks (e.g, Bodil's vgtk or something).
  • It attempts to mimic how you'd write things in native ObjC/Swift, by providing very clear hooks for lifecycle events.
  • As it runs via the ObjC runtime, there are many unsafe blocks. You can question them, and feel free to suggest better ways to do it, but this library will never have no unsafe usage. Issues pertaining to total removal will be closed without question. If you want a Rust UI framework for the future, then follow what's happening over in Druid or something. If you'd like to do things now, natively, then feel free to consider tinkering with this.

I look at it like this: you realistically, for an app with a proper GUI, can't write 100% "safe" code today. You can get close, though - pick your poison.

Can I use this now?

For now, you can clone this repository and link it into your Cargo.toml by path. I'm squatting the names on crates.io, as I (in time) will throw this up there, but only when it's at a point where there's reasonable expectation that things won't be changing around much.

If you're interested in seeing this in use in a shipping app, head on over to subatomic.

Gotchas

Note that this framework expects that you're participating in code signing. Certain linked frameworks (UserNotifications.framework, etc) will not work if you're not.

Etc

I assume I'll produce a better README at some point, but who knows. You can follow me over on twitter or email me with questions. Dual licensed MPL 2.0 and MIT.