Configuration

Prérequis des plateformes et configuration des projets natifs pour iOS et Android. Guides associés : Modèle de repli Android, Disponibilité, Images.

Prérequis des plateformes

Configuration iOS

Les utilisateurs de CocoaPods n’ont besoin d’aucune configuration supplémentaire. Foundation Models et Image Playground sont des frameworks système disponibles automatiquement sur les appareils compatibles où Apple Intelligence est activé.

Pour les projets Capacitor utilisant Swift Package Manager, la CLI Capacitor actuelle génère CapApp-SPM/Package.swift avec une cible de déploiement iOS 18.0 et ne conserve pas la version mineure requise. Après chaque npx cap sync ios, modifiez la déclaration de plateforme en platforms: [.iOS("18.4")]. L’application d’exemple fournie automatise cette opération avec npm run cap:sync ; consultez example-app/scripts/sync-capacitor.mjs pour ce petit script qui échoue immédiatement en cas d’anomalie.

Appelez getAvailability() à l’exécution pour vérifier que le modèle textuel est prêt avant de créer des conversations ou de générer du texte. Vérifiez séparément getImageAnalysisAvailability() avant de fournir des images, car la disponibilité du texte et de la vision peut différer. Consultez Images pour les détails de l’analyse d’images.

Sur les versions d’iOS antérieures à 26, seul getAvailability() signale 'device-not-eligible' pour le LLM textuel. Les API textuelles et de conversation telles que createChat(), deleteChat(), generateText() et streamText() sont rejetées avec LOCAL_LLM_UNSUPPORTED. La génération d’images via generateImage() est disponible sur iOS 18.4+.

downloadModel() n’est pas disponible sur iOS — le système gère le modèle. Utilisez getAvailability() ou l’événement availabilityChange pour observer sa disponibilité.

Configuration Android

Le SDK Android minimal du plugin est 29, supérieur à la valeur par défaut actuelle de Capacitor (24). Mettez à jour android/variables.gradle dans votre application :

ext {
    minSdkVersion = 29
}

Gemini Nano est distribué via Google Play Services et doit être téléchargé sur l’appareil avant utilisation. Le modèle n’est pas inclus dans votre application.

Lorsque Gemini Nano est indisponible, les applications peuvent configurer explicitement un repli LiteRT-LM. Consultez Modèle de repli Android.

Vérifier la disponibilité et télécharger

Appelez getAvailability() pour examiner l’état actuel. Si l’état est downloadable, lancez le téléchargement avec downloadModel() et écoutez downloadProgress et/ou availabilityChange jusqu’à ce que l’état devienne available.

import { LocalLLM } from '@rdlabo/capacitor-local-llm';

const availabilityListener = await LocalLLM.addListener('availabilityChange', ({ status }) => {
  console.log('availability:', status);
});

const progressListener = await LocalLLM.addListener('downloadProgress', (event) => {
  if (event.progress != null) {
    console.log('download progress:', event.progress);
  } else if (event.downloadedBytes != null) {
    console.log('downloaded bytes:', event.downloadedBytes);
  }
});

const { status } = await LocalLLM.getAvailability();

if (status === 'downloadable') {
  await LocalLLM.downloadModel();
}

await availabilityListener.remove();
await progressListener.remove();

Configuration Web

Les navigateurs Chrome compatibles sur ordinateur génèrent du texte via la Prompt API intégrée. Consultez Configuration et limites du Web. Exécutez npm run dev dans example-app pour tester sur localhost.