Android应用中PSPDFKit批注工具未显示问题求助

嘿，我仔细看了你的代码，发现几个关键问题导致批注工具没有出现，咱们一步步来修复：

1. 缺少触发批注模式的交互入口 #

你已经配置了批注相关的参数，也初始化了AnnotationCreationToolbar，但没有给用户提供打开批注工具的触发按钮——PSPDFKit不会自动显示批注工具栏，需要手动触发进入批注创建模式。

修复方案：添加顶部工具栏触发按钮 #

首先修改activity_pdf_kit_fragment_demo.xml，调整布局结构并添加顶部Toolbar：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    tools:context=".PdfKitFragmentDemo"
    tools:ignore="UnusedAttribute">

    <!-- 新增顶部Toolbar，用于触发批注模式 -->
    <androidx.appcompat.widget.Toolbar
        android:id="@+id/mainToolbar"
        android:layout_width="match_parent"
        android:layout_height="?attr/actionBarSize"
        android:background="?attr/colorPrimary" />

    <FrameLayout
        android:id="@+id/fragmentContainer"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:layout_weight="1" />

    <!-- 确保批注工具栏在Fragment上方显示 -->
    <com.pspdfkit.ui.toolbar.ToolbarCoordinatorLayout
        android:id="@+id/toolbarCoordinatorLayout"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />

</LinearLayout>

然后在PdfKitFragmentDemo.kt中添加工批注按钮的点击逻辑：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_pdf_kit_fragment_demo)
    
    // 设置顶部Toolbar
    val mainToolbar = findViewById<Toolbar>(R.id.mainToolbar)
    setSupportActionBar(mainToolbar)
    supportActionBar?.title = "PDF批注演示"
    
    // 添加工批注按钮到Toolbar
    mainToolbar.inflateMenu(R.menu.annotation_menu)
    mainToolbar.setOnMenuItemClickListener { menuItem ->
        when(menuItem.itemId) {
            R.id.action_start_annotation -> {
                // 触发进入自由文本批注模式（可替换为你需要的工具）
                pdfFragment.annotationManager?.enterAnnotationCreationMode(AnnotationTool.FREETEXT)
                true
            }
            else -> false
        }
    }
    
    // 原有的初始化代码...
    uri = Uri.parse("file:///android_asset/sample.pdf")
    toolbarCoordinatorLayout = findViewById(R.id.toolbarCoordinatorLayout)
    annotationCreationToolbar = AnnotationCreationToolbar(this)

    val configuration = PdfConfiguration.Builder()
        // 保持原有的配置不变...
        .build()

    pdfFragment = PdfFragment.newInstance(uri!!, configuration)
    supportFragmentManager
        .beginTransaction()
        .replace(R.id.fragmentContainer, pdfFragment)
        .commit();
    pdfFragment.addOnAnnotationCreationModeChangeListener(this)
}

创建对应的菜单文件res/menu/annotation_menu.xml：

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto">
    <item
        android:id="@+id/action_start_annotation"
        android:title="开启批注"
        app:showAsAction="always" />
</menu>

2. 确保AnnotationManager初始化完成 #

有时候Fragment的annotationManager可能还没初始化就调用方法，导致无响应。可以添加状态监听确保初始化完成：

pdfFragment.addOnAttachStateChangeListener(object : View.OnAttachStateChangeListener {
    override fun onViewAttachedToWindow(v: View) {
        // Fragment视图附着后，确认annotationManager可用
        pdfFragment.annotationManager?.let { manager ->
            // 可在这里预加载批注配置
        }
    }

    override fun onViewDetachedFromWindow(v: View) {}
})

3. 完善批注模式的回调逻辑 #

你的onChangeAnnotationCreationMode和onExitAnnotationCreationMode是空实现，补充逻辑处理工具栏的显示/隐藏：

override fun onChangeAnnotationCreationMode(controller: AnnotationCreationController) {
    // 切换批注工具时更新工具栏绑定
    annotationCreationToolbar.bindController(controller)
}

override fun onExitAnnotationCreationMode(controller: AnnotationCreationController) {
    // 退出批注模式时隐藏工具栏
    toolbarCoordinatorLayout.hideContextualToolbar()
}

做完这些修改后，点击顶部的“开启批注”按钮，就能看到你配置的批注工具栏了，试试自由文本、签名等工具是否正常工作。

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