1. 程式人生 > >Android微信登入、分享、支付

Android微信登入、分享、支付

前言

大部分的app都有接入第三方sdk的需求。例如第三方登入需要接入微信、QQ、微博。第三方支付需要接入微信、支付寶、銀聯。

這些我都有使用過,都有使用過他們的sdk,感覺最麻煩的就是微信,不能直接除錯,得用正式的簽名進行簽名才能除錯。還有他們官方的demo也是跑不起來的,因為沒有簽名檔案。需要注意的地方也很多。

程式碼實現

微信sdk現在支援Android Studio線上引用了,之前都是新增jar的方法。需要訪問微信的介面獲取使用者資訊,所以把我們之前封裝的okhttp也一起線上引用。okhttp需要在自定義的Application中初始化這個我就不貼程式碼了。之前已經講過很多次。在app/build.gradle檔案dependencies標籤中加入以下兩行程式碼:

compile 'com.tencent.mm.opensdk:wechat-sdk-android-without-mta:+'
compile 'com.ansen.http:okhttpencapsulation:1.0.1'

需要用到網路,所以在AndroidManifest.xml檔案中加入網路許可權:

<uses-permission android:name="android.permission.INTERNET" />

activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="match_parent" android:padding="10dp" android:orientation="vertical">
<TextView android:layout_width="wrap_content" android:layout_height="wrap_content"
android:text="登入之後資訊在這裡顯示"/>
<RelativeLayout android:layout_width="wrap_content" android:layout_height="wrap_content"> <TextView android:id="@+id/tv_nickname" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="暱稱:"/> <TextView android:id="@+id/tv_age" android:layout_below="@+id/tv_nickname" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="年齡:"/> </RelativeLayout> <Button android:id="@+id/btn_login" android:layout_width="match_parent" android:layout_height="wrap_content" android:text="微信登入"/> <Button android:id="@+id/btn_share_friend_circle" android:layout_width="match_parent" android:layout_height="wrap_content" android:text="分享到朋友圈"/> <Button android:id="@+id/btn_share_friend" android:layout_width="match_parent" android:layout_height="wrap_content" android:text="分享給好友"/> <Button android:id="@+id/btn_pay" android:layout_width="match_parent" android:layout_height="wrap_content" android:text="微信支付"/> </LinearLayout>

佈局檔案很簡單,就LinearLayout裡面放了幾個TextView,跟幾個按鈕。

WeiXin.java 用於EventBus來傳送訊息,微信sdk有個很奇怪的地方,就是不管登入、分享、支付之後都得用一個Activity來接收,所以我們還得從接收的那個activity把結果資訊通過EventBus傳遞給MainActivity。雖然用廣播也能實現,但是個人喜歡用EventBus,使用靈活。簡單輕量。

public class WeiXin {
    private int type;//1:登入 2.分享 3:微信支付
    private int errCode;//微信返回的錯誤碼
    private String code;//登入成功才會有的code

    public WeiXin() {
    }

    public WeiXin(int type,int errCode, String code) {
        this.type = type;
        this.errCode=errCode;
        this.code = code;
    }

    public int getType() {
        return type;
    }

    public void setType(int type) {
        this.type = type;
    }

    public String getCode() {
        return code;
    }

    public void setCode(String code) {
        this.code = code;
    }

    public int getErrCode() {
        return errCode;
    }

    public void setErrCode(int errCode) {
        this.errCode = errCode;
    }
}

Constant.java 常量類,微信appid跟secret的值用兩個常量儲存。為了保護隱私這兩個值我已經修改過。

public class Constant {
    public static String WECHAT_APPID="wxda6db2aec81389af";
    public static String WECHAT_SECRET="8fed5a2d510022587ef8a6194c965be3";
}

MainActivity.java 全部程式碼貼出來比較亂,暫時貼出MainActivity部分程式碼。

public class MainActivity extends AppCompatActivity implements View.OnClickListener {
    private IWXAPI wxAPI;
    private TextView tvNickname,tvAge;
    public static final int IMAGE_SIZE=32768;//微信分享圖片大小限制

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        EventBus.getDefault().register(this);//註冊
        wxAPI = WXAPIFactory.createWXAPI(this,Constant.WECHAT_APPID,true);
        wxAPI.registerApp(Constant.WECHAT_APPID);

        findViewById(R.id.btn_login).setOnClickListener(this);
        findViewById(R.id.btn_share_friend_circle).setOnClickListener(this);
        findViewById(R.id.btn_share_friend).setOnClickListener(this);
        findViewById(R.id.btn_pay).setOnClickListener(this);

        tvNickname= (TextView) findViewById(R.id.tv_nickname);
        tvAge=(TextView) findViewById(R.id.tv_age);
    }

    @Override
    public void onClick(View view) {
        switch (view.getId()){
            case R.id.btn_login://微信登入
                login();
                break;
            case R.id.btn_share_friend_circle://微信分享到朋友圈
                share(true);
                break;
            case R.id.btn_share_friend://微信分享給朋友
                share(false);
                break;
            case R.id.btn_pay://微信支付
//              先去伺服器獲取支付資訊,返回一個WeiXinPay物件,然後呼叫pay方法
                showToast("微信支付需要伺服器支援");
                break;
        }
    }

    /**
     * 這裡用到的了EventBus框架
     * @param weiXin
     */
    @Subscribe
    public void onEventMainThread(WeiXin weiXin){
        Log.i("ansen","收到eventbus請求 type:"+weiXin.getType());
        if(weiXin.getType()==1){//登入
            getAccessToken(weiXin.getCode());
        }else if(weiXin.getType()==2){//分享
            switch (weiXin.getErrCode()){
                case BaseResp.ErrCode.ERR_OK:
                    Log.i("ansen", "微信分享成功.....");
                    break;
                case BaseResp.ErrCode.ERR_USER_CANCEL://分享取消
                    Log.i("ansen", "微信分享取消.....");
                    break;
                case BaseResp.ErrCode.ERR_AUTH_DENIED://分享被拒絕
                    Log.i("ansen", "微信分享被拒絕.....");
                    break;
            }
        }else if(weiXin.getType()==3){//微信支付
            if(weiXin.getErrCode()==BaseResp.ErrCode.ERR_OK){//成功
                Log.i("ansen", "微信支付成功.....");
            }
        }
    }
    
    ..........

    public void showToast(String message){
        Toast.makeText(this,message,Toast.LENGTH_LONG).show();
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        EventBus.getDefault().unregister(this);//取消註冊
    }
}
  • onCreate 註冊EventBus,通過WXAPIFactory建立IWXAPI類,並且註冊appid,給四個按鈕按鈕設定點選事件。查詢顯示名字跟年齡的兩個TextView。
  • onClick 點選事件監聽,根據id來判斷點選不同的按鈕,跳轉到相應的方法,這些方法沒貼出來來,等會單獨講。
  • onEventMainThread(WeiXin weiXin) 用來接收訊息,這個方法有個引數,用來判斷型別,就是我們用EventBus傳送時引數必須是WeiXin型別。首先判斷type,是登入還是分享還是支付。登入成功情況下會獲取到code,根據code然後我們就能獲取到微信使用者資訊。
  • showToast Toast提示
  • onDestroy 取消EventBus註冊

微信登入

微信登入流程有以下三個步驟:

  • 微信授權登陸
  • 根據授權登陸code 獲取該使用者token
  • 根據token獲取使用者資料

當我們點選登入按鈕的時候,呼叫的是login方法。這個方法就在MainActivity裡面。就是給微信發起一個登入請求,彈出一個授權介面。

public void login(){
    SendAuth.Req req = new SendAuth.Req();
    req.scope = "snsapi_userinfo";
    req.state = String.valueOf(System.currentTimeMillis());
    wxAPI.sendReq(req);
}

在你的包名相應目錄下新建一個wxapi目錄,然後在wxapi目錄下新增一個WXEntryActivity類,用來接收登入授權以及分享時微信的回撥資訊。這個類繼承自Activity,需要實現IWXAPIEventHandler介面。

package com.ansen.shoenet.wxapi;
public class WXEntryActivity extends Activity implements IWXAPIEventHandler {
    private IWXAPI wxAPI;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        wxAPI = WXAPIFactory.createWXAPI(this,Constant.WECHAT_APPID,true);
        wxAPI.registerApp(Constant.WECHAT_APPID);
        wxAPI.handleIntent(getIntent(), this);
    }

    @Override
    protected void onNewIntent(Intent intent){
        super.onNewIntent(intent);
        wxAPI.handleIntent(getIntent(),this);
        Log.i("ansen","WXEntryActivity onNewIntent");
    }

    @Override
    public void onReq(BaseReq arg0) {
        Log.i("ansen","WXEntryActivity onReq:"+arg0);
    }

    @Override
    public void onResp(BaseResp resp){
        if(resp.getType()== ConstantsAPI.COMMAND_SENDMESSAGE_TO_WX){//分享
            Log.i("ansen","微信分享操作.....");
            WeiXin weiXin=new WeiXin(2,resp.errCode,"");
            EventBus.getDefault().post(weiXin);
        }else if(resp.getType()==ConstantsAPI.COMMAND_SENDAUTH){//登陸
            Log.i("ansen", "微信登入操作.....");
            SendAuth.Resp authResp = (SendAuth.Resp) resp;
            WeiXin weiXin=new WeiXin(1,resp.errCode,authResp.code);
            EventBus.getDefault().post(weiXin);
        }
        finish();
    }
}

onCreate、onNewIntent、onReq這三個方法是固定寫法。onResp方法接收微信結果資訊,首先判斷型別,根據不同的型別去封裝WeiXin物件,如果是登入操作,把code傳入進去,然後把封裝好的WeiXin物件通過EventBus傳送出去。MainActivity的onEventMainThread方法就會接收到這個訊息。最後呼叫finish關閉當前的activity。

WXEntryActivity記得在AndroidManifest.xml中註冊

<activity
    android:exported="true"
    android:name=".wxapi.WXEntryActivity"/>

繼續回到首頁的onEventMainThread,如果登入型別呼叫getAccessToken(),並且傳入code。根據code獲取access_token,這個url是微信公開的,需要傳入三個引數,appid、secret、code。請求成功之後會返回access_token跟openid等資訊。

public void getAccessToken(String code){
    String url = "https://api.weixin.qq.com/sns/oauth2/access_token?" +
            "appid="+Constant.WECHAT_APPID+"&secret="+Constant.WECHAT_SECRET+
            "&code="+code+"&grant_type=authorization_code";
    HTTPCaller.getInstance().get(WeiXinToken.class, url, null, new RequestDataCallback<WeiXinToken>() {
        @Override
        public void dataCallback(WeiXinToken obj) {
            if(obj.getErrcode()==0){//請求成功
                getWeiXinUserInfo(obj);
            }else{//請求失敗
                showToast(obj.getErrmsg());
            }
        }
    });
}

獲取到access_token跟openid之後繼續呼叫getWeiXinUserInfo方法獲取使用者資訊。這樣就能取到當前微信app登入的使用者一些資訊。有暱稱、年齡、頭像地址、語言等基本資訊。在企業開發中,到了這一步就可以拿著這些資訊呼叫自己伺服器的登入介面。當然我們這邊就把暱稱跟年齡給TextView顯示下。

public void getWeiXinUserInfo(WeiXinToken weiXinToken){
    String url = "https://api.weixin.qq.com/sns/userinfo?access_token="+
            weiXinToken.getAccess_token()+"&openid="+weiXinToken.getOpenid();
    HTTPCaller.getInstance().get(WeiXinInfo.class, url, null, new RequestDataCallback<WeiXinInfo>() {
        @Override
        public void dataCallback(WeiXinInfo obj) {
            tvNickname.setText("暱稱:"+obj.getNickname());
            tvAge.setText("年齡:"+obj.getAge());
            Log.i("ansen","頭像地址:"+obj.getHeadimgurl());
        }
    });
}

WeiXinToken跟WeiXinInfo這兩個實體類就不貼程式碼了,WeiXinToken用來對映獲取訪問token介面返回的json。WeiXinInfo用來對映獲取使用者介面返回的json。

微信分享

分享有兩種分享到朋友圈跟分享給好友,統一呼叫share方法。傳入一個boolean型別來判斷是否分享到朋友圈。

public void share(boolean friendsCircle){
    WXWebpageObject webpage = new WXWebpageObject();
    webpage.webpageUrl = "www.baidu.com";//分享url
    WXMediaMessage msg = new WXMediaMessage(webpage);
    msg.title = "分享標題";
    msg.description = "分享描述";
    msg.thumbData =getThumbData();//封面圖片byte陣列

    SendMessageToWX.Req req = new SendMessageToWX.Req();
    req.transaction = String.valueOf(System.currentTimeMillis());
    req.message = msg;
    req.scene = friendsCircle ? SendMessageToWX.Req.WXSceneTimeline : SendMessageToWX.Req.WXSceneSession;
    wxAPI.sendReq(req);
}

分享內容有很多格式,分享圖片、分享視訊、分享訊息。我們這邊就分享訊息為例,也是分享比較常見的格式。首先new一個WXWebpageObject物件,設定標題、內容、開啟連結、封面等。最後呼叫wxAPI的sendReq放鬆一個請求。

分享跟登入一樣,都會回撥WXEntryActivity,然後又把分享結果傳送給MainActivity.onEventMainThread方法。

支付
支付首先需要請求我們自己的伺服器,獲取支付資訊。獲取成功之後呼叫pay方法。

public void pay(WeiXinPay weiXinPay){
    PayReq req = new PayReq();
    req.appId = Constant.WECHAT_APPID;//appid
    req.nonceStr=weiXinPay.getNoncestr();//隨機字串,不長於32位。推薦隨機數生成演算法
    req.packageValue=weiXinPay.getPackage_value();//暫填寫固定值Sign=WXPay
    req.sign=weiXinPay.getSign();//簽名
    req.partnerId=weiXinPay.getPartnerid();//微信支付分配的商戶號
    req.prepayId=weiXinPay.getPrepayid();//微信返回的支付交易會話ID
    req.timeStamp=weiXinPay.getTimestamp();//時間戳

    wxAPI.registerApp(Constant.WECHAT_APPID);
    wxAPI.sendReq(req);
}

weiXinPay的值應該是我們從自己伺服器獲取的,然後把返回資訊封裝到PayReq物件中,最後呼叫wxAPI的sendReq方法發起請求。

在wxapi目錄下新增一個WXPayEntryActivity類,這個類跟WXEntryActivity同級,用來接收微信支付的回撥資訊。這個類繼承自Activity,需要實現IWXAPIEventHandler介面。

public class WXPayEntryActivity extends Activity implements IWXAPIEventHandler {
    private IWXAPI wxAPI;
    
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        wxAPI = WXAPIFactory.createWXAPI(this, Constant.WECHAT_APPID);
        wxAPI.handleIntent(getIntent(), this);
    }
    
    @Override
    protected void onNewIntent(Intent intent){
        super.onNewIntent(intent);
        setIntent(intent);
        wxAPI.handleIntent(intent, this);
    }

    @Override
    public void onReq(BaseReq baseReq) {}

    @Override
    public void onResp(BaseResp resp) {
        Log.i("ansen", "微信支付回撥 返回錯誤碼:"+resp.errCode+" 錯誤名稱:"+resp.errStr);
        if (resp.getType() == ConstantsAPI.COMMAND_PAY_BY_WX){//微信支付
            WeiXin weiXin=new WeiXin(3,resp.errCode,"");
            EventBus.getDefault().post(weiXin);
        }
        finish();
    }
}

其他方法都是固定寫法,在onResp中判斷如果是微信登入,就封裝一個WeiXin物件,然後傳送EventBus請求。這樣MainActivity的onEventMainThread就會接收到這個WeiXin物件。

WXPayEntryActivity記得在AndroidManifest.xml中註冊。

<activity
    android:exported="true"
    android:name=".wxapi.WXPayEntryActivity"/>

專案結構圖如下所示,從圖中我們看到軟體包名是com.ansen.shoenet。接收微信登入支付返回的Activity的包名必須是com.ansen.shoenet.wxapi。兩個activity的名字也是固定寫法。

簽名

微信登入分享支付都有一個簽名驗證,這個很麻煩,導致每次除錯都需要重新簽名。

首先用android studio生成一個正式的簽名檔案,簽名檔案是.jks結尾的,這個簽名檔案是你以後打線上包一直要用到的。然後用這個簽名檔案生成apk。這個時候我們的app就有了正式簽名。把正式簽名的apk傳送到手機上進行安裝。

並且下載一個簽名生成工具安裝,這個工具用於獲取安裝到手機的第三方應用簽名的apk包。微信官方下載地址:

https://res.wx.qq.com/open/zh_CN/htmledition/res/dev/download/sdk/Gen_Signature_Android2.apk

以上兩個app都安裝好了之後開啟從微信下載的那個app,軟體名字叫「GenSignature」,有一個輸入框,輸入我們軟體的包名,點選Get Signature按鈕.效果圖如下:

把那行綠色的16進位制數炒下來儲存到txt文字中。

微信sdk官網後臺配置

官網地址:

https://open.weixin.qq.com/

在微信sdk首頁,有個管理中心點選之後預設就是移動應用,如果還沒有建立移動應用就先建立一個,如果有了就點選當前的應用後面的檢視按鈕,就會進入應用詳細介面。

在應用詳細介面一直往下滾動,滾到最底部有個開發資訊。點選修改,進入修改介面,在修改介面滾動到最下面,效果圖如下所示:

首先我們在Android應用這裡打上勾,然後填寫應用簽名,這個簽名都是我之前要你們儲存到記事本上的那個值,包名就是app包名。點選儲存。

執行軟體

登入之後效果圖如下:

分享到朋友圈如下:

分享給朋友:

微信支付沒法測試,因為需要伺服器支援。

微信官方開發文件

我這偏文章只是針對現在微信的sdk版本接入,但是sdk是有可能變化的,版本變化、介面變化等。所以建議大家還是以官方文件為主。我的文章提供參考。

移動應用微信登入開發指南

https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1419317851&token=19192a54f13e8e7011ced8e4ce5b36b699629c4&lang=zh_CN

Android微信支付開發手冊

https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1419317784&token=19192a54f13e8e7011ced8e4ce5b36b699629c4&lang=zh_CN

注意事項

接入微信sdk有很多需要注意的地方,這裡我們最後再來做一個總結。

  • 微信登陸,分享,支付回撥的Activity包名跟類名一定要嚴格按照要求去寫
  • 接收回調的是Activity一定要在AndroidManifest.xml中中註冊
  • Constant裡面兩個常量的值要去微信申請並且建立應用才有的,這裡需要改成你們申請的值。
  • 需要訪問網路所以記得在AndroidManifest.xml中新增許可權
  • 呼叫微信的登陸,分享,支付你的安裝包一定要有簽名,簽名信息一定要跟你在微信官網上配置的簽名信息一致
  • 微信沒有客服支援.....如果出了問題看官方的Demo或者官方API
  • 微信SDK經常升級,如果你開發的時候有最新的就用最新的吧.....

最後的最後

你們直接執行我的demo是不行的,因為你們沒有的jks檔案,沒法簽名,並且原始碼中的appid跟secret被我修改過了,是不能使用的,但是你們可能又想看執行效果,所以我在專案下建了個apk資料夾,裡面放了一個可以測試微信登入分享的apk安裝包。