SwiftyGiphy 1.3.1

SwiftyGiphy 1.3.1

测试已测试
语言语言 SwiftSwift
许可证 MIT
发布上次发布2019年10月
SPM支持 SPM

Brendan LeeEvan Owen 维护。



 
依赖
ObjectMapper~> 3.0
SDWebImage/GIF>= 0
NSTimer-Blocks>= 0
FLAnimatedImage~> 1.0
 

SwiftyGiphy

SwiftyGiphy 是一个库,允许您轻松将 Giphy 图像搜索集成到您的应用程序中。

该库包含两个主要组件

  1. SwiftyGiphyViewController,它提供了简单的搜索 UI,并为选择的图片提供了回调,以便您可以将 Giphy 快速集成到您的应用程序中。控制器还支持分页,以便您的用户可以持续滚动并查看结果。

  2. SwiftyGiphyAPI,它提供了一层 API,用于访问 Giphy。这不需要您在 UI 中使用 SwiftyGiphyViewController,并且可以独立使用。



安装

SwiftyGiphy 支持 Cocoapods 和手动包含。

Cocoapods

pod 'SwiftyGiphy', '~> 1.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的应用程序,请告诉我,我将在此处提供链接。