自定义PDF View无法识别及嵌入Fragment的技术疑问

我来帮你一步步拆解并解决这两个问题，顺便聊聊开发中需要注意的细节和重写方法：

一、自定义View在布局中无法被识别的问题 #

出现这个情况通常有几个常见原因，你可以逐一排查：

1. 确保XML中使用了正确的全限定类名
   比如你的类在com.yourpackage包下，布局里要完整写出包名+类名：

   <com.yourpackage.PDF
       android:layout_width="match_parent"
       android:layout_height="match_parent"/>
   

   注意包名、类名的大小写和拼写都不能出错。

2. 补充完整的构造函数
   Android布局系统加载自定义View时，可能会调用三个参数的构造函数，所以你需要补充这个重载：

   public PDF(Context context, @Nullable AttributeSet attrs, int defStyleAttr) {
       super(context, attrs, defStyleAttr);
       // 复用属性解析逻辑，建议抽成私有方法避免重复代码
       parseAttributes(attrs, defStyleAttr);
   }
   
   private void parseAttributes(@Nullable AttributeSet attrs, int defStyleAttr) {
       TypedArray a = getContext().getTheme().obtainStyledAttributes(
           attrs, R.styleable.PDF, defStyleAttr, 0);
       try{
           // 这里后面会说明，建议把background的format改成reference
           mBackgroundRes = a.getResourceId(R.styleable.PDF_background, R.drawable.pdf);
           setBackgroundResource(mBackgroundRes);
       } finally {
           a.recycle();
       }
   }
   

3. 添加自定义属性的命名空间
   在布局根节点添加命名空间，才能正确使用自定义属性：

   xmlns:app="http://schemas.android.com/apk/res-auto"
   

   之后使用自定义属性就可以写成app:background="@drawable/xxx"，避免和系统的android:background冲突。

4. 修复styleable的属性格式问题
   你定义的background属性format是integer，但背景资源属于引用类型，应该改成reference：

   <declare-styleable name="PDF">
       <attr name="background" format="reference"/>
       <attr name="contentDescription" format="string"/>
   </declare-styleable>
   

   对应代码里用getResourceId获取资源，而不是getInteger，这样才能正确读取drawable资源。

二、在自定义View中加载Fragment的方案 #

首先要明确：普通View类不能直接承载Fragment，Fragment需要依附于FragmentManager，并且需要一个ViewGroup作为容器。所以你需要调整自定义View的父类：

1. 让自定义View继承ViewGroup（推荐FrameLayout） #

FrameLayout是最简单的容器布局，适合作为Fragment的载体。修改你的类定义：

public class PDF extends FrameLayout {
    private int mBackgroundRes;
    private static final String PDF_FRAGMENT_TAG = "pdf_fragment";

    public PDF(Context context) {
        super(context);
        init(null, 0);
    }

    public PDF(Context context, @Nullable AttributeSet attrs) {
        super(context, attrs);
        init(attrs, 0);
    }

    public PDF(Context context, @Nullable AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);
        init(attrs, defStyleAttr);
    }

    private void init(@Nullable AttributeSet attrs, int defStyleAttr) {
        // 解析自定义属性
        parseAttributes(attrs, defStyleAttr);

        // 加载Fragment（避免编辑器报错，加isInEditMode判断）
        if (!isInEditMode()) {
            loadTargetFragment();
        }
    }

    private void parseAttributes(@Nullable AttributeSet attrs, int defStyleAttr) {
        TypedArray a = getContext().getTheme().obtainStyledAttributes(
                attrs, R.styleable.PDF, defStyleAttr, 0);
        try{
            mBackgroundRes = a.getResourceId(R.styleable.PDF_background, R.drawable.pdf);
            setBackgroundResource(mBackgroundRes);
            // 处理contentDescription属性
            String desc = a.getString(R.styleable.PDF_contentDescription);
            if (desc != null) {
                setContentDescription(desc);
            }
        } finally {
            a.recycle();
        }
    }

    private void loadTargetFragment() {
        // 注意：如果View在Fragment中使用，要用getChildFragmentManager()
        FragmentManager fragmentManager = ((FragmentActivity) getContext()).getSupportFragmentManager();
        Fragment existingFragment = fragmentManager.findFragmentByTag(PDF_FRAGMENT_TAG);
        if (existingFragment == null) {
            // 替换成你的目标Fragment实例
            PDFContentFragment fragment = new PDFContentFragment();
            fragmentManager.beginTransaction()
                    .add(this.getId(), fragment, PDF_FRAGMENT_TAG)
                    .commit();
        }
    }

    // 可选：提供方法让外部传入FragmentManager，适配Fragment内的场景
    public void setFragmentManager(FragmentManager fragmentManager) {
        if (!isInEditMode()) {
            Fragment existingFragment = fragmentManager.findFragmentByTag(PDF_FRAGMENT_TAG);
            if (existingFragment == null) {
                PDFContentFragment fragment = new PDFContentFragment();
                fragmentManager.beginTransaction()
                        .add(this.getId(), fragment, PDF_FRAGMENT_TAG)
                        .commit();
            }
        }
    }
}

2. 关键注意事项 #

• 确保当前Context是FragmentActivity或AppCompatActivity，这样才能获取到SupportFragmentManager；如果View嵌套在Fragment里，一定要用getChildFragmentManager()，避免生命周期冲突。
• 加入isInEditMode()判断，防止Android Studio布局编辑器因为Fragment加载逻辑崩溃。
• 给Fragment设置Tag，方便后续查找、更新或移除。

三、需要重写的View方法 #

根据你的需求，这些方法可能需要重点关注：

• 构造函数：必须实现至少两个参数的构造（Context, AttributeSet），建议实现三个参数的重载，支持默认样式属性。
• onMeasure：如果需要自定义View的尺寸规则（比如强制宽高比），可以重写这个方法计算并设置测量尺寸：

  @Override
  protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
      // 示例：设置宽高比为4:3
      int width = MeasureSpec.getSize(widthMeasureSpec);
      int height = (int) (width * 3f / 4f);
      setMeasuredDimension(width, height);
  }
  

• onAttachedToWindow：如果需要在View依附到窗口后做初始化工作（比如加载Fragment），可以在这里执行，确保Context完全可用。
• onDetachedFromWindow：如果有需要释放的资源（比如Fragment的监听、异步任务），在这里做清理工作。

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