Configurer un projet Android pour utiliser Retrofit [AK 9 HTTPS]
Ce tutoriel explique comment configurer un projet Android pour utiliser la bibliothèque Retrofit 2.0. Une brève étude sur les dépendances Android permettant de faire des requêtes HTTP (cf. question “What is the best library to make HTTP calls from Java/Android” sur Quora) m’a orienté vers les travaux de Jake Wharton, pour le transfert de données textuelles (hors chargement d’image).
Importer les bibliothèques nécessaires dans Android Studio
Il s’agit d’importer Retrofit développée par Square. De plus, depuis la version 2 de Retrofit, il faut également importer un convertisseur de requête pour le format utilisé, JSON dans notre cas.
-
Dans le fichier gradle de votre projet Android Studio, celui lié au module app/, importer la dépendances Retrofit :
dependencies { ... compile "com.squareup.retrofit2:retrofit:$retrofit_version" } avec, au 22 novembre 20017 : (prenez la dernière version figurant dans la partie gradle du site ) ext.retrofit_version = '2.3.0'
-
Importer également un convertisseur JSON, soit la bibliothèque converter-moshi (prenez la dernière version indiqué sur le site github): compile “com.squareup.retrofit2:converter-moshi:$retrofit_version”
Il existe d’autres convertisseurs, voici la liste proposé par Square :
- Gson:
com.squareup.retrofit:converter-gson
(JSON) - Jackson:
com.squareup.retrofit:converter-jackson
(JSON) - Moshi:
com.squareup.retrofit:converter-mosh
(JSON) - Protobuf:
com.squareup.retrofit:converter-protobuf
(Protocol Buffer binary) - Wire:
com.squareup.retrofit:converter-wire
(Wire pour protocol buffer-compatible) - Simple XML:
com.squareup.retrofit:converter-simplexml
(XML)Ajouter les permissions de se connecter à Internet
Afin de pouvoir exécuter des requêtes HTTP sur un serveur distant, il faut également ajouter, à l’application Android, les permissions de se connecter à Internet.
- Dans le fichier Manifest de votre projet Android Studio, ajouter la permission internet :
<uses-permission android:name="android.permission.INTERNET" />
Note : Les permissions sont placées dans la balise manifest
et hors de la balise application
(juste avant la balise application).
Finalement, dans ce tutoriel, il est expliqué comment importer les bibliothèques de Retrofit 2, pour le transfert HTTP, avec le format JSON et le convertisseur Moshi dans un projet Android.
À présent vous pouvez réaliser des requêtes HTTP GET et HTTP POST, avec Retrofit 2 dans une application Android.
Références :
Partagez ou réagissez sur Twitter.
Vous avez trouvé une erreur ou voulez améliorer cet article ? Editez le directement !