Envoyer des données avec Android – Intent & ACTION_SEND

L’une des fonctionnalité bien pratique sous Android est l’envoi de données. Je l’utilise dans Scores Keeper pour envoyer les détails d’un tournoi. En utilisant les Intent et l’intention ACTION_SEND, il est possible de démarrer une « intention d’envoi », le système propose alors à l’utilisateur différentes façon d’envoyer ces données (mail, sms, …).

Voici un petit tutorial qui vous en présentera les principes de base.

Mise à jour : Coup de gueule contre Facebook qui ne gère pas ou très mal l’intent ACTION_SEND. Il est seulement possible de poster un lien et non un texte libre. Je ne comprend pas pourquoi mais on dirait qu’Android ne les intéresse pas. Étrange ! 😦

Voici un exemple de code permettant d’envoyer un simple message :

Main.java (activité principale) :

package org.bbt.actionsend;

import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.EditText;

public class Main extends Activity {

	/**
	 * Text qui sera envoyé
	 */
	private EditText text;

	@Override
	public void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.main);

		findViewById(R.id.send).setOnClickListener(new OnClickListener() {
			@Override
			public void onClick(View v) {
				send();
			}
		});

		text = (EditText) findViewById(R.id.text);
	}

	/**
	 * Envoyer le message
	 */
	private void send() {
		// intention d'envoi
		Intent intent = new Intent(Intent.ACTION_SEND);
		// contenu à envoyer
		intent.setType("text/plain");
		intent.putExtra(Intent.EXTRA_TEXT, text.getText().toString());
		// envoi de l'intention
		startActivity(Intent.createChooser(intent, "Send a simple text"));
	}
}

main.xml (vue attaché à l’activité) :

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
	android:orientation="vertical" android:layout_width="fill_parent"
	android:layout_height="fill_parent">

	<EditText android:layout_width="fill_parent"
		android:layout_height="wrap_content" android:text="Un petit message à envoyer"
		android:lines="5" android:gravity="top" android:id="@+id/text"/>

	<Button android:layout_width="wrap_content"
		android:layout_height="wrap_content" android:layout_gravity="right"
		android:id="@+id/send" android:text="Envoyer" />

</LinearLayout>

La partie interressante est dans la fonction send de l’activité Main. On créé une intention d’envoi de données. On précise que c’est du texte qu’on envoi text/plain et l’on démarre l’activité. Et pis c’est tout 🙂 Android propose alors cet écran :

On voit dans cette liste toutes les applications qui se sont déclarées auprès du système pour réceptionner des données de type texte. On retrouve les incontournables Mail, Messages ou Facebook dans cette liste par exemple. Si l’on clique sur Messages par exemple, on se retrouve dans l’application de messagerie, prêt à envoyer un message avec le contenu déjà pré-rempli. Il ne reste plus qu’à renseigner les destinataires :

A ce stade, nous avons quitté notre application et on se retrouve dans l’application d’envoi de messages. L’utilisateur a donc la liberté de modifier le message, choisir ses destinataires. Ce système est juste une aide pré-remplissant un message. De plus c’est l’utilisateur qui choisi ou non d’envoyer le message et non notre application.

Pour envoyer des mails, il suffit de faire un petit peu évoluer notre méthode send :

	/**
	 * Envoyer le message
	 */
	private void send() {
		// intention d'envoi
		Intent intent = new Intent(Intent.ACTION_SEND);
		// contenu à envoyer
		intent.setType("message/rfc822");
		intent.putExtra(Intent.EXTRA_TEXT, text.getText().toString());
		intent.putExtra(Intent.EXTRA_SUBJECT, "Sujet du mail");
		intent.putExtra(Intent.EXTRA_EMAIL, new String[] { "blogde@benoit.com" });
		// envoi de l'intention
		startActivity(Intent.createChooser(intent, "Send a message"));
	}

En souhaitant envoyer un mail, on peut utiliser d’autres Extra pour enrichir l’Intent. EXTRA_SUBJECT permet de préciser un sujet pour le mail. EXTRA_MAIL permet de préciser le/les destinataire(s) du mail. Après avoir déclenché cette intention on se retrouve sur l’écran d’envoi de mail pré-rempli :

Enfin terminons par l’envoi de fichier. On précise alors le type mime précis du fichier que l’on souhaite envoyer (image/png par exemple si c’est une image PNG).

	/**
	 * Envoyer le message
	 */
	private void send() {
		// intention d'envoi
		Intent intent = new Intent(Intent.ACTION_SEND);
		// fichier à envoyer
		File file = ...;
		// contenu à envoyer
		intent.setType("type mime du fichier");
		intent.putExtra(Intent.EXTRA_STREAM, Uri.fromFile(file));
		// envoi de l'intention
		startActivity(Intent.createChooser(intent, "Send a file"));
	}

Attention à ne pas envoyer un fichier qui se situe dans le context de l’application. C’est le cas si l’on utilise la méthode openFileOutput à partir du context de notre application. En effet il est nécessaire que l’application tierce (Gmail, Facebook, …) puisse accéder à ce fichier. N’oublions pas que l’envoi s’effectue en dehors de notre application. Il est possible de l’enregistrer sur la carte SD pour résoudre ce problème par exemple.

En espérant que cet article vous sera utile 😉