1. 程式人生 > >iOS實現微信第三方登入

iOS實現微信第三方登入

一、接入微信第三方登入準備工作。
移動應用微信登入是基於OAuth2.0協議標準構建的微信OAuth2.0授權登入系統。
在進行微信OAuth2.0授權登入接入之前,在微信開放平臺註冊開發者帳號,並擁有一個已稽核通過的移動應用,並獲得相應的AppID和AppSecret,申請微信登入且通過稽核後,可開始接入流程。(注意)
1、下載iOS微信SDK。(自己去微信開放平臺下載,並整合進專案,若之前專案已經整合過微信支付SDK,那麼微信登入已經包括在內了,而且使用的AppID和AppSecret也是同一個。)

2、補充匯入一些依賴框架。

3、新增URL Types

4、新增iOS9 URL Schemes.

注意:如果沒有做這步的話會出現以下錯誤.

1

-canOpenURL: failed for URL:  - error: "This app is not allowed to query for scheme weixin"

5、向微信終端程式註冊第三方應用,並在第三方應用實現從微信返回
在AppDelegate.m中引入"WXApi.h"標頭檔案,然後寫入如下:

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

#import "AppDelegate.h"

#import "LoginViewController.h"

#import "WXApi.h"

#pragma mark - application delegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

[WXApi registerApp:@"wxd1931d4a0e46****"

 withDescription:@"Wechat"];

return YES;

}

// 這個方法是用於從微信返回第三方App

- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url {

[WXApi handleOpenURL:url delegate:self];

return YES;

}

6、請求CODE
開發者需要配合使用微信開放平臺提供的SDK進行授權登入請求接入。正確接入SDK後並擁有相關授權域(scope,什麼是授權域?)許可權後,開發者移動應用會在終端本地拉起微信應用進行授權登入,微信使用者確認後微信將拉起開發者移動應用,並帶上授權臨時票據(code)。

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

#import "LoginViewController.h"

#import "RegisterViewController.h"

#import "MBProgressHUD.h"

#import "AFNetworking.h"

#import "WXApi.h"

#pragma mark - 微信登入

/*

目前移動應用上德微信登入只提供原生的登入方式,需要使用者安裝微信客戶端才能配合使用。

對於iOS應用,考慮到iOS應用商店稽核指南中的相關規定,建議開發者接入微信登入時,先檢測使用者手機是否已經安裝

微信客戶端(使用sdk中的isWXAppInstall函式),對於未安裝的使用者隱藏微信 登入按鈕,只提供其他登入方式。

*/

- (IBAction)wechatLoginClick:(id)sender {

if ([WXApi isWXAppInstalled]) {

SendAuthReq *req = [[SendAuthReq alloc] init];

req.scope = @"snsapi_userinfo";

req.state = @"App";

[WXApi sendReq:req];

}

else {

[self setupAlertController];

}

}

#pragma mark - 設定彈出提示語

- (void)setupAlertController {

UIAlertController *alert = [UIAlertController alertControllerWithTitle:@"溫馨提示" message:@"請先安裝微信客戶端" preferredStyle:UIAlertControllerStyleAlert];

UIAlertAction *actionConfirm = [UIAlertAction actionWithTitle:@"確定" style:UIAlertActionStyleDefault handler:nil];

[alert addAction:actionConfirm];

[self presentViewController:alert animated:YES completion:nil];

}

執行完上面那一步後,如果客戶端安裝了微信,那麼就會向微信請求相應的授權,圖如下:

還有在實際的使用中我們還要結合需求做一些改變。因為微信授權後access_token(2小時)之類的欄位都是有效期的在有效期範圍內,我們是沒必要讓使用者再次授權的,很可能你的實現,會如我下面所寫的(LoginViewController)

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

// LoginViewController.h

#import <UIKit/UIKit.h>

@interface LoginViewController : BaseViewController

/** 通過block去執行AppDelegate中的wechatLoginByRequestForUserInfo方法 */

@property (copy, nonatomic) void (^requestForUserInfoBlock)();

@end

// LoginViewController.m

#pragma mark - 微信登入

/*

目前移動應用上德微信登入只提供原生的登入方式,需要使用者安裝微信客戶端才能配合使用。

對於iOS應用,考慮到iOS應用商店稽核指南中的相關規定,建議開發者接入微信登入時,先檢測使用者手機是否已經安裝

微信客戶端(使用sdk中的isWXAppInstall函式),對於未安裝的使用者隱藏微信 登入按鈕,只提供其他登入方式。

*/

- (IBAction)wechatLoginClick:(id)sender {

NSString *accessToken = [[NSUserDefaults standardUserDefaults] objectForKey:WX_ACCESS_TOKEN];

NSString *openID = [[NSUserDefaults standardUserDefaults] objectForKey:WX_OPEN_ID];

// 如果已經請求過微信授權登入,那麼考慮用已經得到的access_token

if (accessToken && openID) {

AFHTTPRequestOperationManager *manager = [AFHTTPRequestOperationManager manager];

NSString *refreshToken = [[NSUserDefaults standardUserDefaults] objectForKey:WX_REFRESH_TOKEN];

NSString *refreshUrlStr = [NSString stringWithFormat:@"%@/oauth2/refresh_token?appid=%@&grant_type=refresh_token&refresh_token=%@", WX_BASE_URL, WXPatient_App_ID, refreshToken];

[manager GET:refreshUrlStr parameters:nil success:^(AFHTTPRequestOperation *operation, id responseObject) {

NSLog(@"請求reAccess的response = %@", responseObject);

NSDictionary *refreshDict = [NSDictionary dictionaryWithDictionary:responseObject];

NSString *reAccessToken = [refreshDict objectForKey:WX_ACCESS_TOKEN];

// 如果reAccessToken為空,說明reAccessToken也過期了,反之則沒有過期

if (reAccessToken) {

// 更新access_token、refresh_token、open_id

[[NSUserDefaults standardUserDefaults] setObject:reAccessToken forKey:WX_ACCESS_TOKEN];

[[NSUserDefaults standardUserDefaults] setObject:[refreshDict objectForKey:WX_OPEN_ID] forKey:WX_OPEN_ID];

[[NSUserDefaults standardUserDefaults] setObject:[refreshDict objectForKey:WX_REFRESH_TOKEN] forKey:WX_REFRESH_TOKEN];

[[NSUserDefaults standardUserDefaults] synchronize];

// 當存在reAccessToken不為空時直接執行AppDelegate中的wechatLoginByRequestForUserInfo方法

!self.requestForUserInfoBlock ? : self.requestForUserInfoBlock();

}

else {

[self wechatLogin];

}

} failure:^(AFHTTPRequestOperation *operation, NSError *error) {

NSLog(@"用refresh_token來更新accessToken時出錯 = %@", error);

}];

}

else {

[self wechatLogin];

}

}

- (void)wechatLogin {

if ([WXApi isWXAppInstalled]) {

SendAuthReq *req = [[SendAuthReq alloc] init];

req.scope = @"snsapi_userinfo";

req.state = @"GSTDoctorApp";

[WXApi sendReq:req];

}

else {

[self setupAlertController];

}

}

#pragma mark - 設定彈出提示語

- (void)setupAlertController {

UIAlertController *alert = [UIAlertController alertControllerWithTitle:@"溫馨提示" message:@"請先安裝微信客戶端" preferredStyle:UIAlertControllerStyleAlert];

UIAlertAction *actionConfirm = [UIAlertAction actionWithTitle:@"確定" style:UIAlertActionStyleDefault handler:nil];

[alert addAction:actionConfirm];

[self presentViewController:alert animated:YES completion:nil];

}

當有access_token和openID時輸出:

1

2

3

4

5

6

7

**請求****reAccess****的****response = {**

**  "access_token" = "OezXcEiiBSKSxW0eoylIeK3BOTSVaRovFSXb5oysH6dewFfLsQRgU3fphSLkKkhOokra9H-JMZuB5nPoM-Iy5YbFeA1nKMRYCbL0fj_s46oFKOluGoRUY8jyTdrdDiiFdgS2fxgo5odEtpnpFk3EXA";**

**  "expires_in" = 7200;**

**  openid = oXskgs62CJGFhFX05dSjy9Sjw2KA;**

**  "refresh_token" = "OezXcEiiBSKSxW0eoylIeK3BOTSVaRovFSXb5oysH6dewFfLsQRgU3fphSLkKkhOOWPTKGEjUtuiueutxRjKOlHGZ9b9ogc3KMbibu4eKc4yTMGzSZayjYPmwQ-c4RJE1RzMLrqvjUWgB5roFnjykw";**

**  scope = "snsapi_base,snsapi_userinfo,";**

**}**

重新整理access_token有效期:
access_token是呼叫授權關係介面的呼叫憑證,由於access_token有效期(目前為2個小時)較短,當access_token超時後,可以使用refresh_token進行重新整理,access_token重新整理結果有兩種:

  • 1. 若access_token已超時,那麼進行refresh_token會獲取一個新的access_token,新的超時時間;
  • 2. 若access_token未超時,那麼進行refresh_token不會改變access_token,但超時時間會重新整理,相當於續期access_token。

refresh_token擁有較長的有效期(30天),當refresh_token失效的後,需要使用者重新授權。
讓AppDelegate遵守<WXApiDelegate>協議,並實現協議方法onResp:
 我們在該方法中接收請求回來的資料,如下:

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

//授權後回撥

/*

http請求方式:GET

// 根據響應結果中的code獲取access_token(要用到申請時得到的AppID和AppSecret)

正確返回

{

"access_token":"ACCESS_TOKEN",

"expires_in":7200,

"refresh_token":"REFRESH_TOKEN",

"openid":"OPENID",

"scope":"SCOPE",

"unionid":"o6_bmasdasdsad6_2sgVt7hMZOPfL"

}

錯誤返回樣例

{"errcode":40029,"errmsg":"invalid code"}

ErrCode ERR_OK = 0(使用者同意)

ERR_AUTH_DENIED = -4(使用者拒絕授權)

ERR_USER_CANCEL = -2(使用者取消)

code  使用者換取access_token的code,僅在ErrCode為0時有效

state  第三方程式傳送時用來標識其請求的唯一性的標誌,由第三方程式呼叫sendReq時傳入,由微信終端回傳,state字串長度不能超過1K

lang  微信客戶端當前語言

country 微信使用者當前國家資訊

*/

1

2

3

4

5

6

7

8

9

10

11

12

-(void)showLoginController:(BOOL)shouldAnimation

{

LoginViewController *loginController=[[LoginViewController alloc]initWithNibName:@"LoginViewController" bundle:nil];

loginController.requestForUserInfoBlock = ^() {

[[AppDelegate sharedInstance] wechatLoginByRequestForUserInfo];

};

BaseNavigationController *baseNavController=[[BaseNavigationController alloc]initWithRootViewController:loginController];

[kAppDelegate.window.rootViewController presentViewController:baseNavController animated:shouldAnimation completion:NULL];

}

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

// 授權後回撥

// AppDelegate.m

- (void)onResp:(BaseResp *)resp {

// 向微信請求授權後,得到響應結果

if ([resp isKindOfClass:[SendAuthResp class]]) {   

SendAuthResp *temp = (SendAuthResp *)resp;

AFHTTPRequestOperationManager *manager = [AFHTTPRequestOperationManager manager];

NSString *accessUrlStr = [NSString stringWithFormat:@"%@/oauth2/access_token?appid=%@&secret=%@&code=%@&grant_type=authorization_code", WX_BASE_URL, WXPatient_App_ID, WXPatient_App_Secret, temp.code];

[manager GET:accessUrlStr parameters:nil success:^(AFHTTPRequestOperation *operation, id responseObject) {

NSLog(@"請求access的response = %@", responseObject);

NSDictionary *accessDict = [NSDictionary dictionaryWithDictionary:responseObject];

NSString *accessToken = [accessDict objectForKey:WX_ACCESS_TOKEN];

NSString *openID = [accessDict objectForKey:WX_OPEN_ID];

NSString *refreshToken = [accessDict objectForKey:WX_REFRESH_TOKEN];

// 本地持久化,以便access_token的使用、重新整理或者持續

if (accessToken && ![accessToken isEqualToString:@""] && openID && ![openID isEqualToString:@""]) {

[[NSUserDefaults standardUserDefaults] setObject:accessToken forKey:WX_ACCESS_TOKEN];

[[NSUserDefaults standardUserDefaults] setObject:openID forKey:WX_OPEN_ID];

[[NSUserDefaults standardUserDefaults] setObject:refreshToken forKey:WX_REFRESH_TOKEN];

[[NSUserDefaults standardUserDefaults] synchronize]; // 命令直接同步到檔案裡,來避免資料的丟失

}

[self wechatLoginByRequestForUserInfo];

} failure:^(AFHTTPRequestOperation *operation, NSError *error) {

NSLog(@"獲取access_token時出錯 = %@", error);

}];

}

}

7、通過code獲取access_token
通過上一步獲取的code後,請求以下連結獲取access_token:

相關程式碼上面實現onResp:方法,接收返回的響應。
引數說明:

引數           是否必須        說明
appid           是             應用唯一標識,在微信開放平臺提交應用稽核通過後獲得
secret          是             應用金鑰AppSecret,在微信開放平臺提交應用稽核通過後獲得
code            是             填寫第一步獲取的code引數
grant_type      是             填authorization_code
返回說明:

1

2

3

4

5

6

7

8

{

"access_token":"ACCESS_TOKEN", // 介面呼叫憑證

"expires_in":7200, // access_token介面呼叫憑證超時時間,單位(秒)

"refresh_token":"REFRESH_TOKEN", // 使用者重新整理access_token

"openid":"OPENID", // 授權使用者唯一標識

"scope":"SCOPE", // 使用者授權的作用域,使用逗號(,)分隔

"unionid":"o6_bmasdasdsad6_2sgVt7hMZOPfL" // 只有在使用者將公眾號繫結到微信開放平臺帳號後,才會出現該欄位

}

錯誤返回樣例:

{"errcode":40029,"errmsg":"invalid code"}
8、獲取使用者個人資訊(UnionID機制)

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

// AppDelegate.m

// 獲取使用者個人資訊(UnionID機制)

- (void)wechatLoginByRequestForUserInfo {

AFHTTPRequestOperationManager *manager = [AFHTTPRequestOperationManager manager];

NSString *accessToken = [[NSUserDefaults standardUserDefaults] objectForKey:WX_ACCESS_TOKEN];

NSString *openID = [[NSUserDefaults standardUserDefaults] objectForKey:WX_OPEN_ID];

NSString *userUrlStr = [NSString stringWithFormat:@"%@/userinfo?access_token=%@&openid=%@", WX_BASE_URL, accessToken, openID];

// 請求使用者資料

[manager GET:userUrlStr parameters:nil success:^(AFHTTPRequestOperation *operation, id responseObject) {

NSLog(@"請求使用者資訊的response = %@", responseObject);

// NSMutableDictionary *userDict = [NSMutableDictionary dictionaryWithDictionary:responseObject];

} failure:^(AFHTTPRequestOperation *operation, NSError *error) {

NSLog(@"獲取使用者資訊時出錯 = %@", error);

}];

}

返回的Json結果:

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

返回的Json結果

{

"openid":"OPENID",

"nickname":"NICKNAME",

"sex":1,

"province":"PROVINCE",

"city":"CITY",

"country":"COUNTRY",

"privilege":[

"PRIVILEGE1",

"PRIVILEGE2"

],

"unionid": " o6_bmasdasdsad6_2sgVt7hMZOPfL"

}

返回錯誤的Json事例

{

"errcode":40003,"errmsg":"invalid openid"

}

9、最後
做到上面一步就應該得到返回微信的基本資訊,然後根據你公司後臺的基本需求去實現授權後如何登入App.
資料:

1

2

3

4

5

6

7

8

9

10

// access_token openid refresh_token unionid

#define WXDoctor_App_ID @"wxd1931d4a0e462***" // 註冊微信時的AppID

#define WXDoctor_App_Secret @"d0dd6b58da42cbc4f4b715c70e65c***" // 註冊時得到的AppSecret

#define WXPatient_App_ID @"wxbd02bfeea4292***"

#define WXPatient_App_Secret @"4a788217f363358276309ab655707***"

#define WX_ACCESS_TOKEN @"access_token"

#define WX_OPEN_ID @"openid"

#define WX_REFRESH_TOKEN @"refresh_token"

#define WX_UNION_ID @"unionid"