Erstellung einer mobilen App mit KI
Schritt-für-Schritt-Tutorial zum Aufbau einer nativen mobilen Anwendung mit künstlicher Intelligenz durch die Integration der Gemini-API unter Verwendung von PNPM.
Dieser praktische Leitfaden beschreibt das vollständige Entwicklungsverfahren zum Bau eines mobilen, KI-basierten Conversational Assistants mit mehreren Plattformen unter Verwendung von React Native, Expo Router, dem Abhängigkeits-Manager PNPM und dem neuen offiziellen SDK von Google GenAI zur Verbindung mit der Gemini-API.
1. App-Planung
Sección titulada «1. Planificación de la Aplicación»Das Ziel dieser Lerneinheit ist die Implementierung einer mobilen Premium-Chat-Oberfläche, die die folgenden funktionalen und gestalterischen Anforderungen erfüllt:
- Verlaufspersistenz: Speichern des interaktiven Dialoggedächtnisses im reaktiven lokalen Speicher.
- Fließendes Design: Ein Header mit Glaseffekt (Glassmorphism), abgerundete Chat-Blasen mit asymmetrischem Kontrast und Unterstützung für die mobile virtuelle Tastatur (
KeyboardAvoidingView). - Sichere Integration: Sicherer Zugriff auf die Gemini-API unter Verwendung von Umgebungsvariablen in Expo.
2. Installation von KI-Abhängigkeiten mit PNPM
Sección titulada «2. Instalación de Dependencias de IA con PNPM»Stellen Sie sicher, dass Sie sich im Stammverzeichnis Ihres Projekts befinden, und installieren Sie das Google GenAI SDK sowie die erforderlichen Icons über 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-nativeSicherheit in der Produktion
Expo stellt Umgebungsvariablen, die mit EXPO_PUBLIC_ beginnen, im finalen Client-Build bereit. Stellen Sie sicher, dass Sie die Einschränkungen Ihres API-Schlüssels in der Google Cloud Console festlegen, um Missbrauch in der Produktion zu verhindern.
3. Konfiguration von Umgebungsvariablen
Sección titulada «3. Configuración de Variables de Entorno»Erstelle eine Datei .env in der Wurzel deines Projekts, um die Zugriffsschlüssel sicher zu speichern:
# Clave API generada en Google AI StudioEXPO_PUBLIC_GEMINI_API_KEY=AIzaSyA1B2C3D4E5...Expo lädt diese Datei während der Entwicklung automatisch und verknüpft den Token mit process.env.EXPO_PUBLIC_GEMINI_API_KEY.
4. Implementierung des Hauptquellcodes
Sección titulada «4. Implementación del Código Fuente Principal»Erstelle oder ersetze die Hauptpfaddatei deiner Anwendung (app/index.tsx oder App.tsx) mit dem folgenden Premium-Design und optimiertem reaktivem Code:
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. Fortschrittskontrolle und Ausführungsmeilensteine mit PNPM
Sección titulada «5. Control de Progreso e Hitos de Ejecución con PNPM»- ✓ Installation von SDK mit PNPM: Sofortige und sichere Integration.
- ✓ .env-Variablen (ini-Format): Sichere Verbindung bereit und validiert.
- ✓ UI/UX-Design: Flexibilität, Tastaturunterstützung und automatisches Scrollen aktiviert.
- ✕ Verteilung in Stores (EAS Submit): Wartet auf Konfiguration für den Produktions-Build.

