OBB扩展包手动下载失效求助（自动下载正常）

我来帮你梳理这个OBB扩展包手动下载失效的问题，结合你的代码和日志信息，下面是几个关键的排查点和修复建议：

一、先解读日志里的关键信息 #

你的日志显示startResult: 2，这个值对应DownloaderClientMarshaller.STATE_PENDING，说明下载服务已经被启动，但还没有进入实际下载流程——大概率是服务绑定失败、权限缺失或者配置错误导致的。

二、核心排查与修复步骤 #

1. 确认AndroidManifest的服务与权限配置 #

这是最容易遗漏的点，必须确保以下内容已添加到AndroidManifest.xml中：

<!-- 注册SampleDownloaderService -->
<service
    android:name=".SampleDownloaderService"
    android:exported="false" />

<!-- 必要权限 -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!-- Android 10+ 如需兼容Scoped Storage，可添加这个权限（可选） -->
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />

2. 核对XAPKFile参数的准确性 #

你的xAPKS数组里的参数必须和Google Play后台上传的OBB文件完全一致：

• mFileVersion：必须等于上传OBB时对应的APK版本号（不是APP的版本名称，是版本代码）
• mFileSize：必须是OBB文件的精确字节数（可以通过文件属性查看，差1字节都会导致校验失败）

如果这两个参数错误，下载服务会直接判定"无需下载"或校验不通过，导致流程卡住。

3. 修复SampleDownloaderService的核心配置 #

确保你的SampleDownloaderService正确实现了以下方法，这是下载服务正常工作的关键：

public class SampleDownloaderService extends DownloaderService {
    @Override
    public String getPublicKey() {
        // 替换成你在Google Play控制台获取的应用公钥
        return "YOUR_GOOGLE_PLAY_APP_PUBLIC_KEY";
    }

    @Override
    public byte[] getSALT() {
        // 替换成随机生成的盐值（任意8位以上字节数组即可）
        return new byte[]{1, 2, 3, 4, 5, 6, 7, 8, 9, 10};
    }

    @Override
    public String getAlarmReceiverClassName() {
        // 必须指向你的SampleAlarmReceiver完整类名
        return SampleAlarmReceiver.class.getName();
    }
}

如果公钥错误，会直接导致授权失败，下载无法启动。

4. 适配Android版本的PendingIntent FLAG #

在Android 12及以上版本，PendingIntent.FLAG_UPDATE_CURRENT需要替换为兼容的FLAG，否则会导致服务绑定失败：

// 修改PendingIntent的创建代码
int pendingFlag = Build.VERSION.SDK_INT >= Build.VERSION_CODES.S 
    ? PendingIntent.FLAG_IMMUTABLE 
    : PendingIntent.FLAG_UPDATE_CURRENT;
PendingIntent pendingIntent = PendingIntent.getActivity(this, 0, notifierIntent, pendingFlag);

5. 添加动态权限申请（Android 6+） #

Android 6及以上版本需要动态申请存储权限，否则无法读写OBB文件，你可以在SplashActivity中添加权限申请逻辑：

private static final int REQUEST_STORAGE_PERMISSION = 1001;

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

    // 先检查权限
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        if (checkSelfPermission(Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
            requestPermissions(new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, REQUEST_STORAGE_PERMISSION);
            return;
        }
    }

    // 权限通过后再执行OBB检查逻辑
    checkExpansionFiles();
}

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == REQUEST_STORAGE_PERMISSION) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            checkExpansionFiles();
        } else {
            Toast.makeText(this, "需要存储权限才能下载扩展文件", Toast.LENGTH_SHORT).show();
            finish();
        }
    }
}

// 将原来的OBB检查逻辑封装到这个方法里
private void checkExpansionFiles() {
    if (!expansionFilesDelivered()) {
        // 原来的下载启动代码...
    } else {
        // 跳转到主页面...
    }
}

6. 调试服务是否正常启动 #

在SampleDownloaderService的onCreate方法中添加日志，确认服务是否被正确启动：

@Override
public void onCreate() {
    super.onCreate();
    Log.e("DownloadService", "SampleDownloaderService 已启动");
}

如果这条日志没有出现在Logcat中，说明服务没有被正确注册或启动，需要重新检查Manifest配置。

三、额外测试建议 #

• 测试时先清除APP数据，确保之前的OBB缓存被清空
• 切换网络环境（WiFi/移动数据）测试，排除网络限制问题
• 检查Logcat中是否有DownloaderService相关的错误日志（比如授权失败、文件路径错误等）

内容的提问来源于stack exchange，提问作者صلي علي محمد - Atef Farouk