Partager via


Installation sur un système Windows

Ce guide décrit les étapes d’installation de Xamarin.Android pour Visual Studio sur un système Windows, et explique comment configurer Xamarin.Android pour créer votre première application Xamarin.Android.

Vue d’ensemble

Dans ce guide, vous apprendrez à :

  • Configurer des emplacements personnalisés pour Java Development Kit, pour Android SDK et pour le NDK Android

  • Lancer le Gestionnaire Android SDK pour télécharger et installer les composants supplémentaires du kit Android SDK

  • Préparer un appareil ou un émulateur Android en vue d’un débogage ou d’un test

  • Créer votre premier projet d’application Xamarin.Android

À la fin de ce guide, Xamarin.Android aura été intégré à Visual Studio, et vous serez prêt à créer votre première application Xamarin.Android.

Installation

Pour plus d’informations sur l’installation de Xamarin en vue de son utilisation avec Visual Studio sur un système Windows, consultez le guide Installation sur un système Windows.

Configuration

Xamarin.Android utilise le JDK Java et Android SDK pour créer des applications. Pendant l’installation, le programme d’installation de Visual Studio place ces outils dans leur emplacement par défaut, et configure l’environnement de développement avec la configuration de chemin appropriée. Vous pouvez afficher et modifier ces emplacements en cliquant sur Options > outils > Xamarin > Paramètres Android :

Capture d’écran de la boîte de dialogue Paramètres Xamarin Android

Pour la plupart des utilisateurs, ces emplacements par défaut fonctionnent sans nécessiter de modifications. Toutefois, vous pouvez souhaiter configurer des emplacements personnalisés pour ces outils dans Visual Studio (par exemple, si vous avez installé le JDK Java, Android SDK ou le NDK dans un autre emplacement). Cliquez sur Modifier en regard du chemin que vous souhaitez modifier, puis accédez au nouvel emplacement.

Xamarin.Android utilise le JDK 11, qui est requis pour l’API 31 et ultérieure, JDK 8, ce qui est requis si vous développez pour le niveau API 24 à 30 (JDK 8 prend également en charge les niveaux d’API antérieurs à 24).

Important

Xamarin.Android ne prend pas en charge JDK 9.

Android SDK Manager

Android utilise plusieurs paramètres de niveau d’API Android pour déterminer la compatibilité de votre application avec les différentes versions Android (pour plus d’informations sur les niveaux d’API Android, consultez Présentation des niveaux d’API Android). Selon le ou les niveaux d’API Android à cibler, vous devrez peut-être télécharger et installer d’autres composants Android SDK. De plus, vous aurez peut-être à installer les outils facultatifs et les images d’émulateur fournis par Android SDK. Pour cela, utilisez le Gestionnaire Android SDK. Vous pouvez lancer le Gestionnaire du KIT de développement logiciel (SDK) Android en cliquant sur Outils > Gestionnaire de sdk Android >Android :

Guide pratique pour lancer le Gestionnaire de kit de développement logiciel (SDK) Android

Par défaut, Visual Studio installe le Gestionnaire Android SDK de Google :

Capture d’écran du Gestionnaire Android SDK de Google

Vous pouvez utiliser le Gestionnaire Android SDK de Google Android pour installer le paquet Android SDK Tools jusqu’à la version 25.2.3. Toutefois, si vous devez utiliser une version ultérieure du paquet Android SDK Tools, installez le plug-in Gestionnaire Android SDK Xamarin pour Visual Studio (disponible sur Visual Studio Marketplace). Cette installation est nécessaire, car la version autonome du Gestionnaire Android SDK de Google est dépréciée depuis la version 25.2.3 du paquet Android SDK Tools.

Pour plus d’informations sur l’utilisation du Gestionnaire Android SDK Xamarin, consultez Configuration du kit Android SDK.

sous-système Windows 11 pour Android (préversion)

Windows 11 inclut désormais un sous-système pour l’exécution d’applications Android. Cela offre une nouvelle façon de déboguer rapidement vos applications Android directement à partir de Visual Studio sans avoir besoin d’un autre appareil ou émulateur. Pour obtenir des instructions complètes et des conditions requises pour activer cette fonctionnalité, suivez les instructions Windows 11.

Une fois connecté à adb, votre machine s’affiche dans le menu Exécuter/déboguer aux côtés des émulateurs ou appareils que vous avez configurés.

Limitations et problèmes connus :

  • Les services Google Play ne sont pas pris en charge.
  • Rester sur un point d’arrêt pendant le débogage finit par expirer et bloquer votre application.

Émulateur Android

L’émulateur Android peut être très utile pour développer et tester une application Xamarin.Android. C’est le cas, par exemple, quand un appareil physique comme une tablette n’est disponible pendant le développement ou quand un développeur veut exécuter des tests d’intégration sur son ordinateur avant de valider le code.

L’émulation d’un appareil Android sur un ordinateur implique les composants suivants :

  • Émulateur Google Android : il s’agit d’un émulateur basé sur QEMU qui crée un appareil virtualisé s’exécutant sur la station de travail du développeur.
  • Image d’émulateur : une image d’émulateur est un modèle ou une spécification du matériel et du système d’exploitation destiné à être virtualisé. Par exemple, une image d’émulateur identifie la configuration matérielle requise d’un appareil Nexus 5X exécutant Android 7.0 avec Google Play Services installé. Une autre image d’émulateur peut être une tablette 10 pouces exécutant Android 6.0.
  • Appareil virtuel Android (AVD) : un appareil virtuel Android est un appareil Android émulé créé à partir d’une image d’émulateur. Quand vous exécutez et testez des applications Android, Xamarin.Android démarre l’émulateur Android qui démarre un AVD spécifique, installe l’APK, puis exécute l’application.

Vous pouvez considérablement améliorer les performances en cas de développement sur des ordinateurs x86 en utilisant des images d’émulateur spéciales optimisées pour l’architecture x86 ainsi que l’une des deux technologies de virtualisation :

  1. Hyper-V de Microsoft : disponible sur les ordinateurs exécutant la Windows 10 mise à jour d’avril 2018 ou ultérieure.
  2. Gestionnaire d’exécution accélérée du matériel (HAXM) d’Intel : disponible sur les ordinateurs x86 exécutant OS X, macOS ou des versions antérieures de Windows.

Pour plus d’informations sur l’émulateur Android, Hyper-V et HAXM, consultez le guide Accélération matérielle de l’émulateur Android.

Notes

Sur les versions de Windows antérieures à la mise à jour d’avril 2018 de Windows 10, HAXM n’est pas compatible avec Hyper-V. Dans ce scénario, vous devez désactiver Hyper-V ou utiliser des images d’émulateur plus lentes qui n’ont pas les optimisations x86.

Appareil Android

Si vous disposez d’un appareil physique Android pour vos tests, c’est le moment de le configurer pour le développement. Consultez Configurer un appareil pour le développement pour configurer votre appareil Android pour le développement. Ensuite, connectez-le à votre ordinateur pour exécuter et déboguer des applications Xamarin.Android.

Créer une application

Maintenant que vous avez installé Xamarin.Android, vous pouvez lancer Visual Studio pour créer un projet. Cliquez sur Fichier > Nouveau > projet pour commencer à créer votre application :

Comment créer un projet

Dans la boîte de dialogue Nouveau projet, sélectionnez Android sous Modèles, puis cliquez sur Application Android dans le volet droit. Entrez un nom pour votre application (dans la capture d’écran ci-dessous, l’application se nomme MyApp), puis cliquez sur OK :

Capture d’écran de la boîte de dialogue Nouveau projet, création d’une application Android vide

Et voilà ! Vous êtes maintenant prêt à utiliser Xamarin.Android pour créer des applications Android !

Résumé

Dans cet article, vous avez appris à configurer et à installer la plateforme Xamarin.Android sur un système Windows. Vous avez également vu comment configurer des emplacements d’installation personnalisés pour le JDK Java et Android SDK dans Visual Studio (facultatif), comment lancer le Gestionnaire Android SDK pour installer des composants Android SDK supplémentaires, comment configurer un émulateur et un appareil Android, et comment créer votre première application.

Dans la prochaine étape, vous allez étudier les didacticiels Hello, Android pour apprendre à créer une application Xamarin.Android.