API mobile

Les fonctionnalités mobiles natives sont exposées de deux manières :

• Gestionnaires propres à chaque plateforme — application.IOS (dans les fichiers //go:build ios) et application.Android (dans les fichiers //go:build android). Utilisez-les pour tout ce qui est propre à une plateforme. Consultez les références iOS et Android pour connaître l’ensemble de l’API propre à chaque plateforme.
• application.Mobile — un gestionnaire unique, protégé par des contraintes de compilation, qui couvre le sous-ensemble de fonctionnalités au comportement identique sur les deux plateformes. Utilisez-le si vous souhaitez un seul chemin de code qui se compile et s’exécute partout.

application.Mobile

application.Mobile délègue à IOS sous iOS, à Android sous Android et à une implémentation factice sans effet sur ordinateur. Comme il n’est soumis à aucune contrainte de compilation, vous pouvez l’appeler depuis du code Go ordinaire et indépendant de la plateforme, sans devoir créer vos propres fichiers //go:build :

// Works in any file, on any target.
// On desktop this returns "" (no-op); on device it returns the real path.
dbDir := application.Mobile.StoragePath()
if dbDir == "" {
    // Off-device, or the directory could not be created — handle accordingly.
    return
}
db, _ := sql.Open("sqlite", filepath.Join(dbDir, "app.db"))

StoragePath() renvoie le chemin absolu du répertoire de fichiers privé de l’application — getFilesDir() sous Android et le répertoire Application Support sous iOS — recommandé pour stocker les bases de données et autres fichiers persistants. Il renvoie une chaîne vide sur ordinateur, ainsi que sur l’appareil si le répertoire est indisponible (sous iOS, s’il ne peut pas être créé). Vérifiez donc la valeur "" avant de l’utiliser.

Fonctionnalités

Le gestionnaire Mobile expose les fonctionnalités dont les signatures sont identiques sous iOS et Android :

Les résultats asynchrones arrivent sous forme d’événements common:*, exactement comme avec les gestionnaires propres à chaque plateforme — consultez Événements pour connaître les charges utiles.

Ce qui reste propre à chaque plateforme

Les fonctionnalités dont la forme diffère entre iOS et Android ne sont pas disponibles sur Mobile. Appelez-les via application.IOS / application.Android depuis un fichier doté d’une balise de compilation :