基于 OpenWrt 25.12.4 SDK 编译第三方插件 .apk 文件

一、环境准备与 SDK 下载

在开始编译前，需要先配置好底层依赖环境。建议选用 Ubuntu/Debian 稳定的发行版操作系统。我们将利用国内的高速镜像源来快速下载官方编译好的工具链（SDK）：

# 1. 安装 Debian/Ubuntu 系统的底层基本编译依赖
sudo apt update && sudo apt install -y \
    build-essential clang flex bison g++ gawk gcc-multilib g++-multilib \
    gettext git libncurses-dev libssl-dev python3-distutils rsync unzip \
    zlib1g-dev file wget zstd

# 2. 从清华大学镜像站下载并解压 25.12.4 官方 SDK (以常见的 x86_64 架构为例)
wget https://mirrors.tuna.tsinghua.edu.cn/openwrt/releases/25.12.4/targets/x86/64/openwrt-sdk-25.12.4-x86-64_gcc-14.2.0_musl.Linux-x86_64.tar.zst
tar -vxf openwrt-sdk-*.tar.zst
cd openwrt-sdk-*

二、导入 GitHub 插件源码与换源

为了保证 feeds 组件依赖库在更新时不会卡住，需要将默认的下载源修改为国内清华大学镜像。之后，将你想编译的第三方主流插件克隆到 package/ 目录下：

# 1. 修改 feeds.conf.default 文件，换源为清华大学国内镜像
sed -i 's/downloads.openwrt.org/mirrors.tuna.tsinghua.edu.cn\/openwrt/g' feeds.conf.default

# 2. 将 GitHub 上的第三方插件源码直接克隆到本地项目的 package 文件夹内
git clone https://github.com/jerrykuku/luci-theme-argon.git package/luci-theme-argon
git clone https://github.com/jerrykuku/luci-app-argon-config.git package/luci-app-argon-config

# 3. 刷新并加载 feeds 依赖环境
./scripts/feeds update -a && ./scripts/feeds install -a

三、配置菜单与单项精准编译

打开图形化菜单配置项，将我们刚刚下载的目标插件勾选为独立打包模块 <M>，随后执行单项精准打包指令：

# 1. 开启配置菜单
make menuconfig
# 【操作提示】：
# 键盘连续按下空格键，使其前缀符号变为 <M>。随后保存配置并退出。

# 2. 执行单项精准打包编译 (避免多余全局构建)
make package/luci-theme-argon/compile V=s
make package/luci-app-argon-config/compile V=s

sed -i 's/DEPENDS:=.*/DEPENDS:=/g' package/你的插件名称/Makefile

📦 编译产物成品位置

一切运行无误后，你打包生成的 .apk 安装包会躺在如下输出路径：

当前SDK根目录/bin/targets/x86/64/packages/
├── luci-app-argon-config_xxxx_all.apk
└── luci-theme-argon_xxxx_all.apk