如何实现Firebase应用中Google Play Services版本过低时的更新提示？

我之前在开发Firebase应用时也碰到过这个问题，直接崩溃的用户体验太差了，后来用Google官方的API实现了友好的更新提示，给你一步步讲怎么弄：

1. 添加必要依赖 #

首先在你的模块级build.gradle（或build.gradle.kts）中添加Google Play Services基础库的依赖，这个库提供了我们需要的版本检查工具类：

dependencies {
    // 建议使用最新稳定版，可在Google Maven仓库查看版本号
    implementation 'com.google.android.gms:play-services-base:18.2.0'
}

2. 编写版本检查逻辑 #

推荐在应用启动的第一个页面（比如闪屏页SplashActivity）做检查，这样能在应用核心功能初始化前拦截版本问题。核心是使用GoogleApiAvailability类来检测Play Services的状态：

Java 示例 #

import com.google.android.gms.common.GoogleApiAvailability;
import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.widget.Toast;

public class SplashActivity extends Activity {
    private static final int REQUEST_CODE_PLAY_SERVICES = 9001;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_splash);

        // 启动时立即检查Play Services版本
        checkGooglePlayServices();
    }

    private void checkGooglePlayServices() {
        GoogleApiAvailability apiAvailability = GoogleApiAvailability.getInstance();
        int resultCode = apiAvailability.isGooglePlayServicesAvailable(this);

        if (resultCode != GoogleApiAvailability.SUCCESS) {
            if (apiAvailability.isUserResolvableError(resultCode)) {
                // 弹出官方提供的对话框，引导用户更新/修复Play Services
                apiAvailability.getErrorDialog(this, resultCode, REQUEST_CODE_PLAY_SERVICES).show();
            } else {
                // 设备不支持Play Services，提示用户无法使用应用
                Toast.makeText(this, "你的设备不支持Google Play Services，无法使用本应用", Toast.LENGTH_LONG).show();
                finish();
            }
        } else {
            // 版本符合要求，进入主应用界面
            startMainActivity();
        }
    }

    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        if (requestCode == REQUEST_CODE_PLAY_SERVICES) {
            if (resultCode == RESULT_OK) {
                // 用户完成更新后，再次检查版本
                checkGooglePlayServices();
            } else {
                // 用户拒绝更新，提示无法使用应用
                Toast.makeText(this, "需要更新Google Play Services才能使用本应用", Toast.LENGTH_LONG).show();
                finish();
            }
        }
    }

    private void startMainActivity() {
        Intent intent = new Intent(this, MainActivity.class);
        startActivity(intent);
        finish();
    }
}

Kotlin 示例 #

import com.google.android.gms.common.GoogleApiAvailability
import android.app.Activity
import android.content.Intent
import android.os.Bundle
import android.widget.Toast

class SplashActivity : Activity() {
    private val REQUEST_CODE_PLAY_SERVICES = 9001

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_splash)

        checkGooglePlayServices()
    }

    private fun checkGooglePlayServices() {
        val apiAvailability = GoogleApiAvailability.getInstance()
        val resultCode = apiAvailability.isGooglePlayServicesAvailable(this)

        if (resultCode != GoogleApiAvailability.SUCCESS) {
            if (apiAvailability.isUserResolvableError(resultCode)) {
                apiAvailability.getErrorDialog(this, resultCode, REQUEST_CODE_PLAY_SERVICES)?.show()
            } else {
                Toast.makeText(this, "你的设备不支持Google Play Services，无法使用本应用", Toast.LENGTH_LONG).show()
                finish()
            }
        } else {
            startMainActivity()
        }
    }

    override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
        super.onActivityResult(requestCode, resultCode, data)
        if (requestCode == REQUEST_CODE_PLAY_SERVICES) {
            if (resultCode == RESULT_OK) {
                checkGooglePlayServices()
            } else {
                Toast.makeText(this, "需要更新Google Play Services才能使用本应用", Toast.LENGTH_LONG).show()
                finish()
            }
        }
    }

    private fun startMainActivity() {
        val intent = Intent(this, MainActivity::class.java)
        startActivity(intent)
        finish()
    }
}

3. 关键逻辑说明 #

• isGooglePlayServicesAvailable()：返回当前设备Play Services的状态码，SUCCESS表示版本符合要求
• isUserResolvableError()：判断当前错误是否可以通过用户操作修复（比如更新、启用Play Services）
• getErrorDialog()：生成官方标准的对话框，会自动处理跳转Play商店更新、启用服务等操作，不需要自己写跳转逻辑

注意事项 #

• 一定要在主线程执行检查和对话框显示操作，避免异常
• 如果是在Fragment中使用，要确保传递的上下文是关联的Activity，避免内存泄漏
• 官方对话框已经适配了不同场景（比如Play Services被禁用、需要更新等），尽量使用官方实现，保证和系统行为一致
• 如果你需要指定具体的最低Play Services版本，可以调用apiAvailability.getApkVersion(context)获取当前版本号，再和你需要的版本对比，但一般来说，依赖库会自动检查最低兼容版本，所以用isGooglePlayServicesAvailable()就足够了

内容的提问来源于stack exchange，提问作者DouglasNickson