Bien démarrer avec Xamarin.EssentialsGet Started with Xamarin.Essentials

Xamarin.Essentials fournit une API inter-plateformes unique qui fonctionne avec n’importe quelle application Android, iOS ou UWP qui est accessible à partir du code partagé, quel que soit le mode de création de l’interface utilisateur.Xamarin.Essentials provides a single cross-platform API that works with any iOS, Android, or UWP application that can be accessed from shared code no matter how the user interface is created. 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.See the platform & feature support guide for more information on supported operating systems.

InstallationInstallation

Xamarin.Essentials est disponible sous forme de package NuGet qui peut être ajouté à n’importe quel projet nouveau ou existant à l’aide de Visual Studio.Xamarin.Essentials is available as a NuGet package that can be added to any existing or new project using Visual Studio.

  1. Téléchargez et installez Visual Studio avec Visual Studio Tools pour Xamarin.Download and install Visual Studio with the Visual Studio tools for 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).Open an existing project, or create a new project using the Blank App template under Visual Studio C# (Android, iPhone & iPad, or Cross-Platform).

    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.If adding to a UWP project ensure Build 16299 or higher is set in the project properties.

  3. Ajouter le package NuGet Xamarin.Essentials à chaque projet :Add the Xamarin.Essentials NuGet package to each project:

    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.In the Solution Explorer panel, right click on the solution name and select Manage NuGet Packages. Recherchez Xamarin.Essentials et installez le package dans Tous les projets, notamment les bibliothèques Android, iOS, UWP et .NET Standard.Search for Xamarin.Essentials and install the package into ALL projects including Android, iOS, UWP, and .NET Standard libraries.

  4. Ajoutez une référence à Xamarin.Essentials dans n’importe quelle classe C# pour référencer les API.Add a reference to Xamarin.Essentials in any C# class to reference the APIs.

    using Xamarin.Essentials;
    
  5. Xamarin.Essentials nécessite une configuration spécifique à la plateforme :Xamarin.Essentials requires platform-specific setup:

    Xamarin.Essentials prend en charge une version minimale d’Android 4.4, correspondant au niveau d’API 19, mais la version Android cible pour la compilation doit être 9.0, correspondant au niveau de l’API 28.Xamarin.Essentials supports a minimum Android version of 4.4, corresponding to API level 19, but the target Android version for compiling must be 9.0, corresponding to API level 28. (Dans Visual Studio, ces deux versions sont définies dans la boîte de dialogue Propriétés du projet pour le projet Android, dans l’onglet Manifeste Android. (Dans Visual Studio pour Mac, elles sont définies dans la boîte de dialogue Options du projet pour le projet Android, dans l’onglet Application Android.)(In Visual Studio, these two versions are set in the Project Properties dialog for the Android project, in the Android Manifest tab. In Visual Studio for Mac, they're set in the Project Options dialog for the Android project, in the Android Application tab.)

    Xamarin.Essentials installe la version 28.0.0.1 des bibliothèques Xamarin.Android.Support dont il a besoin.Xamarin.Essentials installs version 28.0.0.1 of the Xamarin.Android.Support libraries that it requires. Les autres bibliothèques Xamarin.Android.Support requises par votre application doivent également être mises à jour vers la version 28.0.0.1 à l’aide du Gestionnaire de package NuGet.Any other Xamarin.Android.Support libraries that your application requires should also be updated to version 28.0.0.1 using the NuGet package manager. 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.1.All Xamarin.Android.Support libraries used by your application should be the same, and should be at least version 28.0.0.1. Consultez la page Résolution des problèmes si vous rencontrez des problèmes d’ajout du package NuGet Xamarin.Essentials ou de mise à jour des packages NuGet dans votre solution.Refer to the troubleshooting page if you have issues adding the Xamarin.Essentials NuGet or updating NuGets in your solution.

    Dans MainLauncher pour le projet Android ou n’importe quel Activity qui est lancé Xamarin.Essentials doit être initialisé dans la méthode OnCreate :In the Android project's MainLauncher or any Activity that is launched Xamarin.Essentials must be initialized in the OnCreate method:

    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 doit recevoir OnRequestPermissionsResult.To handle runtime permissions on Android, Xamarin.Essentials must receive any OnRequestPermissionsResult. Ajoutez le code suivant à toutes les classes Activity :Add the following code to all Activity classes:

    public override void OnRequestPermissionsResult(int requestCode, string[] permissions, [GeneratedEnum] Android.Content.PM.Permission[] grantResults)
    {
        Xamarin.Essentials.Platform.OnRequestPermissionsResult(requestCode, permissions, grantResults);
    
        base.OnRequestPermissionsResult(requestCode, permissions, grantResults);
    }
    
  6. Suivez les guides Xamarin.Essentials qui vous permettent de copier et de coller des extraits de code pour chaque fonctionnalité.Follow the Xamarin.Essentials guides that enable you to copy and paste code snippets for each feature.

Xamarin.Essentials - APIs inter-plateformes pour Mobile Apps (vidéo)Xamarin.Essentials - Cross-Platform APIs for Mobile Apps (video)

Autres ressourcesOther Resources

Nous recommandons aux développeurs qui découvrent Xamarin de consulter Bien démarrer avec le développement de Xamarin.We recommend developers new to Xamarin visit getting started with Xamarin development.

Consultez le référentiel GitHub Xamarin.Essentials pour afficher le code source actuel, ce qui se prépare, des exemples d’exécution et pour cloner le référentiel.Visit the Xamarin.Essentials GitHub Repository to see the current source code, what is coming next, run samples, and clone the repository. Les contributions de la communauté sont les bienvenues !Community contributions are welcome!

Parcourez la documentation de l’API pour découvrir toutes les fonctionnalités de Xamarin.Essentials.Browse through the API documentation for every feature of Xamarin.Essentials.