leancloud-social-ios

LeanCloud Social Network 模块是 LeanCloud 开源的一个第三方平台登录、分享组件，目前支持 QQ 空间、新浪微博、微信三个平台，具体使用方法可以参看文档。

视频演示

请用浏览器打开视频 ，相应的代码见这里。

如何运行 demo

    cd leancloud-social-ios
    pod install --verbose (如果本地安装过 AVOSCloud 库，则可以加选项 --no-repo-update，加快速度)
    open LeanCloudSocial.xcworkspace

使用方法

具体的使用方法可以参看文档。我们推荐使用 pod 方式来安装此组件。

    pod 'LeanCloudSocial'

您也可以参考LeanChat，此应用使用了该组件来实现第三方登录，就像视频中演示的那样。相关代码见这里。

宝贵意见

如有任何问题，欢迎提出 issue，写下您不理解的地方，看到后会尽快提供帮助。

如何贡献

您可以通过提出 issue 或者发送 pull request 的方式来贡献代码。开源世界因为我们的参与而更加美好。

项目结构

为了便于测试，我们将 Social Network 模块的代码和 demo 都放在了一起，整个 repo 结构如下：

.
├── LeanCloudSocial  <--- LeanCloudSocial 框架代码
├── LeanCloudSocial.podspec  <--- podspec 描述
├── LeanCloudSocialDemo  <--- Demo 项目
│   ├── LeanCloudSocialDemo
│   ├── LeanCloudSocialDemo.xcodeproj
│   ├── LeanCloudSocialDemo.xcworkspace <--- Demo及框架 workspace，这里打开
│   └── Podfile   <--- Demo和框架的 Podfile 
├── LeanCloudSocialTests
└── README.md

如何编译

Xcode 编译

在 Xcode 中选择 UniversalFramework Target，设备选择 iOS Device，在 Product 菜单中选择 Archive 即可开始编译。编译完成后会在当前 build 目录下。

.
├── LeanCloudSocial.build
│   ├── Release-iphoneos
│   │   └── LeanCloudSocial.build
│   └── Release-iphonesimulator
│       └── LeanCloudSocial.build
└── Release-iphoneuniversal
    └── LeanCloudSocial.framework <------ 这里就是编译出来的 framework

命令行编译

在项目根目录下执行以下语句，即可开始编译：

xcodebuild -target UniversalFramework -config Release

编译后的结果文件目录与上面示例一致。

其他问题

我想增加其他平台，该怎么做？

我可以使用其他 SDK 来做登录，然后将其权限信息绑定到 AVUser 吗？

发布日志

发布流程：修改 podspec 版本，打 tag，推送到仓库，执行pod trunk push LeanCloudSocial.podspec --verbose --allow-warnings --use-libraries。

0.0.8

• 修复 bug：修复由 null 引起的崩溃 bug

0.0.7

• 由于 AFNetworking 2.6 最低支持版本为 7.0，同时考虑到微信等应用也是最低支持 7.0。因此，LeanCloudSocial 项目支持的 iOS 版本从 6.0 提升到 7.0。
• 仅公开 AVUser+SNS.h、AVOSCloudSNS.h 头文件。

0.0.6

• 调整目录结构。同时发布动态库，可通过 pod LeanCloudSocialDynamic 引入到项目中。

0.0.5

• 重构部分函数，以使命名更符合 Cocoa 规范。

0.0.4

• 支持微信 SSO 登录，对 -[AVOSCloudSNS loginWithCallback:toPlatform] 第二个参数传入 AVOSCloudSNSWeiXin 即可。
• 同时提供 -[AVOSCloudSNS isAppInstalledWithType] 来检测相应应用是否已安装。

0.0.3

• 将 LCHttpClient 重命名为 AVSNSHttpClient，以避免与其它 LC 模块冲突。

0.0.2

• 使用 AFNetworking ~2.0 版本，使得主项目能够与此库共用同一个 AFNetworking 版本。如果主项目使用的是 AFNetworking 1.0，建议使用 LeanCloudSocial 0.0.1 版本。

0.0.1

• 在重命名模块后进行发布。

许可协议

MIT