# rk3588v21-image

**Repository Path**: zvm-developer/rk3588v21-image

## Basic Information

- **Project Name**: rk3588v21-image
- **Description**: RK3588v2.1发行版除了大文件系统镜像外的其他镜像和文件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2026-05-14
- **Last Updated**: 2026-07-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# rk3588v21-image

## 这个仓库包含什么

这个仓库是给镜像发行版做验证和分发用的轻量仓库，主要包含：

- 实时操作系统的小镜像文件
- 一些用于验证的 vda 镜像
- 用于打包和解包的脚本：
  - `compress_all.sh`
  - `extract_all.sh`

## 这个仓库不包含什么

这个仓库不包含完整发行版所需的“大镜像”原始内容。

也就是说，仓库里原本用于存放大镜像的 `file_system_images/` 目录现在是空的，里面没有最终生成发行版压缩包所需的那些大文件。

因此：

- 不包含完整的 `file_system_images` 大镜像内容
- 不包含完整的 `kernel_images` 大镜像内容
- 不包含最终打包好的发行版压缩包

## 如果要编译最终压缩包，还需要哪些文件

如果你想用本仓库里的脚本制作最终发行版压缩包，还需要准备下面这些内容：

1. `file_system_images/` 目录里的完整大镜像文件
   - 例如各类 `.img`、`.bin`、`.vda` 等最终用于发行版的文件
2. `kernel_images/` 目录里的完整镜像文件
3. `compress_all.sh`
4. `extract_all.sh`
5. 系统里已安装 `7z`

如果你只有这个 gitee 仓库本身，而没有补齐大镜像内容，那么只能拿到验证用的小镜像，不能生成完整的最终发行版压缩包。

## 如何生成最终压缩包

前提条件：

- 当前目录应为：`xxx/rk3588v21-image`
- 目录下应同时存在：
  - `file_system_images/`
  - `kernel_images/`
  - `compress_all.sh`

执行方式：

```bash
cd xxx/rk3588v21-image
./compress_all.sh
```

执行后会在 `compressed_archives/` 下生成压缩结果。

### 压缩后的文件命名规则

为了适配网站上传限制，压缩包分卷对外会显示为：

- `file_system_images.001.7z`
- `file_system_images.002.7z`
- `file_system_images.003.7z`
- ...
- `kernel_images.001.7z`

脚本内部会在真正压缩时临时转换成 7z 可识别的分卷名，再把文件名恢复成上面的格式。

## 如何解压

在 `compressed_archives/` 目录下执行：

```bash
cd /home/zvm/data/tftp_server/release_version/ZVM-RK3588v2.1/compressed_archives
./extract_all.sh
```

脚本会自动做下面几件事：

- 识别 `file_system_images.001.7z` 这类分卷
- 在真正解压前临时改成 7z 需要的分卷名
- 解压到当前目录下的：
  - `file_system_images/`
  - `kernel_images/`
- 解压完成后再把临时改名恢复回去

## 备注

- 如果只是做验证，仓库里的小镜像已经够用。
- 如果要产出最终发行版压缩包，必须补齐完整的大镜像文件。
- `extract_all.sh` 只负责把压缩包还原出来，不负责重新生成镜像内容。