xain_ai 已停止积极维护。部分代码已复制到 xayn_discovery_engine 并将在那里进一步开发。

Xayn-AI

模型

要下载模型，请使用 download_data.sh 脚本。

工具

为了生成包含资产元数据的代码，您需要安装 gomplate。

构建

要在项目根目录下构建库，只需运行 cargo build 即可。

要生成dart ffi，需要在 bindings/dart 目录中运行 flutter pub get 和 flutter pub run ffigen。

在dart代码更改后更新非ffi自动生成的dart代码，需要运行 flutter pub run build_runner build。

项目提供了一个 Makefile.toml，可以使用 cargo make 运行。您可以使用以下方式安装cargo make：

cargo install --version 0.35.0 cargo-make

所有上述操作都可以通过 cargo make build 自动完成。

要为移动目标构建库，可以使用

cargo make build-mobile

在Linux上，这将只构建Android库，而在Mac上则会同时构建Android和iOS。

要为Web构建库，可以使用

cargo make build-web

或

DISABLE_WASM_THREADS=1 cargo make build-web

构建一个不需要浏览器支持 SharedArrayBuffer 和 Atomics 的版本。

Android

要为Android构建，需要以下目标

rustup target add \
  aarch64-linux-android \
  armv7-linux-androideabi \
  x86_64-linux-android \
  i686-linux-android

还需要 cargo-ndk

cargo install --version 2.4.1 cargo-ndk

您还需要安装Android NDK，可能还需要设置ANDROID_NDK_HOME变量。如果您通过AndroidStudio安装Android NDK，则需要将ANDROID_NDK_HOME设置为类似~/Android/Sdk/ndk/<ndk-version>的路径，例如/home/user/Android/Sdk/ndk/22.1.7171670/。

iOS

为了为iOS构建，需要以下目标

rustup target add \
  aarch64-apple-ios \
  x86_64-apple-ios

WASM

先决条件

• wasm-pack

cargo install --version 0.10.1 wasm-pack

• rustuptarget add wasm32-unknown-unknown
• nodejs（仅当您想在nodejs上运行测试时使用）
• yarn

以下所有wasm-pack命令都需要在xayn-ai-ffi-wasm/目录下运行。

构建WASM模块

wasm-pack build

运行WASM测试

浏览器

wasm-pack test --firefox --chrome --safari --headless

注意

在Safari中，您首先需要通过safaridriver --enable启用WebDriver支持，然后才能运行测试。

nodejs

wasm-pack test --node -- --no-default-features --features=node

Flutter示例

在移动设备/模拟器上运行

cargo make build-mobile
cd bindings/dart/example
flutter run

在Chrome中运行

cargo make build-web
cargo make serve-web
# Then open http://127.0.0.1:8000/ in a browser.

flutter run不能使用，因为它没有设置正确的头文件，即使设置了正确的头文件，它也没有以正确的方式提供正确的文件。

（至少目前flutter run仍然可以与DISABLE_WASM_THREADS=1一起使用，这在未来并不保证，但可以作为flutter run提供热重载和更好的调试功能的有用方式。）

提示：有一些情况，由于某些原因，在从DISABLE_WASM_THREADS=0切换到DISABLE_WASM_THREADS=1时，genesis.js没有被更新，原因不明，因为它无法重现，但不同的开发者都观察到了这一点。如果发生这种情况，请运行cargo make clean-non-rust。

  xayn_ai_ffi_dart:
-   path: '../'
+   git:
+       url: [email protected]:xaynetwork/xayn_ai_release.git
+       ref: <branch>

- const _baseAssetUrl = 'assets';
+ const _baseAssetUrl = 'https://ai-assets.xaynet.dev';