Tvorba mobilní aplikace s AI
Krok za krokem návod, jak postavit nativní mobilní aplikaci s umělou inteligencí pomocí integrace Gemini API s využitím PNPM.
Tento praktický průvodce podrobně popisuje kompletní vývojový proces pro tvorbu multiplatformního mobilního konverzačního asistenta umělé inteligence s využitím React Native, Expo Router, správce závislostí PNPM a nového oficiálního SDK od Google GenAI pro připojení k Gemini API.
1. Plánování aplikace
Sección titulada «1. Planificación de la Aplicación»Cílem této vzdělávací lekce je implementovat prémiové mobilní rozhraní typu chat, které splňuje následující funkční a designové požadavky:
- Trvalost historie: Udržování paměti interaktivního dialogu v reaktivní lokální paměti.
- Plynulý design: Hlavička s efektem skla (Glassmorphism), zaoblené konverzační bubliny s asymetrickým kontrastem a podpora pro mobilní virtuální klávesnici (
KeyboardAvoidingView). - Bezpečná Integrace: Bezpečný přístup k API Gemini pomocí environmentálních proměnných v Expo.
2. Instalace závislostí AI pomocí PNPM
Sección titulada «2. Instalación de Dependencias de IA con PNPM»Ujistěte se, že jste v kořenovém adresáři vašeho projektu a nainstalujte Google GenAI SDK a potřebné ikony přes 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čnost v produkci
Expo exponuje v konečné buildu klienta proměnné prostředí začínající EXPO_PUBLIC_. Ujistěte se, že omezíte limity svého API klíče v konzoli Google Cloud, abyste zabránili zneužití v produkci.
3. Konfigurace proměnných prostředí
Sección titulada «3. Configuración de Variables de Entorno»Vytvořte soubor .env v kořenovém adresáři svého projektu pro bezpečné uložení přístupových klíčů:
# Clave API generada en Google AI StudioEXPO_PUBLIC_GEMINI_API_KEY=AIzaSyA1B2C3D4E5...Expo tento soubor během vývoje automaticky načte a přiřadí token k process.env.EXPO_PUBLIC_GEMINI_API_KEY.
4. Implementace hlavního zdrojového kódu
Sección titulada «4. Implementación del Código Fuente Principal»Vytvořte nebo nahraďte hlavní soubor trasy vaší aplikace (app/index.tsx nebo App.tsx) následujícím prémiovým designem a optimalizovaným reaktivním kódem:
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 milníky spuštění pomocí PNPM
Sección titulada «5. Control de Progreso e Hitos de Ejecución con PNPM»- ✓ Instalace SDK pomocí PNPM: Okamžitě a bezpečně integrováno.
- ✓ Proměnné .env (formát ini): Bezpečné připojení je připraveno a ověřeno.
- ✓ Návrh UI/UX: Flexibilita, podpora klávesnice a automatické posouvání jsou povoleny.
- ✕ Distribuce do obchodů (EAS Submit): Čeká na konfiguraci pro produkční sestavení.

