flutter_rust_bridge 2.12.0

Flutter/Dart <-> Rust binding generator, feature-rich, but seamless and simple
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

use dart_sys::{Dart_DeletePersistentHandle_DL, Dart_Handle, Dart_HandleFromPersistent_DL};
use dart_sys::{Dart_NewPersistentHandle_DL, Dart_PersistentHandle};

#[derive(Debug)]
/// A [Dart_PersistentHandle] that delete the handle when `Drop`ped
// `Option` is used for correct drop.
pub struct AutoDropDartPersistentHandle(Option<Dart_PersistentHandle>);

impl AutoDropDartPersistentHandle {
    pub fn new_from_non_persistent_handle(non_persistent_handle: Dart_Handle) -> Self {
        unsafe {
            let persistent_handle = Dart_NewPersistentHandle_DL
                .expect("dart_api_dl has not been initialized")(
                non_persistent_handle
            );
            Self::from_raw(persistent_handle)
        }
    }

    // `from_raw` is `unsafe` while `into_raw` is not, mimicking `Box::*` counterpart.
    unsafe fn from_raw(ptr: Dart_PersistentHandle) -> Self {
        Self(Some(ptr))
    }

    /// https://github.com/dart-lang/sdk/blob/af20a8ab0394408ee48483c5c06c75281e7ba52c/runtime/include/dart_api.h#L424C8-L424C8
    /// "Allocates a handle in the current scope from a persistent handle."
    pub fn create_dart_handle(&self) -> Dart_Handle {
        unsafe {
            Dart_HandleFromPersistent_DL.expect("dart_api_dl has not been initialized")(
                self.0.unwrap(),
            )
        }
    }
}

impl Drop for AutoDropDartPersistentHandle {
    // the function signature is not covered while the whole body is covered - looks like a bug in coverage tool
    // frb-coverage:ignore-start
    fn drop(&mut self) {
        // frb-coverage:ignore-end
        if let Some(inner) = self.0 {
            unsafe {
                Dart_DeletePersistentHandle_DL.expect("dart_api_dl has not been initialized")(inner)
            }
        }
    }
}