项目本地启动并部署到控制板

项目本地启动

  1. 安装Miniconda用于控制python的版本

安装miniconda，请按照官方安装指南

创建 python 3.11 环境

conda create -n aka python=3.11 -y
  1. 运行 pip install -r requirements.txt 安装依赖
pip install -r requirements.txt
  1. 安装前端依赖
cd frontend && npm i

4.打包前端项目

npm run build && cd ..
  1. 运行项目
python run.py

之后访问本地的80端口或443端口即可

本地对于硬件调用的接口进行了隔离，所以可以直接启动

打包部署到控制板

使用 make -C cpp ota 将整个项目打包为单个自解压可执行文件 aka-00-server，然后拷贝到 SG2002 控制板即可运行。

# 构建（在开发机上执行）
make -C cpp ota                 # 打包（用已有前端产物）
cd frontend && npm run build    # 需要重建前端时先跑这个
make -C cpp ota                 # 再打包

# 输出: cpp/dist/aka-00-server（约 9MB 自解压安装器）
#       cpp/dist/AKA-00/（部署目录，就是板上 $AKA_HOME 的样子）

首次部署

# 1. 拷贝 aka-00-server 到控制板
scp cpp/dist/aka-00-server root@<robot>:/usr/local/bin/

# 2. 一键初始化（解压 + 热点 + 开机自启）
ssh root@<robot> 'aka-00-server --init'

更新部署

清除旧数据后重新运行：

scp cpp/dist/aka-00-server root@<robot>:
ssh root@<robot> 'aka-00-server --update'

工作原理

aka-00-server 是一个自解压程序：

  1. 首次运行时自动解压项目文件到 ${AKA_HOME:-$HOME/AKA-00}
  2. 执行 uart_init.sh 初始化串口（如果存在）
  3. 启动 python3 run.py 运行 Web 服务

后续运行时跳过解压步骤，直接启动服务。