Android魔方计时应用：动态添加按钮图标不显示问题求助

我正在开发一款魔方计时应用，需要在GraphSelectorActivity中动态添加带有图标的按钮到指定LinearLayout中。目前布局轮廓正常显示，但图标完全不显示，相关代码如下：

相关代码 #

1. Activity布局文件 (activity_graph_selector.xml) #

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".GraphSelectorActivity">

    <LinearLayout
        android:id="@+id/cube_sequence_container"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_marginStart="16dp"
        android:layout_marginTop="16dp"
        android:layout_marginEnd="16dp"
        android:orientation="vertical"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

    <Button
        android:id="@+id/btn_graphselector_home"
        android:layout_width="0dp"
        android:layout_height="wrap_content"
        android:layout_marginStart="16dp"
        android:layout_marginEnd="16dp"
        android:layout_marginBottom="16dp"
        android:background="@drawable/transparent_button_with_outline"
        android:text="@string/lbl_back"
        app:backgroundTint="@null"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

2. Activity代码 (GraphSelectorActivity.java) #

import androidx.appcompat.app.AppCompatActivity;

import android.os.Bundle;
import android.widget.LinearLayout;

import be.svdb.cubetimer.templates.CubeIcon;

public class GraphSelectorActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_graph_selector);

        String[] cubeSequences = HomeActivity.db.getSolvedCubeSequences();

        LinearLayout cubeSequenceContainer = findViewById(R.id.cube_sequence_container);
        for (String cubeSequence : cubeSequences) {
            cubeSequenceContainer.addView(new CubeSequenceButton(this, cubeSequence));
        }

    }
}

3. CubeSequenceButton布局 (cube_sequence_button.xml) #

<?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="wrap_content"
    android:orientation="horizontal"
    android:clickable="true"
    android:padding="5dp"
    android:background="@drawable/transparent_button_with_outline"
    tools:context=".CubeSequenceButton" />

4. CubeSequenceButton代码 (CubeSequenceButton.java) #

import android.content.Context;
import android.widget.LinearLayout;

import be.svdb.cubetimer.templates.CubeIcon;

public class CubeSequenceButton extends LinearLayout {
    private String cubeSequence;

    public CubeSequenceButton(Context context, String cubeSequence) {
        super(context);

        this.cubeSequence = cubeSequence;

        inflate(getContext(), R.layout.cube_sequence_button, this);

        for (String cube : cubeSequence.split(" ")) {
            addView(new CubeIcon(context, getResources().getIdentifier(
                    "icon_" + cube.toLowerCase(), "drawable", context.getPackageName())));
        }
    }
}

5. CubeIcon布局 (cube_icon.xml) #

<?xml version="1.0" encoding="utf-8"?>
<ImageView
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    tools:context=".templates.CubeIcon" />

6. CubeIcon代码 (CubeIcon.java) #

import android.content.Context;

import androidx.appcompat.widget.AppCompatImageView;

public class CubeIcon extends AppCompatImageView {
    public CubeIcon(Context context, int iconID) {
        super(context);

        setImageResource(iconID);
    }
}

排查与解决步骤 #

1. 验证图标资源ID是否有效 #

getResources().getIdentifier()找不到资源时会返回0，传入0给setImageResource()不会报错，但也不会显示内容。在CubeSequenceButton的循环中添加日志排查：

int iconResId = getResources().getIdentifier(
    "icon_" + cube.toLowerCase(), "drawable", context.getPackageName());
Log.d("CubeIcon", "Cube type: " + cube + ", Res ID: " + iconResId);
addView(new CubeIcon(context, iconResId));

如果日志显示ID为0，检查：

• 图标文件名是否严格符合icon_xxx格式（比如icon_3x3.png）
• 文件名是否为小写字母、数字、下划线的组合（Android资源文件名不允许大写和特殊字符）
• 图标是否放在正确的drawable目录（注意区分drawable-mdpi、drawable-v24等，确保至少有一个基础目录存在对应资源）

2. 为动态添加的View设置布局参数 #

直接添加CubeIcon到LinearLayout时，若未设置布局参数，可能导致View尺寸为0无法显示。修改CubeIcon构造函数：

public CubeIcon(Context context, int iconID) {
    super(context);
    setImageResource(iconID);
    // 设置LinearLayout布局参数，自定义宽高与间距
    LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(
        dpToPx(context, 40),
        dpToPx(context, 40)
    );
    params.setMargins(dpToPx(context, 5), 0, dpToPx(context, 5), 0);
    setLayoutParams(params);
}

// dp转px工具方法
private int dpToPx(Context context, int dp) {
    float density = context.getResources().getDisplayMetrics().density;
    return Math.round(dp * density);
}

3. 清理冗余布局文件（可选） #

当前CubeIcon继承自AppCompatImageView，代码中直接通过代码创建View，对应的cube_icon.xml并未被使用，可删除该布局文件避免混淆；若想保留布局，修改CubeIcon构造函数为inflate方式：

public CubeIcon(Context context, int iconID) {
    super(context);
    inflate(context, R.layout.cube_icon, this);
    ((AppCompatImageView) findViewById(R.id.cube_icon_image)).setImageResource(iconID);
}

同时修改cube_icon.xml添加ImageView的id：

<ImageView
    android:id="@+id/cube_icon_image"
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content" />

4. 验证图标资源本身 #

• 在Activity布局中直接添加ImageView引用图标（如android:src="@drawable/icon_3x3"），确认资源是否能正常显示，排除资源损坏问题
• 确保图标格式为Android支持的类型（PNG、JPG等，避免使用WebP等需要特定版本支持的格式）

内容的提问来源于stack exchange，提问作者Simon Van den Bossche