HuLa 即时通讯安装教程入门 🚀

hula是目前非常火热的即时通讯IM系统，同时提供 Windows / macOS / Linux / iOS / Android 五端原生或 Electron/React-Native 客户端

亮点：Tauri+Vue3 客户端，单文件绿色运行；Spring-Boot 微服务后端，自带插件市场。
场景：10～200 人团队，想 1 小时内把服务器跑起来，又希望界面“像微信”。

开源系统

必需环境

环境	版本要求	说明
Node.js	^20.19.0 或 >=22.12.0	JavaScript 运行环境
pnpm	>=10.x	包管理器，必须使用 pnpm
Rust	最新稳定版	Tauri 后端开发需要
Git	2.0+	版本控制

安装前准备

1. 确保磁盘剩余空间≥2GB
2. 关闭杀毒软件避免误拦截
3. 准备稳定的网络环境

系统使用ubuntu安装

Linux (Ubuntu/Debian):

# 安装 Node.js
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# 安装 pnpm
npm install -g pnpm@latest

2. 安装 Rust 和 Tauri 环境

# 安装 Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source ~/.cargo/env

# 验证安装
rustc --version
cargo --version

3.Linux 额外环境安装:

# Ubuntu/Debian
sudo apt update
sudo apt install libwebkit2gtk-4.0-dev \
    build-essential \
    curl \
    wget \
    libssl-dev \
    libgtk-3-dev \
    libayatana-appindicator3-dev \
    librsvg2-dev

🚀 项目启动

1. 克隆项目

# 从 GitHub 克隆
git clone https://github.com/HuLaSpark/HuLa.git

# 或从 Gitee 克隆（国内推荐）
git clone https://gitee.com/HuLaSpark/HuLa.git

# 进入项目目录
cd HuLa

2. 安装依赖

# 使用 pnpm 安装所有依赖
pnpm install

# 如果在国内网络环境下遇到问题，可以设置镜像
pnpm config set registry https://registry.npmmirror.com/

3. 启动开发环境

# 启动桌面应用开发环境（推荐）
pnpm run tauri:dev
# 简化命令
pnpm run td

# 启动 Android 开发环境
pnpm run tauri:android:dev
# 简化命令
pnpm run adev

# 启动 iOS 开发环境（仅 macOS）
pnpm run tauri:ios:dev
# 简化命令
pnpm run idev

4. 构建生产版本

# 构建桌面应用
pnpm run tauri:build
# 简化命令
pnpm run tb

5. 代码质量检查

# 检查代码格式和问题（不修复）
pnpm run check

# 修复代码格式和问题
pnpm run check:write

# 格式化所有文件（包括 Vue 组件）
pnpm run format:all

# Git 提交前的代码检查
pnpm run lint:staged

6. 测试

# 运行单元测试
pnpm run test:run

# 运行测试 UI 界面
pnpm run test:ui

# 生成测试覆盖率报告
pnpm run coverage