Ir al contenido

Creazione di un'app mobile con IA

Tutorial passo dopo passo per costruire un'applicazione mobile nativa con intelligenza artificiale integrando l'API di Gemini utilizzando PNPM.

0letture

Questa guida pratica descrive la procedura di sviluppo completo per costruire un assistenti conversazionali di intelligenza artificiale mobile multi-piattaforma utilizzando React Native, Expo Router, il gestore di dipendenze PNPM e il nuovo SDK ufficiale di Google GenAI per connettersi all'API di Gemini.


L'obiettivo di questa sessione di apprendimento è implementare un'interfaccia mobile premium in stile chat che soddisfi i seguenti requisiti funzionali e di design:

  • Persistenza della Cronologia: Mantenere la memoria del dialogo interattivo in memoria locale reattiva.
  • Design Fluido: Un'intestazione con effetto vetro (Glassmorphism), bolle di conversazione arrotondate con contrasto asimmetrico e supporto per la tastiera virtuale del cellulare (KeyboardAvoidingView).
  • Integrazione Sicura: Accedere in modo sicuro all'API di Gemini utilizzando variabili d'ambiente in Expo.

Assicurati di essere nella directory radice del tuo progetto e installa il SDK di Google GenAI e le icone necessarie tramite PNPM:

Ventana de terminal
# Instalar el SDK oficial de Google Gen AI usando PNPM y Expo
pnpm expo install @google/genai
# Instalar iconos premium de forma ultra rápida
pnpm expo install lucide-react-native

Sicurezza in Produzione

Expo espone variabili d'ambiente che iniziano con EXPO_PUBLIC_ nella build finale del client. Assicurati di impostare dei limiti per la tua chiave API nella console di Google Cloud per prevenire abusi in produzione.


3. Configurazione delle Variabili d'Ambiente

Sección titulada «3. Configuración de Variables de Entorno»

Crea un file .env nella radice del tuo progetto per memorizzare le chiavi di accesso in modo sicuro:

# Clave API generada en Google AI Studio
EXPO_PUBLIC_GEMINI_API_KEY=AIzaSyA1B2C3D4E5...

Expo caricherà automaticamente questo file durante lo sviluppo e assocerà il token a process.env.EXPO_PUBLIC_GEMINI_API_KEY.


4. Implementazione del Codice Sorgente Principale

Sección titulada «4. Implementación del Código Fuente Principal»

Crea o sostituisci il file di percorso principale della tua applicazione (app/index.tsx o App.tsx) con il seguente design premium e codice reattivo ottimizzato:

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 entorno
const 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. Controllo del Progresso e Milestone di Esecuzione con PNPM

Sección titulada «5. Control de Progreso e Hitos de Ejecución con PNPM»
  • ✓ Installazione di SDK con PNPM: Integrato in modo istantaneo e sicuro.
  • ✓ Variabili .env (formato ini): Connessione sicura pronta e validata.
  • ✓ Design UI/UX: Flessibilità, supporto della tastiera e scorrimento automatico abilitati.
  • ✕ Distribuzione nelle Store (EAS Submit): In attesa di configurazione per la compilazione di produzione.