OpenWrt快速构建项目GitHub Actions使用教程

1. 项目目录结构及介绍

本项目是基于GitHub Actions和Docker的OpenWrt快速构建项目。以下是项目的目录结构及各部分功能的介绍：

openwrt-fastbuild-actions/
├── .github/
│   ├── workflows/
│   │   ├── build-openwrt.yml
│   │   └── squash.yml
│   └── secrets/
├── docs/
│   └── imgs/
├── imgs/
├── scripts/
├── user/
│   └── example/
├── .gitattributes
├── .gitignore
├── LICENSE
├── README.md
├── README_CN_OUTDATED.md
└── TODO

• .github/: 存放GitHub Actions的工作流配置文件和Secrets配置。
• docs/: 存放项目文档。
• imgs/: 存放项目相关的图片文件。
• scripts/: 存放项目相关的脚本文件。
• user/: 用户自定义配置目录，包含构建目标的相关文件。
• .gitattributes: Git属性配置文件。
• .gitignore: Git忽略文件配置。
• LICENSE: 项目许可证文件。
• README.md: 项目英文说明文件。
• README_CN_OUTDATED.md: 项目中文说明文件（已过时）。
• TODO: 项目待办事项列表。

2. 项目的启动文件介绍

项目的启动主要依赖于.github/workflows目录下的build-openwrt.yml工作流配置文件。该文件定义了触发构建的条件、构建步骤以及构建环境等。

以下是build-openwrt.yml的部分内容示例：

name: Build OpenWrt

on:
  push:
    branches: [ master ]
  workflow_dispatch:
    inputs:
      target:
        description: 'Build target'
        required: true
        default: 'x86_64'

jobs:
  build:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        target: [${TARGET_NAME}]
    steps:
      # ... 步骤详细配置 ...

在这个配置文件中，定义了触发构建的事件（如push操作），构建运行的环境（如ubuntu-latest），以及构建的目标（如x86_64）。

3. 项目的配置文件介绍

项目的配置文件主要包括在user/目录下的settings.ini、config.diff、packages.txt、custom.sh、patches/和files/等文件或目录。

• settings.ini: 包含目标的基本设置，如构建参数、依赖等。
• config.diff: 包含对OpenWrt默认配置文件的差异 patch，用于自定义构建配置。
• packages.txt: 包含需要添加到OpenWrt构建中的额外包列表。
• custom.sh: 包含构建前需要执行的shell脚本。
• patches/: 包含需要应用到OpenWrt源代码的patch文件。
• files/: 包含需要复制到OpenWrt构建目录的文件。