Android line登录接入
最近做的Android海外项目需要接入line登录，但是网上搜索了一圈发现没有写得非常详实的中文文档参考，因此决定写一篇。
line是什么
LINE是韩国互联网集团NHN的日本子公司NHN Japan推出的一款即时通讯软件。全世界用于数亿用户，类似微信
接入前准备
- 手机连接外部网络(你懂的)
- 下载line apk并注册登录(可能需要下载apk的方式安装，除非你有google play)
- 可先下载官方demo体验，官方demo提供了测试的channelId，可以进行测试，具体文档参考：https://developers.line.biz/en/docs/android-sdk/try-line-login/
接入步骤
- 创建应用
到line开发者平台https://developers.line.biz/console/，注册账号，并添加provider，provider类似组织或公司，一般以公司表示创建，然后在此provider下创建一个新的channel，channel可以类比国内其他平台创建的应用，最终会得到一个channelID(即appID)，通过此channelID与应用关联。创建时选择类型：LINE Login ，根据提示逐个填入相关资料，这些资料都会在后面app调起的授权页面显示，可先尝试填充，后面更改。重点关注Package names和App types两个选项，App types选择web和App两个，即支持跳转app登录和跳转网页登录；
- 添加依赖
implementation 'com.linecorp:linesdk:lastest-version'
根据https://github.com/line/line-sdk-android，引入最新版本
- 跳转登录
接入登录官方提供了两种方式，内建登录按钮和自定义登录按钮。
-
内建登录按钮
官方提供的一个控件，视觉上应该是按照line的官方要求定义的，直接封装了登录相关的逻辑，com.linecorp.linesdk.widget.LoginButton，官方文档地址：https://developers.line.biz/en/docs/android-sdk/integrate-line-login/#adding-line-login-button。具体代码如下：
```java
// A delegate for delegating the login result to the internal login handler.
private LoginDelegate loginDelegate = LoginDelegate.Factory.create();
LoginButton loginButton = rootView.findViewById(R.id.line_login_btn);
// if the button is inside a Fragment, this function should be called.
loginButton.setFragment(this);
loginButton.setChannelId(channelIdEditText.getText().toString());
// configure whether login process should be done by Line App, or inside WebView.
loginButton.enableLineAppAuthentication(true);
// set up required scopes and nonce.
loginButton.setAuthenticationParams(new LineAuthenticationParams.Builder()
.scopes(Arrays.asList(Scope.PROFILE))
// .nonce("<a randomly-generated string>") // nonce can be used to improve security
.build()
);
loginButton.setLoginDelegate(loginDelegate);
loginButton.addLoginListener(new LoginListener() {
@Override
public void onLoginSuccess(@NonNull LineLoginResult result) {
Toast.makeText(getContext(), "Login success", Toast.LENGTH_SHORT).show();
}
@Override
public void onLoginFailure(@Nullable LineLoginResult result) {
Toast.makeText(getContext(), "Login failure", Toast.LENGTH_SHORT).show();
}
});
```
-
自定义登录按钮
基本都会根据自己的视觉UI添加按钮，官方也提供的文档入口：https://developers.line.biz/en/docs/android-sdk/integrate-line-login/#starting-login-activity 直接添加如下事件即可：
try{ // App-to-app login Intent loginIntent = LineLoginApi.getLoginIntent( view.getContext(), Constants.CHANNEL_ID, new LineAuthenticationParams.Builder() .scopes(Arrays.asList(Scope.PROFILE)) // .nonce("<a randomly-generated string>") // nonce can be used to improve security .build()); startActivityForResult(loginIntent, REQUEST_CODE); } catch(Exception e) { Log.e("ERROR", e.toString()); }
-
接收回调
在onActivityResult()方法中接受处理结果
LineLoginResult result = LineLoginApi.getLoginResultFromIntent(data); switch (result.getResponseCode()) { case SUCCESS: // Login successful String accessToken = result.getLineCredential().getAccessToken().getTokenString(); Intent transitionIntent = new Intent(this, PostLoginActivity.class); transitionIntent.putExtra("line_profile", result.getLineProfile()); transitionIntent.putExtra("line_credential", result.getLineCredential()); startActivity(transitionIntent); break; case CANCEL: // Login canceled by user Log.e("ERROR", "LINE Login Canceled by user."); break; default: // Login canceled due to other error Log.e("ERROR", "Login FAILED!"); Log.e("ERROR", result.getErrorData().toString()); }
后续根据接收到的accessToken与服务端进行交互验证。
注意点
- 授权页面点击“取消”或返回时返回的信息中的code值是AUTHENTICATION_AGENT_ERROR，而不是error，引入在官方代码示例上可以添加此case用于判断，为什么不进CANCEL，目前还没搞明白；
- 包名务必保证正确；
- 目前官方提供的其他如刷新token接口官方建议不手动去调用，只要后面有在调用接口，token会不断刷新续期；
常见错误
所有的错误第一时间检查网络是否正常，是否可正常打开连接line
-
登录唤起line时，提示”未知错误“
解决方案：检查line后台配置，重点看包名是否正确
