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. Planejamento do Aplicativo
Sección titulada «1. Planificación de la Aplicación»O objetivo desta sessão de aprendizado é implementar uma interface móvel premium tipo chat que atenda aos seguintes requisitos funcionais e de design:
- Persistencia del Historial: Conservar la memoria del diálogo interactivo en memoria local reactiva.
- O design da interface é baseado em um efeito cristal (Glassmorphism), com burbujas de conversa redondas e contraste asimétrico, e suporta o teclado virtual do móvel (KeyboardAvoidingView).
- Integración Segura: Acceder de forma segura a la API de Gemini utilizando variables de entorno en Expo.
2. Instalação de Dependências de IA com 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-nativeSegurança em Produção
Expo expós variáveis de ambiente que comecem com EXPO_PUBLIC_ na compilação final do cliente. Certifique-se de restringir os limites da sua chave API na consola de Google Cloud para prevenir abusos em produção.
3. Configuração de Variáveis de Ambiente
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. Implementação do Código-Fonte 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. Controle de Progresso e Marcos de Execução com 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.

