Bien démarrer avec Xamarin.Essentials

  • Article

Xamarin.Essentials fournit une API multiplateforme unique qui fonctionne avec n’importe quelle application iOS, Android ou UWP accessible à partir du code partagé, quelle que soit la façon dont l’interface utilisateur est créée. Pour plus d’informations sur les systèmes d’exploitation pris en charge, consultez le guide de prise en charge des plateformes et des fonctionnalités.

Installation

Xamarin.Essentials est disponible en tant que package NuGet et est inclus dans chaque nouveau projet dans Visual Studio. Il peut également être ajouté à tous les projets existants à l’aide de Visual Studio en procédant comme suit.

  1. Téléchargez et installez Visual Studio avec Visual Studio Tools pour Xamarin.

  2. Ouvrez un projet existant ou créez un projet à l’aide du modèle d’application vide sous Visual Studio C# (Android, iPhone et iPad ou inter-plateformes).

    Important

    En cas d’ajout à un projet UWP, vérifiez que la build 16299 ou ultérieure est définie dans les propriétés du projet.

  3. Ajoutez le Xamarin.Essentials package NuGet à chaque projet :

    Dans le panneau de l’Explorateur de solutions, cliquez avec le bouton droit sur le nom de la solution et sélectionnez Gérer les packages NuGet. Xamarin.Essentials Recherchez et installez le package dans tous les projets, notamment les bibliothèques Android, iOS, UWP et .NET Standard.

  4. Ajoutez une référence à Xamarin.Essentials n’importe quelle classe C# pour référencer les API.

    using Xamarin.Essentials;

  5. Xamarin.Essentials nécessite une configuration spécifique à la plateforme :

    Xamarin.Essentials prend en charge une version Android minimale de 4.4, correspondant au niveau de l’API 19, mais la version Android cible pour la compilation doit être 9.0 ou 10.0, correspondant au niveau d’API 28 et au niveau 29. (Dans Visual Studio, ces deux versions sont définies dans la boîte de dialogue Propriétés du projet pour le projet Android, sous l’onglet Manifeste Android. Dans Visual Studio pour Mac, ils sont définis dans la boîte de dialogue Options du projet Android, sous l’onglet Application Android.)

    Lors de la compilation sur Android 9.0, Xamarin.Essentials installe la version 28.0.0.3 des bibliothèques Xamarin.Android.Support requises. Les autres bibliothèques Xamarin.Android.Support requises par votre application doivent également être mises à jour vers la version 28.0.0.3 à l’aide du Gestionnaire de package NuGet. Toutes les bibliothèques Xamarin.Android.Support utilisées par votre application doivent être identiques, et doivent avoir au moins la version 28.0.0.3. Reportez-vous à la page de résolution des problèmes si vous rencontrez des problèmes lors de l’ajout de NuGet ou de la Xamarin.Essentials mise à jour de NuGets dans votre solution.

    À compter de la version 1.5.0 lors de la compilation sur Android 10.0, Xamarin.Essentials installez les bibliothèques de support AndroidX requises. Lisez la documentation AndroidX si vous n’avez pas encore effectué la transition.

    Dans le projet Android ou l’un Activity MainLauncher des projets lancés, Xamarin.Essentials doit être initialisé dans la OnCreate méthode :

    protected override void OnCreate(Bundle savedInstanceState) {
    //...
    base.OnCreate(savedInstanceState);
    Xamarin.Essentials.Platform.Init(this, savedInstanceState); // add this line to your code, it may also be called: bundle
    //...

    Pour gérer les autorisations d’exécution sur Android, Xamarin.Essentials doivent recevoir n’importe quel OnRequestPermissionsResult. Ajoutez le code suivant à toutes les classes Activity :

    public override void OnRequestPermissionsResult(int requestCode, string[] permissions, Android.Content.PM.Permission[] grantResults)
{
    Xamarin.Essentials.Platform.OnRequestPermissionsResult(requestCode, permissions, grantResults);

    base.OnRequestPermissionsResult(requestCode, permissions, grantResults);
}

  6. Suivez les Xamarin.Essentials guides qui vous permettent de copier et coller des extraits de code pour chaque fonctionnalité.

Xamarin.Essentials - API multiplateformes pour Mobile Apps (vidéo)

Autres ressources

Nous recommandons aux développeurs qui découvrent Xamarin de consulter Bien démarrer avec le développement de Xamarin.

Visitez le Xamarin.Essentials référentiel GitHub pour voir le code source actuel, ce qui sera à venir, exécuter des exemples et cloner le référentiel. Les contributions de la communauté sont les bienvenues !

Parcourez la documentation de l’API pour chaque fonctionnalité de Xamarin.Essentials.