From 5da76ddd575b22d45bbea0155f62c7c32e1a510e Mon Sep 17 00:00:00 2001 From: Dirk Dougherty Date: Thu, 17 Dec 2009 14:49:26 -0800 Subject: doc change: Add ?details query to doc about Android Market. Bug: 2160782 Change-Id: I86d1339e5bc5a36dbd033a7938764818a27b4d81 --- docs/html/guide/publishing/publishing.jd | 117 ++++++++++++++++++++++++------- 1 file changed, 92 insertions(+), 25 deletions(-) (limited to 'docs/html/guide') diff --git a/docs/html/guide/publishing/publishing.jd b/docs/html/guide/publishing/publishing.jd index c027f4d..0c087ef 100644 --- a/docs/html/guide/publishing/publishing.jd +++ b/docs/html/guide/publishing/publishing.jd @@ -121,6 +121,9 @@ certificate do not match those of the existing version, Market will consider it a new application and will not offer it to users as an update.

+ + +

Using Intents to Launch the Market Application on a Device

@@ -141,9 +144,37 @@ startActivity() to send the ACTION_VIEW Intent with the Market-handled URI.

The URI that you supply with the Intent lets the system route the intent properly and also expresses the type of action that you want Market to perform -after launch. Currently, you can have Market initiate a search for applications -on Android Market, based on query parameters that you provide. For example, you -can specify URIs to search for applications by:

+after launch. Currently, you can have Market take these actions:

+ + + +

Initiating a search

+ +

Your application can initiate a search on Android Market for applications +that match the query parameters that you provide. To do so, your application +sends an ACTION_VIEW Intent that includes a URI and query parameters in this +format:

+ +

market://search?q=<paramtype>:<value>

+ +
+ +
+ +

Searches on Android Market

+

When you initiate a search, Android Market returns results from matches in +the public metadata supplied by developers in their Android Market profiles or +application publishing information, but not from the developer's private account +or from the certificate used to sign the application.

+
+
+ +

Using this URI format, you can search for applications by:

-

Note that the URI queries return results from the public metadata supplied by -developers in their Android Market profiles or application publishing -information, but not from the developer's private account or from the -certificate used to sign the application.

+

The table at the bottom of this page specifies the paramtypes +and values that correspond to each of these types of search.

+ +

When you send an intent to initiate a search for applications, Market sends +the search query to the server and displays the result. To the user, the +experience is something like this:

+ +
    +
  1. The user presses a link or button in your application.
    2. +
  2. The Market application launches and takes control of the screen, displaying +a progress indicator labeled "Searching" until it receives the search +results.
    3. +
  3. Market receives the search results and displays them. Depending on the query +parameters, the search results may include a list of one or more applications. +
    4. +
  4. From the results page, the user can select an app to go to its Details page, +which offers information about the app and lets the user download/purchase the +app.
    5. +
+ +

Loading an application's Details page

+ +

In Android Market, every application has a Details page that provides an +overview of the application for users. For example, the page includes a short +description of the app and screen shots of it in use, if supplied by the +developer, as well as feedback from users and information about the developer. +The Details page also includes an "Install" button that lets the user trigger +the download/purchase of the application.

+ +

If you want to refer the user to a specific appplication, your application +can take the user directly to the application's Details page. To do so, your +application sends an ACTION_VIEW Intent that includes a URI and query parameter +in this format:

+ +

market://details?id=<packagename>

+ +

In this case, the packagename parameter is target application's +fully qualified package name, as declared in the package attribute +of the manifest element in the application's manifest file. For example:

+ +

market://details?id=com.example.android.jetboy

+ +

Android Market URIs

The table below provides a list of URIs and actions currently supported by the Market application.

+

Note that these URIs work only when passed as Intent data — you +can't currently load the URIs in a web browser, either on a desktop machine or +on the device.

+ - + - + - - @@ -191,8 +262,8 @@ matches. - + @@ -212,7 +283,3 @@ matches.
For this ResultFor this Result Pass this URI with the ACTION_VIEW IntentCommentsComments
Search for an application by its fully qualified Java package name and display the result.
Search for applications by developer name and display the results.http://market.android.com/search?q=pub:"<Developer Name>" -or
market://search?q=pub:"<Developer Name>"		http://market.android.com/search?q=pub:<Developer Name> +or
market://search?q=pub:<Developer Name>		 Searches only the "Developer Name" fields of Market public profiles. Returns exact matches only.
Returns a list of applications meeting all the supplied parameters.
- -

Note that these URIs work only when passed as intent data — you -can't currently load the URIs in a web browser, either on a desktop machine or -on the device.

\ No newline at end of file -- cgit v1.1