napi-ohos 1.1.5

N-API bindings
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

# ohos-rs

![Crates.io Version](https://img.shields.io/crates/v/napi-ohos) ![Platform](https://img.shields.io/badge/platform-arm64/arm/x86__64-blue) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

> This project is forked from [napi-rs](https://github.com/napi-rs/napi-rs), many thank to [@Brooooooklyn](https://github.com/Brooooooklyn).

## MSRV

1.88.0

## Taste

> You can use [ohrs](https://ohos.rs/en/docs/cli/init.html) to start a new project.

### Define ArkTS function

```rs
use napi_ohos::bindgen_prelude::*;
use napi_derive_ohos::napi;

/// module registration is done by the runtime, no need to explicitly do it now.
#[napi]
pub fn fibonacci(n: u32) -> u32 {
  match n {
    1 | 2 => 1,
    _ => fibonacci(n - 1) + fibonacci(n - 2),
  }
}

/// use `Fn`, `FnMut` or `FnOnce` traits to defined JavaScript callbacks
/// the return type of callbacks can only be `Result`.
#[napi]
pub fn get_cwd<T: Fn(String) -> Result<()>>(callback: T) {
  callback(
    std::env::current_dir()
      .unwrap()
      .to_string_lossy()
      .to_string(),
  )
  .unwrap();
}

/// or, define the callback signature in where clause
#[napi]
pub fn test_callback<T>(callback: T) -> Result<()>
where
  T: Fn(String) -> Result<()>,
{
  callback(std::env::current_dir()?.to_string_lossy().to_string())
}

/// async fn, require `async` feature enabled.
/// [dependencies]
/// napi = {version="2", features=["async"]}
#[napi]
pub async fn read_file_async(path: String) -> Result<Buffer> {
  Ok(tokio::fs::read(path).await?.into())
}
```

## Building

Before build, we must setup some environments. You can follow the [document](https://ohos.rs/en/docs/basic/quick-start.html) to setup them.

Then you can use `ohrs` to build it directly.

```sh
ohrs build

# build single arch
ohrs build --arch aarch
```

Finally you can copy the `dist` folder into your OpenHarmony/HarmonyNext project and use it.

## Asynchronous runtime

We use `tokio` as the default asynchronous runtime. But for some simple scenarios, we don't need so complete runtime, and you can try [ohos-ffrt](https://github.com/ohos-rs/ohos-ffrt).

## Discussion

[Feel free to join our WeChat group!](https://github.com/ohos-rs/ohos-rs/wiki/Welcome-to-join-our-WeChat-Group!)

## License

[MIT](https://github.com/ohos-rs/ohos-rs/blob/ohos/LICENSE)