Android – Associer son application avec des fichiers – les Intent Filter

Voici un petit article pour mon ami Laurent 😉 (et pour moi aussi car je vais certainement en avoir besoin pour Scores Keeper). Il décrit comment associer un type de fichier avec son application Android. Ainsi lorsqu’on essaiera d’ouvrir un fichier de ce type avec Gmail, un explorateur ou tout autre application, notre application pourra être utilisée pour ouvrir et lire ce dernier.

Pour ce tutorial, nous allons donc créer une application qui s’associera aux fichiers CSV (comma-separated values). En voici un petit que j’ai créé avec Excel :

La première chose à faire (comme toujours) est de créer un nouveau projet :-P. Nous allons déclarer notre activité principale comme réceptrice de fichiers CSV grâce au Manifest en lui précisant son type MIME dans un Intent Filter de la façon suivante :

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
	package="org.bbt.opencsv" android:versionCode="1" android:versionName="1.0">
	<uses-sdk android:minSdkVersion="4" />

	<application android:icon="@drawable/icon" android:label="@string/app_name">
		<activity android:name=".Main" android:label="@string/app_name">

			<intent-filter>
				<action android:name="android.intent.action.VIEW" />
				<category android:name="android.intent.category.DEFAULT" />
				<category android:name="android.intent.category.BROWSABLE" />
				<data android:mimeType="text/csv" />
			</intent-filter>

		</activity>

	</application>
</manifest>

Il est aussi possible de filtrer sur une extension précise, un chemin précis, … pour cela rendez-vous sur le site d’Android et son chapitre sur les Intents & Intent Filters. Nous définissons ici un Intent Filter pour une activité, mais il est aussi possible d’en définir un pour un Service ou un BrodcastReceiver.

Pour filtrer suivant l’extension d’un fichier voici comment procéder pour les fichiers CSV :

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="file" />
    <data android:mimeType="*/*" />
    <data android:pathPattern=".*\\.csv" />
    <data android:host="*" />
</intent-filter>

Ensuite, dans la vue main.xml nous allons y placer un TextView qui servira à afficher le contenu :

<?xml version="1.0" encoding="utf-8"?>
<TextView xmlns:android="http://schemas.android.com/apk/res/android"
	android:layout_width="fill_parent"
	android:layout_height="wrap_content"
	android:text="Aucune données n'a été reçue"
	android:id="@+id/content" />

Enfin dans notre activité principale, nous allons tester qu’un contenu nous a été envoyé. Nous allons en extraire le contenu et l’afficher dans le TextView prévu à cet effet :

package org.bbt.opencsv;

import java.io.BufferedReader;
import java.io.InputStream;
import java.io.InputStreamReader;

import android.app.Activity;
import android.os.Bundle;
import android.widget.TextView;
import android.widget.Toast;

public class Main extends Activity {
	/** Called when the activity is first created. */
	@Override
	public void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.main);

		// TextView utilisé pour afficher le contenu du fichier
		TextView contentText = (TextView) findViewById(R.id.content);

		// test du type de contenu que l'on pourrait recevoir (en fonction de l'URI des données envoyées)
		String scheme = getIntent().getScheme();
		if (("content".equals(scheme)) || ("file".equals(scheme))) {
			try {
				// Tentative d'ouverture du flux de données
				InputStream attachment = getContentResolver().openInputStream(getIntent().getData());
				BufferedReader r = new BufferedReader(new InputStreamReader(attachment));
				// Lecture du contenu
				String line;
				StringBuffer result = new StringBuffer();
				while ((line = r.readLine()) != null) {
					result.append(line + "\n");
				}
				contentText.setText(result.toString());
				Toast.makeText(this, "success", Toast.LENGTH_SHORT).show();
			} catch (Exception e) {
				// Une erreur s'est produite lors de la lecture du flux
				Toast.makeText(this, "error while opening the file.", Toast.LENGTH_SHORT).show();
				e.printStackTrace();
			}
		}
	}
}

Ainsi, lorsque nous ouvriront un fichier CSV de Gmail par exemple :

Android nous proposera toutes les applications associées à ce type de fichier, et nous pouvons trouver Open Csv (notre application) dans la liste :

Notez que notre application n’est pas la seule associée avec les fichiers CSV. En choisissant notre application, nous pouvons voir le contenu du fichier affiché dans notre TextView :

Et voilà, c’est aussi simple que ça 🙂 Il nous est alors possible de traiter le contenu de ce fichier comme bon nous semble !