Vytvorenie mobilnej aplikácie s AI
Krok za krokom návod na vytvorenie natívnej mobilnej aplikácie s umelou inteligenciou integrujúcou Gemini API pomocou PNPM.
Táto praktická príručka podrobne popisuje celý postup vývoja na zostavenie multiplatformového mobilného asistenta umelej inteligencie využívajúceho React Native, Expo Router, správcu závislostí PNPM a nový oficiálny SDK Google GenAI pre pripojenie k Gemini API.
1. Plánovanie aplikácie
Sección titulada «1. Planificación de la Aplicación»Cieľom tejto učebnej relácie je implementovať prémiovú mobilnú rozhranie typu chat, ktoré spĺňa nasledujúce funkčné a dizajnové požiadavky:
- Perzistencia histórie: Zachovať pamäť interaktívneho dialógu v reaktívnej lokálnej pamäti.
- Fluidný dizajn: Hlavička s kryštalickým efektom (Glassmorphism), zaoblené konverzačné bubliny s asymetrickým kontrastom a podpora pre virtuálnu klávesnicu mobilného zariadenia (
KeyboardAvoidingView). - Bezpečná integrácia: Bezpečný prístup k Gemini API pomocou premenných prostredia v Expo.
2. Inštalácia závislostí AI pomocou PNPM
Sección titulada «2. Instalación de Dependencias de IA con PNPM»Uistite sa, že ste v koreňovom adresári vášho projektu a nainštalujte Google GenAI SDK a potrebné ikony pomocou 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-nativeBezpečnosť vo výrobe
Expo vystavuje premenné prostredia, ktoré začínajú s EXPO_PUBLIC_ v konečnej zostave klienta. Obmedzte rozsah svojej API klávesy v konzole Google Cloud, aby ste zabránili zneužitiu vo výrobe.
3. Konfigurácia premenných prostredia
Sección titulada «3. Configuración de Variables de Entorno»Vytvorte súbor .env v koreňovom adresári vášho projektu pre bezpečné uloženie prístupových kľúčov:
# Clave API generada en Google AI StudioEXPO_PUBLIC_GEMINI_API_KEY=AIzaSyA1B2C3D4E5...Expo automaticky načítá tento súbor počas vývoja a priradí token k process.env.EXPO_PUBLIC_GEMINI_API_KEY.
4. Implementácia Hlavného Zdrojového Kódu
Sección titulada «4. Implementación del Código Fuente Principal»Vytvorte alebo nahraďte hlavný súbor trasy vašej aplikácie (app/index.tsx alebo App.tsx) s nasledujúcim prémiovým dizajnom a optimalizovaným reaktívnym kódom:
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. Kontrola Postupu a Etáp Výkonu s PNPM
Sección titulada «5. Control de Progreso e Hitos de Ejecución con PNPM»- ✓ Inštalácia SDK s PNPM: Integrácia okamžitá a bezpečná.
- ✓ Premenné .env (formát ini): Bezpečné pripojenie pripravené a overené.
- ✓ Dizajn UI/UX: Flexibilita, podpora klávesnice a automatické posúvanie povolené.
- ✕ Distribúcia v obchodoch (EAS Submit): Čaká na konfiguráciu pre produkčnú zostavu.

