aria2-next-bin

aria2-next-bin 项目用来把 AnInsomniacy/aria2-next GitHub Releases 中已经构建好的 aria2-next 可执行文件打包成平台专用 Python wheel。本项目已经发布到 PyPI，包名为 aria2-next，安装命令为：

pip install aria2-next

本项目不会从源码编译 aria2-next。

构建

从最新 release 为当前平台构建 wheel：

python3 scripts/build_wheel.py

从最新 release 构建指定目标平台：

python3 scripts/build_wheel.py --target linux-x86_64
python3 scripts/build_wheel.py --target macos-arm64
python3 scripts/build_wheel.py --target windows-x86_64

构建所有支持的目标平台：

python3 scripts/build_wheel.py --target all

从指定 release tag 构建：

python3 scripts/build_wheel.py --release v2.2.6 --target linux-x86_64

也可以通过环境变量指定相同配置：

ARIA2_NEXT_RELEASE=v2.2.6 ARIA2_NEXT_TARGET=linux-x86_64 python3 scripts/build_wheel.py

支持平台

目标	Release asset	Wheel 平台标签
`linux-x86_64`	`linux-x86_64`	`manylinux_2_28_x86_64`
`linux-aarch64`	`linux-aarch64`	`manylinux_2_28_aarch64`
`macos-x86_64`	`macos-x86_64`	`macosx_10_13_x86_64`
`macos-arm64`	`macos-arm64`	`macosx_11_0_arm64`
`windows-x86_64`	`windows-x86_64.exe`	`win_amd64`
`windows-arm64`	`windows-arm64.exe`	`win_arm64`

wheel 版本号来自 GitHub release tag。例如 release v2.2.6 会生成版本号为 2.2.6 的 wheel。

安装和运行

从 PyPI 安装：

pip install aria2-next

从本地 wheel 安装：

python3 -m venv .venv
. .venv/bin/activate
pip install dist/aria2_next-*.whl
aria2-next --version
python -m aria2_next --version

wheel 文件名来自发行包名 aria2-next，安装后的 Python import 包名是 aria2_next。 wheel 会像 uv 一样把真实的 aria2-next 二进制文件安装到当前 Python 环境的脚本目录（例如虚拟环境的 bin/aria2-next）。python -m aria2_next 会按 uv 的 _find_uv.py 思路定位该二进制文件并执行它。

校验

release 下载文件会使用 SHA-256 校验。构建脚本会优先使用 GitHub asset 的 digest 字段；如果该字段不可用，则下载并解析 release 中的 checksums.sha256 文件。

GitHub Actions 发布

build-wheels workflow 会在 push、PR 和手动触发时构建所有平台 wheel，并上传 aria2-next-bin-wheels artifact。手动触发时可以填写 release 来指定要打包的 aria2-next release。

默认不会上传到 PyPI。需要发布新版本时，在 GitHub Actions 手动运行 workflow，并把 publish 设置为 true。发布使用 twine upload dist/*.whl，凭据从 Secrets 读取：

推荐设置 PYPI_API_TOKEN，workflow 会使用 __token__ 作为 Twine 用户名。
也可以设置标准的 TWINE_USERNAME 和 TWINE_PASSWORD。
如果要上传到 TestPyPI 或私有仓库，可以填写 repository_url。

许可证

打包进去的可执行文件来自 AnInsomniacy/aria2-next，按 GPL-2.0-or-later 分发。如果所选 release tag 可以获取上游 COPYING 文件，构建出的 wheel 会一并包含该文件。

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

aria2_next-2.5.4-py3-none-win_arm64.whl (1.8 MB view details)

Uploaded Jul 31, 2026 Python 3Windows ARM64

aria2_next-2.5.4-py3-none-win_amd64.whl (2.0 MB view details)

Uploaded Jul 31, 2026 Python 3Windows x86-64

aria2_next-2.5.4-py3-none-manylinux_2_28_x86_64.whl (1.7 MB view details)

Uploaded Jul 31, 2026 Python 3manylinux: glibc 2.28+ x86-64

aria2_next-2.5.4-py3-none-manylinux_2_28_aarch64.whl (1.7 MB view details)

Uploaded Jul 31, 2026 Python 3manylinux: glibc 2.28+ ARM64

aria2_next-2.5.4-py3-none-macosx_11_0_arm64.whl (3.7 MB view details)

Uploaded Jul 31, 2026 Python 3macOS 11.0+ ARM64

aria2_next-2.5.4-py3-none-macosx_10_13_x86_64.whl (3.5 MB view details)

Uploaded Jul 31, 2026 Python 3macOS 10.13+ x86-64

aria2_next-2.5.4-py3-none-android_21_arm64_v8a.whl (3.6 MB view details)

Uploaded Jul 31, 2026 Android API level 21+ ARM64 v8aPython 3

File details

Details for the file aria2_next-2.5.4-py3-none-win_arm64.whl.

File metadata

Download URL: aria2_next-2.5.4-py3-none-win_arm64.whl
Upload date: Jul 31, 2026
Size: 1.8 MB
Tags: Python 3, Windows ARM64
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.11.15

File hashes

Hashes for aria2_next-2.5.4-py3-none-win_arm64.whl
Algorithm	Hash digest
SHA256	`bc6c490cfdda3fe599025930d85fd9e04de8516bf8bf12fa14ad436dd2ee3038`
MD5	`3f0fd22a476d84b0899bff6f42aba6c9`
BLAKE2b-256	`6a8a1cd754dba2fe4627b35c04a2b33e6c06d276bdd8124cc970308436a73ccc`

See more details on using hashes here.

File details

Details for the file aria2_next-2.5.4-py3-none-win_amd64.whl.

File metadata

Download URL: aria2_next-2.5.4-py3-none-win_amd64.whl
Upload date: Jul 31, 2026
Size: 2.0 MB
Tags: Python 3, Windows x86-64
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.11.15

File hashes

Hashes for aria2_next-2.5.4-py3-none-win_amd64.whl
Algorithm	Hash digest
SHA256	`0c0f5e0aa775eefbd160b9002455b6012eadb34687aa4f0e0a7b6cd0b846a170`
MD5	`6eb3646cd172c1c65abc6ea43b4c197e`
BLAKE2b-256	`daea2c2e1dc3c06650f0ab4ee83317af7fabdd2ef30c97484cf77f023161932e`

See more details on using hashes here.

File details

Details for the file aria2_next-2.5.4-py3-none-manylinux_2_28_x86_64.whl.

File metadata

Download URL: aria2_next-2.5.4-py3-none-manylinux_2_28_x86_64.whl
Upload date: Jul 31, 2026
Size: 1.7 MB
Tags: Python 3, manylinux: glibc 2.28+ x86-64
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.11.15

File hashes

Hashes for aria2_next-2.5.4-py3-none-manylinux_2_28_x86_64.whl
Algorithm	Hash digest
SHA256	`dd97fb7f5671323892b4ab0404c7612b6d05f49ed48fefe797efc259b4407750`
MD5	`0e76a99887d71ef43ebc86f013ab3403`
BLAKE2b-256	`7234b284f52715084e02a4ec5ae2cfd611ce94ee74f235adf6b8a2ab26cece97`

See more details on using hashes here.

File details

Details for the file aria2_next-2.5.4-py3-none-manylinux_2_28_aarch64.whl.

File metadata

Download URL: aria2_next-2.5.4-py3-none-manylinux_2_28_aarch64.whl
Upload date: Jul 31, 2026
Size: 1.7 MB
Tags: Python 3, manylinux: glibc 2.28+ ARM64
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.11.15

File hashes

Hashes for aria2_next-2.5.4-py3-none-manylinux_2_28_aarch64.whl
Algorithm	Hash digest
SHA256	`d09dbeb619a062f47457668ff3ae0a2983a831e3111f8bd97bdeb3ebc26bd7af`
MD5	`fcc696169574eddfa5ba5f95042960e6`
BLAKE2b-256	`61815af3de79429d7cd2c0eb6252e7a77b15a6a2e67bfc8bd922b9218eddac77`

See more details on using hashes here.

File details

Details for the file aria2_next-2.5.4-py3-none-macosx_11_0_arm64.whl.

File metadata

Download URL: aria2_next-2.5.4-py3-none-macosx_11_0_arm64.whl
Upload date: Jul 31, 2026
Size: 3.7 MB
Tags: Python 3, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.11.15

File hashes

Hashes for aria2_next-2.5.4-py3-none-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`0f3be4811d54ac0584e4aaa5b9a122138de07a15514800ba3d1b096b66e7bf36`
MD5	`680920965c1a448fc23dd2661fb9d981`
BLAKE2b-256	`c3aaa95730e86b91573e62ac64edac3cfcdd6d15a828af78fa0449346fb4fae6`

See more details on using hashes here.

File details

Details for the file aria2_next-2.5.4-py3-none-macosx_10_13_x86_64.whl.

File metadata

Download URL: aria2_next-2.5.4-py3-none-macosx_10_13_x86_64.whl
Upload date: Jul 31, 2026
Size: 3.5 MB
Tags: Python 3, macOS 10.13+ x86-64
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.11.15

File hashes

Hashes for aria2_next-2.5.4-py3-none-macosx_10_13_x86_64.whl
Algorithm	Hash digest
SHA256	`9792e149cec71801828318595ba6b3800d4795a6647f98835a13b8350e9a2cca`
MD5	`1aa2965fa934bf56eae733297f483d4c`
BLAKE2b-256	`f629938ced57de342961073823cf28bbaf619b902a0a6fcb91c725400a74f29c`

See more details on using hashes here.

File details

Details for the file aria2_next-2.5.4-py3-none-android_21_arm64_v8a.whl.

File metadata

Download URL: aria2_next-2.5.4-py3-none-android_21_arm64_v8a.whl
Upload date: Jul 31, 2026
Size: 3.6 MB
Tags: Android API level 21+ ARM64 v8a, Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.11.15

File hashes

Hashes for aria2_next-2.5.4-py3-none-android_21_arm64_v8a.whl
Algorithm	Hash digest
SHA256	`fe3fbba8223fd5af2cf93c50950b99dec04954d2f7484361f805b60873461cbc`
MD5	`ab222ca47e737a27b43a1c22d2f73ca5`
BLAKE2b-256	`894ac9db29252b8fe6fb41b65a35278283a31fba93dc8e1ad1d8b1fce0b43ea6`