BRScroller 1.4.4

BRScroller 1.4.4

测试已测试
语言语言 Obj-CObjective C
许可证 Apache 2
发布上次发布2016 年 8 月

Matt MagoffinMatt Magoffinwmjesstaylor 维护。



  • Matt Magoffin

内存友好的 iOS 水平滚动视图。

BRScroller 提供了一个 UIScrollView 子类,它有效地管理水平滚动的内容页面,就像 UITableView 管理垂直滚动的行内容一样。此外,BRScroller 为高效显示高分辨率内容(如照片)提供了一些框架。在这方面,BRScroller 可以像 MWPhotoBrowserTTPhotoViewControllerEGOPhotoViewer 一样使用。然而,BRScroller 的不同之处在于它不提供任何内置 UI。而不是强制执行任何特定 UI,您可以构建任何适合您应用程序的 UI,并依赖 BRScroller 来执行低级(我敢说,无聊的)工作,帮助您高效地管理内存。

要求

BRScroller 之外无其他依赖项。它支持部署到任何 iOS 设备,版本 5.1 或更高。

示例用法

请参阅包含在此项目中的 BRScrollerDemo 项目,该项目演示了使用 BRScroller 的不同方法。以下是该项目中可用的演示的描述:

  • SimpleViewController

    一个非常简单的 BRScrollerView 演示,展示了如何处理管理页面视图的基本原则。如果您曾经编写过 UITableViewController,应该会觉得非常熟悉。

  • AsyncPhotoViewController

    一个演示,展示了常见场景:以类似 iOS 内置的照片应用程序的方式显示图像。在照片之间滚动时显示较小的 预览 图像。当您对任何特定照片进行捏合缩放时,将显示该照片的完整分辨率版本。

  • PdfViewController

    一个演示,展示了使用 BRCachedPreviewPdfPageZoomView 来显示 PDF 文件中的页面。使用 BRScrollerView 在所有 PDF 页面之间滚动,每个页面都在自己的可缩放的滚动视图中展示。显示较小的 预览 图像以快速显示,同时使用 CATiledLayer 绘制 PDF 内容,这使 PDF 内容在缩放时保持清晰。

  • DemoTiledViewController

    演示了使用背靠 CATiledLayer 的视图来渲染任意大小的内容。

  • MultiViewController

    展示了如何一起使用多个滚轮,其中全屏滚轮代表内容的全详情页面,而小型丝带滚轮代表对应于全详情页面的缩略图。点击缩略图会导致全详情页面以动画方式进入视图。

  • InfiniteViewController

    BRScroller具有无限模式,其中页面的数量不一定事先知道(或者有很多页面!)这种模式通过定义一个起点页面,所有其他页面都与该起点相关(例如,-1表示立即左边或1表示立即右边)。

  • ReverseViewController

    BRScroller具有反向布局模式,其中页面以从右到左的顺序定位,而不是默认的从左到右的顺序。

项目集成

您可以通过CocoaPods或手动作为依赖项目或静态框架来集成BRScroller。

通过静态框架

您可以通过几种方式将BRScroller集成到项目中。首先,BRScroller Xcode项目包含一个名为BRScroller.framework的目标,该目标构建一个静态库框架。构建该目标,它将在根项目目录中生成一个BRScroller.framework捆绑包。将该框架复制到您的项目中,并将其添加为构建依赖项。

您还必须添加以下链接器构建依赖项,可以通过在项目设置的“构建阶段”选项卡中点击“链接二进制与库”部分的+按钮来实现。

  • QuartzCore.framework

接下来,将-ObjC添加为其他链接器标志构建设置。

最后,您需要将包含BRScroller.framework捆绑包的目录路径添加为项目设置的“构建设置”选项卡中的“框架搜索路径”值。

通过依赖项目

另一种将BRScroller集成到项目中的方法是将BRScroller Xcode项目添加为您的项目的依赖项目。BRScroller Xcode项目包含一个名为BRScroller的目标,该目标构建一个静态库。您可以在自己的项目中使用该目标作为依赖项。《BRScrollerDemo》项目就是这样设置的。

为此,将BRScroller.xcodeproj拖到项目导航器中的您的项目上。然后转到您的项目设置的“构建阶段”选项卡。展开“目标依赖项”部分,并点击+按钮。您应该看到一个可用的选项BRScroller静态库目标。选择它并点击添加按钮。

您还必须添加以下链接器构建依赖项,可以通过在项目设置的“构建阶段”选项卡中点击“链接二进制与库”部分的+按钮来实现。

  • QuartzCore.framework

接下来,将-ObjC添加为其他链接器标志构建设置。

最后,您需要将包含BRScroller.xcodeproj文件的目录路径添加为项目设置的“构建设置”选项卡中的“头文件搜索路径”值。如果您已将BRScroller作为git子模块添加到自己的项目中,则路径可能如下所示:"$(PROJECT_DIR)/../BRScroller"

更多有关Xcode依赖项目的详细信息可在网上找到,例如这里这里