.. | ||
compat-headers | ||
src | ||
.cargo-checksum.json | ||
build.rs | ||
Cargo.toml | ||
CHANGELOG.md | ||
README.md |
block-sys
Raw Rust bindings to Apple's C language extension of blocks.
This crate is part of the objc2
project,
see that for related crates.
Runtime Support
This library is basically just a raw interface to the aptly specified Blocks ABI. However, different runtime implementations exist and act in slightly different ways (and have several different helper functions), the most important aspect being that the libraries are named differently, so the linking must take that into account.
The user can choose the desired runtime by using the relevant cargo feature
flags, see the following sections (might have to disable the default apple
feature first). Note that if the objc-sys
crate is present in the module
tree, this should have the same feature flag enabled as that.
Apple's libclosure
- Feature flag:
apple
.
This is naturally the most sophisticated runtime, and it has quite a lot more features than the specification mandates. This is used by default.
The minimum required operating system versions are as follows:
- macOS:
10.6
- iOS:
3.2
- tvOS: Unknown
- watchOS: Unknown
Though in practice Rust itself requires higher versions than this.
LLVM compiler-rt
's libBlocksRuntime
- Feature flag:
compiler-rt
.
This is effectively just a copy of Apple's older (around macOS 10.6) runtime,
and is now used in Swift's libdispatch
and Swift's Foundation as well.
This can be easily used on many Linux systems with the libblocksruntime-dev
package.
Using this runtime probably won't work together with objc-sys
crate.
GNUStep's libobjc2
- Feature flag:
gnustep-1-7
,gnustep-1-8
,gnustep-1-9
,gnustep-2-0
andgnustep-2-1
depending on the version you're using.
GNUStep is a bit odd, because it bundles blocks support into its Objective-C
runtime. This means we have to link to libobjc
, and this is done by
depending on the objc-sys
crate. A bit unorthodox, yes, but it works.
Sources:
Microsoft's WinObjC
- Feature flag:
unstable-winobjc
.
Unstable: Hasn't been tested on Windows yet!
Essentially just a fork based on
GNUStep's libobjc2
version 1.8.
ObjFW
- Feature flag:
unstable-objfw
.
Unstable: Doesn't work yet!
TODO.
C Compiler configuration
To our knowledge, currently only clang
supports the Language Specification
for Blocks. To assist in compiling C (or Objective-C) sources
using these features, this crate's build script expose the
DEP_BLOCK_0_1_CC_ARGS
environment variable to downstream build scripts.
Example usage in your build.rs
(using the cc
crate) would be as follows:
fn main() {
let mut builder = cc::Build::new();
builder.compiler("clang");
builder.file("my_script_using_blocks.c");
for flag in std::env::var("DEP_BLOCK_0_1_CC_ARGS").unwrap().split(' ') {
builder.flag(flag);
}
builder.compile("libmy_script_using_blocks.a");
}