Plugin.injection . Ventoy

Ventoy 文件注入插件

使用此插件，你可以往ISO启动后的环境中注入一些文件（比如驱动/脚本等）。对于Windows，就是WinPE环境；对于Linux就是initramfs的环境。所有需要注入的文件需要按照目录结构组织好，然后整体上打包压缩成1个文件。Ventoy在启动后会在运行时的根目录下解压此文件。

只是一个注入框架

本插件只是实现了一个注入文件的框架。对于注入的是什么文件、里面包含什么内容、注入之后会产生什么作用、如何使用注入的文件等等，这些Ventoy都不关心。
简单来说，就是你告诉 Ventoy 要注入一个压缩包，Ventoy就在启动之后把这个压缩包解压到运行环境中，然后Ventoy的任务就结束了。使用者需要根据系统的目录结构以及提供的功能来构造你的压缩包。
比如，可以构造一个包含 sources\$OEM$ 目录的压缩包用来注入Windows驱动，或者注入CentOS 的 dracut hook 脚本等。

Json 定义

推荐使用 VentoyPlugson 工具进行配置，无需手动创建、编辑json文件。请参考 VentoyPlugson
关于 ventoy.json 的位置以及相关说明，请首先参考插件入口（*必读）
在镜像分区 /ventoy/ventoy.json 中定义了一个 injection 的数组用于描述相关配置。

{
    "injection": [
        {
            "image": "/ISO/MX-19.1_x64.iso",
            "archive": "/driver/mx-driver.tar.gz"
        },
        {
            "image": "/ubuntu-20.04-desktop-amd64.iso",
            "archive": "/driver/ubuntu-driver.tar.bz2"
        },
        {
            "image": "/cn_windows_10_enterprise_ltsc_2019_x64_dvd_9c09ff24.iso",
            "archive": "/driver/win10-driver.zip"
        },
        {
            "parent": "/ISO/Windows",
            "archive": "/driver/win-driver.zip"
        }
    ]
}

关键字	类型	说明
`image`	`STRING`	镜像文件的全路径。本参数支持模糊匹配，请参考插件路径匹配说明
`parent`	`STRING`	iso文件父目录的全路径。此目录下的所有ISO文件将会使用相同的一个注入文件。注意最后不能以斜杠结尾。
`archive`	`STRING`	需要注入的压缩文件的全路径。支持的压缩格式为： `Windows:` `.7z` `.zip` `Linux:` `.zip` `.tar.gz` `.tar.bz2` `.tar.xz` `.tar.lzma`

多模式选项

支持。可以分别针对 x86 Legacy BIOS、IA32 UEFI、x86_64 UEFI 和 ARM64 UEFI 模式做不同的设置。详细说明请参考多模式选项

解压路径

对于 Windows，Ventoy在 X: 盘的根路径下解压压缩包。
对于 Linux，Ventoy在 initramfs 的根目录下解压，类似于 tar -xzf inject.tar.gz -C /

典型应用场景

1. 注入 Windows 驱动
2. 注入 CentOS dracut hook 脚本
3. 注入 Redhat/CentOS dd.iso
4. ......

如何往 Linux Live 系统中注入文件

如何往 Linux Live 系统中注入文件

VentoyAutoRun.bat (1.0.55+)

从 Ventoy 1.0.55 版本开始，对于 Windows/WinPE 的ISO文件，如果注入之后存在 X:\VentoyAutoRun.bat 文件，则会自动调用此脚本。
详细说明请参考：关于 VentoyAutoRun.bat