AD4M可执行文件

此包包含用于构建可互操作、去中心化应用程序的代理中心分布式应用程序元本体（ADAM，即AD4M）的命令行工具。它为开发者提供了控制AD4M功能和脚本的工具，利用AD4M GraphQL接口包装器的Rust实现的力量。

这些CLIs的目的是开发、脚本化和远程控制AD4M功能，以及ADAM代理的程序化设置和运行。

安装

此crate发布到crates.io，可以通过cargo install ad4m安装。但几个依赖crate有非Rust依赖项，需要安装。

构建依赖项

Rust版本

请确保已安装rustup（请参阅此处的说明）。使用rustup安装最新的稳定版Rust。

ADAM目前需要至少Rust版本

1.77.0

Rust WASM目标语言

为了构建包含在此处的ADAM引导语言的一部分的Holochain DNAs，您的Rust工具链需要能够编译到WASM。

运行以下命令以安装WASM目标

rustup target add wasm32-unknown-unknown

Go

Holochain目前依赖于版本1.21或更高版本的Go已安装。请按照https://golang.ac.cn/doc/install上的说明进行安装。

在使用之前，请确保您的go已经添加到$PATH环境变量中。运行go version的输出应如下所示

go version go1.21.0 darwin/arm64

平台特定依赖

根据您的操作系统运行以下命令，安装Holochain和ADAM依赖的一些Rust crate所需的系统库。

macOS

确保您已安装Homebrew，然后运行

brew install protobuf cmake

Linux (Ubuntu / Debian)

sudo apt-get update
sudo apt-get install -y libgtk-3-dev webkit2gtk-4.0 libappindicator3-dev librsvg2-dev patchelf protobuf-compiler cmake

Windows

确保您已安装Chocolatey，然后运行

choco install strawberryperl protoc cmake curl cygwin gnuwin32-m4 msys2 make mingw

安装命令

使用Rust的包管理器Cargo安装AD4M

cargo install ad4m

此命令安装两个二进制文件

• ad4m：与执行器交互的客户端。
• ad4m-executor：运行AD4M代理的执行器。

入门指南

使用以下命令初始化AD4M执行器

ad4m-executor init

这将创建一个位于~/.ad4m的新代理/配置目录。

使用以下命令运行执行器（即ADAM代理/节点）

ad4m-executor run

与AD4M交互

使用ad4m客户端与执行器交互。以下是一些常用命令

生成并解锁代理

新安装需要首先创建一个新代理，这需要一个密码，该密码用于加密代理的密钥

ad4m agent generate

此命令将提示您输入新密码。执行器未来的运行需要使用相同的密码解锁钱包

ad4m agent unlock

。

显示所有视角

ad4m perspectives

查询视角

通过其UUID查询视角的链接

ad4m perspectives query-links <perspective-UUID>

实时查看视角的变化

ad4m perspectives watch <perspective-UUID>

创建邻域

从模板克隆并发布一种语言

ad4m languages apply-template-and-publish <language-template-hash>

将视角作为邻域发布

ad4m neighbourhoods create <perspective-UUID> <neighbourhood-template-hash>

要查看所有命令及其解释，请使用

ad4m --help

贡献

欢迎为AD4M做出贡献！请阅读我们的贡献指南，并将拉取请求提交到我们的仓库。

许可

AD4M根据CAL-1.0许可。

屏幕截图

更多信息

有关AD4M和ADAM的更多信息，请访问我们的官方网站或查看核心文档。