配置部分

1.官方sdk链接 https://developers.zalo.me/docs/sdk/android-sdk/tong-quan

2.zalo sdk主要提供的功能

• 集成zalo登录
• 获取用户信息，朋友列表
• 支持android4.3及以上

3.demo链接 https://gitlab.com/zalosdk/repositories

集成步骤

第一步：去Zolo后台创建应用  http://developers.zalo.me

　　需要提供包名，签名文件SHA1的Base64编码（也称为密钥散列）

//签名文件SHA1的Base64编码获取方法
public static String getApplicationHashKey(Context ctx) throws Exception {
    PackageInfo info = ctx.getPackageManager().getPackageInfo(ctx.getPackageName(), PackageManager.GET_SIGNATURES);
    for (Signature signature : info.signatures) {
        MessageDigest md = MessageDigest.getInstance("SHA");
        md.update(signature.toByteArray());
        String sig = Base64.encodeToString(md.digest(), Base64.DEFAULT).trim();
        if (sig.trim().length() > 0) {
            return sig;
        }
    }
}

第二步

在app的build.gradle文件配置

//仓库地址
repositories {
    maven {
        url "https://gitlab.com/api/v4/projects/50747855/packages/maven"
    }
}


//依赖
implementation "me.zalo:sdk-core:+"
implementation "me.zalo:sdk-auth:+"
implementation "me.zalo:sdk-openapi:+"

第三步

appId配置

//res下的strings.xml
<string name="appID"> 替换成你的appID </string>

//清单文件 AndroidManifest.xml
<!-- Required zalo app id -->
 <meta-data
      android:name="com.zing.zalo.zalosdk.appID"
      android:value="@string/appID" />

//android11及以上需要以下配置才能调用Zalo登录

　　<queries>
　　　　<package android:name="com.zing.zalo" />
　　</queries>

第四步

Application配置

方法一：没有自己的Application

<application android:name="com.zing.zalo.zalosdk.oauth.ZaloSDKApplication" />

方法二：如果有自己的Application

public class DemoApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        ZaloSDKApplication.wrap(this);//加入这一行就行了
    }
}

第五步

配置Zalo的web登录

//android12(api>=31)需要声明 android:exported="true"

<activity android:name="com.zing.zalo.zalosdk.oauth.BrowserLoginActivity" 
　　android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />

        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="zalo-{你的appID}" /> 
　　</intent-filter> 
</activity>

第六步

混淆配置

-keep class com.zing.zalo.\*\*{ \*; }
-keep enum com.zing.zalo.\*\*{ \*; }
-keep interface com.zing.zalo.\*\*{ \*; }

代码部分

登录部分

注意：

oauthCode 仅仅10分钟有效，所以活到到 oauthCode 后，立即获取 AccessToken 和 RefreshToken

AccessToken 是1小时有效，用与调用官方api

RefreshToken 是三个月有效，用于检查登录和登出

（这个还不是很懂）授权码   code challenge   和   code verifier

• code_challenge = Base64.encode(SHA-256.hash(ASCII(code_verifier))
• code_verifier 是任何字符串 数字

第一步

调用登录

//loginVia ：APP 只使用App进行登录 ； WEB 只使用Web进行登录 ；APP_OR_WEB 有app调app没app调web，最好选这个，不然产品会跳脚
ZaloSDK.Instance.authenticateZaloWithAuthenType (Activity, LoginVia loginVia, String codeChallenge, OAuthCompleteListener) //default extInfo null，不使用透传，一般服务端没啥要求的我们选这个

//ZaloSDK.Instance.authenticateZaloWithAuthenType (Activity, LoginVia loginVia, String codeChallenge, JSONObject extInfo, OAuthCompleteListener)

添加监听器

OAuthCompleteListener listener = new OAuthCompleteListener() {
    @Override
    public void onAuthenError(ErrorResponse errorResponse) {
        //授权失败
    }

    @Override
    public void onGetOAuthComplete(OauthResponse response) {
        String code = response.getOauthCode()
        //授权成功
    }
};

第二步

获取登录返回的数据

@Override
protected void onActivityResult(int reqCode, int resCode, Intent d) {
   super.onActivityResult(requestCode, resultCode, data);
   ZaloSDK.Instance.onActivityResult(this, reqCode, resCode, d);
}

获取Access Token部分

//ctx 应用的上下文； oacode 登录返回的 ；codeVerifier 见登录代码部分
ZaloSDK.Instance.getAccessTokenByOAuthCode( Context ctx,String oacode, String codeVerifier, new ZaloOpenAPICallback() {
    @Override
    public void onResult(JSONObject data) {
        int err = data.optInt("error");
        if (err == 0) {
            //clearOauthCodeInfo(); //clear used oacode

            access_token = data.optString("access_token");//访问官方api的token
            refresh_token = data.optString("refresh_token");//登录的token，过期了要重新登录，有效期3个月
            long expires_in = Long.parseLong(data.optString("expires_in"));//access_token的过期时间，默认3600s

            //Store data token in app cache
            ....  
        }
    }
});

获取Access Token部分2

因为access token的过期时间1小时，所以过期之后我们需要通过refresh token去重新获取

ZaloSDK.Instance.getAccessTokenByRefreshToken(Context ctx,String refresh_token, new ZaloOpenAPICallback() {
    @Override
    public void onResult(JSONObject data) {
        int err = data.optInt("error");
        if (err == 0) {
            access_token = data.optString("access_token");
            refresh_token = data.optString("refresh_token");//必须要重新保存它哦，因为通过refresh token获取access token只能使用一次，下一次请求必须使用这个新的
            long expires_in = Long.parseLong(data.optString("expires_in"));

            //Update new data token in app cache
            ....  
        }
    }
});

 验证Refresh Token是否有效

ZaloSDK.Instance.isAuthenticate(refreshToken, new ValidateCallback() {

    @Override
    public void onValidateComplete(boolean validated, int errorCode, OauthResponse oauthResponse) {
        if (validated) {
            // refreshToken còn hiệu lực...
            long expireTime = oauthResponse.getExpireTime();
        }

    }
});

登出

ZaloSDK.Instance.unauthenticate();

获取用户的基本信息（userId，userName，头像地址）

//field：id ， picture ，name
ZaloSDK.Instance.getProfile(
  Context ctx,String access_token, ZaloOpenAPICallback callback, String[] fields)

//返回示例

{
　　"id": "UserId",
　　"name": "User Name",
　　"picture": {
　　　　"data": {
　　　　　　"url": "User avatar url"
　　　　}
　　}
}

附录

Error Code错误码对照表