Android 動態創建 RelativeLayout 與 ImageView 未顯示的修復

問題現象

代碼中動態創建 RelativeLayout 和 ImageView，設置圖片資源並添加關係，但在模擬器運行後介面空白，圖片未顯示。

原始代碼

RelativeLayout relativeLayout = new RelativeLayout(this);
RelativeLayout.LayoutParams lp = new RelativeLayout.LayoutParams(
    RelativeLayout.LayoutParams.WRAP_CONTENT,
    RelativeLayout.LayoutParams.WRAP_CONTENT
);
ImageView iv = new ImageView(this);
iv.setImageResource(R.drawable.freshface_mmm);
relativeLayout.addView(iv, lp);
// 缺少將 relativeLayout 添加到 Activity 視圖層級的代碼

根因分析

• 動態創建的 View 必須掛載到 Activity 的視圖層級樹中才會被渲染。
• 代碼僅創建了 RelativeLayout 並添加了 ImageView 作為其子 View，但未將 RelativeLayout 本身添加到任何父容器（如 setContentView() 的根 View、FrameLayout、或其他已掛載的 ViewGroup）。
• Android 繪製機制從 DecorView 開始遍歷視圖樹，未掛載的 View 及其子樹完全不會被測量、佈局、繪製。

解決方案

方案一：作為 Activity 內容視圖設置（最簡單）

// 在 onCreate 中
RelativeLayout relativeLayout = new RelativeLayout(this);
RelativeLayout.LayoutParams lp = new RelativeLayout.LayoutParams(
    RelativeLayout.LayoutParams.MATCH_PARENT, // 建議 MATCH_PARENT 填滿
    RelativeLayout.LayoutParams.MATCH_PARENT
);
ImageView iv = new ImageView(this);
iv.setImageResource(R.drawable.freshface_mmm);
// 設置 ImageView 在 RelativeLayout 中居中
RelativeLayout.LayoutParams ivLp = new RelativeLayout.LayoutParams(
    RelativeLayout.LayoutParams.WRAP_CONTENT,
    RelativeLayout.LayoutParams.WRAP_CONTENT
);
ivLp.addRule(RelativeLayout.CENTER_IN_PARENT, RelativeLayout.TRUE);
relativeLayout.addView(iv, ivLp);

// 關鍵：將 relativeLayout 設置為 Activity 的內容視圖
setContentView(relativeLayout, lp);

方案二：添加到現有佈局容器中（推薦，保留 XML 佈局）

XML 佈局 activity_main.xml：

<FrameLayout
    xmlns:android="https://schemas.android.com/apk/res/android"
    android:id="@+id/container"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

// 在 onCreate 中
setContentView(R.layout.activity_main);
FrameLayout container = findViewById(R.id.container);

RelativeLayout relativeLayout = new RelativeLayout(this);
FrameLayout.LayoutParams flp = new FrameLayout.LayoutParams(
    FrameLayout.LayoutParams.MATCH_PARENT,
    FrameLayout.LayoutParams.MATCH_PARENT
);

ImageView iv = new ImageView(this);
iv.setImageResource(R.drawable.freshface_mmm);
RelativeLayout.LayoutParams ivLp = new RelativeLayout.LayoutParams(
    RelativeLayout.LayoutParams.WRAP_CONTENT,
    RelativeLayout.LayoutParams.WRAP_CONTENT
);
ivLp.addRule(RelativeLayout.CENTER_IN_PARENT, RelativeLayout.TRUE);
relativeLayout.addView(iv, ivLp);

// 關鍵：添加到已掛載的容器中
container.addView(relativeLayout, flp);

方案三：使用 addContentView() 添加到 DecorView（不推薦常規使用）

addContentView(relativeLayout, new ViewGroup.LayoutParams(
    ViewGroup.LayoutParams.MATCH_PARENT,
    ViewGroup.LayoutParams.MATCH_PARENT
));

注意：addContentView() 將 View 直接添加到 DecorView（根視圖），位於 setContentView() 設置的視圖之上，常用於對話框、彈窗等覆蓋層，不適合作為主介面容器。

關鍵點總結

最佳實踐建議

• 優先使用 XML 定義靜態佈局結構，動態代碼僅處理數據綁定、列表項、條件性視圖。
• 動態創建 View 時，務必指定 LayoutParams（寬高、邊距、規則），否則默認 WRAP_CONTENT 可能導致顯示異常。
• 使用 ViewBinding 或 findViewById 獲取容器引用，避免硬編碼視圖層級。
• 複雜動態佈局考慮使用 RecyclerView + Adapter 或 Fragment 管理子視圖生命週期。

總結：動態創建的 View 必須顯式添加到已掛載的視圖樹中（通過 setContentView、container.addView 或 addContentView）才會顯示。缺少這一步是導致「代碼無錯但介面空白」的最常見原因。