.whl 文件是 Python 的二进制分发包格式（Wheel），用于简化和加速 Python 包的安装过程。它本质上是一个 ZIP 压缩文件，包含了预编译的 Python 代码、扩展模块、依赖项和元数据，适用于特定的 Python 版本和系统架构。

WHl 文件的特点

1. 平台特定性：
   例如 rkllm_toolkit-1.0.0-cp38-cp38-linux_aarch64.whl 表示：

   • cp38：兼容 CPython 3.8
   • linux_aarch64：适用于 Linux ARM64 架构

2. 快速安装：
   无需编译，直接解压到 Python 环境中，比源码包（.tar.gz）安装更快。

3. 依赖管理：
   包含 METADATA 文件，记录了包的依赖项和版本要求。

WHl 文件的结构

一个典型的 Wheel 包解压后包含：

plaintext

rkllm_toolkit-1.0.0/
├── rkllm_toolkit/          # 主模块目录
│   ├── __init__.py         # Python 模块初始化文件
│   ├── core.py             # 核心功能代码
│   └── _rk_npu.so          # C/C++ 扩展库（NPU 加速）
├── tests/                  # 测试代码（可选）
├── METADATA                # 包元数据（作者、版本、依赖等）
├── WHEEL                   # Wheel 格式规范文件
└── RECORD                  # 文件清单（用于验证安装）

如何使用 WHl 文件

1. 安装 Wheel 包

bash

pip install rkllm_toolkit-1.0.0-cp38-cp38-linux_aarch64.whl

2. 查看 Wheel 内容

bash

# 方法一：直接解压
unzip rkllm_toolkit-1.0.0-cp38-cp38-linux_aarch64.whl -d output_dir

# 方法二：使用 wheel 命令（需先安装 wheel 包）
pip install wheel
wheel unpack rkllm_toolkit-1.0.0-cp38-cp38-linux_aarch64.whl

3. 创建自己的 Wheel 包

bash

# 从源码构建 Wheel
python setup.py bdist_wheel

# 使用 setuptools 构建（推荐）
pip install build
python -m build --wheel

常见问题与解决

1. 版本不兼容：

   • 错误：ERROR: This wheel package is not compatible with your Python version.
   • 解决：确保 Python 版本与 Wheel 标记（如 cp38）一致。

2. 架构不匹配：

   • 错误：wrong ELF class: ELFCLASS64（x86_64 尝试安装 ARM64 包）
   • 解决：下载对应架构的 Wheel（如 linux_x86_64）。

3. 依赖缺失：

   • 错误：ImportError: librknn_api.so: cannot open shared object file
   • 解决：安装 Rockchip NPU 驱动或相关系统依赖。

获取官方 WHl 文件

如果你需要 RKLLM-Toolkit 的官方 Wheel 包，建议：

1. 访问 Rockchip 官方 GitHub 仓库（如 Rockchip Linux）。
2. 查看 PyPI 上的 rkllm-toolkit 页面。
3. 联系 Rockchip 技术支持获取特定版本。