Android line登录接入

Android line登录接入

最近做的Android海外项目需要接入line登录，但是网上搜索了一圈发现没有写得非常详实的中文文档参考，因此决定写一篇。

btn_base.png

line是什么

LINE是韩国互联网集团NHN的日本子公司NHN Japan推出的一款即时通讯软件。全世界用于数亿用户，类似微信

接入前准备

1. 手机连接外部网络(你懂的)
2. 下载line apk并注册登录(可能需要下载apk的方式安装，除非你有google play)
3. 可先下载官方demo体验，官方demo提供了测试的channelId，可以进行测试，具体文档参考：https://developers.line.biz/en/docs/android-sdk/try-line-login/

接入步骤

1. 创建应用

到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登录和跳转网页登录；

2. 添加依赖

implementation 'com.linecorp:linesdk:lastest-version'

根据https://github.com/line/line-sdk-android，引入最新版本

3. 跳转登录

接入登录官方提供了两种方式，内建登录按钮和自定义登录按钮。

• 内建登录按钮

  官方提供的一个控件，视觉上应该是按照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("") // 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("") // nonce can be used to improve security
                         .build());
              startActivityForResult(loginIntent, REQUEST_CODE);
  
          }
          catch(Exception e) {
              Log.e("ERROR", e.toString());
          }
  

4. 接收回调

   在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与服务端进行交互验证。

注意点

1. 授权页面点击“取消”或返回时返回的信息中的code值是AUTHENTICATION_AGENT_ERROR，而不是error，引入在官方代码示例上可以添加此case用于判断，为什么不进CANCEL，目前还没搞明白；
2. 包名务必保证正确；
3. 目前官方提供的其他如刷新token接口官方建议不手动去调用，只要后面有在调用接口，token会不断刷新续期；

常见错误

所有的错误第一时间检查网络是否正常，是否可正常打开连接line

1. 登录唤起line时，提示”未知错误“

   解决方案：检查line后台配置，重点看包名是否正确