just_audio_background与PsPdfKit集成时Android类型转换异常问题

问题分析 #

异常com.ryanheise.audioservice.AudioServiceActivity cannot be cast to androidx.fragment.app.FragmentActivity的核心原因是：just_audio_background默认要求使用的AudioServiceActivity继承自FlutterActivity，而非FragmentActivity子类，但PsPdfKit依赖FragmentActivity加载PDF相关组件。直接替换Manifest中的Activity类会破坏just_audio_background的初始化逻辑，导致编译失败。

解决方案 #

1. 自定义MainActivity并继承FlutterAppCompatActivity #

在Android项目的kotlin/[包名]/MainActivity.kt中修改代码：

import androidx.annotation.NonNull
import io.flutter.embedding.android.FlutterAppCompatActivity
import io.flutter.embedding.engine.FlutterEngine
import com.ryanheise.audioservice.AudioServicePlugin

class MainActivity : FlutterAppCompatActivity() {
    override fun configureFlutterEngine(@NonNull flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        // 绑定当前Activity到AudioServicePlugin
        AudioServicePlugin.setActivity(this)
    }
}

如果是Java项目，对应代码：

import androidx.annotation.NonNull;
import io.flutter.embedding.android.FlutterAppCompatActivity;
import io.flutter.embedding.engine.FlutterEngine;
import com.ryanheise.audioservice.AudioServicePlugin;

public class MainActivity extends FlutterAppCompatActivity {
    @Override
    public void configureFlutterEngine(@NonNull FlutterEngine flutterEngine) {
        super.configureFlutterEngine(flutterEngine);
        AudioServicePlugin.setActivity(this);
    }
}

2. 调整AndroidManifest.xml配置 #

确保主Activity指向自定义的MainActivity，同时保留AudioService的必要配置：

<activity
    android:name=".MainActivity"
    android:launchMode="singleTop"
    android:theme="@style/LaunchTheme"
    android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
    android:hardwareAccelerated="true"
    android:windowSoftInputMode="adjustResize">
    <intent-filter>
        <action android:name="android.intent.action.MAIN"/>
        <category android:name="android.intent.category.LAUNCHER"/>
    </intent-filter>
</activity>

<!-- 保留just_audio_background的Service配置 -->
<service android:name="com.ryanheise.audioservice.AudioService"
    android:foregroundServiceType="mediaPlayback" />

3. 统一AndroidX依赖版本 #

检查项目的build.gradle（项目级或模块级），确保所有AndroidX相关依赖使用一致的版本，避免Fragment库版本冲突：

dependencies {
    // 示例：统一Fragment版本
    implementation 'androidx.fragment:fragment-ktx:1.6.1'
    // 其他依赖...
}

验证 #

完成上述修改后重新编译Android项目：

• 类型转换异常会消失，因为MainActivity是FlutterAppCompatActivity（FragmentActivity的子类）
• just_audio_background通过AudioServicePlugin.setActivity(this)绑定到当前Activity，功能不受影响
• PsPdfKit可以正常加载Fragment相关组件

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