从源码运行 mower-ng

发表于 更新于 分类于 本文字数： 1.2k 阅读时长 ≈ 4 分钟

在 Windows 10 / 11 下，推荐使用启动器 mower-ng/launcher。

若不希望使用启动器，或在其它平台上运行，可以参照本文的说明，从源码运行 mower-ng。支持的平台如下：

  • Windows 7+
  • macOS
  • Ubuntu Linux
  • Android (Termux)

使用必看：命令行操作与 cd 命令

本教程假定读者对命令行操作有基本的了解，并且已掌握 cd 命令的用法。

Android (Termux)

在 Termux 中安装 proot-distro（仅需安装一次）：

1
pkg install proot-distro

使用 proot-distro 创建 Ubuntu 24.04 容器（仅需创建一次）：

1
proot-distro install ubuntu

进入 Ubuntu 容器（每次运行 mower-ng 前都需要进入）：

1
proot-distro login ubuntu

随后参照下文中适用于 Ubuntu 的教程安装 mower-ng。

分支选择

镜像选择正在测试连接……
正在测试连接……

安装依赖

Python 3.12

Git

ADB

如果模拟器自带 ADB，可以不用安装。

下载链接：https://dl.google.com/android/repository/platform-tools-latest-windows.zip

其它依赖

Python 3.12

Ubuntu 24.04 自带 Python 3.12.3，可以直接从软件源安装。对于其它版本的 Ubuntu，可以添加 deadsnakes ppa ：

1
2
apt install software-properties-common
add-apt-repository ppa:deadsnakes/ppa

安装 Python 3.12：

1
apt install python3.12 python3.12-venv

如果有图形界面，并希望启动出错时用对话框显示错误信息，可以安装 Tkinter：

1
apt install python3.12-tk

其它依赖

1
apt install adb git git-lfs libzbar0 libgl1

使用 Homebrew 安装所需依赖：

1
brew install [email protected] [email protected] android-platform-tools git git-lfs zbar

下载源码

安装 Git LFS：

1
git lfs install

下载代码：

1
git clone -c lfs.concurrenttransfers=200 https://git.zhaozuohong.vip/mower-ng/mower-ng.git --branch fast

进入源码目录：

1
cd mower-ng

虚拟环境与 Python 依赖

创建虚拟环境（仅需创建一次）：

1
%LocalAppData%\Programs\Python\Python312\python -m venv venv

激活虚拟环境（每次运行 mower-ng 前都需要激活）：

1
venv\Scripts\activate

安装 Python 依赖：

1
pip install -r requirements.in

Windows 7 需要额外安装 rapidocr-paddle：

1
pip install paddlepaddle rapidocr-paddle

创建虚拟环境（仅需创建一次）：

1
python3.12 -m venv venv

激活虚拟环境（每次运行 mower-ng 前都需要激活）：

1
source venv/bin/activate

安装 Python 依赖：

1
pip install -r requirements.in

创建虚拟环境（仅需创建一次）：

1
$(brew --prefix)/opt/[email protected]/libexec/bin/python -m venv venv

激活虚拟环境（每次运行 mower-ng 前都需要激活）：

1
source venv/bin/activate

安装 Python 依赖：

1
pip install -r requirements.in

运行

使用 cli.py 管理 mower-ng 实例：

1
python cli.py
1
./cli.py
1
./cli.py

更新

更新源码：

1
2
3
4
git remote set-url origin https://git.zhaozuohong.vip/mower-ng/mower-ng.git
git fetch origin fast --progress
git -c lfs.concurrenttransfers=100 switch -f fast --progress
git -c lfs.concurrenttransfers=200 reset --hard origin/fast

更新 Python 依赖：

1
pip install -r requirements.in