ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

3 种方式快速集成 SwiftVideoGenerator:CocoaPods、SPM 与手动安装完整教程

2026/8/16 19:01:16 拓冰建站 浏览量
3 种方式快速集成 SwiftVideoGenerator:CocoaPods、SPM 与手动安装完整教程 3 种方式快速集成 SwiftVideoGeneratorCocoaPods、SPM 与手动安装完整教程【免费下载链接】swift-video-generator项目地址: https://gitcode.com/gh_mirrors/sw/swift-video-generator想在 iOS 应用里把图片和音频一键合成视频SwiftVideoGenerator 是一款开源的 iOS 视频生成器库只需几行代码就能完成图片转视频、多视频合并、视频倒放等操作。本文带来最完整的 SwiftVideoGenerator 集成教程覆盖 CocoaPods、SPM 与手动安装三种方式新手也能轻松上手。SwiftVideoGenerator 是什么能做什么SwiftVideoGenerator 由 Dev Labs 团队开发维护核心能力是把「图片 音频」组合成视频或者把多段视频合并为一段。它的 API 设计非常友好全部通过VideoGenerator单例调用无需了解复杂的 AVFoundation 底层细节。主要功能一览 单张图片 单个音频 → 生成视频️ 多组图片/音频 → 生成多段拼接视频️ 多张图片 单个音频 → 生成配乐幻灯片 纯图片无音频→ 按指定时长生成视频️ 合并多段视频、视频倒放、按时间区间裁剪 为视频替换自定义音频输出方面生成的视频为 m4v 格式合并视频时支持 mov、mp4 输入。集成前准备环境要求一览开始之前请确认开发环境满足以下条件门槛非常低iOS 12.0 及以上Xcode 10 及以上Swift 4 及以上已安装 CocoaPods仅方式一需要方式一CocoaPods 集成 SwiftVideoGenerator最主流这是绝大多数项目采用的 SwiftVideoGenerator 集成方法一条命令安装、一行配置搞定。第 1 步安装 CocoaPods如果还没装过 CocoaPods打开终端执行gem install cocoapods第 2 步在 Podfile 中添加依赖在项目根目录的 Podfile 中加入以下内容platform :ios, 12.0 use_frameworks! target 你的Target名称 do pod SwiftVideoGenerator end第 3 步执行 pod install保存后执行pod install安装完成后记得用生成的.xcworkspace打开项目而不是原来的.xcodeproj。方式二Swift Package Manager 集成最快配置方法如果不想引入 CocoaPodsSPM 是当前最快的配置方法全程图形化操作在 Xcode 中打开项目点击菜单 File → Swift Packages → Add Package Dependency输入仓库地址https://gitcode.com/gh_mirrors/sw/swift-video-generator点击 Next选择版本规则建议 Up to Next Major点击 Finish等待自动拉取编译即可SPM 方式下包内的SwiftVideoGeneratortarget 会作为独立模块编译集成后的导入方式与 CocoaPods 完全一致。方式三手动集成 SwiftVideoGenerator零依赖最轻量如果不想使用任何依赖管理器手动集成也只需要 4 个文件非常适合轻量级项目。第 1 步获取源码文件克隆仓库git clone https://gitcode.com/gh_mirrors/sw/swift-video-generator第 2 步拷贝核心文件进入Sources/SwiftVideoGenerator/Classes目录你只需要以下文件VideoGenerator.swift核心生成器Error/VideoGeneratorError.swift错误处理Extensions/AVAssetExtension.swiftAVAsset 扩展Extensions/ImageExtension.swift图片扩展第 3 步拖入 Xcode 工程打开你的 Xcode 项目把这 4 个文件直接拖入 Project Navigator并勾选目标 Target 的 membership。至此集成完成可以开始生成视频了集成后 5 分钟快速上手无论用哪种方式集成使用前都需要导入模块import SwiftVideoGenerator下面以最常用的「单张图片 单个音频」为例演示核心 API 的调用方式import SwiftVideoGenerator // 准备素材一张图片 一段本地音频 let image UIImage(named: scene3)! let audioURL Bundle.main.url(forResource: audio1, withExtension: mp3)! // 设置输出文件名并开始生成 VideoGenerator.fileName myVideo VideoGenerator.current.generate( withImages: [image], andAudios: [audioURL], andType: .single, { progress in print(生成进度\(progress.fractionCompleted)) }, outcome: { result in switch result { case .success(let url): print(视频生成成功\(url)) case .failure(let error): print(生成失败\(error.localizedDescription)) } } )代码说明VideoGenerator.current是全局单例直接调用即可generate(withImages:andAudios:andType:)是核心生成方法progress回调实时返回生成进度outcome回调返回成功地址或失败原因音频数组留空并设置videoDurationInSeconds即可生成纯图片视频常见问题与避坑指南SPM 添加失败确认 Xcode 版本支持swift-tools-version5.1必要时升级 Xcode。手动集成编译报错检查 4 个文件是否都加入了对应 Target且工程最低版本为 iOS 12.0。生成失败确认音频为本地文件 URL暂不支持网络音频链接。合并视频崩溃当前版本合并仅支持 mov、mp4 输入生成结果为 m4v。总结三种集成方式怎么选追求省心、团队协作规范 → 选 CocoaPods不想装额外工具、想快速尝试 → 选 SPM追求零依赖、代码完全可控 → 手动集成三种 SwiftVideoGenerator 集成方式殊途同归集成后的调用代码完全一致。根据项目情况选择最适合的一种5 分钟就能让你的 iOS 应用拥有视频生成能力快去动手试试吧【免费下载链接】swift-video-generator项目地址: https://gitcode.com/gh_mirrors/sw/swift-video-generator创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考