Jetpack Compose集成PSPDFKit打开PDF遇NonFragmentActivityException错误

错误原因 #

com.pspdfkit.jetpack.compose.NonFragmentActivityException 触发的核心原因是：PSPDFKit的Compose版DocumentView组件内部依赖Fragment相关的生命周期管理机制，它要求承载该组件的Activity必须是FragmentActivity（或其子类，比如AppCompatActivity）。如果你的Activity直接继承自ComponentActivity而非FragmentActivity体系，就会触发这个异常。

你可能存在的操作问题 #

1. 承载HomeScreen、PdfList这些Composable的主Activity，继承的是ComponentActivity而非AppCompatActivity/FragmentActivity。
2. 如果是点击卡片后启动新Activity显示PDF，这个新Activity同样没有继承FragmentActivity体系，却在其Compose内容中使用了DocumentView。

修复步骤 #

1. 修改Activity继承关系
   找到你启动Compose内容的Activity（比如MainActivity），将其继承类从ComponentActivity改为AppCompatActivity（推荐，包含Material主题支持）或FragmentActivity：

   // 错误写法
   class MainActivity : ComponentActivity() {
       override fun onCreate(savedInstanceState: Bundle?) {
           super.onCreate(savedInstanceState)
           setContent {
               HomeScreen()
           }
       }
   }
   
   // 正确写法
   class MainActivity : AppCompatActivity() {
       override fun onCreate(savedInstanceState: Bundle?) {
           super.onCreate(savedInstanceState)
           setContent {
               HomeScreen()
           }
       }
   }
   

2. 检查PDF预览Activity（如果有）
   若你是通过启动新Activity来打开PDF，确保该Activity同样继承AppCompatActivity/FragmentActivity，再在其setContent中使用DocumentView。

补充说明 #

PSPDFKit的Compose组件并非完全脱离传统Android组件体系，DocumentView底层依赖Fragment的视图容器来渲染PDF内容，因此必须依托FragmentActivity的上下文才能正常工作。只要确保承载组件的Activity属于FragmentActivity体系，这个异常就能解决。

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