fix(apk): banner de AdMob en franja propia debajo de la WebView (guia AdMob, no superpuesto)

- MainActivity: raiz vertical (mainFrame=webview+progress arriba, bannerSlot abajo), el banner nunca tapa contenido
- BannerAdManager: el SMART_BANNER vive en el slot inferior; show/hide ocultan el slot completo

Author: wilson360-labs

apk/android/app/src/main/java/com/codehub/app/BannerAdManager.java

@@ -11,7 +11,9 @@
 import com.google.android.gms.ads.AdView;
 
 /**
- * Banner nativo de AdMob, anclado al fondo de la pantalla (sobre la WebView).
+ * Banner nativo de AdMob, en una franja PROPIA debajo de la WebView
+ * (recomendación de AdMob: el banner nunca se superpone al contenido).
+ * Se coloca dentro del contenedor inferior (bannerSlot) de MainActivity.
  *
  * Control desde JS (CodeHubBridge):
  *   CodeHubNative.showNativeBanner() / hideNativeBanner()
@@ -27,25 +29,28 @@ final class BannerAdManager {
     private static final String AD_UNIT_ID_BANNER = "ca-app-pub-3780093322926832/1968391001";
 
     private static AdView adView;
+    private static View slot;
 
     private BannerAdManager() {}
 
     static boolean hasUnitId() {
         return !AD_UNIT_ID_BANNER.contains("0000000000");
     }
 
-    /** Crea el banner (una sola vez) y lo ancla abajo, centrado. */
-    static void setup(final Activity activity, final FrameLayout root) {
-        if (adView != null || !hasUnitId() || !ConsentManager.canRequestAds()) return;
+    /** Crea el banner (una sola vez) dentro de la franja inferior reservada. */
+    static void setup(final Activity activity, final View bottomSlot) {
+        if (adView != null || bottomSlot == null || !hasUnitId() || !ConsentManager.canRequestAds()) return;
         try {
+            slot = bottomSlot;
             adView = new AdView(activity);
             adView.setAdUnitId(AD_UNIT_ID_BANNER);
             adView.setAdSize(AdSize.SMART_BANNER);
             FrameLayout.LayoutParams lp = new FrameLayout.LayoutParams(
                     ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.WRAP_CONTENT);
-            lp.gravity = android.view.Gravity.BOTTOM | android.view.Gravity.CENTER_HORIZONTAL;
-            root.addView(adView, lp);
+            lp.gravity = android.view.Gravity.CENTER_HORIZONTAL;
+            ((FrameLayout) bottomSlot).addView(adView, lp);
             adView.loadAd(new AdRequest.Builder().build());
+            bottomSlot.setVisibility(View.VISIBLE);
             Log.i(TAG, "banner configurado en APP_ID=" + adView.getAdUnitId());
         } catch (Throwable t) {
             Log.w(TAG, "banner setup error", t);
@@ -54,9 +59,11 @@ static void setup(final Activity activity, final FrameLayout root) {
 
     static void show() {
         if (adView != null) adView.setVisibility(View.VISIBLE);
+        if (slot != null) slot.setVisibility(View.VISIBLE);
     }
 
     static void hide() {
         if (adView != null) adView.setVisibility(View.GONE);
+        if (slot != null) slot.setVisibility(View.GONE);
     }
 }

apk/android/app/src/main/java/com/codehub/app/MainActivity.java

@@ -27,6 +27,7 @@
 import android.view.ViewGroup;
 import android.widget.FrameLayout;
 import android.widget.ProgressBar;
+import android.widget.LinearLayout;
 import android.content.res.ColorStateList;
 import android.graphics.Bitmap;
 import android.webkit.CookieManager;
@@ -69,6 +70,8 @@ public class MainActivity extends Activity {
     private FusedLocationProviderClient fusedLocation;
     private boolean backPressedOnce = false;
     private final Handler backHandler = new Handler(Looper.getMainLooper());
+    /** Franja inferior reservada para el banner de AdMob (nunca superpuesto al contenido). */
+    private FrameLayout bannerSlot;
 
     @SuppressLint("SetJavaScriptEnabled")
     @Override
@@ -102,19 +105,31 @@ protected void onCreate(Bundle savedInstanceState) {
         progressBar.setLayoutParams(pbParams);
         progressBar.setVisibility(View.GONE);
 
-        FrameLayout rootLayout = new FrameLayout(this);
+        // Estructura vertical (AdMob — banners SIEMPRE abajo, nunca sobre el
+        // contenido): mainFrame (webview + barra de progreso) arriba, banner abajo.
+        LinearLayout rootLayout = new LinearLayout(this);
+        rootLayout.setOrientation(LinearLayout.VERTICAL);
         rootLayout.setBackgroundColor(0xFF080810);
-        rootLayout.addView(swipeRefreshLayout, new FrameLayout.LayoutParams(
+
+        FrameLayout mainFrame = new FrameLayout(this);
+        mainFrame.addView(swipeRefreshLayout, new FrameLayout.LayoutParams(
             ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT));
-        rootLayout.addView(progressBar);
+        mainFrame.addView(progressBar);
+        rootLayout.addView(mainFrame, new LinearLayout.LayoutParams(
+            ViewGroup.LayoutParams.MATCH_PARENT, 0, 1f));
+
+        bannerSlot = new FrameLayout(this);
+        bannerSlot.setVisibility(View.GONE);
+        rootLayout.addView(bannerSlot, new LinearLayout.LayoutParams(
+            ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.WRAP_CONTENT));
 
         setContentView(rootLayout);
 
         try { setupStatusBar(); } catch (Throwable t) { crashLog("statusBar", t); }
         try { createNotificationChannels(); } catch (Throwable t) { crashLog("notifChannels", t); }
         try { requestAllPermissions(); } catch (Throwable t) { crashLog("permissions", t); }
         try { setupWebView(); } catch (Throwable t) { crashLog("webView", t); }
-        try { initAdMob(rootLayout); } catch (Throwable t) { crashLog("adMob", t); }
+        try { initAdMob(); } catch (Throwable t) { crashLog("adMob", t); }
         try { registerFCMToken(); } catch (Throwable t) { crashLog("fcm", t); }
         try { checkInternetAndLoad(); } catch (Throwable t) { crashLog("internet", t); }
 
@@ -133,11 +148,11 @@ protected void onCreate(Bundle savedInstanceState) {
     // Nada de AdMob se pide antes de que UMP resuelva el consentimiento
     // (EEE/UK/Canadá). Fuera de esas regiones lookup UMP resuelve inmediato
     // con canRequestAds=true y no se bloquea ningún anuncio.
-    private void initAdMob(final FrameLayout rootLayout) {
+    private void initAdMob() {
         ConsentManager.init(this, () -> {
             runOnUiThread(() -> {
                 if (!ConsentManager.canRequestAds()) return;
-                BannerAdManager.setup(MainActivity.this, rootLayout);
+                BannerAdManager.setup(MainActivity.this, bannerSlot);
                 RewardedAdManager.load(MainActivity.this);
                 InterstitialAdManager.load(MainActivity.this);
             });

docs/ADS-COMPLIANCE.md

@@ -69,11 +69,12 @@ apps salvo integraciones aprobadas; la app monetiza con AdMob, ver §2).
 - **Interstitial spam**: no mostrar intersticiales que bloqueen la UI sin interacción.
 - Clics propios en la app (usar **test ads** durante desarrollo, no ads reales).
 
-### Mejora recomendada (no urgente)
-El banner (`BannerAdManager`) se ancla sobre el FrameLayout raíz (cubre el borde
-inferior del WebView). Google prefiere que el banner NO solape contenido
-interactivo: idealmente la WebView debería quedar encima con padding inferior y
-el banner debajo (Layout vertical WebView+banner), o `WEBVIEW_PADDING` al mostrar.
+### Banner según guía de AdMob (implementado)
+`MainActivity` usa estructura vertical: **WebView arriba** (`mainFrame`, weight 1) y
+**franja inferior reservada** (`bannerSlot`) para el banner. `BannerAdManager`
+coloca el SMART_BANNER dentro de esa franja debajo del contenido; `show/hide`
+(desde JS) ocultan todo el slot → **el banner nunca se superpone a la UI**
+(patrón "recommended" de AdMob, no el "discouraged" que cubre contenido).
 
 ## 3) Cruzado (aplica en ambos)
 - Membresía y conflictos: no distributions de ads vía software (toolbars/ext) ni