@open-mova/cli 0.1.18 → 0.1.20

package/README.md

@@ -165,6 +165,30 @@ mova cap sync android
 mova cap sync
 ```
 
+En Android, el CLI aplica también los requisitos técnicos de los plugins
+incluidos por la shell: configura el repositorio AAR de Background Runner y
+eleva `minSdkVersion` a 28 cuando está instalado Local LLM. También añade la
+entrada obligatoria de Google Maps. Para usar mapas reales, define una clave
+restringida antes de sincronizar:
+
+```bash
+OPEN_MOVA_GOOGLE_MAPS_ANDROID_API_KEY=tu_clave mova cap sync android
+```
+
+Como alternativa, guarda `native.googleMaps.androidApiKey` en
+`mova.config.json`. Sin una clave configurada la aplicación sigue arrancando,
+pero Google Maps no estará operativo.
+
+```json
+{
+  "native": {
+    "googleMaps": {
+      "androidApiKey": "tu_clave"
+    }
+  }
+}
+```
+
 ### `mova cap open`
 
 Abre el proyecto nativo en Android Studio o Xcode.

package/dist/application/configuration.js

@@ -77,11 +77,32 @@ function validateApplicationConfiguration(value, configurationPath) {
             commit: value.shell.commit,
         };
     }
+    let native;
+    if (value.native !== undefined) {
+        if (!isRecord(value.native)) {
+            throw new Error(`${configurationPath} contiene una configuración nativa no válida.`);
+        }
+        if (value.native.googleMaps !== undefined) {
+            if (!isRecord(value.native.googleMaps) ||
+                typeof value.native.googleMaps.androidApiKey !== 'string') {
+                throw new Error(`${configurationPath} contiene una clave de Google Maps no válida.`);
+            }
+            native = {
+                googleMaps: {
+                    androidApiKey: value.native.googleMaps.androidApiKey,
+                },
+            };
+        }
+        else {
+            native = {};
+        }
+    }
     const microfrontends = value.microfrontends.map((entry) => validateMicrofrontend(entry, configurationPath));
     return {
         schemaVersion: 1,
         name: value.name,
         ...(shell ? { shell } : {}),
+        ...(native ? { native } : {}),
         microfrontends,
     };
 }

package/dist/commands/capacitor.js

@@ -1,5 +1,5 @@
 import { spawnSync } from 'node:child_process';
-import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { readApplicationConfiguration, requireApplicationRoot, } from '../application/configuration.js';
 import { localBinaryName, npmCommand, useCommandShell } from '../utils/platform.js';
@@ -12,7 +12,7 @@ export function registerCapacitorCommands(program) {
         const root = requireApplicationRoot(process.cwd());
         buildMobileShell(root);
         runCapacitor(root, ['add', selectedPlatform]);
-        configureNativePlatform(root, selectedPlatform);
+        configureNativePlatform(root, selectedPlatform, readApplicationConfiguration(root));
     });
     capacitor.command('sync [platform]')
         .description('Compila la shell y sincroniza sus assets y plugins nativos')
@@ -22,10 +22,10 @@ export function registerCapacitorCommands(program) {
         const selectedPlatform = platform ? parsePlatform(platform) : undefined;
         runCapacitor(root, ['sync', ...(selectedPlatform ? [selectedPlatform] : [])]);
         if (selectedPlatform) {
-            configureNativePlatform(root, selectedPlatform);
+            configureNativePlatform(root, selectedPlatform, readApplicationConfiguration(root));
         }
         else {
-            configureExistingPlatforms(root);
+            configureExistingPlatforms(root, readApplicationConfiguration(root));
         }
     });
     capacitor.command('open <platform>')
@@ -72,16 +72,83 @@ function isHttpsUrl(value) {
         return false;
     }
 }
-function configureExistingPlatforms(root) {
+function configureExistingPlatforms(root, configuration) {
     if (existsSync(join(root, 'android'))) {
-        configureNativePlatform(root, 'android');
+        configureNativePlatform(root, 'android', configuration);
     }
 }
-function configureNativePlatform(root, platform) {
+function configureNativePlatform(root, platform, configuration) {
     if (platform === 'android') {
+        configureMinimumAndroidSdk(root);
         configureBackgroundRunnerForAndroid(root);
+        configureGoogleMapsForAndroid(root, configuration);
     }
 }
+function configureGoogleMapsForAndroid(root, configuration) {
+    const packageJson = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'));
+    if (!packageJson.dependencies?.['@capacitor/google-maps'])
+        return;
+    const manifestPath = join(root, 'android', 'app', 'src', 'main', 'AndroidManifest.xml');
+    if (!existsSync(manifestPath)) {
+        throw new Error('No se encuentra AndroidManifest.xml para configurar Google Maps.');
+    }
+    const manifest = readFileSync(manifestPath, 'utf8');
+    const apiKeyMetadata = 'android:name="com.google.android.geo.API_KEY"';
+    if (!manifest.includes(apiKeyMetadata)) {
+        const applicationCloseTag = '</application>';
+        if (!manifest.includes(applicationCloseTag)) {
+            throw new Error('No se ha encontrado el elemento application en AndroidManifest.xml.');
+        }
+        const metadata = [
+            '        <meta-data',
+            `            ${apiKeyMetadata}`,
+            '            android:value="@string/open_mova_google_maps_api_key" />',
+        ].join('\n');
+        writeFileSync(manifestPath, manifest.replace(applicationCloseTag, `${metadata}\n    ${applicationCloseTag}`), 'utf8');
+    }
+    const valuesDirectory = join(root, 'android', 'app', 'src', 'main', 'res', 'values');
+    mkdirSync(valuesDirectory, { recursive: true });
+    const apiKey = process.env.OPEN_MOVA_GOOGLE_MAPS_ANDROID_API_KEY
+        ?? configuration.native?.googleMaps?.androidApiKey
+        // Google Maps aborta la aplicación si falta por completo esta entrada.
+        // El valor explícito permite arrancar; Maps seguirá requiriendo una clave real al usarse.
+        ?? 'OPEN_MOVA_GOOGLE_MAPS_API_KEY_NOT_CONFIGURED';
+    const resource = [
+        '<?xml version="1.0" encoding="utf-8"?>',
+        '<resources>',
+        `    <string name="open_mova_google_maps_api_key" translatable="false">${escapeXml(apiKey)}</string>`,
+        '</resources>',
+        '',
+    ].join('\n');
+    writeFileSync(join(valuesDirectory, 'open_mova_google_maps.xml'), resource, 'utf8');
+}
+function escapeXml(value) {
+    return value.replace(/[&<>"']/g, (character) => ({
+        '&': '&amp;',
+        '<': '&lt;',
+        '>': '&gt;',
+        '"': '&quot;',
+        "'": '&apos;',
+    })[character] ?? character);
+}
+function configureMinimumAndroidSdk(root) {
+    const packageJson = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'));
+    if (!packageJson.dependencies?.['@capacitor/local-llm'])
+        return;
+    const variablesPath = join(root, 'android', 'variables.gradle');
+    if (!existsSync(variablesPath)) {
+        throw new Error('No se encuentra android/variables.gradle para configurar Local LLM.');
+    }
+    const variables = readFileSync(variablesPath, 'utf8');
+    const minimumSdkPattern = /minSdkVersion\s*=\s*(\d+)/;
+    const currentMinimumSdk = Number(minimumSdkPattern.exec(variables)?.[1]);
+    if (!Number.isFinite(currentMinimumSdk)) {
+        throw new Error('No se ha encontrado minSdkVersion en android/variables.gradle.');
+    }
+    if (currentMinimumSdk >= 28)
+        return;
+    writeFileSync(variablesPath, variables.replace(minimumSdkPattern, 'minSdkVersion = 28'), 'utf8');
+}
 function configureBackgroundRunnerForAndroid(root) {
     const packageJson = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'));
     if (!packageJson.dependencies?.['@capacitor/background-runner'])

package/dist/types.d.ts

@@ -6,8 +6,16 @@ export interface OpenMovaApplicationConfiguration {
         readonly version: string;
         readonly commit: string;
     };
+    /** Configuración opcional de las capacidades nativas de la aplicación. */
+    readonly native?: NativeConfiguration;
     readonly microfrontends: readonly MicrofrontendConfiguration[];
 }
+export interface NativeConfiguration {
+    readonly googleMaps?: {
+        /** Clave de Android Maps. También puede venir de OPEN_MOVA_GOOGLE_MAPS_ANDROID_API_KEY. */
+        readonly androidApiKey?: string;
+    };
+}
 export interface MicrofrontendConfiguration {
     readonly name: string;
     readonly route: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mova/cli",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "description": "CLI para crear y mantener aplicaciones Open Mova",
   "license": "MIT",
   "author": "Open Mova contributors",