# @devenvy/ffmpeg-build 中文文档

规范地址：https://npmcn.com/package/%40devenvy/ffmpeg-build/

版本：0\.0\.24
npm 元数据更新时间：2026-11-11T01:21:01.015Z
中文译文更新时间：2026-11-12T02:57:04.104Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40devenvy/ffmpeg-build
原文对照：https://npmcn.com/package/%40devenvy/ffmpeg-build/?lang=original
项目主页：https://github.com/devenvy/ffmpeg-build#readme
源码仓库：https://github.com/devenvy/ffmpeg-build

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2.9 MB，548 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24
- 运行依赖：3 个
- 首次发布：2026-10-14T21:01:41.974Z
- 最新版本发布：2026-11-11T01:21:00.470Z
- 近 30 天下载量：5604（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：25（近 12 个月 25 个）

## 中文简介

构建 FFmpeg 方式: 版本、 平台、 许可证、 库和从一个 YAML 文件取来的补丁, 并加锁版本和检查许可证

## 安装

```sh
npm install @devenvy/ffmpeg-build
```

也可以使用：`pnpm add @devenvy/ffmpeg-build`、`yarn add @devenvy/ffmpeg-build`、`bun add @devenvy/ffmpeg-build`

## README

# ffmpeg 构建

构建 FFmpeg 路径: FFmpeg 版本, 平台, 许可证, 库和您自己的补丁, 从一个 YAML 文件开始 . 每个图书馆版本都被锁定,每张许可证都会在任何东西建立之前被检查,每个档案都说它是什么 是用这个做的.

```yaml
# ffmpeg-build.yml
bases:
  common: { with: [dav1d, opus, srt] }
targets:
  linux-x64-lgplv3:
    { platform: linux-x64, license: lgplv3, ffmpeg: 9, base: [common], with: [vaapi] }
  win-x64-gplv3:
    { platform: win-x64, license: gplv3, ffmpeg: 9, base: [common], with: [x264, x265] }
```

```
ffmpeg-build check                          # is every target possible? (offline)
ffmpeg-build lock                           # pick and lock the versions (asks upstream)
ffmpeg-build build --target win-x64-gplv3   # ffmpeg-9.x.y-win-x64-gplv3.tar.gz and -dev.tar.gz
```

**状态:0.x,早起.** 下面的每个平台都建立和复制已出版的devenvy/ffmpeg所建,并发布 以 CI 结尾。 直至1.0 `ffmpeg-build.yml` 格式,则, `ffmpeg.lock` 编辑 `@v0` 工作流程输入仍然可能改变; 修改它们的发布 在他的笔记中是这样说的.

## 平台

|  |  |
| --- | --- |
| Linux (glibc 2. 28+) (英语) | linux- x64, linux- arm64, linux- armhf (英语) |
| Linux( 穆斯尔 ) | linux- musl- x64, linux- musl- arm64 (英语) |
| 窗口 | 双臂64,双臂64 |
| 机器人 | android-arm64, android-x64 (中文(简体) ) |
| 马科斯 | o-arm64; o-x64 |
| iOS 和 Mac Catoryst 软件 | ios-arm64, ios-sim-arm64, maccatalyst-arm64, maccatalyst-x64 (英语) |

Linux,Windows和Android在任意主机上以被钉住的多克图像构建;Apple平台以有Xcode的Mac为基础构建. 每一个都复制Devenvy/ffmpeg出版的建筑(文件、配置旗帜、组件和依赖性,以及 ”)。 苹果上的Vulkan运行在MoltenVK上,就像devenvy/ffmpeg's一样(仅v3:它是 Apache-2.0: macOS档案载有Vulkan装载器, `libMoltenVK.dylib` 财务报告和审定财务报表 `MoltenVK_icd.json` (点) `VK_ICD_FILENAMES` 在iOS和Mac Catoryst MoltenVK上连接到libav\*框架,以及一个应用链接 `-framework Metal -framework IOSurface -framework Foundation -framework QuartzCore -framework CoreGraphics -framework UIKit` (和 `-framework IOKit` 在麦克催化剂.

## 安装

```
npm install --global @devenvy/ffmpeg-build      # Node 24+
```

建筑还需要多克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克; `lock`, (中文(简体) ), `update` 财务报告和审定财务报表 `outdated` 需求 `git`。 。 。 .

## 快开始

```
mkdir my-ffmpeg && cd my-ffmpeg
ffmpeg-build init --license lgplv3 --platforms linux-x64,win-x64   # from the shipped targets
ffmpeg-build profile remove whisper --from linux-x64-lgplv3        # make it yours
ffmpeg-build check && ffmpeg-build lock
ffmpeg-build build --target linux-x64-lgplv3
```

[开始](https://npmcn.com/package/%40devenvy/ffmpeg-build/docs/getting-started.md) 穿过一栋小楼,然后CI 建造和出版 和下载它们的产品.

## 图标

```
init         write ffmpeg-build.yml from the shipped targets
check        is every target possible? (offline)
plan         what each target builds: options, libraries, versions (offline)
show         what one target gets and which base gave it; --has <name>: which targets get it
targets      the targets (--json for CI matrices)
options      what a target can list: library, licenses, platforms (offline)
profile      add | remove | missing: edit ffmpeg-build.yml in place, keeping its comments
lock         write ffmpeg.lock, looking up only what is missing
outdated     what is newer upstream (read-only)
update       move ffmpeg.lock to the newest allowed versions (and write the PR text)
build        build one target in its pinned toolchain
test         run a build where this machine can (a library build: link a program against it, run that where it can)
releases     each release's next tag, and whether it changed since it was last published
bundle       write a release's sources archive, manifest.yml, SHA256SUMS and notes (--apple: the iOS bundle)
fetch        take a published build (for products that don't build FFmpeg)
migrate      convert a folder of old matrix profiles
guide        the step-by-step guide, for people, scripts and AI agents
```

最厉害的 `--json`没有提示 出站代码:0精细,1目标有问题,2使用,数据,网络或工具 问题(消息说是哪个).

## 文档

-   [开始](https://npmcn.com/package/%40devenvy/ffmpeg-build/docs/getting-started.md):第一种构件,CI和释放,一种产品;环境变量
-   [目标](https://npmcn.com/package/%40devenvy/ffmpeg-build/docs/targets.md)数字 : `ffmpeg-build.yml`、基础、许可证、针头、补丁、更新
-   [大楼](https://npmcn.com/package/%40devenvy/ffmpeg-build/docs/building.md)工具链 缓存, `THIRD-PARTY-NOTICES.txt`,这是从什么建筑
-   [释放、CI和产品](https://npmcn.com/package/%40devenvy/ffmpeg-build/docs/releases.md): 发布标签,工作流程, `fetch`
-   [命令](https://npmcn.com/package/%40devenvy/ffmpeg-build/docs/getting-started.md#the-commands) (单位:千美元)`ffmpeg-build guide`:按你使用的顺序,带有出口代码

## 发展

```
pnpm install
pnpm test                                                 # vitest
pnpm run dev check                                        # the CLI from source, in the folder you are in
node <path to the engine>/src/cli.ts check                # the same, from anywhere (or `npm link` once)
```

见 [发展.md](https://npmcn.com/package/%40devenvy/ffmpeg-build/DEVELOPMENT.md) 检查CI运行,食谱和平台如何组合,如何释放 出来吧.

## 许可证

发动机是 [麻省理工学院](https://npmcn.com/package/%40devenvy/ffmpeg-build/LICENSE). FFmpeg 构造其生产量由每个目标选择的许可证(LGPL或GPL, • 携带每个部件的许可证进入 `THIRD-PARTY-NOTICES.txt` 在他们的根部.

## 常见问题

### @devenvy/ffmpeg-build 是什么？

构建 FFmpeg 方式: 版本、 平台、 许可证、 库和从一个 YAML 文件取来的补丁, 并加锁版本和检查许可证

### 如何安装 @devenvy/ffmpeg-build？

在项目目录运行 npm install @devenvy/ffmpeg-build，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ffmpeg-build，可以用 npx ffmpeg-build 直接运行。

### @devenvy/ffmpeg-build 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/devenvy\_\_ffmpeg-build 是否存在。

### @devenvy/ffmpeg-build 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @devenvy/ffmpeg-build 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @devenvy/ffmpeg-build 可以商用吗？

@devenvy/ffmpeg-build 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @devenvy/ffmpeg-build 的下载量有多少？

根据 npm 官方下载统计，@devenvy/ffmpeg-build 在 2026/10/12 – 2026/11/10 这 30 天内被下载 5,604 次，日均约 187 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @devenvy/ffmpeg-build 还在维护吗？

最新版本 0\.0\.24 发布于 2026/11/11（1 天前）；至今共发布 25 个版本，其中过去 12 个月发布了 25 个；首次发布于 2026/10/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。