萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 整合新浪微博 SSO 授權:SDK 接入、授權流程與 Token 管理

SSO (Single Sign-On) 優勢

若手機已安裝新浪微博客戶端 (3.0+),直接喚起客戶端授權,**無需輸入帳密**,體驗極佳;未安裝則自動降級為 H5/OAuth2.0 網頁授權。

前置準備

  1. 微博開放平台創建應用,獲取 App Key、設定 回調頁 (如 `https://www.sina.com`)、包名簽名 (MD5)。
  2. 下載最新 Weibo SDK (AAR/JAR),放入 `libs/` 或依賴 Maven。
  3. Manifest 配置權限、組件:
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<application>
    <activity android:name="com.weibo.sdk.android.WeiboActivity"
        android:configChanges="keyboardHidden|orientation"
        android:windowSoftInputMode="adjustResize" />
    <!-- SDK 內部需要的組件 -->
</application>

核心授權代碼 (MainActivity)

public class MainActivity extends AppCompatActivity {
    private static final String APP_KEY = "966056985"; // 替換為你的 App Key
    private static final String REDIRECT_URL = "https://www.sina.com"; // 必須與後台一致
    
    private Weibo mWeibo;
    private SsoHandler mSsoHandler;
    private TextView tvInfo;
    private Button btnAuth, btnSso, btnCancel;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        
        mWeibo = Weibo.getInstance(APP_KEY, REDIRECT_URL);
        tvInfo = findViewById(R.id.tv_info);
        btnAuth = findViewById(R.id.btn_auth); // 傳統 OAuth
        btnSso = findViewById(R.id.btn_sso);   // SSO 授權
        btnCancel = findViewById(R.id.btn_cancel);

        // 檢查是否已有有效 Token
        Oauth2AccessToken token = AccessTokenKeeper.readAccessToken(this);
        if (token.isSessionValid()) {
            updateUI(token);
        }

        btnAuth.setOnClickListener(v -> mWeibo.authorize(this, new AuthListener()));
        btnSso.setOnClickListener(v -> {
            mSsoHandler = new SsoHandler(this, mWeibo);
            mSsoHandler.authorize(new AuthListener());
        });
        btnCancel.setOnClickListener(v -> {
            AccessTokenKeeper.clear(this);
            resetUI();
        });
    }

    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        // **關鍵**:SSO 回調必須轉發給 SsoHandler
        if (mSsoHandler != null) mSsoHandler.authorizeCallBack(requestCode, resultCode, data);
    }

    private class AuthListener implements WeiboAuthListener {
        @Override public void onComplete(Bundle values) {
            String tokenStr = values.getString("access_token");
            String expiresStr = values.getString("expires_in");
            Oauth2AccessToken token = new Oauth2AccessToken(tokenStr, expiresStr);
            if (token.isSessionValid()) {
                AccessTokenKeeper.keepAccessToken(MainActivity.this, token);
                updateUI(token);
                Toast.makeText(MainActivity.this, "授權成功", Toast.LENGTH_SHORT).show();
            }
        }
        @Override public void onWeiboException(WeiboException e) { showError(e.getMessage()); }
        @Override public void onError(WeiboDialogError e) { showError(e.getMessage()); }
        @Override public void onCancel() { Toast.makeText(MainActivity.this, "取消授權", Toast.LENGTH_SHORT).show(); }
    }

    private void updateUI(Oauth2AccessToken token) {
        btnAuth.setVisibility(View.GONE);
        btnSso.setVisibility(View.GONE);
        btnCancel.setVisibility(View.VISIBLE);
        String date = new SimpleDateFormat("yyyy/MM/dd HH:mm:ss", Locale.getDefault())
            .format(new Date(token.getExpiresTime()));
        tvInfo.setText("Access Token: " + token.getToken() + "\n有效期: " + date);
    }
    private void resetUI() { /* 重置按鈕可見性、清空文字 */ }
    private void showError(String msg) { Toast.makeText(this, "錯誤: " + msg, Toast.LENGTH_LONG).show(); }
}

Token 持久化工具

public class AccessTokenKeeper {
    private static final String PREF = "weibo_token", KEY_TOKEN = "token", KEY_EXPIRES = "expires";
    public static void keepAccessToken(Context ctx, Oauth2AccessToken token) {
        ctx.getSharedPreferences(PREF, MODE_PRIVATE).edit()
            .putString(KEY_TOKEN, token.getToken())
            .putLong(KEY_EXPIRES, token.getExpiresTime())
            .apply();
    }
    public static Oauth2AccessToken readAccessToken(Context ctx) {
        SharedPreferences sp = ctx.getSharedPreferences(PREF, MODE_PRIVATE);
        String token = sp.getString(KEY_TOKEN, "");
        long expires = sp.getLong(KEY_EXPIRES, 0);
        return new Oauth2AccessToken(token, String.valueOf(expires));
    }
    public static void clear(Context ctx) {
        ctx.getSharedPreferences(PREF, MODE_PRIVATE).edit().clear().apply();
    }
}

常見坑位

  • 包名/簽名不匹配:打包簽名必須與開放平台錄入一致 (測試簽名/正式簽名分開配置)。
  • 回調頁格式:必須為 `https://` 或 `https://` 開頭,不能用自定義 scheme。
  • onActivityResult 必須轉發:否則 SSO 回調失敗。
  • SDK 版本過舊:舊版不支援 Android 11+ 封裝可見性,需升級 SDK 或在 Manifest 加 ``。
copyright © 萬盛學電腦網 all rights reserved