rsbinder 0.12.0

Pure-Rust Binder IPC for Linux, Android, and macOS — kernel binder plus a libbinder-compatible RPC (binder-over-socket) transport.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

// Copyright 2022 Jeff Kim <hiking90@gmail.com>
// SPDX-License-Identifier: Apache-2.0

//! Generates the AIDL bindings the runtime crate vendors.
//!
//! The codegen's async support mirrors the runtime crate's own `async`
//! feature (`CARGO_FEATURE_ASYNC`, set by cargo whenever the current
//! package's `async` feature is active). The emitted `IServiceManager` /
//! `IAccessor` traits would otherwise reference `crate::BoxFuture`, which
//! `rsbinder/src/lib.rs` gates on `#[cfg(feature = "async")]`: a sync-only
//! profile such as `--no-default-features --features rpc,rpc-tls,...` then
//! fails `cargo doc` / `cargo check` with "cannot find type `BoxFuture` in
//! the crate root", since rsbinder-aidl's own `async` feature (a build-dep)
//! is always on.
//!
//! `IAccessor` is compiled on its own (plan 2-13): `IServiceManager.aidl`
//! does not import it, so the `Service.accessor` union arm surfaces as an
//! unbound `IBinder`, and the accessor-bridge resolve path
//! (`hub::android_16::resolve_accessor`) needs the generated proxy to call
//! `addConnection()` / `getInstanceName()`. `ParcelFileDescriptor` is already
//! part of the runtime crate.
//!
//! A codegen failure prints the `miette` report and exits 1, as the
//! rsbinder-aidl README's `build.rs` does.

use std::path::PathBuf;

fn generate_bindings(async_enabled: bool, sources: &[&str], output: &str) {
    let builder = sources.iter().fold(
        rsbinder_aidl::Builder::new()
            .set_crate_support(true)
            .set_async_support(async_enabled),
        |builder, source| builder.source(PathBuf::from(source)),
    );
    if let Err(err) = builder.output(PathBuf::from(output)).generate() {
        eprintln!("generating {output}: {:?}", miette::Report::new(err));
        std::process::exit(1);
    }
}

fn main() {
    // Codegen `async` follows the runtime crate's feature (see the module doc).
    let async_enabled = std::env::var_os("CARGO_FEATURE_ASYNC").is_some();
    let generate =
        |sources: &[&str], output: &str| generate_bindings(async_enabled, sources, output);

    generate(
        &["aidl/11/android/os/IServiceManager.aidl"],
        "service_manager_11.rs",
    );
    generate(
        &["aidl/12/android/os/IServiceManager.aidl"],
        "service_manager_12.rs",
    );
    generate(
        &["aidl/13/android/os/IServiceManager.aidl"],
        "service_manager_13.rs",
    );
    generate(
        &["aidl/14/android/os/IServiceManager.aidl"],
        "service_manager_14.rs",
    );
    // 15.0.0_r6+ (`getService2`): `hub::servicemanager_15`; r1–r5 use 14's; `hub::default` probes.
    generate(
        &["aidl/15/android/os/IServiceManager.aidl"],
        "service_manager_15.rs",
    );
    generate(
        &["aidl/16/android/os/IServiceManager.aidl"],
        "service_manager_16.rs",
    );
    // Not imported by `IServiceManager.aidl`, so compiled on its own (see the module doc).
    generate(&["aidl/16/android/os/IAccessor.aidl"], "accessor_16.rs");
    // Client stub for PermissionManagerService; stable across android-{11..16}, so unversioned.
    generate(
        &["aidl/permission/android/os/IPermissionController.aidl"],
        "permission_controller.rs",
    );
    // Plan 10-5: unchanged since 2012, so unversioned; rsbinder implements both sides of it.
    generate(
        &["aidl/cancel/android/os/ICancellationSignal.aidl"],
        "cancellation_signal.rs",
    );
    // AOSP FMQ AIDL (plans/12-fmq.md): rsbinder-aidl maps user imports to it, so built once here.
    generate(
        &[
            "aidl/fmq/android/hardware/common/NativeHandle.aidl",
            "aidl/fmq/android/hardware/common/fmq/GrantorDescriptor.aidl",
            "aidl/fmq/android/hardware/common/fmq/MQDescriptor.aidl",
            "aidl/fmq/android/hardware/common/fmq/SynchronizedReadWrite.aidl",
            "aidl/fmq/android/hardware/common/fmq/UnsynchronizedWrite.aidl",
        ],
        "fmq.rs",
    );
    // rsbinder's own streaming AIDL (AOSP has none): plans/10-7b-streaming-over-fmq.md §2.1.
    generate(
        &[
            "aidl/stream/rsbinder/stream/StreamEndpoint.aidl",
            "aidl/stream/rsbinder/stream/IStreamSink.aidl",
            "aidl/stream/rsbinder/stream/IStreamSource.aidl",
        ],
        "stream.rs",
    );
}