Creación de una App Móvil con IA
Tutorial paso a paso para construir una aplicación móvil nativa con inteligencia artificial integrando la API de Gemini utilizando PNPM.
Esta guía práctica detalla el procedimiento de desarrollo completo para construir un asistente conversacional de inteligencia artificial móvil multiplataforma utilizando React Native, Expo Router, el gestor de dependencias PNPM y el nuevo SDK oficial de Google GenAI para conectarse a la API de Gemini.
1. Planificación de la Aplicación
Sección titulada «1. Planificación de la Aplicación»El objetivo de esta sesión de aprendizaje es implementar una interfaz móvil premium tipo chat que cumpla con los siguientes requisitos funcionales y de diseño:
- Persistencia del Historial: Conservar la memoria del diálogo interactivo en memoria local reactiva.
- Diseño Fluido: Una cabecera con efecto cristal (Glassmorphism), burbujas de conversación redondeadas con contraste asimétrico y soporte para el teclado virtual del móvil (
KeyboardAvoidingView). - Integración Segura: Acceder de forma segura a la API de Gemini utilizando variables de entorno en Expo.
2. Instalación de Dependencias de IA con PNPM
Sección titulada «2. Instalación de Dependencias de IA con PNPM»Asegúrate de estar en el directorio raíz de tu proyecto e instala el SDK de Google GenAI y los iconos necesarios a través de PNPM:
# Instalar el SDK oficial de Google Gen AI usando PNPM y Expopnpm expo install @google/genai
# Instalar iconos premium de forma ultra rápidapnpm expo install lucide-react-nativeSeguridad en Producción
Expo expone variables de entorno que comiencen con EXPO_PUBLIC_ en la compilación final del cliente. Asegura restringir los límites de tu clave API en la consola de Google Cloud para prevenir abusos en producción.
3. Configuración de Variables de Entorno
Sección titulada «3. Configuración de Variables de Entorno»Crea un archivo .env en la raíz de tu proyecto para almacenar las claves de acceso de forma segura:
# Clave API generada en Google AI StudioEXPO_PUBLIC_GEMINI_API_KEY=AIzaSyA1B2C3D4E5...Expo cargará automáticamente este archivo durante el desarrollo y asociará el token a process.env.EXPO_PUBLIC_GEMINI_API_KEY.
4. Implementación del Código Fuente Principal
Sección titulada «4. Implementación del Código Fuente Principal»Crea o sustituye el archivo de ruta principal de tu aplicación (app/index.tsx o App.tsx) con el siguiente diseño premium y código reactivo optimizado:
import React, { useState, useRef } from 'react';import { StyleSheet, Text, View, TextInput, TouchableOpacity, FlatList, KeyboardAvoidingView, Platform, ActivityIndicator, SafeAreaView} from 'react-native';import { GoogleGenAI } from '@google/genai';import { Send, Bot, User, Trash2 } from 'lucide-react-native';
// Inicializar el cliente de IA con la clave de entornoconst ai = new GoogleGenAI({ apiKey: process.env.EXPO_PUBLIC_GEMINI_API_KEY });
interface Mensaje { id: string; role: 'user' | 'model'; text: string;}
export default function AppChat() { const [messages, setMessages] = useState<Mensaje[]>([]); const [input, setInput] = useState(''); const [loading, setLoading] = useState(false); const flatListRef = useRef<FlatList>(null);
const enviarMensaje = async () => { if (!input.trim() || loading) return;
const userText = input.trim(); setInput('');
// Crear ID único para el mensaje del usuario const nuevoMensajeUsuario: Mensaje = { id: Date.now().toString(), role: 'user', text: userText, };
const mensajesActualizados = [...messages, nuevoMensajeUsuario]; setMessages(mensajesActualizados); setLoading(true);
try { // Llamar al modelo de última generación optimizado para velocidad (Gemini 2.5 Flash) const response = await ai.models.generateContent({ model: 'gemini-2.5-flash', contents: userText, });
const modelText = response.text || 'Sin respuesta.';
setMessages(prev => [ ...prev, { id: (Date.now() + 1).toString(), role: 'model', text: modelText, } ]); } catch (error) { console.error(error); setMessages(prev => [ ...prev, { id: (Date.now() + 1).toString(), role: 'model', text: 'Error de conexión: Verifica tu clave de API o conexión a red.', } ]); } finally { setLoading(false); // Hacer scroll suave automático hacia el último mensaje enviado setTimeout(() => { flatListRef.current?.scrollToEnd({ animated: true }); }, 100); } };
const limpiarChat = () => { setMessages([]); };
return ( <SafeAreaView style={styles.container}> {/* Cabecera Premium */} <View style={styles.header}> <View style={styles.headerLeft}> <Bot size={24} color="hsl(142, 70%, 45%)" style={{ marginRight: 8 }} /> <Text style={styles.headerTitle}>Portelcore AI</Text> </View> <TouchableOpacity onPress={limpiarChat} style={styles.clearButton} activeOpacity={0.7}> <Trash2 size={18} color="#ef4444" /> </TouchableOpacity> </View>
{/* Área del Chat */} <FlatList ref={flatListRef} data={messages} keyExtractor={(item) => item.id} contentContainerStyle={styles.chatList} renderItem={({ item }) => ( <View style={[styles.bubbleWrapper, item.role === 'user' ? styles.bubbleUser : styles.bubbleModel]}> <View style={styles.bubbleHeader}> {item.role === 'user' ? ( <User size={12} color="#94a3b8" style={{ marginRight: 4 }} /> ) : ( <Bot size={12} color="hsl(142, 70%, 45%)" style={{ marginRight: 4 }} /> )} <Text style={styles.bubbleRoleText}>{item.role === 'user' ? 'Tú' : 'Asistente IA'}</Text> </View> <Text style={styles.bubbleText}>{item.text}</Text> </View> )} ListEmptyComponent={ <View style={styles.emptyContainer}> <Bot size={48} color="#475569" style={{ marginBottom: 12 }} /> <Text style={styles.emptyText}>Inicia un diálogo con tu asistente móvil de Inteligencia Artificial.</Text> </View> } />
{/* Indicador de carga */} {loading && ( <View style={styles.loadingContainer}> <ActivityIndicator size="small" color="hsl(142, 70%, 45%)" /> <Text style={styles.loadingText}>Pensando...</Text> </View> )}
{/* Barra de Entrada interactiva */} <KeyboardAvoidingView behavior={Platform.OS === 'ios' ? 'padding' : 'height'} keyboardVerticalOffset={Platform.OS === 'ios' ? 90 : 0} > <View style={styles.inputContainer}> <TextInput style={styles.textInput} placeholder="Escribe tu consulta aquí..." placeholderTextColor="#64748b" value={input} onChangeText={setInput} onSubmitEditing={enviarMensaje} /> <TouchableOpacity onPress={enviarMensaje} style={styles.sendButton} activeOpacity={0.8}> <Send size={18} color="#ffffff" /> </TouchableOpacity> </View> </KeyboardAvoidingView> </SafeAreaView> );}
const styles = StyleSheet.create({ container: { flex: 1, backgroundColor: '#0f172a', /* Fondo oscuro premium profundo */ }, header: { flexDirection: 'row', alignItems: 'center', justifyContent: 'space-between', paddingHorizontal: 16, paddingVertical: 14, borderBottomWidth: 1, borderBottomColor: 'rgba(255,255,255,0.06)', }, headerLeft: { flexDirection: 'row', alignItems: 'center', }, headerTitle: { fontSize: 18, fontWeight: 'bold', color: '#f8fafc', }, clearButton: { padding: 8, borderRadius: 8, backgroundColor: 'rgba(239,68,68,0.1)', }, chatList: { padding: 16, paddingBottom: 24, }, bubbleWrapper: { maxWidth: '85%', padding: 12, borderRadius: 12, marginBottom: 16, boxShadow: '0 2px 4px rgba(0,0,0,0.1)', }, bubbleUser: { alignSelf: 'flex-end', backgroundColor: '#1e293b', borderTopRightRadius: 2, }, bubbleModel: { alignSelf: 'flex-start', backgroundColor: '#1a3a35', /* Contraste verde jade oscuro muy premium */ borderTopLeftRadius: 2, }, bubbleHeader: { flexDirection: 'row', alignItems: 'center', marginBottom: 4, }, bubbleRoleText: { fontSize: 10, fontWeight: 'bold', color: '#94a3b8', textTransform: 'uppercase', }, bubbleText: { fontSize: 14, color: '#f1f5f9', lineHeight: 20, }, emptyContainer: { alignItems: 'center', justifyContent: 'center', marginTop: 100, paddingHorizontal: 32, }, emptyText: { fontSize: 14, color: '#64748b', textAlign: 'center', lineHeight: 22, }, loadingContainer: { flexDirection: 'row', alignItems: 'center', justifyContent: 'center', paddingVertical: 10, }, loadingText: { fontSize: 12, color: 'hsl(142, 70%, 45%)', marginLeft: 8, }, inputContainer: { flexDirection: 'row', alignItems: 'center', padding: 12, borderTopWidth: 1, borderTopColor: 'rgba(255,255,255,0.06)', backgroundColor: '#0f172a', }, textInput: { flex: 1, height: 44, backgroundColor: '#1e293b', borderRadius: 22, paddingHorizontal: 16, color: '#f8fafc', fontSize: 14, marginRight: 10, borderWidth: 1, borderColor: 'rgba(255,255,255,0.04)', }, sendButton: { width: 44, height: 44, borderRadius: 22, backgroundColor: 'hsl(142, 70%, 45%)', alignItems: 'center', justifyContent: 'center', },});5. Control de Progreso e Hitos de Ejecución con PNPM
Sección titulada «5. Control de Progreso e Hitos de Ejecución con PNPM»- ✓ Instalación de SDK con PNPM: Integrado de forma instantánea y segura.
- ✓ Variables .env (formato ini): Conexión segura lista y validada.
- ✓ Diseño UI/UX: Flexibilidad, soporte de teclado y Scroll automático habilitados.
- ✕ Distribución en Tiendas (EAS Submit): Pendiente de configuración para el compilado de producción.

