AhShare-冀銀社交化分享組件
- 適用于公司組件化開發(fā),采用cocoapods控制組件版本,做到一次提交,多處可用。
寫在前面的話
這里的組件或者叫做模塊,嚴(yán)格來說就是pod庫的制作,不能算是嚴(yán)格意義上的組件化開發(fā),SO某些大神不必在此糾結(jié)查辩。建立這些組件的目的在于組件服務(wù)化莱革，將組件從app中解耦出來缩举，統(tǒng)一開發(fā)泪蔫，統(tǒng)一管理，統(tǒng)一修改熟菲。 我們提出這樣一個(gè)暢想露久，在公司新上一個(gè)項(xiàng)目時(shí)更米，該項(xiàng)目的開發(fā)人員通過簡單的配置，將所用到的功能模塊集合到框架中去毫痕，開發(fā)人員不需要去關(guān)注組件內(nèi)部具體的實(shí)現(xiàn)方式征峦，只需要關(guān)注本項(xiàng)目的業(yè)務(wù)邏輯的實(shí)現(xiàn)，界面的跳轉(zhuǎn)即可消请。當(dāng)需要修改時(shí)栏笆，只需要專職人員將組件庫修改并更新，各項(xiàng)目組直接update下就OK了梯啤。
一.為什么要做這類組件?
App是一個(gè)面向特定業(yè)務(wù)群體的產(chǎn)品化應(yīng)用竖伯。 每一款app在業(yè)務(wù)邏輯上都具有獨(dú)立性和特異性存哲。但是就技術(shù)本身而言又具有很多通性和可復(fù)用性因宇。比如網(wǎng)絡(luò)層七婴，數(shù)據(jù)緩存，數(shù)據(jù)解析察滑，還有一些常用的業(yè)務(wù)組件打厘，這些我們都可以拆分成一個(gè)個(gè)的功能組件（模塊），這些組件能夠獨(dú)立升級(jí)贺辰，不影響引用組件項(xiàng)目的穩(wěn)定性户盯。同時(shí)這些組件省去了項(xiàng)目內(nèi)開發(fā)人員引入依賴庫的麻煩，用Xcode引入所有sdk的FrameWorks饲化，個(gè)中酸爽只有搞過才會(huì)有體會(huì)莽鸭。
二.為什么只是簡單的封裝pod庫？
一來個(gè)人能力和精力有限吃靠，二來要考慮使用者的能力硫眨，如果采用注冊(cè)表形式 通過openurl調(diào)取控制器， 去model化進(jìn)一步解除對(duì)數(shù)據(jù)模型的依賴的話巢块，那項(xiàng)目組的開發(fā)人員的學(xué)習(xí)成本會(huì)增大很多礁阁， 這與我們建設(shè)組件化的根本目的相違背，我們希望通過組件的逐漸完善族奢，讓初中級(jí)研發(fā)人員在開發(fā)過程中只關(guān)注于業(yè)務(wù)邏輯姥闭。提高整體開發(fā)效率，給公司帶來的效益最大化越走。如果是一群大神只做一款產(chǎn)品棚品，我也覺得后者的形式進(jìn)行組件化開發(fā)會(huì)更好，可擴(kuò)展性會(huì)更好廊敌，比如蘑菇街南片。
三.為什么只是簡單的封裝sdk？
如果只是學(xué)習(xí)的話庭敦，我覺得還是要扎下去疼进，研究底層，公司開發(fā)的話秧廉，有2個(gè)因素決定封裝現(xiàn)有的優(yōu)良sdk伞广， 時(shí)間成本和穩(wěn)定性。
AhShare使用方法
1.通過cocoapods導(dǎo)入AhShare組件
pod 'AhShare', '~> 0.1.3'
2.編寫AhShareSet.plist文件
文件可以從demo中獲取,demo地址:https://github.com/ahao1011/AhShare.git 也可以直接下載
按照上圖將申請(qǐng)的id和key填寫到對(duì)應(yīng)位置.
注意,該plist文件名稱不能修改,若修改的話請(qǐng)?jiān)贏hShareManager的+ (void)SetUmSocial類方法中對(duì)應(yīng)修改掉
NSString *plistPath = [[NSBundle mainBundle]pathForResource:@"AhShareSet" ofType:@"plist"];;
NSDictionary *dic = [NSDictionary dictionaryWithContentsOfFile:plistPath];
}
3.配置SSO白名單
從iOS9開始,如果你的應(yīng)用使用了SSO授權(quán)或者跳轉(zhuǎn)到第三方分享功能,我們需要在項(xiàng)目的info.plist添加一個(gè)可跳轉(zhuǎn)到白名單,不添加在跳轉(zhuǎn)時(shí)canOpenURL會(huì)返回NO,授權(quán)或者分享功能不能正常實(shí)現(xiàn),具體方法為右鍵info.plist文件選擇source code打開,將一下文本復(fù)制到info.plist中去,注意打開時(shí)是以HTML展示的,不要插到節(jié)點(diǎn)內(nèi)部里.
PS:
本打算通過代碼處理,不用使用人員手工導(dǎo)入, 但是因?yàn)樘O果針對(duì)info.plist做了特殊處理,代碼實(shí)現(xiàn)了插入操作,打印log也確實(shí)看到插入進(jìn)去了,但是info.plist文件就是沒有體現(xiàn),因?yàn)檫@個(gè)文件是只讀的,蘋果應(yīng)該做了一些特殊的處理.
<key>LSApplicationQueriesSchemes</key>
<array>
<!-- 微信 URL Scheme 白名單-->
<string>wechat</string>
<string>weixin</string>
<!-- 新浪微博 URL Scheme 白名單-->
<string>sinaweibohd</string>
<string>sinaweibo</string>
<string>sinaweibosso</string>
<string>weibosdk</string>
<string>weibosdk2.5</string>
<!-- QQ疼电、Qzone URL Scheme 白名單-->
<string>mqqapi</string>
<string>mqq</string>
<string>mqqOpensdkSSoLogin</string>
<string>mqqconnect</string>
<string>mqqopensdkdataline</string>
<string>mqqopensdkgrouptribeshare</string>
<string>mqqopensdkfriend</string>
<string>mqqopensdkapi</string>
<string>mqqopensdkapiV2</string>
<string>mqqopensdkapiV3</string>
<string>mqqopensdkapiV4</string>
<string>mqzoneopensdk</string>
<string>wtloginmqq</string>
<string>wtloginmqq2</string>
<string>mqqwpa</string>
<string>mqzone</string>
<string>mqzonev2</string>
<string>mqzoneshare</string>
<string>wtloginqzone</string>
<string>mqzonewx</string>
<string>mqzoneopensdkapiV2</string>
<string>mqzoneopensdkapi19</string>
<string>mqzoneopensdkapi</string>
<string>mqqbrowser</string>
<string>mttbrowser</string>
</array>
4.設(shè)置URL Scheme
如果想實(shí)現(xiàn)第三方app可以跳轉(zhuǎn)到自己的項(xiàng)目app中來,就必須設(shè)置自身app的url scheme,這里使用第三方平臺(tái)注冊(cè)的appkey信息向系統(tǒng)注冊(cè)你的app,流程以及設(shè)計(jì)規(guī)則參看下圖, 參考了友盟的sdk文檔
- 配置第三方URL Scheme說明
| 平臺(tái) | 格式 | 舉例 | 備注 |
|---|---|---|---|
| 微信 | 微信appKey | wxdc1e388c3822c80b | |
| QQ/Qzone | 需要添加兩項(xiàng)URL Scheme：1嚼锄、"tencent"+騰訊QQ互聯(lián)應(yīng)用appID2、“QQ”+騰訊QQ互聯(lián)應(yīng)用appID轉(zhuǎn)換成十六進(jìn)制（不足8位前面補(bǔ)0） | 如appID：100424468 1蔽豺、tencent100424468 2区丑、QQ05fc5b14 | QQ05fc5b14為100424468轉(zhuǎn)十六進(jìn)制而來，因不足8位向前補(bǔ)0，然后加"QQ"前綴 |
| 新浪微博 | “wb”+新浪appKey | wb3921700954 | m |
5.實(shí)現(xiàn)分享與登錄
5.1 AppDelegate設(shè)置
引入頭文件
#import "AhShare.h"
設(shè)置初始化
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[AhShareManager SetUmSocial];
[AhShareManager openLog:YES];
[AhShareManager usingWaterMark:YES];
return YES;
}
設(shè)置系統(tǒng)回調(diào)
//#define __IPHONE_10_0 100000
#if __IPHONE_OS_VERSION_MAX_ALLOWED > 100000
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options
{
BOOL result = [AhShareHandle AhHandleOpenURL:url options:options];
if (!result) {
// 其他sdk的調(diào)用 例如支付寶支付
}
return result;
}
#endif
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
{
//6.3的新的API調(diào)用沧侥，是為了兼容國外平臺(tái)(例如:新版facebookSDK,VK等)的調(diào)用[如果用6.2的api調(diào)用會(huì)沒有回調(diào)],對(duì)國內(nèi)平臺(tái)沒有影響
BOOL result = [AhShareHandle AhHandleOpenURL:url sourceApplication:sourceApplication annotation:annotation];
if (!result) {
// 其他如支付等SDK的回調(diào)
}
return result;
}
- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url
{
BOOL result = [AhShareHandle AhHandleOpenURL:url];
if (!result) {
// 其他如支付等SDK的回調(diào)
}
return result;
}
5.2 信息分享
AhShareInfo 是一個(gè)自定義的分享對(duì)象模型,需要先實(shí)例化該類一對(duì)象,將圖片,標(biāo)題,描述文字補(bǔ)充完整,通過AhShareManager的類方法showWithType: info:進(jìn)行分享
AhShareInfo *info = [[AhShareInfo alloc]init];
info.title = @"hah";
info.subTitle = @"描述...";
info.thumImg = [UIImage imageNamed:@"kk"];
info.linkUrl = @"http://www.baidu.com";
[AhShareManager showWithType:Show_UM info:info];
5.3第三方登錄
通過AhShareHandle的類方法實(shí)現(xiàn)第三方登錄.
[AhShareHandle AhShareHandleGetUserInfoFormPlatform:AhShare_QQ DoHandle:^(BOOL issus, NSString *username, NSString *usergender, NSString *usericonurl) {
// username 昵稱 usergender 性別 usericonurl 頭像地址
}];
其中AhShare_QQ 為AhSharePlatform枚舉,代表QQ登錄.
typedef enum { // 分享平臺(tái)
/**QQ聊天界面*/
AhShare_QQ =0,
/**QQ空間*/
AhShare_Qzone =1 << 0,
/**微信聊天*/
AhShare_WechatSession =1 << 1,
/**微信朋友圈*/
AhShare_WechatTimeLine =1 << 2,
/**新浪*/
AhShare_Sina =1 << 3,
}AhSharePlatform;
目前分享平臺(tái)只添加了QQ聊天,QQ控件,微信聊天,微信朋友圈,微信收藏,三方登錄只添加了微信和QQ,若新增其他平臺(tái)你可以在AhShare中follow 然后盡情的request.如果你覺得有用,方便時(shí)請(qǐng)給我Star.也可以通過郵箱聯(lián)系我zth0218@126.com
