Android自定義RadioGroup類型轉換異常的解決方案：XML布局中正確引用自定義控件

異常現場

// Java 代碼
public class MyRadioGroup extends RadioGroup { ... }

// Activity 中
MyRadioGroup group = findViewById(R.id.radioGroup); // ❌ ClassCastException
// 錯誤信息：android.widget.RadioGroup cannot be cast to com.xxx.MyRadioGroup

根本原因

XML 布局文件中聲明的是父類標籤 ``，系統按父類實例化對象。運行時嘗試將父類實例強轉為子類，必然失敗（父類不可轉子類）。

解決方案：XML 中使用完整類名

錯誤寫法

<RadioGroup
    android:id="@+id/radioGroup"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" />

正確寫法

<com.xxx.widget.MyRadioGroup
    android:id="@+id/radioGroup"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" />

關鍵點： 標籤名必須為 完整包名 + 類名，系統會反射實例化你的子類，`findViewById` 直接返回子類型，無需強轉。

進階：自定義屬性支持

<!-- res/values/attrs.xml -->
<declare-styleable name="MyRadioGroup">
    <attr name="customColor" format="color" />
    <attr name="orientation" format="enum">
        <enum name="horizontal" value="0" />
        <enum name="vertical" value="1" />
    </attr>
</declare-styleable>

<!-- 布局中使用 -->
<com.xxx.widget.MyRadioGroup
    xmlns:app="https://schemas.android.com/apk/res-auto"
    android:id="@+id/radioGroup"
    app:customColor="#FF5722"
    app:orientation="horizontal" />

// Java 構造方法讀取屬性
public MyRadioGroup(Context context, AttributeSet attrs) {
    super(context, attrs);
    TypedArray a = context.obtainStyledAttributes(attrs, R.styleable.MyRadioGroup);
    int color = a.getColor(R.styleable.MyRadioGroup_customColor, Color.BLACK);
    int orientation = a.getInt(R.styleable.MyRadioGroup_orientation, HORIZONTAL);
    a.recycle();
    // 初始化邏輯...
}

常見誤區對比

總結

Android 視圖膨脹機制按 XML 標籤名實例化類。**自定義控件必須在 XML 中聲明完整類名**，系統才會創建子類實例。這是 View 系統的基礎契約，同理適用於所有繼承 `View`/`ViewGroup` 的自定義組件。