Android Studio中Google Play许可分步教程及显式Intent错误求助

嘿，这个问题我之前踩过坑！报错的原因很明确：从Android 5.0（API 21）开始，Android系统要求绑定服务必须使用显式Intent，而Google官方的旧版许可示例用的是隐式Intent，所以才会抛出这个IllegalArgumentException。下面给你一份完整的分步教程，包含错误修复和可运行的示例代码：

一、前期准备工作 #

• 先在Google Play Console中创建你的应用，获取两个关键信息：应用包名和LICENSE_KEY（在应用的「应用完整性」→「应用许可」栏目下可以找到）
• 确保你的项目minSdkVersion至少设置为21（因为显式Intent是API 21+的强制要求）

二、添加许可库依赖 #

打开app模块的build.gradle（Module级别），在dependencies块中添加许可库依赖：

dependencies {
    implementation 'com.android.vending:licensing:1+'
}

点击Sync Now同步依赖，等待构建完成。

三、核心错误修复：改用显式Intent绑定服务 #

Google默认的LicenseChecker类使用隐式Intent绑定许可服务，我们需要自定义子类来修改这个逻辑，强制使用显式Intent：

1. 创建自定义许可检查器类 #

Kotlin版本：

import android.content.Context
import android.content.Intent
import com.android.vending.licensing.ILicensingService
import com.android.vending.licensing.LicenseChecker
import com.android.vending.licensing.Policy

class ExplicitLicenseChecker(
    context: Context,
    policy: Policy,
    licenseKey: String
) : LicenseChecker(context, policy, licenseKey) {

    override fun bindService() {
        val intent = Intent(ILicensingService::class.java.name)
        // 显式指定Google Play服务的包名（固定为com.android.vending）
        intent.setPackage("com.android.vending")
        if (mContext.packageManager.resolveService(intent, 0) != null) {
            mContext.bindService(intent, this, Context.BIND_AUTO_CREATE)
        } else {
            handleServiceConnectionError()
        }
    }
}

Java版本：

import android.content.Context;
import android.content.Intent;
import com.android.vending.licensing.ILicensingService;
import com.android.vending.licensing.LicenseChecker;
import com.android.vending.licensing.Policy;

public class ExplicitLicenseChecker extends LicenseChecker {

    public ExplicitLicenseChecker(Context context, Policy policy, String licenseKey) {
        super(context, policy, licenseKey);
    }

    @Override
    protected void bindService() {
        Intent intent = new Intent(ILicensingService.class.getName());
        // 显式指定Google Play服务的包名
        intent.setPackage("com.android.vending");
        if (getContext().getPackageManager().resolveService(intent, 0) != null) {
            getContext().bindService(intent, this, Context.BIND_AUTO_CREATE);
        } else {
            handleServiceConnectionError();
        }
    }
}

四、在Activity中实现许可验证逻辑 #

以你的MainPageActivity为例，完整实现验证流程：

1. 定义核心变量与回调 #

import android.os.Bundle
import android.provider.Settings
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity
import com.android.vending.licensing.AESObfuscator
import com.android.vending.licensing.LicenseCheckerCallback
import com.android.vending.licensing.ServerManagedPolicy

class MainPage : AppCompatActivity() {
    // 替换成你从Google Play Console获取的LICENSE_KEY
    private val LICENSE_KEY = "YOUR_LICENSE_KEY_HERE"
    private lateinit var licenseChecker: ExplicitLicenseChecker

    // 许可验证回调
    private val licenseCallback = object : LicenseCheckerCallback {
        override fun allow(reason: Int) {
            // 验证通过：正常显示应用内容
            runOnUiThread {
                Toast.makeText(this@MainPage, "许可验证通过，欢迎使用", Toast.LENGTH_SHORT).show()
                // 这里可以初始化主界面内容
            }
        }

        override fun dontAllow(reason: Int) {
            // 验证失败：引导用户购买或退出
            runOnUiThread {
                Toast.makeText(this@MainPage, "未检测到有效许可，请前往Google Play购买", Toast.LENGTH_LONG).show()
                // 跳转至应用的Google Play页面
                val intent = android.content.Intent(android.content.Intent.ACTION_VIEW).apply {
                    data = android.net.Uri.parse("market://details?id=${packageName}")
                    setPackage("com.android.vending")
                }
                startActivity(intent)
                finish()
            }
        }

        override fun applicationError(errorCode: Int) {
            // 验证出错：比如网络问题、服务不可用
            runOnUiThread {
                Toast.makeText(this@MainPage, "验证出错，错误码：$errorCode", Toast.LENGTH_SHORT).show()
            }
        }
    }

2. 初始化并启动验证 #

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

        // 创建许可策略：使用官方的ServerManagedPolicy，搭配AES混淆器
        val obfuscator = AESObfuscator(
            // 自定义混淆密钥（建议用随机生成的字节数组）
            byteArrayOf(0x12, 0x34, 0x56, 0x78, 0x90, 0xAB, 0xCD, 0xEF),
            packageName,
            // 获取设备唯一ID用于混淆
            Settings.Secure.getString(contentResolver, Settings.Secure.ANDROID_ID)
        )
        val policy = ServerManagedPolicy(this, obfuscator)

        // 初始化我们的显式许可检查器
        licenseChecker = ExplicitLicenseChecker(this, policy, LICENSE_KEY)
        // 启动许可验证
        licenseChecker.checkAccess(licenseCallback)
    }

3. 释放资源 #

override fun onDestroy() {
        super.onDestroy()
        // 销毁时释放许可检查器资源
        licenseChecker.onDestroy()
    }
}

五、添加必要权限 #

在AndroidManifest.xml中添加网络权限：

<uses-permission android:name="android.permission.INTERNET" />

六、测试注意事项 #

• 测试必须使用发布签名的APK，上传到Google Play Console的内部测试/封闭测试轨道，用指定的测试账号安装测试
• 调试签名的APK无法通过验证（因为和Play Console中注册的签名不匹配）
• 可以在Play Console的「应用许可」中添加测试账号，让这些账号跳过付费直接通过验证

这样修改后，那个Service Intent must be explicit的错误就会彻底消失，许可验证流程也能正常运行了。

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