From c454b4aebf283ed96e3d362627a68ca727d0a626 Mon Sep 17 00:00:00 2001
From: FarizzDev <159558642+FarizzDev@users.noreply.github.com>
Date: Thu, 12 Mar 2026 07:17:53 +0800
Subject: [PATCH] Android export: add error message when ETC2/ASTC compression
 is not enabled

When `rendering/textures/vram_compression/import_etc2_astc` is disabled
in Project Settings, the Android export would silently fail with only a
generic "configuration errors" message, giving no indication of what
needed to be fixed.

This was especially problematic for headless/CI exports where there is
no visual feedback at all.
---
 platform/android/export/export_plugin.cpp | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/platform/android/export/export_plugin.cpp b/platform/android/export/export_plugin.cpp
index 0c1182f2cd..f87d8da872 100644
--- a/platform/android/export/export_plugin.cpp
+++ b/platform/android/export/export_plugin.cpp
@@ -3087,6 +3087,9 @@ bool EditorExportPlatformAndroid::has_valid_project_configuration(const Ref<Edit
 
 	if (!ResourceImporterTextureSettings::should_import_etc2_astc()) {
 		valid = false;
+		if (EditorNode::is_cmdline_mode()) {
+			err += TTR("ETC2/ASTC texture compression is required for Android export. In Project Settings, search for 'ETC2' in the search field, or enable 'Advanced Settings' and go to Rendering > Textures > VRAM Compression to enable 'Import ETC2 ASTC'.") + "\n";
+		}
 	}
 
 	bool gradle_build_enabled = p_preset->get("gradle_build/use_gradle_build");