FSSDKSocialCore 2.0

FSSDKSocialCore 2.0

测试已测试
语言语言 SwiftSwift
许可证 MIT
发布最后发布2016年4月
SPM支持 SPM

Vladimir Goncharov 维护。



  • VladimirGoncharov

社交

为什么需要它?

在每个新项目中,都需要不停地重新连接所需的 SDK,从旧项目中复制或编写相同的代码进行社交网络授权、退出或执行必需的操作。通常,整个逻辑没有统一,各个项目之间有所不同。这个库是为了解决这个问题而实现的,这样我们不必考虑特定社交网络的工作方式 - 我们只需将这些社交网络作为单一实体来操作。

它是如何工作的?

为了创建社交网络,我们必须实现 SocialNetwork 协议。注意!所有社交网络都应作为 单例模式 实现。

  • 通过 static var name: String,社交网络必须自己进行唯一标识。
  • static var isAuthorized: Bool 方法应返回布尔值,表示当前是否存在已授权的用户。这个库预计只能与一个授权用户一起使用。
  • static func authorization(completion: ...) 方法应描述授权过程,并在失败时返回错误。
  • static func logout(completion: ...) 方法应从设备中删除当前用户的相关本地数据。

SocialNetwork 扩展了 Equatable 协议,并通过唯一的 name 属性进行比较。

所有操作都应继承自抽象类 SocialOperation,该类应控制当前状态变量 private(set) var state,在成功时应保存 private(set) var result,如果发生错误则 - private(set) var error。这些状态不能直接设置,而应通过方法设置

  • setSendingState() - 如果操作已启动并且仍在进行中
  • setSuccessedState(result: AnyObject?) - 如果操作成功完成并希望保存结果
  • setFailedState(error: NSError?) - 如果发生某些错误。

PostToWallAction 协议

SocialActions.swift 中添加所有可能的社交网络操作。例如,协议 PostToWallAction 表示社交网络支持将记录添加到用户的墙/时间线的功能,其中数据应支持 SocialData 协议。

如果有社交网络可以使用某些包含图片的方法,建议使用SocialImage。在这个类中,我们保存图片和序列化块以发送。

FACEBOOK

连接步骤

  1. 要连接 Facebook,需要添加 podspecs

    #facebook SDK 
    pod 'Facebook-iOS-SDK'
    
  2. 在 Facebook 上创建新应用程序

  3. 设置 -> 基本中添加必要的联系电子邮件,然后在iOS Bundle ID选项卡中添加预发布和生产的 bundle ID。
  4. 按照文档iOS9指导文档中的说明进行应用设置。
  5. 角色中添加管理员和开发者

登录权限设置

  • 如果您想使用protocol PostToWallAction,则需要具有确认的publish_actions(未经确认的将只在角色中的用户上工作)。请参阅说明

应用程序对所有用户的访问

状态 & 审查 -> 状态中,将您的应用程序图标旁边的开关切换到打开位置。对于其他用户,只有已验证的权限才可用

TWITTER

通过 Fabric 连接的步骤

  1. 如果尚未安装,请下载Mac OS 的 Fabric桌面应用程序。
  2. 在您的 Fabric 帐户中创建一个新组织
  3. 使用桌面应用程序将应用程序添加到新的组织。为此,请单击 + 新应用 -> 选择您的项目 -> 选择您的新组织 -> 在 Twitter 旁边单击安装,并按照未安装 Fabric 的集成说明进行操作。对于 Twitter,请选择选项Embedded Tweets
  4. https://fabric.io/dashboard中设置 Twitter 应用程序。
  5. 邀请必要的管理员

通过 Twitter.com 连接的步骤

  1. 要连接 Twitter,需要连接 podspecs

    #twitter SDK
    pod 'TwitterKit'
    pod 'TwitterCore'
    pod 'twitter-text'
    
  2. 访问https://apps.twitter.com并单击创建新应用。输入名称描述网站回调 URL。如果不知道可以添加什么内容到网站回调 URL,则只需插入http://www.placeholder.com即可。现在创建应用程序。
  3. 权限选项卡中检查访问是否为读取和写入
  4. 应用设置选项卡复制Consumer Key (API Key)Consumer Secret (API Secret)
  5. 按照文档iOS9指导文档中的说明进行应用设置。

应用程序对所有用户的访问

此应用程序现在对所有用户可用。

GOOGLE

连接步骤

  1. 要连接 Google Sign-In,需要连接 podspecs

    #google SDK
    pod 'Google/SignIn'
    
  2. 根据文档中的说明进行应用设置。

应用程序对所有用户的访问

此应用程序现在对所有用户可用。

VK

连接步骤

  1. 要连接 vk,需要连接 podspecs

    #vk SDK
    pod 'VK-ios-sdk'
    
  2. 访问https://vk.com/dev并单击我的应用程序 -> 创建应用程序。选择独立应用程序并写入必要的名称。单击连接应用程序

  3. 转到设置选项卡并添加App Bundle ID для iOS,然后保存。只能添加一个 bundle,因此您需要立即使用与 App Store bundle ID 一致的 bundle。
  4. 按照文档中的说明进行应用设置。
  5. 转到指南选项卡并添加管理员

应用程序对所有用户的访问

设置 -> 状态中,从列表中选择应用程序已启用和可见

PIXTA

连接步骤

  1. 要连接到PIXTA,需要连接到 podspect。

    #pinterest SDK
    pod 'PinterestSDK', :git => 'https://github.com/pinterest/ios-pdk.git'
    
  2. 按照文档中描述的方式设置应用程序。

应用程序对所有用户的访问