Ir al contenido

AIを備えたモバイルアプリの作成

PNPMを活用したGemini APIへの統合を含む、ナティブモバイルアプリのステップバイステップチュートリアル。

0閲覧数

この実践的なガイドでは、Googleの新しい公式Google GenAI SDKを使用してGemini APIに接続するための、クロスプラットフォームのモバイル人工知能チャットアシスタントの開発手順をすべて詳しく説明します。React Native、Expo Router、PNPMの依存関係管理ツールを使用します。


この学習セッションの目的は、次の機能的およびデザイン要件を満たす高品質なチャット風モバイルインターフェースを実装することです:

  • 履歴の永続化: 反応性ローカルメモリにインタラクティブなダイアログの記憶を保持します。
  • フローのデザイン: ガラス効果(ガラスモーフィズム)のヘッダー、非対称なコントラストを持つラウンドされた会話バブル、およびモバイル仮想キーボードのサポート([PC_BLOCK_0])
  • セキュアな統合: Expoで環境変数を使用してGemini APIにセキュアにアクセスします。

2. PNPMによるAI依存関係のインストール

Sección titulada «2. Instalación de Dependencias de IA con PNPM»

プロジェクトのルートディレクトリにいることを確認し、PNPM経由でGoogle GenAI SDKと必要なアイコンをインストールしてください:

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

プロダクションでのセキュリティ

Expoは、クライアントの最終ビルド内でEXPO_PUBLIC_で始まる環境変数を公開します。本番環境での悪用を防ぐため、Google CloudコンソールでAPIキーの制限を設定してください。


アクセスキーを安全に保存するため、プロジェクトのルートに.envファイルを作成します:

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

Expoは開発中にこのファイルを自動的に読み込み、トークンをprocess.env.EXPO_PUBLIC_GEMINI_API_KEYに関連付けます。


アプリのメインルートファイル(app/index.tsxまたはApp.tsx)を作成または置き換え、以下のプレミアムなデザインと最適化されたリアクティブコードを使用してください:

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. PNPMによる進行状況の追跡と実行のマイルストーン

Sección titulada «5. Control de Progreso e Hitos de Ejecución con PNPM»
  • ✓ PNPMによるSDKインストール: 瞬時に安全に統合されました。
  • ✓ .env変数(ini形式): セキュアな接続が準備できており、検証されています。
  • ✓ UI/UXデザイン: フレキシビリティ、キーボードサポート、および自動スクロールが有効になっています。
  • ✕ Store Distribution (EAS Submit): プロダクションビルドの設定が保留中です。