基于 ohos-rs 适配 ada-url 到鸿蒙系统本文我们将基于 ohos-rs 来实现一个完整的鸿蒙原生模块开发，

本文我们将基于 ohos-rs 来实现一个完整的鸿蒙原生模块开发，并且将其发布到 ohpm 中心仓。

本文涉及代码仓库地址在：github.com/ohos-rs/ada…

背景

在开始之前，我们先简单讲解下 ada-url

简单来说就是一个使用 C++ 实现的高性能符合规范的 URL 解析工具，从 Node.js18 版本开始引入，让内置的 url 模块提升了四倍的性能。

相关阅读可以参考：blog.rafaelgss.dev/state-of-no…

因为其优秀的性能和完备的能力，开源之后逐渐在各个语言或者开发领域有了对应的适配版本，因此我们现在尝试将其适配到鸿蒙平台上面。

得益于官方的 Rust 实现，我们可以基于 ohos-rs 非常快速的将其适配到鸿蒙生态。

Let's go~

开发

得益于 ohos-rs 的发展，我们能够通过几行命令完成一个基于原生模块实现的 Har 包的初始化、开发、发布等流程。

ohos-rs 关于环境初始化等操作，这里不再过多讲解，具体可以参考官网文档。

创建项目

现在我们创建一个项目名为ada-ohos，并且在创建项目的时候我们需要定义我们的 har 包名为@ohos-rs/ada，其命令如下所示：

ohrs init ada-ohos --package=@ohos-rs/ada

可以看到，除去生成了最基本的 Rust 相关开发代码之外，我们还额外生成了一个鸿蒙 har 包所需的最基本的项目结构与相关文件。

⚠️ 注意：现阶段生成的oh-package.json5文件中缺少了 dependencies 字段，该字段缺少会导致最终发布的审核不过，该问题将在下一个版本的脚手架工具中解决，现阶段可以自行补齐即可。

最终的项目结构如下所示：

开发

完成项目的创建之后，我们就可以开始正常的开发了，首先就是需要将 ada 依赖加入到项目依赖中。

cargo add ada-url

在开始开发前，我们先思考下如果提供给上层的 ArkTS 使用应当是以什么样的形式或者接口，这里我们可以参考系统内置的@kit.ArkTS中提供的 url 模块来设计。

系统内置模块的使用示例

import { url } from "@kit.ArkTS";

const urlInstance = url.URL.parseURL("https://www.baidu.com");
const h = urlInstance.host;

从示例中我们可以很清晰的看到，URL 解析的流程如下所示：

有一个对象，对象上面带有一个静态方法用于解析 URL。
解析返回的是 Url 对象，该对象可以直接获取诸如 host、port 等信息。

那么我们就可以定义两个结构体分别用于表示最外层的带有静态方法的对象和解析的结果，如下所示：

/// ada-url wrapper support parse and canParse method.
#[napi]
pub struct Ada();

/// url instance wrapper, can directly get host,protocol,etc.
#[napi]
pub struct Url {
    // 持有 ada 解析的 url 实例
    inner: AUrl,
}

Ada

对于 Ada 来说，我们需要让其暴露静态方法用于解析 url 对象等操作，我们可以直接写出如下代码：

use ada_url::Url as AUrl;
use napi_derive_ohos::napi;
use napi_ohos::{Error, Result, Status};

#[napi]
impl Ada {
    /// parse url
    #[napi]
    pub fn parse(url: String) -> Result<Url> {
        let ada = AUrl::parse(url, None)
            .map_err(|e| Error::new(Status::GenericFailure, e.to_string()))?;
        Ok(Url { inner: ada })
    }
}

这里有几个核心开发点需要注意：

函数的返回值一般为基础类型（支持转为上层 ArkTS 数据结构的）
如果需要使用 Result 来处理错误等逻辑，需要使用 napi_ohos 暴露的 Result
对于错误必须是有impl From<x> for napi_ohos::Error的错误才可以被正常接收，否则应该使用map_err等操作将其转化为可识别的错误
对于结构体来说，需要定义静态方法则只需要将对应的结构体实现方法不添加self关联即可

这样我们就完成了一个最简单的 Native 对象定义，其带有一个静态方法parse，parse 方法接收一个字符串，并且返回一个 Url 的 native 对象。

注意：返回 Result 就意味着我们需要额外处理这里可能的错误。

现在我们继续实现 Url 对象，用于获取解析之后的数据。

Url

在上面的例子中，我们可以看到，获取数据时是直接通过.操作符进行操作的。在 JS/ArkTS 中，我们知道除去对象本身的属性之外，还可以通过getter方法来定义其通过该操作符获取值，出于方便和可读性来看，我们可以为每个属性都设置对应的getter方法，避免了在构建 Url 对象时全部获取其属性。

那么我们这里的代码就可以实现如下：

#[napi]
impl Url {
    #[napi(getter)]
    pub fn host(&self) -> &str {
        self.inner.host()
    }
}

因为 ada-url 当我们去获取参数的时候已经明确不会报错了，那么这里我们就不再需要使用 Result 来处理错误相关的内容了。

定义getter方法也非常简单，如代码所示即可。

在这之后，我们将整个项目进行构建来查看是否符合预期。

ohrs build

执行完毕之后，我们可以看到在项目中生成了dist以及对应的类型声明文件等内容。

测试

现在我们先简单测试下解析是否符合预期，具体的使用操作可以参考之前的文章：juejin.cn/post/737246…

已经正常的解析出了数据并且是符合预期的。

接下来我们简单的测试下性能数据，看下使用 ada-url 实现的能力和系统内置的是否有一定的优化。

这里的测试方案，我们使用官方的HiTraceMeter来实现，具体的使用示例可参考 developer.huawei.com/consumer/cn…

测试代码如下所示：

  parseWithBuiltin = () => {
    hiTraceMeter.startTrace("builtin-url", 1234);
    const u = url.URL.parseURL('http://nodejs.org:89/docs/latest/api/foo/bar/qua/13949281/0f28b/' +
      '/5d49/b3020/url.html#test?payload1=true&payload2=false&test=1' +
      '&benchmark=3&foo=38.38.011.293&bar=1234834910480&test=19299&3992&' +
      'key=f5c65e1e98fe07e648249ad41e1cfdb0');
    const h = u.host;
    hiTraceMeter.finishTrace("builtin-url", 1234);
  }

  parseWithAda() {
    hiTraceMeter.startTrace("ada-url", 1235);
    const u = Ada.parse('http://nodejs.org:89/docs/latest/api/foo/bar/qua/13949281/0f28b/' +
      '/5d49/b3020/url.html#test?payload1=true&payload2=false&test=1' +
      '&benchmark=3&foo=38.38.011.293&bar=1234834910480&test=19299&3992&' +
      'key=f5c65e1e98fe07e648249ad41e1cfdb0');
    const h = u.host;
    hiTraceMeter.finishTrace("ada-url", 1235);
  }