🇺🇸 English

📦 安装指南

本指南将帮助您在系统上安装和配置 GPU SpMV 库。

目录

  1. 系统要求
    1. 必需组件
    2. 支持的 GPU 架构
  2. 依赖安装
    1. Ubuntu / Debian
    2. CentOS / RHEL / Rocky Linux
    3. Windows
  3. 构建步骤
    1. 使用 CMake Presets（推荐）
    2. 自定义构建
    3. 安装到系统
  4. 验证安装
    1. 运行测试
    2. 运行基准测试
  5. 卸载

系统要求

必需组件

组件 最低版本 推荐版本
CUDA Toolkit 11.0 12.0+
CMake 3.18 3.25+
C++ 编译器 C++17 C++17
NVIDIA GPU CC 7.0 CC 8.6+

支持的 GPU 架构

架构 计算能力 代表型号
Volta 7.0, 7.5 V100, Titan V
Turing 7.5 RTX 20 系列, T4
Ampere 8.0, 8.6 RTX 30 系列, A100
Ada Lovelace 8.9 RTX 40 系列
Hopper 9.0 H100

依赖安装

Ubuntu / Debian 

1
2
3
4
5
6
7
8
9
10
11
12

# 1. 安装 CUDA Toolkit
wget https://developer.download.nvidia.com/compute/cuda/repos/ubuntu2204/x86_64/cuda-keyring_1.0-1_all.deb
sudo dpkg -i cuda-keyring_1.0-1_all.deb
sudo apt-get update
sudo apt-get -y install cuda-toolkit-12-2

# 2. 安装构建工具
sudo apt-get install -y cmake build-essential git

# 3. 验证安装
nvcc --version
nvidia-smi

CentOS / RHEL / Rocky Linux 

1
2

sudo yum groupinstall -y "Development Tools"
sudo yum install -y cmake3 git

Windows

  1. 安装 Visual Studio 2019/2022（C++ 桌面开发）
  2. 安装 CUDA Toolkit
  3. 安装 CMake

构建步骤

使用 CMake Presets（推荐） 

1
2
3
4
5
6
7
8
9
10
11

# 克隆仓库
git clone https://github.com/LessUp/gpu-spmv.git
cd gpu-spmv

# Release 构建（生产环境）
cmake --preset release
cmake --build --preset release

# Debug 构建（开发调试）
cmake --preset default
cmake --build --preset default

自定义构建 

1
2
3
4

mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release \
         -DCMAKE_CUDA_ARCHITECTURES="80;86"
cmake --build . -j$(nproc)

安装到系统 

1

sudo cmake --install .

验证安装

运行测试 

1
2
3

ctest --preset default
# 或
./build-release/spmv_tests

运行基准测试 

1

./build-release/spmv_benchmark

卸载 

1

sudo xargs rm < build/install_manifest.txt