Android Studio-Kotlin中doOnLayout未执行致DialogFragment无法显示大图

我尝试创建一个DialogFragment用于展示点击缩略图后的高清大图，通过日志排查发现doOnLayout从未执行，IDE也没有抛出任何错误提示。试过添加延迟和post{}方法都没用，所有日志都显示图片相关信息正确，但对话框始终打不开，怀疑是布局创建有问题，附上代码求调试技巧和排查建议。

相关代码 #

1. PictureDialogFragment实现 #

class PictureDialogFragment: DialogFragment() {

    companion object {
        private const val ARG_IMAGE = "ARG_IMAGE"

        fun newInstance(photoFile: String?): PictureDialogFragment {
            val args = Bundle().apply { putString(ARG_IMAGE, photoFile) }
            return PictureDialogFragment().apply { arguments = args }
        }
    }

    @RequiresApi(Build.VERSION_CODES.TIRAMISU)
    override fun onCreateDialog(savedInstanceState: Bundle?): Dialog {
        return activity?.let { it ->
            val builder = AlertDialog.Builder(it)
            val inflater = requireActivity().layoutInflater
            val view = inflater.inflate(R.layout.dialog_photo, null)
            
            val photoFileName = arguments?.getString(ARG_IMAGE)
            Log.d("debug", "$photoFileName retrieved photofilename")

            val photoFile = photoFileName?.let {
                File(requireContext().applicationContext.filesDir, it)
            }
            Log.d("debug", "$photoFile retrieved photoFile")

            val imageView = view.findViewById(R.id.dialog_photo_viewer) as ImageView
            Log.d("debug", "$imageView retrieved imageview")

            updatePhotoForDialog(photoFile, imageView)
            builder.create()

        } ?: throw IllegalStateException("Activity cannot be null")
    }

2. updatePhotoForDialog方法 #

private fun updatePhotoForDialog(photoFile: File?, imageView: ImageView) {
    Log.d("debug", "updatePhotoForDialog called $imageView, $photoFile")
    if (photoFile != null && photoFile.exists()) {
        Log.d("debug", "photoFile called inside updatePhotoForDialog: $photoFile")
            imageView.doOnLayout {
                Log.d("debug", "doOnLayout: $photoFile")
                val scaledBitmap = getScaledBitmap(
                    photoFile.path,
                    imageView.width,
                    imageView.height
                )
                imageView.setImageBitmap(scaledBitmap)
                Log.d("debug", "setImageBitmap error")
            }
        } else {
            imageView.setImageBitmap(null)
            Log.d("debug", "updatePhotoForDialog error")
        }
    }
}

3. 调用DialogFragment的代码 #

plantPhoto.setOnClickListener{
                if (photoName?.isNotBlank() == true) {
                    Log.d("Debug", "photoName contains: $photoName")
                    photoName?.let { it1 ->
                        val dialogFragment = PictureDialogFragment.newInstance(it1)
                        dialogFragment.show(parentFragmentManager, "PictureDialogFragmentTag")
                    }
                }
            }

4. build.gradle配置 #

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("com.google.devtools.ksp")
    id("androidx.navigation.safeargs")
}

android {
    namespace = "com.example.greenspot"
    compileSdk = 33

    defaultConfig {
        applicationId = "com.example.greenspot"
        minSdk = 25
        targetSdk = 33
        versionCode = 1
        versionName = "1.0"

        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"

    }


    buildTypes {
        release {
            isMinifyEnabled = false
            proguardFiles(
                getDefaultProguardFile("proguard-android-optimize.txt"),
                "proguard-rules.pro"
            )
        }
    }
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_1_8
        targetCompatibility = JavaVersion.VERSION_1_8

    }
    kotlinOptions {
        jvmTarget = "1.8"
    }
    buildFeatures {
        viewBinding = true
    }
}

dependencies {
    implementation("com.github.bumptech.glide:glide:4.12.0")
    annotationProcessor("com.github.bumptech.glide:compiler:4.12.0")
    implementation("androidx.core:core-ktx:1.9.0")
    implementation("androidx.appcompat:appcompat:1.6.1")
    implementation("com.google.android.material:material:1.9.0")
    implementation("androidx.constraintlayout:constraintlayout:2.1.4")
    implementation("androidx.fragment:fragment-ktx:1.6.1")
    implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:2.4.1")
    implementation("androidx.recyclerview:recyclerview:1.2.1")
    testImplementation("junit:junit:4.13.2")
    androidTestImplementation("androidx.test.ext:junit:1.1.5")
    androidTestImplementation("androidx.test.espresso:espresso-core:3.5.1")
    debugImplementation ("androidx.fragment:fragment-testing:1.6.1")
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.1")
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.1")
    implementation("androidx.lifecycle:lifecycle-runtime-ktx:2.6.2")
    implementation("androidx.room:room-runtime:2.5.0")
    implementation("androidx.room:room-ktx:2.5.0")
    ksp("androidx.room:room-compiler:2.5.0")
    implementation("androidx.navigation:navigation-fragment-ktx:2.4.1")
    implementation("androidx.navigation:navigation-ui-ktx:2.4.1")

}

核心问题：对话框未关联布局 #

你创建了AlertDialog.Builder并inflate了布局，但没有把布局设置给Dialog，导致布局从未被添加到Dialog的视图树中，自然doOnLayout不会触发，对话框也不会正常显示。

修复步骤： #

在onCreateDialog中，调用builder.setView(view)将inflate的布局绑定到AlertDialog：

override fun onCreateDialog(savedInstanceState: Bundle?): Dialog {
    return activity?.let { it ->
        val builder = AlertDialog.Builder(it)
        val inflater = requireActivity().layoutInflater
        val view = inflater.inflate(R.layout.dialog_photo, null)
        
        // ... 原有获取图片、ImageView的代码 ...
        
        updatePhotoForDialog(photoFile, imageView)
        // 关键：把布局设置给Dialog
        builder.setView(view)
        builder.create()

    } ?: throw IllegalStateException("Activity cannot be null")
}

额外调试建议： #

• 检查dialog_photo.xml布局是否正确：确保ImageView的id是dialog_photo_viewer，且布局有合适的宽高设置（比如match_parent），避免视图尺寸为0导致逻辑不执行。
• 替换doOnLayout为viewTreeObserver.addOnGlobalLayoutListener做兼容性验证：

imageView.viewTreeObserver.addOnGlobalLayoutListener(object : ViewTreeObserver.OnGlobalLayoutListener {
    override fun onGlobalLayout() {
        // 记得移除监听避免重复触发
        imageView.viewTreeObserver.removeOnGlobalLayoutListener(this)
        Log.d("debug", "onGlobalLayout triggered")
        // 缩放图片逻辑
    }
})

• 验证Dialog是否真的创建：在builder.create()后添加日志，确认Dialog实例不为null。
• 尝试简化布局：暂时用带背景色的简单布局测试，排除复杂布局导致的加载问题。

内容的提问来源于stack exchange，提问作者Jamie McGrath