Home | History | Annotate | Download | only in articles 
      1 page.title=Can I Use this Intent?
      2 @jd:body
      3 
      4 <p>Android offers a very powerful and yet easy-to-use message type called 
      5 an <a href="{@docRoot}guide/topics/intents/intents-filters.html">intents</a>.
      6 You can use intents to turn applications into high-level libraries and
      7 make code modular and reusable. The Android Home screen and AnyCut 
      8 applications, for instance, use intents extensively to create shortcuts. </p>
      9 
     10 <p>While it is nice to be able to make use of a loosely coupled
     11 API, there is no guarantee that the intent you send will be received by
     12 another application. This happens in particular with third-party apps, like 
     13 <a href="http://code.google.com/p/apps-for-android/source/browse/trunk/Panoramio">Panoramio</a> 
     14 and its RADAR intent.</p>
     15 
     16 <p>This article describes a technique you can use to find out whether the system
     17 contains any application capable of responding to the intent you want to use.
     18 The example below shows a helper method that queries the system package manager
     19 to determine whether there's an app that can respond to a specified intent. Your
     20 application can pass an intent to the method and then, for example, show or hide
     21 user options that the user would normally use to trigger the intent. </p>
     22 
     23 <pre class="prettyprint">/**
     24  * Indicates whether the specified action can be used as an intent. This
     25  * method queries the package manager for installed packages that can
     26  * respond to an intent with the specified action. If no suitable package is
     27  * found, this method returns false.
     28  *
     29  * @param context The application's environment.
     30  * @param action The Intent action to check for availability.
     31  *
     32  * @return True if an Intent with the specified action can be sent and
     33  *         responded to, false otherwise.
     34  */
     35 public static boolean isIntentAvailable(Context context, String action) {
     36     final PackageManager packageManager = context.getPackageManager();
     37     final Intent intent = new Intent(action);
     38     List&lt;ResolveInfo&gt; list =
     39             packageManager.queryIntentActivities(intent,
     40                     PackageManager.MATCH_DEFAULT_ONLY);
     41     return list.size() &gt; 0;
     42 }
     43 </pre>
     44 
     45 <p>Here is how you could use the helper method:</p>
     46 
     47 <pre class="prettyprint">@Override
     48 public boolean onPrepareOptionsMenu(Menu menu) {
     49     final boolean scanAvailable = isIntentAvailable(this,
     50         "com.google.zxing.client.android.SCAN");
     51 
     52     MenuItem item;
     53     item = menu.findItem(R.id.menu_item_add);
     54     item.setEnabled(scanAvailable);
     55 
     56     return super.onPrepareOptionsMenu(menu);
     57 }
     58 </pre>
     59 
     60 <p>In this example, the menu is grayed out if the <em>Barcode Scanner</em> 
     61 application is not installed. </p>
     62 
     63 <p>Another, simpler, way to do this is to catch the
     64 <code>ActivityNotFoundException</code> when calling <code>startActivity()</code>
     65 but it only lets you react to the problem, you cannot predict it and update the
     66 UI accordingly to prevent the user from doing something that won't work. The
     67 technique described here can also be used at startup time to ask the user
     68 whether he'd like to install the missing package, you can then simply redirect
     69 him to the Android Market by using the appropriate URI.</p>