AXPhotoViewer 快速上手CocoaPods 安装与示例工程跑通教程【免费下载链接】AXPhotoViewerAn iOS/tvOS photo gallery viewer, useful for viewing a large (or small!) number of photos.项目地址: https://gitcode.com/gh_mirrors/ax/AXPhotoViewerAXPhotoViewer 是一款开源的 iOS/tvOS 图片浏览器photo gallery viewer专为查看大量或少量图片与 GIF 而设计。对新手来说最关心的莫过于 AXPhotoViewer 安装是否简单、示例工程能否快速跑通——答案是非常简单。本文带来一份面向零基础开发者的 AXPhotoViewer 使用教程从 CocoaPods 配置、网络集成选择到官方示例工程一键跑通跟着操作 10 分钟即可上手。AXPhotoViewer 是什么专为 iOS/tvOS 打造的图片浏览器简单来说AXPhotoViewer 是一个可直接嵌入你 App 的全屏图片查看器支持超大图、超多图、GIF 动图并且内置了非常顺滑的交互体验️ 上下文过渡动画从列表小图“放大”到全屏查看器关闭时再缩回转场自然流畅 下拉/上滑手势关闭模拟 Twitter 等 App 的“甩图关闭”交互 3D Touch / Force Touch 预览支持️ GIF 动图支持基于 FLAnimatedImage 与主流异步图片加载库无缝集成SDWebImage、Kingfisher、PINRemoteImage、AFNetworking、Nuke 等️ 同时支持 iOS 8.0 与 tvOS 9.0一套代码两端复用示例工程自带的尼亚加拉瀑布与哈利法塔图片正好可以直观感受它的浏览体验AXPhotoViewer 安装教程CocoaPods 一键配置最快方法AXPhotoViewer 官方推荐通过 CocoaPods 安装这也是最快、最省心的集成方式。整个安装流程只需四步第 1 步确认 CocoaPods 已就绪终端执行pod --version若无输出则先安装 CocoaPodssudo gem install cocoapods。第 2 步创建 Podfile在 Xcode 工程根目录下创建Podfile写入以下内容platform :ios, 10.0 target YourApp do use_frameworks! pod AXPhotoViewer end第 3 步执行安装命令pod install第 4 步打开工作区安装完成后务必打开生成的YourApp.xcworkspace而不是.xcodeproj之后在代码中import AXPhotoViewer即可开始使用。 提示若你不想用 CocoaPods也可以直接把仓库Source目录拷贝进工程但需手动添加MobileCoreServices.framework、QuartzCore.framework、ImageIO.framework三个系统框架并配置好FLAnimatedImage、AXStateButton等依赖因此更推荐用 CocoaPods 方式。AXPhotoViewer 网络集成选择按需选子模块AXPhotoViewer 将图片下载与缓存抽象为AXNetworkIntegration协议定义在 AXNetworkIntegrationProtocol.swift官方为常见图片库提供了开箱即用的子模块subspec。你只需按需选择无需改任何业务代码子模块适用场景AXPhotoViewer/Core默认内置基于 NSURLSession 的简易下载够用且零额外依赖AXPhotoViewer/SDWebImage项目已在使用 SDWebImageAXPhotoViewer/Kingfisher项目已在使用 KingfisherAXPhotoViewer/PINRemoteImage项目已在使用 PINRemoteImageAXPhotoViewer/AFNetworking项目已在使用 AFNetworkingAXPhotoViewer/Nuke项目已在使用 Nuke切换方式很简单把 Podfile 中的声明换一下即可例如pod AXPhotoViewer/Kingfisher各集成类源码位于Source/Integrations/目录例如 KingfisherIntegration.swift 展示了如何将下载回调桥接给图片浏览器如果你想自研加载模块参考它即可。跑通官方示例工程iOS 项目一步一步来官方示例工程是最好的学习素材包含真实可运行的完整代码。按以下步骤即可在本机跑通第 1 步克隆仓库git clone https://gitcode.com/gh_mirrors/ax/AXPhotoViewer第 2 步进入 iOS 示例目录并安装依赖cd AXPhotoViewer/Example/iOS pod install第 3 步打开工作区并运行open AXPhotoViewerExample.xcworkspace选中AXPhotoViewerExampleScheme选择模拟器或真机直接 ⌘R 运行即可看到效果——点击列表中的任意图片会以流畅的过渡动画进入全屏浏览支持左右翻页、双指缩放、下拉关闭。示例工程的目录结构也很清晰值得逐文件阅读Example/iOS/Podfile—— 示例依赖配置展示了本地 podspec 引用方式Example/iOS/AXPhotoViewerExample/TableViewController.swift—— 示例主控制器演示了AXPhoto数据源、过渡动画与 Force Touch 的完整用法Example/iOS/AXPhotoViewerExample/CustomLoadingView.swift—— 自定义加载视图示例tvOS 示例工程跑通方法同款套路AXPhotoViewer 对 tvOS 支持同样完善。跑通 tvOS 示例只需把目录换成 tvOS 版cd AXPhotoViewer/Example/tvOS pod install open AXPhotoViewerExample.xcworkspace其余流程与 iOS 完全一致。tvOS 版示例同样位于Example/tvOS/AXPhotoViewerExample/核心逻辑与 iOS 版共用同一套源码适合做“电视大屏看图”场景的开发者参考。最少代码接入10 行内跑起来跑通示例后回到你自己的项目接入代码其实非常轻量。核心只需要三步构造AXPhoto数据、塞进AXPhotosDataSource、present 出去。import AXPhotoViewer // 1. 准备图片数据支持本地图、GIF 数据或远程 URL let photos [ AXPhoto(image: UIImage(named: local)), AXPhoto(url: URL(string: https://example.com/remote.jpg)), AXPhoto(imageData: gifData) // GIF ] // 2. 创建数据源并指定起始页 let dataSource AXPhotosDataSource(photos: photos, initialPhotoIndex: 0) // 3. 展示 let photosViewController AXPhotosViewController(dataSource: dataSource) self.present(photosViewController, animated: true)如果想定制翻页方向、图片间距或自定义加载视图可配置AXPagingConfig见 AXPagingConfig.swift想定制起始/结束动画视图可配置AXTransitionInfo见 AXTransitionInfo.swift官方示例中均有现成写法可抄。常见问题与避坑指南Q1pod install 报找不到子模块检查 Podfile 中声明的是AXPhotoViewer/xxx子模块名注意大小写与官方拼写一致。Q2用 Nuke 集成但 GIF 不动Nuke 默认关闭 GIF 解码需在启动时手动开启ImagePipeline.Configuration.isAnimatedImageDataEnabled trueQ3不用 CocoaPods 时编译报错按上文提示补齐三个系统框架与第三方依赖即可。Q4图片加载缓慢可通过AXPhotosDataSource的prefetchBehavior参数控制预取策略conservative只加载当前页、regular默认加载前后各一页、aggressive加载前后各两页按需选用。小结AXPhotoViewer 是一个上手成本极低的 iOS/tvOS 图片浏览器CocoaPods 一条命令安装、官方示例工程开箱即跑、核心 API 三行代码即可接入同时兼顾 GIF、大图、过渡动画与主流图片库集成。建议新手先跑通Example/iOS示例再对照Source/目录源码逐模块阅读很快就能把它灵活用进自己的项目。【免费下载链接】AXPhotoViewerAn iOS/tvOS photo gallery viewer, useful for viewing a large (or small!) number of photos.项目地址: https://gitcode.com/gh_mirrors/ax/AXPhotoViewer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考