Skip to content

JiuwenSwarm is an intelligent AI Agent built on openJiuwen. It extends the powerful capabilities of large language models directly to your fingertips through various communication apps you use daily.

Python
6.5 KB
Raw Blame
#!/bin/bash
# build-harmony.sh — JiuwenSwarm 鸿蒙应用打包脚本
#
# 与 Windows build-exe.ps1 对照:
#   Windows: uv sync → npm build → PyInstaller → Inno Setup
#   鸿蒙:  npm build → HNP 更新(嵌入前端) → rawfile 准备 → hvigorw 构建 .hap
#
# 用法:
#   ./scripts/build-harmony.sh
#   ./scripts/build-harmony.sh  # 默认主方案
#   HARMONY_FALLBACK=true ./scripts/build-harmony.sh  # Fallback 方案(rawfile 前端)
#
# 前置条件:
#   - 在鸿蒙 PC (aarch64-linux-ohos) 上运行
#   - hnpcli 可用 (/data/service/hnp/bin/hnpcli)
#   - Node.js / npm 可用
#   - DevEco Studio 或 hvigorw 可用(步骤4可选手动执行)
#   - ~/yangzequ/jiuwenswarm_hnp 目录存在(HNP 工作目录)

set -euo pipefail

# ─── 配置区 ───
JIUWENSWARM_REPO="$(cd "$(dirname "$0")/.." && pwd)"
FRONTEND_DIR="${JIUWENSWARM_REPO}/jiuwenswarm/channels/web/frontend"
HNP_WORK_DIR="$HOME/yangzequ/jiuwenswarm_hnp"
HNP_OUTPUT_DIR="$HOME/yangzequ"
HNPCLI="/data/service/hnp/bin/hnpcli"
HARMONY_PROJECT="${JIUWENSWARM_REPO}/../harmony_facade"
RAWFILE_DIR="${HARMONY_PROJECT}/entry/src/main/resources/rawfile"
HNP_DEST_DIR="${HARMONY_PROJECT}/hnp/arm64-v8a"
HNP_NAME="jiuwen"
HNP_VERSION="1.0"

# 默认端口配置(与 harmony_entry.py 一致)
DEFAULT_AGENTSERVER_PORT=18092
DEFAULT_GATEWAY_PORT=19000
DEFAULT_FRONTEND_PORT=5173

# Fallback 模式检测
FALLBACK_MODE="${HARMONY_FALLBACK:-false}"

echo "============================================"
echo " JiuwenSwarm 鸿蒙应用打包脚本"
echo "============================================"
if [ "$FALLBACK_MODE" = "true" ]; then
    echo " ⚠️ Fallback 模式(rawfile 前端 + WebSocket 远程连接)"
fi
echo ""

# ─── [1/4] 构建 Web 前端 ───
echo "=== [1/4] 构建 Web 前端 ==="

if [ ! -d "$FRONTEND_DIR" ]; then
    echo "错误: 前端目录不存在: $FRONTEND_DIR"
    exit 1
fi

cd "$FRONTEND_DIR"

# 清理旧产物
rm -rf dist

# 安装依赖
npm install

# 构建(Fallback 模式使用 harmony mode:相对路径 + 动态 WS/API URL)
if [ "$FALLBACK_MODE" = "true" ]; then
    echo "⚠️ 使用 Fallback 模式构建前端 (harmony mode: relative paths + dynamic URLs)"
    npm run build -- --mode harmony
else
    npm run build
fi

# 验证构建产物
if [ ! -d "dist" ] || [ -z "$(ls -A dist)" ]; then
    echo "错误: 前端构建失败,dist 目录为空"
    echo "请检查 npm install 和 npm run build 的输出"
    exit 1
fi

echo "✅ 前端构建完成: dist/ 目录已生成"
echo "   产物大小: $(du -sh dist | cut -f1)"
echo ""

# ─── [2/4] 更新 HNP 包(嵌入前端 dist) ───
echo "=== [2/4] 更新 HNP 包(嵌入前端 dist) ==="

if [ ! -d "$HNP_WORK_DIR" ]; then
    echo "错误: HNP 工作目录不存在: $HNP_WORK_DIR"
    echo "请先完成 HNP 基础打包(参考 .pi/specs/hnp-packaging-plan.md)"
    exit 1
fi

# 检查 HNP 工作目录中是否有 jiuwenswarm 包
JWS_PKG_DIR="${HNP_WORK_DIR}/lib/python3.12/site-packages/jiuwenswarm"
if [ ! -d "$JWS_PKG_DIR" ]; then
    echo "错误: HNP 中未找到 jiuwenswarm 包: $JWS_PKG_DIR"
    exit 1
fi

# 拷贝 frontend/dist 到 HNP 的 jiuwenswarm 包内
FRONTEND_DIST_DEST="${JWS_PKG_DIR}/channels/web/frontend/dist"
echo "目标路径: $FRONTEND_DIST_DEST"

# 清理旧的 dist(如果存在)
rm -rf "$FRONTEND_DIST_DEST"

# 拷贝新的 dist
mkdir -p "$FRONTEND_DIST_DEST"
cp -a "${FRONTEND_DIR}/dist/"* "$FRONTEND_DIST_DEST/"

# 验证拷贝
if [ ! -d "$FRONTEND_DIST_DEST" ] || [ -z "$(ls -A "$FRONTEND_DIST_DEST")" ]; then
    echo "错误: 前端产物拷贝到 HNP 失败"
    exit 1
fi

echo "✅ 前端 dist 已嵌入 HNP 包"
echo ""

# 清理缓存(减小体积)
echo "清理 HNP 包内缓存..."
find "$HNP_WORK_DIR" -name '__pycache__' -type d -exec rm -rf {} + 2>/dev/null || true
find "$HNP_WORK_DIR" -name '*.pyc' -delete 2>/dev/null || true
find "$HNP_WORK_DIR" -name '*.pyo' -delete 2>/dev/null || true

# 设置权限
chmod -R 777 "$HNP_WORK_DIR"

echo ""

# 重新打包 HNP
echo "重新打包 HNP..."
if [ ! -f "$HNPCLI" ]; then
    echo "错误: hnpcli 不存在: $HNPCLI"
    echo "请安装 hnpcli 或确认路径"
    exit 1
fi

"$HNPCLI" pack -i "$HNP_WORK_DIR" -o "$HNP_OUTPUT_DIR" -n "$HNP_NAME" -v "$HNP_VERSION"

# 验证 HNP 包
HNP_FILE="${HNP_OUTPUT_DIR}/${HNP_NAME}.hnp"
if [ ! -f "$HNP_FILE" ]; then
    echo "错误: HNP 包生成失败"
    exit 1
fi

echo "✅ HNP 包已生成: $HNP_FILE"
echo "   包大小: $(du -sh "$HNP_FILE" | cut -f1)"
echo ""

# 复制 HNP 包到鸿蒙项目
echo "复制 HNP 包到鸿蒙项目..."
mkdir -p "$HNP_DEST_DIR"
cp "$HNP_FILE" "$HNP_DEST_DIR/"

echo "✅ HNP 包已复制到: $HNP_DEST_DIR/$(basename "$HNP_FILE")"
echo ""

# ─── [3/4] 准备 rawfile ───
echo "=== [3/4] 准备 rawfile ==="

# 复制 harmony_entry.py 到 rawfile
ENTRY_SCRIPT="${JIUWENSWARM_REPO}/scripts/harmony_entry.py"
if [ ! -f "$ENTRY_SCRIPT" ]; then
    echo "错误: harmony_entry.py 不存在: $ENTRY_SCRIPT"
    echo "请先创建该脚本"
    exit 1
fi

mkdir -p "$RAWFILE_DIR"
cp "$ENTRY_SCRIPT" "$RAWFILE_DIR/"

echo "✅ harmony_entry.py 已复制到 rawfile"

# Fallback 模式:将前端 dist 也复制到 rawfile
if [ "$FALLBACK_MODE" = "true" ]; then
    echo "复制前端 dist 到 rawfile (Fallback 模式)..."
    cp -a "${FRONTEND_DIR}/dist/"* "$RAWFILE_DIR/"
    echo "✅ 前端 dist 已复制到 rawfile"
fi

echo ""

# ─── [4/4] 构建鸿蒙 .hap ───
echo "=== [4/4] 构建鸿蒙 .hap ==="
echo ""
echo "⚠️ 此步骤需要在 DevEco Studio 中手动执行,或通过 hvigorw 命令行执行。"
echo ""
echo "请在 DevEco Studio 中打开项目:"
echo "  项目路径: $HARMONY_PROJECT"
echo ""
echo "然后执行:"
echo "  1. File → Project Structure → Signing Configs → 配置签名证书"
echo "  2. Build → Build Hap(s)/APP(s)"
echo ""
echo "或者通过命令行:"
echo "  cd $HARMONY_PROJECT"
echo "  ./hvigorw assembleHap --mode module -p module=entry@default"
echo ""
echo "构建产物位置:"
echo "  $HARMONY_PROJECT/entry/build/default/outputs/default/entry-default-signed.hap"
echo ""
echo "============================================"
echo " 打包脚本执行完成!"
echo "============================================"
echo ""
echo "下一步:"
echo "  1. 在 DevEco Studio 中打开项目并构建"
echo "  2. 连接鸿蒙 PC 设备"
echo "  3. 点击 Run 安装并启动应用"
echo ""
echo "端口配置: AgentServer=${DEFAULT_AGENTSERVER_PORT} / Gateway=${DEFAULT_GATEWAY_PORT} / Frontend=${DEFAULT_FRONTEND_PORT}"
echo ""
echo "使用指南: .pi/specs/harmony-app-usage-guide.md"