SwiftyGiphy
SwiftyGiphy 是一个库,允许您轻松将 Giphy 图像搜索集成到您的应用程序中。
该库包含两个主要组件
-
SwiftyGiphyViewController,它提供了简单的搜索 UI,并为选择的图片提供了回调,以便您可以将 Giphy 快速集成到您的应用程序中。控制器还支持分页,以便您的用户可以持续滚动并查看结果。
-
SwiftyGiphyAPI,它提供了一层 API,用于访问 Giphy。这不需要您在 UI 中使用 SwiftyGiphyViewController,并且可以独立使用。
安装
SwiftyGiphy 支持 Cocoapods 和手动包含。
Cocoapods
pod 'SwiftyGiphy', '~> 1.0'
手动包含
将库和资源文件夹中的文件添加到您的项目中。您还需要包含依赖项
- ObjectMapper - v2.2
- SDWebImage/GIF
- NSTimer-Blocks
- FLAnimatedImage - v1.0
Carthage / Swift Package Manager
目前不支持Carthage和Swift Package Manager。但是,如果您想提交一个支持这两个工具的pull request,我会很高兴考虑将其包括在内。
使用方法
设置
您需要使用您的Giphy API密钥配置SwiftyGiphy。我们建议您在AppDelegate的-didFinishLaunching方法中这样做。
SwiftyGiphyAPI.shared.apiKey = "my_api_key"
注意: 对于测试,您可以使用Giphy的公共beta密钥。但是,您必须在发布应用程序之前更改它。
SwiftyGiphyAPI.shared.apiKey = SwiftyGiphyAPI.publicBetaKey
建议
建议将SwiftyGiphyViewController模态地展示在UINavigationController中,将另一个对象(如展示视图控制器)设定为SwiftyGiphyViewController的代理。
当您需要时,应在代理方法中关闭SwiftyGiphyViewController。
重要的: SwiftyGiphyViewController不会自己关闭。与UIImagePickerController类似,您需要从代理回调中关闭它,以便使其消失。
组件
SwiftyGiphy为您提供了集成Giphy的几个有用工具。
- SwiftyGiphyViewController(如图所示)提供了一个简单的用户界面,用于与Giphy图像搜索交互。
- SwiftyGiphyViewControllerDelegate将由SwiftyGiphyViewController调用,以在用户选择GIF或准备关闭屏幕时通知您。
- SwiftyGiphyAPI提供了对Giphy API的便捷访问。目前这支持所有在此处记录的Giphy API,但图像上传除外。
- 由API层提供的SwiftyGiphy 数据模型,以便您可以与真实对象而不是字典和数组交互。
问题
如果您对如何将SwiftyGiphy集成到项目中有所疑问,请随意创建一个问题,我们会尽力提供帮助。请注意,我们只能为“库存”形式的SwiftyGiphy提供支持,并且不会协助因自定义修改而导致的问题。
鼓励Pull请求,特别是如果您想更多地帮助实现Giphy API层。
使用SwiftyGiphy的应用程序
如果您有一个使用SwiftyGiphy的应用程序,请告诉我,我将在此处提供链接。