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

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

其他问题

Q：使用 CocoaPods 安装，提示无法找到 AVUser+SNS.h 文件的错误

A：删除你项目根目录下的 Pods 文件夹以及 Podfile.lock这个文件，然后重新 pod install

Q ：我要增加其他平台，该怎么做？

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

发布日志

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

0.0.8

fix 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

重命名模块后发布

License

MIT

tang3w/leancloud-social-ios