rustler-precompiled rustler 扩展工具简单说明

已经简单说过mjml_nif使用了rustler+rustler-precompiled 进行nif 的构建，同时官方也写了一篇相关的博客进行介绍

使用说明

• 配置依赖

def deps do

  [

    {:rustler_precompiled, "~> 0.7"}

  ]

end

• 配置native 使用
  可以是一个独立的模块，命名上可以添加Native 比较符合习惯

 

defmodule RustlerPrecompilationExample.Native do

  version = Mix.Project.config()[:version]

 

  use RustlerPrecompiled,

    otp_app: :rustler_precompilation_example,

    crate: "example",

    base_url:

      "https://github.com/philss/rustler_precompilation_example/releases/download/v#{version}",

    force_build: System.get_env("RUSTLER_PRECOMPILATION_EXAMPLE_BUILD") in ["1", "true"],

    targets:

      Enum.uniq(["aarch64-unknown-linux-musl" | RustlerPrecompiled.Config.default_targets()]),

    version: version

 

  # When your NIF is loaded, it will override this function.

  def add(_a, _b), do: :erlang.nif_error(:nif_not_loaded)

end

• 官方示例的一个效果

可以看到预编译的包放在github 的release 中，下载已经使用都很方便

 

mjml-nif 的使用

• 效果

与rustler-precompiled 官方示例效果是一样的

 

• Native 配置

 

defmodule Mjml.Native do

  mix_config = Mix.Project.config()

  version = mix_config[:version]

  github_url = mix_config[:package][:links]["GitHub"]

 

  targets = ~w(

    aarch64-apple-darwin

    aarch64-unknown-linux-gnu

    aarch64-unknown-linux-musl

    riscv64gc-unknown-linux-gnu

    x86_64-apple-darwin

    x86_64-pc-windows-gnu

    x86_64-pc-windows-msvc

    x86_64-unknown-linux-gnu

    x86_64-unknown-linux-musl

  )

 

  nif_versions = ~w(

    2.15

    2.16

  )

 

  use RustlerPrecompiled,

    otp_app: :mjml,

    crate: "mjml_nif",

    base_url: "#{github_url}/releases/download/v#{version}",

    force_build: System.get_env("MJML_BUILD") in ["1", "true"],

    version: version,

    targets: targets,

    nif_versions: nif_versions

 

  def to_html(_mjml, _render_options), do: error()

  defp error(), do: :erlang.nif_error(:nif_not_loaded)

end

说明

开源项目使用，推荐与github action 集成起来，如果是自己的项目可以使用docker进行构建（可以方便生成好不同系统的nif 包）

参考资料

https://dashbit.co/blog/rustler-precompiled
https://hexdocs.pm/rustler_precompiled/RustlerPrecompiled.html
https://github.com/philss/rustler_precompiled
https://github.com/rusterlium/rustler
https://docs.rs/crate/rustler/latest
https://github.com/adoptoposs/mjml_nif
https://github.com/philss/rustler_precompilation_example
https://github.com/adoptoposs/mjml_nif/blob/main/.github/workflows/release.yml