准备工作

在使用移动应用接入钉钉登录之前，你需要完成以下准备工作：

• 搭建Android开发环境。
  
• 下载Android SDK。
  

实现流程

步骤一：创建钉钉应用

1. 登录开发者后台，打开应用列表页，点击应用进入应用详情页。
   
   
2. 在应用信息页面，获取应用的AppKey和AppSecret。
   
3. 在应用详情页，单击钉钉登录与分享，进入登录与分享页面。
   
4. 在接入登录栏，添加回调域名。
   

步骤二：搭建开发环境

Android Studio 环境下：

1. 在build.gradle文件中，指定仓库并添加如下依赖：
   
2. 在工程AndroidManifest.xml中添加声明：
   如需混淆，建议混淆文件中增加：
   

步骤三：发送请求到钉钉

AuthLoginParam.AuthLoginParamBuilder builder = AuthLoginParam.AuthLoginParamBuilder.newBuilder();
builder.appId(yourAppId);
builder.redirectUri(yourRedirectUri);
builder.responseType(responseType);
builder.scope(scope);
builder.nonce(nonce);
builder.state(state);
builder.prompt(prompt);
IDDAuthApi authApi = DDAuthApiFactory.createDDAuthApi(context, builder.build());
authApi.authLogin()

参数说明：

当前用户已安装钉钉，则跳转钉钉APP拉起授权登录页

说明 

第三步截图只在首次授权登录时出现。

当前用户未安装钉钉时，通过H5登录并授权

说明 

第三步截图只在首次授权登录时出现。

步骤四：接收授权结果

1. 在包名相应目录下新建ddauth，并新增DDAuthActivity：
2. 在工程AndroidManifest.xml中添加声明：
   
3. 在DDAuthActivity中接收回调：
   

步骤五：获取用户个人access_token

使用步骤四返回的authCode，调用获取用户token接口，换取用户个人access_token。

public class Test {public static com.aliyun.dingtalkoauth2_1_0.Client createClient() throws Exception {
Config config = new Config();
config.protocol = "https";
config.regionId = "central";return new com.aliyun.dingtalkoauth2_1_0.Client(config);
}public void getUserToken() throws Exception {
com.aliyun.dingtalkoauth2_1_0.Client client = Test.createClient();
GetUserTokenRequest getUserTokenRequest = new GetUserTokenRequest()
.setClientId("dingzxxxx") //第一步创建应用时获取的AppKey。
.setClientSecret("XyJONrxxxxx") //第一步创建应用时获取的AppSecret。
.setCode("18ec1db4xxxxx") //第四步获取的authCode。
.setGrantType("authorization_code");try {
GetUserTokenResponse userToken = client.getUserToken(getUserTokenRequest);
System.out.println(JSON.toJSONString(userToken));
} catch (TeaException err) {if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {// err 中含有 code 和 message 属性，可帮助开发定位问题
System.out.println(JSON.toJSONString(err));
}

} catch (Exception _err) {
TeaException err = new TeaException(_err.getMessage(), _err);if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {// err 中含有 code 和 message 属性，可帮助开发定位问题
System.out.println(JSON.toJSONString(err));

}

}
}
}

步骤六：获取用户个人信息

使用步骤五获取的用户个人access_token，调用获取用户通讯录个人信息接口，获取用户个人手机号、用户的钉钉昵称、头像URL、用户的个人邮箱等信息。

public class Test {public static com.aliyun.dingtalkcontact_1_0.Client createClient() throws Exception {
Config config = new Config();
config.protocol = "https";
config.regionId = "central";return new com.aliyun.dingtalkcontact_1_0.Client(config);
}public void getUserInfo() throws Exception {
com.aliyun.dingtalkcontact_1_0.Client client = Test.createClient();
GetUserHeaders getUserHeaders = new GetUserHeaders();
getUserHeaders.xAcsDingtalkAccessToken = "17e756exxxx";//第五步获取的个人用户Token。
try {
GetUserResponse response = client.getUserWithOptions("me", getUserHeaders, new RuntimeOptions());
System.out.println(JSON.toJSON(response));
} catch (TeaException err) {if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {// err 中含有 code 和 message 属性，可帮助开发定位问题
System.out.println(JSON.toJSONString(err));
}

} catch (Exception _err) {
TeaException err = new TeaException(_err.getMessage(), _err);if (!com.aliyun.teautil.Common.empty(err.code) && !com.aliyun.teautil.Common.empty(err.message)) {// err 中含有 code 和 message 属性，可帮助开发定位问题
System.out.println(JSON.toJSONString(err));

}

}

}
}