From 1698fd608c225397afce3d0c2cab73dd744ac97a Mon Sep 17 00:00:00 2001 From: Scott Main Date: Mon, 18 Jul 2011 18:12:44 -0700 Subject: [PATCH] cherrypick Change-Id: Ib8e73aabb6369a25599aca2351f69cc56333578e docs: clarify that the market app responds to http urls Change-Id: Ie9afca5d2e3072bd85c4eb7da1debbf1b5ec02a0 --- docs/html/guide/publishing/publishing.jd | 111 ++++++++++++----------- 1 file changed, 59 insertions(+), 52 deletions(-) diff --git a/docs/html/guide/publishing/publishing.jd b/docs/html/guide/publishing/publishing.jd index 95d89fa1f2c55..7110fe5ad8b5c 100644 --- a/docs/html/guide/publishing/publishing.jd +++ b/docs/html/guide/publishing/publishing.jd @@ -155,48 +155,43 @@ href="{@docRoot}guide/publishing/licensing.html">Application Licensing.

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.

Opening an app's details page

@@ -209,22 +204,23 @@ the application description, screenshots, reviews and more, and choose to instal

<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.

+<manifest>} element.

-

Opening details in the Android Market application

+

Opening the app details page from your Android app

-

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.

-

Opening details on the Android Market web site

-

To open the details page on the Android Market web site, create a link with a URI in this +

Opening the app details page from a web site

+ +

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.

+

Performing a search

@@ -274,9 +277,9 @@ by the publisher name: -

Searching the Android Market application

+

Searching from your Android app

-

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>

@@ -292,13 +295,13 @@ intent.setData(Uri.parse("market://search?q=pub:Your Publisher Name")); startActivity(intent); -

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.

-

Searching the Android Market web site

+

Searching from a web site

-

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.

Build an Android Market button

-

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.