Apprendre à créer une application Android avec visual studio par la pratique
1 Introduction
Une fois que vous avez configuré, installé et vérifié votre environnement de développement Xamarin, cette procédure pas à pas vous montre comment créer une application de base avec Xamarin.Forms.
Les pages de référence de l’API sont sur :
Xamarin.Forms vous permet d’écrire tout le code de l’interface utilisateur une seule fois dans une bibliothèque de classes portable (PCL). Xamarin affiche ensuite automatiquement les contrôles de l’interface utilisateur native pour les plateformes iOS, Android et Windows. Nous recommandons cette approche, parce que l’option de bibliothèque PCL prend mieux en charge l’utilisation des seules API .NET qui sont prises en charge sur toutes les plateformes cibles, et parce que Xamarin.Forms vous permet de partager le code de l’interface utilisateur entre les plateformes.
Vous allez effectuer les opérations suivantes pour la générer :
1. Configurer votre solution
2. Écrire le code de service de données partagé
3. Commencer la rédaction du code de l’interface utilisateur partagé
4. Tester votre application avec l’émulateur Visual Studio pour Android
5. Terminer l’interface utilisateur avec une apparence native entre les plateformes
2 Configurer votre solution
Les étapes suivantes créent une solution Xamarin.Forms qui contient une bibliothèque PCL pour le code partagé et deux packages NuGet ajoutés.
1. Dans Visual Studio, créez une solution Application vide (Xamarin.Forms Portable) et nommez-la WeatherApp. Vous pouvez trouver plus facilement ce modèle en entrant Xamarin.Forms dans le champ de recherche.
2. Après avoir cliqué sur OK pour créer la solution, vous avez un certain nombre de projets individuels :
o WeatherApp (Portable) : bibliothèque PCL où vous allez écrire du code qui est partagé entre les plateformes, notamment une logique métier commune et le code de l’interface utilisateur à l’aide de Xamarin.Forms. o WeatherApp.Droid : projet qui contient le code Android natif. Ce projet est défini comme projet de démarrage par défaut.
o : projet qui contient le code iOS natif.
o : le projet qui contient du code Windows 10 UWP (Universal Windows).
o WeatherApp.Windows (Windows 8.1) : le projet qui contient du code Windows 8.1 natif. o WeatherApp.WinPhone (Windows Phone 8.1) : le projet qui contient le code Windows Phone natif.
3. Dans chaque projet natif, vous avez accès au concepteur natif pour la plateforme correspondante et pouvez implémenter des écrans et fonctionnalités spécifiques à la plateforme en fonction des besoins.
4. Mettez à niveau le package NuGet Xamarin.Forms dans votre solution vers la dernière version stable comme suit. Nous vous recommandons d’effectuer cette opération chaque fois que vous créez une solution Xamarin : o Sélectionnez Outils > Gestionnaire de package NuGet > Gérer les packages NuGet pour la solution.
o Sous l’onglet Mises à jour, cochez la mise à jour Xamarin.Forms et cochez cette option pour mettre à jour tous les projets de votre solution. (Remarque : laissez les mises à jour pour Xamarin.Android.Support décochées.)
o Mettez à jour le champ Version en sélectionnant « dernière stable » pour la version disponible. o Cliquez sur Mettre à jour.
5. Ajoutez les packages NuGet et au projet de bibliothèque PCL, que vous allez utiliser pour traiter les informations récupérées à partir d’un service de données météo : o Dans le Gestionnaire de package NuGet (toujours ouvert depuis l’étape 3), sélectionnez l’onglet Parcourir et recherchez Newtonsoft. o Sélectionnez . o Cochez le projet WeatherApp (il s’agit du seul projet dans lequel vous devez installer le package).
o Vérifiez que la valeur définie pour le champ Version est Dernière stable. o Cliquez sur Installer.
6. Répétez l’étape 4 ci-dessus pour rechercher et installer le package .
7. Générez votre solution et vérifiez l’absence d’erreur de génération.
3 Écrire le code de service de données partagé
Le projet WeatherApp (Portable) est l’emplacement où vous allez écrire du code pour la bibliothèque PCL partagée entre les plateformes. La bibliothèque PCL est automatiquement incluse dans les packages d’application générés par les projets iOS, Android et Windows Phone.
Pour exécuter cet exemple, vous devez tout d’abord vous inscrire pour obtenir une clé API gratuite d’utilisation du web service sur
Les étapes suivantes ajoutent le code à la bibliothèque PCL pour accéder aux données de ce service météo et stocker ces données :
1. Cliquez avec le bouton droit sur le projet WeatherApp et sélectionnez Ajouter > Classe. Dans la boîte de dialogue Ajouter un nouvel élément, nommez le fichier . Vous utiliserez cette classe pour stocker les données du service de données météo.
2. Remplacez l’intégralité du contenu de par le code suivant :
namespace WeatherApp
{
public class Weather
{
public string Title { get; set; } public string Temperature { get; set; } public string Wind { get; set; } public string Humidity { get; set; } public string Visibility { get; set; } public string Sunrise { get; set; } public string Sunset { get; set; }
public Weather()
{
//Because labels bind to these values, set them to an empty string to //ensure that the label appears on all platforms by default. this.Title = " "; this.Temperature = " "; = " "; this.Humidity = " "; this.Visibility = " "; this.Sunrise = " "; this.Sunset = " ";
}
}
}
3. Ajoutez une autre classe au projet de bibliothèque PCL nommée que vous allez utiliser pour traiter les données JSON du service de données météo.
4. Remplacez l’intégralité du contenu de par le code suivant :
using System.Threading.Tasks; using ;0 using ;
namespace WeatherApp
{
public class DataService
{ public static async Task getDataFromService(string queryString)
{
HttpClient client = new HttpClient();
var response = await client.GetAsync(queryString);
dynamic data = null; if (response != null)
{
String json =
response.Content.ReadAsStringAsync().Result;
data = JsonConvert.DeserializeObject(json);
}
return data;
}
}
}
5. Ajoutez une troisième classe à la bibliothèque PCL nommée Core, où vous allez placer la logique métier partagée, telle que la logique qui forme une chaîne de requête avec un code postal, appelle le service de données météo, puis remplit une instance de la classe Weather.
6. Voici un exemple de code :
using System;
using System.Threading.Tasks;
namespace WeatherApp
{
public class Core
{
public static async Task GetWeather(string zipCode)
{
//Sign up for a free API key at string key = "YOUR KEY HERE";
string queryString =
";
+ zipCode + ",us&appid=" + key + "&units=imperial";
dynamic results = await
DataService.getDataFromService(queryString).ConfigureAwait(false);
if (results["weather"] != null)
{
Weather weather = new Weather();
weather.Title = (string)results["name"]; weather.Temperature = (string)results["main"]["temp"]
+ " F";
= (string)results["wind"]["speed"] + " mph";
weather.Humidity = (string)results["main"]["humidity"]
+ " %";
weather.Visibility =
(string)results["weather"][0]["main"];
DateTime time = new System.DateTime(1970, 1, 1, 0, 0, 0, 0);
DateTime sunrise =
time.AddSeconds((double)results["sys"]["sunrise"]);
DateTime sunset =
time.AddSeconds((double)results["sys"]["sunset"]);
weather.Sunrise = sunrise.ToString() + " UTC"; weather.Sunset = sunset.ToString() + " UTC"; return weather;
} else {
return null;
}
}
}
}
7. Générez le projet de bibliothèque PCL WeatherApp pour vérifier que le code est correct.
4 Commencer la rédaction du code de l’interface utilisateur partagé
Xamarin.Forms vous permet d’implémenter le code de l’interface utilisateur partagé dans la bibliothèque PCL. Dans cette procédure, vous allez ajouter un écran à la bibliothèque PCL avec un bouton qui met à jour son texte avec les données retournées par le code du service de données météo ajouté dans la section précédente :
1. Ajoutez une Page XAML Forms nommée en cliquant avec le bouton droit sur le projet WeatherApp et en sélectionnant Ajouter > Nouvel élément . Dans la boîte de dialogue Ajouter un nouvel élément,recherchez « Forms », sélectionnez Page XAML Forms et nommez-la .
Xamarin.Forms étant basé sur XAML, cette étape crée un fichier ainsi que le fichier code-behind imbriqué . Cela vous permet de générer l’interface utilisateur via XAML ou du code. Vous procéderez de l’une des deux façons dans cette procédure pas à pas.
2. Pour ajouter un bouton à l’écran WeatherPage, remplacez le contenu de par le code suivant :
XAML
Notez que le nom du bouton doit être défini à l’aide de l’attribut x:Name pour pouvoir faire référence à ce bouton par son nom depuis le fichier de code associé, appelé aussi « code-behind ».
3. Pour ajouter un gestionnaire d’événements pour l’événement Clicked du bouton pour mettre à jour le texte du bouton, remplacez le contenu de par le code ci-dessous. (Vous pouvez remplacer « 60601 » par un autre code postal).
using System; using Xamarin.Forms;
namespace WeatherApp
{
public partial class WeatherPage: ContentPage
{
public WeatherPage()
{
InitializeComponent(); this.Title = "Sample Weather App"; getWeatherBtn.Clicked += GetWeatherBtn_Clicked;
//Set the default binding to a default object for now this.BindingContext = new Weather();
}
private async void GetWeatherBtn_Clicked(object sender,
EventArgs e)
{
Weather weather = await Core.GetWeather("60601"); = weather.Title;
}
}
}
4. Pour ouvrir WeatherPage en tant que premier écran quand l’application démarre, remplacez le constructeur par défaut dans par le code suivant :
public App()
{
MainPage = new NavigationPage(new WeatherPage());
}
5. Générez le projet de bibliothèque PCL WeatherApp pour vérifier que le code est correct.
5 Tester votre application avec l’émulateur Visual Studio pour Android
Vous êtes maintenant prêt à exécuter l’application ! À présent, exécutez simplement la version Android pour vérifier que l’application obtient des données du service météo. Par la suite, vous allez également exécuter les versions iOS et Windows Phone après avoir ajouté d’autres éléments d’interface utilisateur. (Remarque : si vous exécutez Visual Studio sous Windows 7, suivez la même procédure, mais avec Xamarin Player à la place.)
1. Définissez WeatherApp.Droid comme projet de démarrage en cliquant dessus avec le bouton droit et en sélectionnant Définir comme projet de démarrage.
2. Dans la barre d’outils Visual Studio, vous verrez WeatherApp.Droid répertorié en tant que projet cible. Sélectionnez l’un des émulateurs Android pour le débogage et appuyez sur F5. Nous vous recommandons d’utiliser l’une des options de l’émulateur
Visual Studio pour l’exécution de l’application dans l’émulateur Visual Studio pour Android.
3. Quand l’application démarre dans l’émulateur, cliquez sur le bouton Get Weather. Le texte du bouton doit être mis à jour et contenir Chicago, IL, qui est la propriété Title des données récupérées à partir du service météo.
6 Terminer l’interface utilisateur avec une apparence native entre les plateformes
Xamarin.Forms affiche les contrôles de l’interface utilisateur native pour chaque plateforme afin que votre application obtienne automatiquement une apparence native. Pour mieux vous rendre compte, terminez l’interface utilisateur avec un champ d’entrée pour un code postal, puis affichez les données météo retournées par le service.
1. Remplacez le contenu de par le code ci-dessous. Notez que chaque élément est nommé à l’aide de l’attribut x:Name comme décrit précédemment afin que l’élément puisse être référencé à partir du code. Xamarin.Forms fournit également de nombreuses options de disposition () ; ici, WeatherPage utilise StackLayout ().
XAML
HorizontalOptions="FillAndExpand"
BackgroundColor="#545454">
FontAttributes="Bold"
FontSize="Medium" />
Style="{StaticResource labelStyle}" />
WidthRequest="185" BorderWidth="1" >
Style="{StaticResource fieldStyle}" />
Style="{StaticResource fieldStyle}" />
Style="{StaticResource fieldStyle}" />
Style="{StaticResource fieldStyle}" />
Style="{StaticResource fieldStyle}" />
Style="{StaticResource fieldStyle}" />
Notez l’utilisation de la balise OnPlatform dans Xamarin.Forms.OnPlatform sélectionne une valeur de propriété qui est propre à la plateforme actuelle sur laquelle l’application est exécutée (voir External XAML Syntax(). Nous l’utilisons ici pour définir une couleur de texte différente pour les champs de données : blanc sur Android et Windows Phone, noir sur iOS. Vous pouvez utiliser OnPlatform pour toutes les propriétés et tous les types de données afin d’effectuer des réglages spécifiques à la plateforme n’importe où dans votre XAML. Dans le fichier code-behind, vous pouvez utiliser l’API Device.OnPlatformdans le même but.
2. Dans , remplacez le gestionnaire d’événements
GetWeatherBtn_Clicked par le code ci-dessous. Ce code vérifie qu’un code postal
figure dans le champ d’entrée, récupère les données pour ce code postal, affecte l’instance résultante de Weather au contexte de liaison de la totalité de l’écran, puis définit « Rechercher à nouveau » comme texte du bouton. Notez que chaque étiquette
dans l’interface utilisateur est liée à une propriété de la classe Weather ; par conséquent, quand vous affectez une instance de Weather au contexte de liaison de l’écran, ces étiquettes sont automatiquement mises à jour.
private async void GetWeatherBtn_Clicked(object sender, EventArgs e)
{
if (!String.IsNullOrEmpty())
{
Weather weather = await Core.GetWeather(); this.BindingContext = weather; = "Search Again";
}
}
3. Exécutez l’application sur les trois plateformes (Android, iOS et Windows Phone) en cliquant avec le bouton droit sur le projet approprié, en sélectionnant Définir comme projet de démarrage et en démarrant l’application sur un appareil, dans l’émulateur ou dans le simulateur. Entrez un code postal des États-Unis valide (par exemple, 60601) et appuyez sur le bouton Get Weather pour afficher les données météo de cette région, comme indiqué ci-dessous. Bien entendu, Visual Studio doit être connecté à un ordinateur Mac OS X sur votre réseau pour le projet iOS.
7 Mettre en place un Web serveur REST en Xamarin
Question 1:A partir des indications de , créez votre propre serveur Web sur votre téléphone et testez-le par le renvoi d’une donnée sur un GET (les bases d’un service REST).