To help users discover your published applications, you can use two special Android Market URIs that direct users to your application's details page or perform a search for all of your published -applications in Android Market. You can use these URIs to do the following:
+applications in Android Market. You can use these URIs to create a button in your application or a +link on a web page that:You can launch the Android Market application or web site in the following ways:
In both cases, you need to create a URI that indicates either the application you'd like to view -in Android Market or the search you'd like to perform. The URI is quite similar whether you want -to open the application or open the web site. The only difference is the URI prefix.
+In both cases, whether you want to initiate the action from your application or from a web +page, the URIs are quite similar. The only difference is the URI prefix.
-To open the Android Market application on the device, the prefix for the intent's data URI -is:
+To open the Android Market application from your application, the prefix for the intent's data +URI is:
market://
To open the Android Market web site, the prefix for the link URI is:
+To open Android Market from your web site, the prefix for the link URI is:
http://market.android.com/
To complete each URI, you must append a string that specifies either the -application for which you want to view or the search to execute. The following sections -describe how to create a complete URI for each case.
+The following sections describe how to create a complete URI for each action.
-Note: If you create a link to open the Android Market web site and -the user selects it from an Android-powered device, the Android Market application will also resolve -the link so the user can use the native application instead of the web site. Also, because the -Android Market application also reads the {@code http://} URIs, you can also use them in an intent, -but you should usually use the {@code market://} URIs for an intent, so that the native application -is opened by default. You should use {@code http://} URIs only when creating links from a web -page.
+Note: If you create a link to open Android Market from your web +site and the user selects it from an Android-powered device, the device's Market application will +resolve the link so the user can use the Market application instead of opening the web +site. As such, you should always use {@code http://market.android.com/} URIs when creating a link on +a web page. When pointing to your apps from within your Android app, use the +{@code market://} URIs in an intent, so that the Market application always opens.
<URI_prefix>details?id=<package_name>
The <package_name> is a placeholder for the target application's fully
-qualified package name, as declared in the The <package_name> is a placeholder for the target application's
+fully-qualified package name, as declared in the {@code
package} attribute of the {@code
-<manifest>} element in the application's manifest file.
To open the details page in the Android Market application, create an intent with the -{@link android.content.Intent#ACTION_VIEW} action and include a data URI in this format:
+To open the Android Market details page from your application, +create an intent with the {@link android.content.Intent#ACTION_VIEW} action and include a data URI +in this format:
market://details?id=<package_name>
For example, here's how you can create an intent and open an application's details page in the -Android Market application:
+For example, here's how you can create an intent and open an application's details page in +Android Market:
Intent intent = new Intent(Intent.ACTION_VIEW);
@@ -232,23 +228,30 @@ intent.setData(Uri.parse("market://details?id=com.android.example"));
startActivity(intent);
+This will open the Android Market application on the device to view the {@code +com.android.example} application.
-To open the details page on the Android Market web site, create a link with a URI in this +
To open the details page from your web site, create a link with a URI in this format:
http://market.android.com/details?id=<package_name>
For example, here's a link that opens an application's details page on the Android Market web -site:
+For example, here's a link that opens an application's details page on Android Market:
<a href="http://market.android.com/details?id=com.android.example">App Link</a>+
When clicked from a desktop web browser, this opens the Android Market web site to view the +{@code com.android.example} application. When clicked from an Android-powered device, users are +given the option to use either their web browser or the Android Market application to view the +application.
+To perform a search in the Android Market application, create an intent with the +
To initiate a search on Android Market from your application, create an intent with the {@link android.content.Intent#ACTION_VIEW} action and include a data URI in this format:
market://search?q=<query>
The search result shows all applications published by the publisher and which are compatible with -the current device.
+This opens the Android Market application to perform the search. The search result shows all +applications published by the publisher that are compatible with the current device.
-To perform a search on the Android Market web site, create a link with a URI in this +
To initiate a search on Android Market from your web site, create a link with a URI in this format:
@@ -307,26 +310,31 @@ format:
The query may include the {@code pub:} parameter described above.
-For example, here's a link that initiates a search on the Android Market web site, based on the +
For example, here's a link that initiates a search on Android Market, based on the publisher name:
<a href="http://market.android.com/search?q=pub:Your Publisher Name">Search Link</a>-
The search result shows all applications published by the publisher.
+When clicked from a desktop web browser, this opens the Android Market web site and performs the +search. When clicked from an Android-powered device, users are given the option to use either their +web browser or the Android Market application to perform the search.
Use the following form to input either your application's package name or your publisher name -and generate a button that you can use on your web site. The button will take users to Android -Market to view your application details or view a list of all applications you've published.
+Use the following form to generate an "Available in Android Market" button that you can use on +your web site. Input either your application's package name or publisher name and the button will +take users to Android Market to either view your application's information or view a list of +your published apps. If users click the button while on an Android-powered device, the Android +Market application will respond to show users your application(s).
-This form offers four versions of the official "Available in Android Market" badge at -recommended sizes. If you would like to create a different size, you can download an EPS file for -the badges from the Android Brand Guidelines.
+This form offers four versions of the official "Available in Android Market" button at +recommended sizes. If you want to create a different size, you can download an EPS file for +the button images from the Android Brand +Guidelines.