From 4d7bc65538c7cd9fbb1fbbcf22d1da47fcee1219 Mon Sep 17 00:00:00 2001
From: Dirk Dougherty Go to Android Market to create a publisher
+href="http://play.google.com/apps/publish">Go to Google Play to create a publisher
account and upload your app.Quickview
-
In this document
-
Interested in publishing your app on Android Market?
+
+ Interested in publishing your app on Google Play?
When a user searches or browses in Android Market on an Android device, the results are filtered +
When a user searches or browses on Google Play on an Android device, the results are filtered based on which applications are compatible with that device. For example, if an application -requires a camera (as specified in the application manifest file), then Android Market will not show +requires a camera (as specified in the application manifest file), then Google Play will not show the app on any device that does not have a camera.
Declarations in the manifest file that are compared to the device's configuration is not the only part of how applications are filtered. Filtering might also occur due to the user's country and carrier, the presence or absence of a SIM card, and other factors.
-Changes to the Android Market filters are independent of changes to the Android platform itself. -This document is updated periodically to reflect any changes that affect the way Android Market +
Changes to the Google Play filters are independent of changes to the Android platform itself. +This document is updated periodically to reflect any changes that affect the way Google Play filters applications.
-Android Market uses the filter restrictions described below to determine +
Google Play uses the filter restrictions described below to determine whether to show your application to a user who is browsing or searching for -applications from the Android Market app. When determining whether to display your app, -Market checks the device's hardware and software configuration, as well as it's +applications from the Google Play app. When determining whether to display your app, +Google Play checks the device's hardware and software configuration, as well as it's carrier, location, and other characteristics. It then compares those against the restrictions and dependencies expressed by the application's manifest file and publishing details. If the application is -compatible with the device according to the filter rules, Market displays the -application to the user. Otherwise, Market hides your application from search +compatible with the device according to the filter rules, Google Play displays the +application to the user. Otherwise, Google Play hides your application from search results and category browsing, even if a user specifically requests -the app by clicking a deep link that points directly to the app's ID within Market..
+the app by clicking a deep link that points directly to the app's ID within Google Play..Note: When users browse the Android Market web site, they can see all published -applications. The Android Market web site compares the application requirements to each of the +href="http://play.google.com/apps">Google Play web site, they can see all published +applications. The Google Play web site compares the application requirements to each of the user's registered devices for compatibility, though, and only allows them to install the application if it's compatible with their device.
You can use any combination of the available filters for your app. For example, you can set a
minSdkVersion
requirement of "4"
and set smallScreens="false"
-in the app, then when uploading the app to Market you could target European countries (carriers)
-only. Android Market's filters will thus prevent the application from being available on any device
+in the app, then when uploading the app to Google Play you could target European countries (carriers)
+only. Google Play's filters will thus prevent the application from being available on any device
that does not match all three of these requirements.
All filtering restrictions are associated with an application's version and can @@ -106,15 +106,15 @@ available.
Most Market filters are triggered by elements within an application's +
Most filters are triggered by elements within an application's manifest file, AndroidManifest.xml (although not everything in the manifest file can trigger filtering). -Table 1 lists the manifest elements that you should use to trigger Android -Market filtering, and explains how the filtering for each element works.
+Table 1 lists the manifest elements that you should use to trigger +filtering, and explains how the filtering for each element works. +trigger filtering on Google Play.Manifest Element | @@ -129,19 +129,19 @@ trigger filtering on Market.An application can - request certain hardware features, and Android Market will show the app only on devices that have the required hardware. + request certain hardware features, and Google Play will show the app only on devices that have the required hardware.Example 1 <uses-configuration android:reqFiveWayNav="true" /> , and a user is searching for apps on a device that does not have a five-way navigational control. Result: Google Play will not show the app to the user.
Example 2 <uses-configuration> element. Result: Google Play will show the app to all users, unless other filters apply.
For more details, see |
An application can require specific shared libraries to be present on the device. Example 1 com.google.android.maps library, and a user is searching for apps on a device that does not have the com.google.android.maps library. Result: Google Play will not show the app to the user.
Example 2 <uses-library> element. Result: Google Play will show the app to all users, unless other filters apply.
For more details, see |
|||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
<uses-permission> |
- | Strictly, Android Market does not filter based on + | Strictly, Google Play does not filter based on
<uses-permission> elements. However, it does read the
elements to determine whether the application has hardware feature requirements
that may not have been properly declared in <uses-feature>
elements. For example, if an application requests the CAMERA
permission but does not declare a <uses-feature> element for
-android.hardware.camera , Android Market considers that the
+android.hardware.camera , Google Play considers that the
application requires a camera and should not be shown to users whose devices do
not offer a camera.
In general, if an application requests hardware-related permissions,
-Android Market assumes that the application requires the underlying hardware
+Google Play assumes that the application requires the underlying hardware
features, even though there might be no corresponding to
- For a list of permissions that imply hardware features, see @@ -305,9 +305,9 @@ element. | An application can require a minimum API level. Example 1 Example 2 minSdkVersion , and the app uses APIs that were introduced in API Level 3. A user is searching for apps on a device that has API Level 2. Result: Google Play assumes that minSdkVersion is "1" and that the app is compatible with all versions of Android. Google Play shows the app to the user and allows the user to download the app. The app crashes at runtime.
Because you want to avoid this second scenario, we recommend that you always declare a |
Deprecated. Android
2.1 and later do not check or enforce the Declaring |
@@ -327,7 +327,7 @@ href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#max">
Manifest Element | Summary | ||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
- Android Market filters the application if the device screen size and density does not match + Google Play filters the application if the device screen size and density does not match any of the screen configurations (declared by a {@code <screen>} element) in the {@code <compatible-screens>} element. Caution: Normally, you should not use @@ -360,7 +360,7 @@ with alternative resources. |
- Android Market filters the application unless one or more of the GL texture compression + Google Play filters the application unless one or more of the GL texture compression formats supported by the application are also supported by the device. |
Filter Name | How It Works |
---|---|
Publishing Status | Only published applications will appear in - searches and browsing within Android Market. Even if an app is unpublished, it can + searches and browsing within Google Play. Even if an app is unpublished, it can be installed if users can see it in their Downloads area among their purchased, installed, or recently uninstalled apps. If an application has been suspended, users will not be able to reinstall or update it, even if it appears in their Downloads. |
Country / Carrier Targeting | When you upload your app to - the Android Market, you can select specific countries to target. The app will only + Google Play, you can select specific countries to target. The app will only be visible to the countries (carriers) that you select, as follows:
|
Copy-Protected Applications | To copy protect an application, set copy protection to "On" when you configure publishing -options for your application. Market will not show copy-protected applications on +options for your application. Google Play will not show copy-protected applications on developer devices or unreleased devices. |
Some specific Android Market filters allow you to publish multiple APKs for the same +
Some specific Google Play filters allow you to publish multiple APKs for the same application in order to provide a different APK to different device configurations. For example, if you're creating a video game that uses high-fidelity graphic assets, you might want to create two APKs that each support different texture compression formats. This way, you can reduce the size of the APK file by including only the textures that are required for each device -configuration. Depending on each device's support for your texture compression formats, Android -Market will deliver it the APK that you've declared to support that device.
+configuration. Depending on each device's support for your texture compression formats, Google +Play will deliver it the APK that you've declared to support that device. -Currently, Android Market allows you to publish multiple APKs for the same application only +
Currently, Google Play allows you to publish multiple APKs for the same application only when each APK provides different filters based on the following configurations:
All other filters still work the same as usual, but these three are the only filters that can -distinguish one APK from another within the same application listing on Android Market. For example, +distinguish one APK from another within the same application listing on Google Play. For example, you cannot publish multiple APKs for the same application if the APKs differ only based on whether the device has a camera.
@@ -450,5 +450,5 @@ APK that supports a wide range of device configurations. Publishing mul requires that you follow specific rules within your filters and that you pay extra attention to the version codes for each APK to ensure proper update paths for each configuration. -If you need more information about how to publish multiple APKs on Android Market, read If you need more information about how to publish multiple APKs on Google Play, read Multiple APK Support.
diff --git a/docs/html/guide/developing/building/index.jd b/docs/html/guide/developing/building/index.jd index 59c4645..569cd28 100644 --- a/docs/html/guide/developing/building/index.jd +++ b/docs/html/guide/developing/building/index.jd @@ -27,8 +27,8 @@ page.title=Building and RunningTo run an application on an emulator or device, the application must be signed using debug or release mode. You typically want to sign your application in debug mode when you develop and test your application, because the build tools use a debug key with a known password so you do not have - to enter it every time you build. When you are ready to release the application to Android - Market, you must sign the application in release mode, using your own private key.
+ to enter it every time you build. When you are ready to release the application to Google + Play, you must sign the application in release mode, using your own private key.Fortunately, Eclipse or your Ant build script signs the application for you in debug mode when you build your application. You can also easily setup Eclipse or your Ant build to sign your diff --git a/docs/html/guide/guide_toc.cs b/docs/html/guide/guide_toc.cs index fd2ec93..9d5064e 100644 --- a/docs/html/guide/guide_toc.cs +++ b/docs/html/guide/guide_toc.cs @@ -444,12 +444,12 @@
You must have an Android Market publisher account to register test accounts. And you must have a +
You must have a Google Play publisher account to register test accounts. And you must have a Google Checkout merchant account to create a product list and issue refunds to your users. If you -already have a publisher account on Android Market, you can use your existing account. You do not +already have a publisher account on Google Play, you can use your existing account. You do not need to register for a new account to support in-app billing. If you do not have a publisher -account, you can register as an Android Market developer and set up a publisher account at the -Android Market publisher site. If you do not have a +account, you can register as a Google Play developer and set up a publisher account at the +Google Play publisher site. If you do not have a Google Checkout merchant account, you can register for one at the Google Checkout site.
The Android Market publisher site provides a product list for each of your published -applications. You can sell an item using Android Market's in-app billing feature only if the item is +
The Google Play publisher site provides a product list for each of your published +applications. You can sell an item using Google Play's in-app billing feature only if the item is listed on an application's product list. Each application has its own product list; you cannot sell items that are listed in another application's product list.
@@ -77,7 +77,7 @@ storing and delivering the digital content that you sell in your applications.You can create a product list for any published application or any draft application that's been
-uploaded and saved to the Android Market site. However, you must have a Google Checkout merchant
+uploaded and saved to the Google Play site. However, you must have a Google Checkout merchant
account and the application's manifest must include the com.android.vending.BILLING
permission. If an application's manifest does not include this permission, you will be able to edit
existing items in the product list but you will not be able to add new items to the list. For more
@@ -104,8 +104,8 @@ number of in-app items.
To add an item to a product list using the In-app Products UI, follow these steps:
An item's publishing state can be Published or Unpublished . To be visible to a user during checkout, an item's publishing state must be set to - Published and the item's application must be published on Android Market.
+ Published and the item's application must be published on Google Play.Note: This is not true for test accounts. An item is visible to a test account if the application is not published and the item is published. See Testing In-app @@ -167,9 +167,9 @@ number of in-app items.
You must provide a default price in your home currency. You can also provide prices in other currencies, but you can do this only if a currency's corresponding country is listed as a target country for your application. You can specify target countries on the Edit Application - page in the Android Market developer console.
+ page in the Google Play developer console.To specify prices in other currencies, you can manually enter the price for each - currency or you can click Auto Fill and let Android Market do a one-time + currency or you can click Auto Fill and let Google Play do a one-time conversion from your home currency to the currencies you are targeting (see figure 4).
To import the items that are specified in your CSV file, do the following:
An item's purchase type controls how Android Market manages the purchase of the item. There are +
An item's purchase type controls how Google Play manages the purchase of the item. There are two purchase types: "managed per user account" and "unmanaged."
Items that are managed per user account can be purchased only once per user account. When an item
-is managed per user account, Android Market permanently stores the transaction information for each
-item on a per-user basis. This enables you to query Android Market with the
+is managed per user account, Google Play permanently stores the transaction information for each
+item on a per-user basis. This enables you to query Google Play with the
RESTORE_TRANSACTIONS
request and restore the state of the items a specific user has
purchased.
If a user attempts to purchase a managed item that has already been purchased, Android Market -displays an "Item already purchased" error. This occurs during checkout, when Android Market +
If a user attempts to purchase a managed item that has already been purchased, Google Play +displays an "Item already purchased" error. This occurs during checkout, when Google Play displays the price and description information on the checkout page. When the user dismisses the error message, the checkout page disappears and the user returns to your user interface. As a best practice, your application should prevent the user from seeing this error. The sample application @@ -404,10 +404,10 @@ or application features. These items are not transient and usually need to be re user reinstalls your application, wipes the data on their device, or installs your application on a new device.
-Items that are unmanaged do not have their transaction information stored on Android Market, -which means you cannot query Android Market to retrieve transaction information for items whose +
Items that are unmanaged do not have their transaction information stored on Google Play, +which means you cannot query Google Play to retrieve transaction information for items whose purchase type is listed as unmanaged. You are responsible for managing the transaction information -of unmanaged items. Also, unmanaged items can be purchased multiple times as far as Android Market +of unmanaged items. Also, unmanaged items can be purchased multiple times as far as Google Play is concerned, so it's also up to you to control how many times an unmanaged item can be purchased.
@@ -417,10 +417,10 @@ times.In-app billing does not allow users to send a refund request to Android Market. Refunds for +
In-app billing does not allow users to send a refund request to Google Play. Refunds for
in-app purchases must be directed to you (the application developer). You can then process the
-refund through your Google Checkout merchant account. When you do this, Android Market receives a
-refund notification from Google Checkout, and Android Market sends a refund message to your
+refund through your Google Checkout merchant account. When you do this, Google Play receives a
+refund notification from Google Checkout, and Google Play sends a refund message to your
application. For more information, see Handling
IN_APP_NOTIFY messages and
The Android Market publisher site lets you set up one or more test accounts. A test account is a
+ The Google Play publisher site lets you set up one or more test accounts. A test account is a
regular Google account that you register on the publisher site as a test account. Test accounts are
-authorized to make in-app purchases from applications that you have uploaded to the Android Market
+authorized to make in-app purchases from applications that you have uploaded to the Google Play
site but have not yet published. You can use any Google account as a test account. Test accounts are useful if you want to let
@@ -458,7 +458,7 @@ accounts yourself and distribute the credentials to your developers or testers.<
To add test accounts to your publisher account, follow these steps:Setting Up Test Accounts
-
-
Market billing issue tracker | -Market billing + | Billing issue tracker | +Billing project issue tracker | Bug and issue reports related specifically to in-app billing sample code. | |||||||||||||||||||||||||||||||||||||||||||
BillingReceiver.java | A {@link android.content.BroadcastReceiver} that receives asynchronous response messages
- (broadcast intents) from Android Market. Forwards all messages to the
+ (broadcast intents) from Google Play. Forwards all messages to the
BillingService . |
||||||||||||||||||||||||||||||||||||||||||||||
BillingService.java | -A {@link android.app.Service} that sends messages to Android Market on behalf of the + | A {@link android.app.Service} that sends messages to Google Play on behalf of the
application by connecting (binding) to the MarketBillingService . |
|||||||||||||||||||||||||||||||||||||||||||||
Consts.java | -Defines various Android Market constants and sample application constants. All constants that -are defined by Android Market must be defined the same way in your application. | +Defines various Google Play constants and sample application constants. All constants that +are defined by Google Play must be defined the same way in your application. | |||||||||||||||||||||||||||||||||||||||||||||
com.android.vending.billing.RESPONSE_CODE |
request_id |
A long representing a request ID. A request ID identifies a specific billing
- request and is returned by Android Market at the time a request is made. |
+ request and is returned by Google Play at the time a request is made.
|||||||||||||||||||||||||||||||||||||||||||||
com.android.vending.billing.RESPONSE_CODE |
response_code |
- An int representing the actual Android Market server response code. |
+ An int representing the actual Google Play server response code. |
||||||||||||||||||||||||||||||||||||||||||||
com.android.vending.billing.IN_APP_NOTIFY |
notification_id |
A String representing the notification ID for a given purchase state change.
- Android Market notifies you when there is a purchase state change and the notification includes a
+ Google Play notifies you when there is a purchase state change and the notification includes a
unique notification ID. To get the details of the purchase state change, you send the notification
ID with the GET_PURCHASE_INFORMATION request. |
RESULT_BILLING_UNAVAILABLE |
3 | Indicates that in-app billing is not available because the API_VERSION that you
- specified is not recognized by the Android Market application or the user is ineligible for in-app
+ specified is not recognized by the Google Play application or the user is ineligible for in-app
billing (for example, the user resides in a country that prohibits in-app purchases). |
|||||||||||||||||||||||||||||||||||||||||||||
RESULT_ITEM_UNAVAILABLE |
4 | -Indicates that Android Market cannot find the requested item in the application's product + | Indicates that Google Play cannot find the requested item in the application's product
list. This can happen if the product ID is misspelled in your REQUEST_PURCHASE
request or if an item is unpublished in the application's product list. |
int |
1 | Yes | -The version of Android Market's in-app billing service you are using. The current version is + | The version of Google Play's in-app billing service you are using. The current version is 1. | |||||||||||||||||||||||||||||||||||||||
Any valid product identifier. | Required for REQUEST_PURCHASE requests. |
The product ID of the item you are making a billing request for. Every in-app item that you - sell using Android Market's in-app billing service must have a unique product ID, which you - specify on the Android Market publisher site. | + sell using Google Play's in-app billing service must have a unique product ID, which you + specify on the Google Play publisher site.|||||||||||||||||||||||||||||||||||||||||||||
NONCE |
@@ -172,7 +172,7 @@ pairs, which are summarized in table 2.
A number used once. Your application must generate and send a nonce with each
GET_PURCHASE_INFORMATION and RESTORE_TRANSACTIONS request. The nonce is
returned with the PURCHASE_STATE_CHANGED broadcast intent, so you can use this value
- to verify the integrity of transaction responses form Android Market. |
+ to verify the integrity of transaction responses form Google Play.
||||||||||||||||||||||||||||||||||||||||||||||
NOTIFY_IDS |
@@ -202,20 +202,20 @@ pairs, which are summarized in table 2.
|||||||||||||||||||||||||||||||||||||||||||||||
nonce | A number used once. Your application generates the nonce and sends it with the
- GET_PURCHASE_INFORMATION request. Android Market sends the nonce back as part of the
+ GET_PURCHASE_INFORMATION request. Google Play sends the nonce back as part of the
JSON string so you can verify the integrity of the message. |
||||||||||||||||||||||||||||||||||||||||||||||
notificationId | A unique identifier that is sent with an IN_APP_NOTIFY broadcast intent. Each
notificationId corresponds to a specify message that is waiting to be retrieved on
- the Android Market server. Your application sends back the notificationId with the
- GET_PURCHASE_INFORMATION message so Android Market can determine which messages you
+ the Google Play server. Your application sends back the notificationId with the
+ GET_PURCHASE_INFORMATION message so Google Play can determine which messages you
are retrieving. |
||||||||||||||||||||||||||||||||||||||||||||||
productId | The item's product identifier. Every item has a product ID, which you must specify in the - application's product list on the Android Market publisher site. | + application's product list on the Google Play publisher site.||||||||||||||||||||||||||||||||||||||||||||||
purchaseTime | diff --git a/docs/html/guide/market/billing/billing_testing.jd b/docs/html/guide/market/billing/billing_testing.jd index 5453047..77aa3ed 100755 --- a/docs/html/guide/market/billing/billing_testing.jd +++ b/docs/html/guide/market/billing/billing_testing.jd @@ -32,16 +32,16 @@ parent.link=index.html -
Accounts, publishing, and deployment issues | -Android -Market Help Forum | +Google Play +Help Forum | Publisher accounts, licensing key pair, test accounts, server responses, test responses, application deployment and results | ||||||||||||||||||||||||||||||
ILicensingService | One-way IPC interface over which a license check request is passed to the -Android Market client. | +Google Play client.||||||||||||||||||||||||||||||||
ILicenseResultListener | @@ -137,7 +137,7 @@ codes. By default, the LicenseValidator class in the LVL provides all of the necessary handling of these response codes for you. +returned by the Google Play server in a license response.
{@code ERROR_CONTACTING_SERVER} | -Local error — the Android Market application was not able to reach the + | Local error — the Google Play application was not able to reach the licensing server, possibly because of network availability problems. | No | @@ -217,12 +217,12 @@ application. |
{@code ERROR_NOT_MARKET_MANAGED} | Server error — the application (package name) was not recognized by -Android Market. | +Google Play.No | Do not retry the license check.
Can indicate that the application was not published -through Android Market or that there is an development error in the licensing +through Google Play or that there is an development error in the licensing implementation. |
Display the details screen for a specific application | -http://market.android.com/details?id=<package_name>
+ | http://play.google.com/store/details?id=<package_name>
| market://details?id=<package_name> |
Search for applications using a general string query. | -http://market.android.com/search?q=<query> |
+http://play.google.com/store/search?q=<query> |
market://search?q=<query> |
Search for applications by publisher name | -http://market.android.com/search?q=pub:<publisher_name> |
+http://play.google.com/store/search?q=pub:<publisher_name> |
market://search?q=pub:<publisher_name> |
Caution: If your application uses the Android Market's Copy - Protection feature, it cannot be installed to a device's SD card. However, if you use Android - Market's Application Licensing instead, +
Caution: If your application uses Google Play's Copy + Protection feature, it cannot be installed to a device's SD card. However, if you use Google + Play's Application Licensing instead, your application can be installed to internal or external storage, including SD cards.
Note: By default, your application will be installed on the diff --git a/docs/html/guide/topics/manifest/supports-gl-texture-element.jd b/docs/html/guide/topics/manifest/supports-gl-texture-element.jd index 6c4a05a..ebdd0b1 100644 --- a/docs/html/guide/topics/manifest/supports-gl-texture-element.jd +++ b/docs/html/guide/topics/manifest/supports-gl-texture-element.jd @@ -18,20 +18,20 @@ parent.link=manifest-intro.html
Android Market and Google Play and
<supports-gl-texture>
elements
Android Market filters applications according +
Google Play filters applications according to the texture compression formats that they support, to ensure that they can be installed only on devices that can handle their textures properly. Developers can use texture compression filtering as a way of targeting specific device types, based on GPU platform.
For important information about how
- Android Market uses <supports-gl-texture>
elements as
- the basis for filtering, please read Android
- Market and texture compression filtering, below.
<supports-gl-texture>
elements as
+ the basis for filtering, please read Google
+ Play and texture compression filtering, below.
Declared <supports-gl-texture>
elements are informational,
meaning that the Android system itself does not examine the elements at install
time to ensure matching support on the device. However, other services
-(such as Android Market) or applications can check your application's
+(such as Google Play) or applications can check your application's
<supports-gl-texture>
declarations as part of handling or
interacting with your application. For this reason, it's very important that
you declare all of the texture compression formats (from the list below) that
@@ -141,20 +141,20 @@ and others.
Android Market filters the applications that are visible to users, so that +
Google Play filters the applications that are visible to users, so that users can see and download only those applications that are compatible with -their devices. One of the ways Market filters applications is by texture +their devices. One of the ways it filters applications is by texture compression compatibility, giving you control over the availability of your application to various devices, based on the capabilities of their GPUs.
To determine an application's texture compression compatibility with a given -user's device, Android Market compares:
+user's device, Google Play compares:Each time you upload an application to the Android Market Publisher Site, -Android Market scans the application's manifest file and looks for any +
Each time you upload an application to the Google Play publisher site,
+Google Play scans the application's manifest file and looks for any
<supports-gl-texture>
elements. It extracts the
format descriptors from the elements and stores them internally as
metadata associated with the application .apk
and the application
version.
When a user searches or browses for applications on Android Market, +
When a user searches or browses for applications on Google Play, the service compares the texture compression formats supported by the application with those supported by the user's device. The comparison is based on the format descriptor strings and a match must be exact.
If any of an application's supported texture compression formats is -also supported by the device, Android Market allows the user to see the +also supported by the device, Google Play allows the user to see the application and potentially download it. Otherwise, if none of the application's -formats is supported by the device, Android Market filters the application so +formats is supported by the device, Google Play filters the application so that it is not available for download.
If an application does not declare any <supports-gl-texture>
elements,
-Android Market does not apply any filtering based on GL texture compression format.
Caution: The Android system does not pay attention to this attribute, so it does not affect how your application behaves at runtime. Instead, it is used -to enable filtering for your application on services such as Android Market. However, -Android Market currently does not support this attribute for filtering (on Android +to enable filtering for your application on services such as Google Play. However, +Google Play currently does not support this attribute for filtering (on Android 3.2), so you should continue using the other size attributes if your application does not support small screens.
diff --git a/docs/html/guide/topics/manifest/uses-feature-element.jd b/docs/html/guide/topics/manifest/uses-feature-element.jd index 9f80638..9175566 100644 --- a/docs/html/guide/topics/manifest/uses-feature-element.jd +++ b/docs/html/guide/topics/manifest/uses-feature-element.jd @@ -9,7 +9,7 @@ parent.link=manifest-intro.htmlAndroid Market and <uses-feature>
elements
Android Market filters the applications that are visible to users, so + +
Google Play and <uses-feature>
elements
Google Play filters the applications that are visible to users, so that users can see and download only those applications that are compatible with their -devices. One of the ways Market filters applications is by feature compatibility.
+devices. One of the ways it filters applications is by feature compatibility. -To do this, Market checks the +
To do this, Google Play checks the
<uses-feature>
elements in each application's manifest, to
-establish the app's feature needs. Market then shows or hides the application to
+establish the app's feature needs. Google Play then shows or hides the application to
each user, based on a comparison with the features available on the user's
device.
By specifying the features that your application requires, -you enable Android Market to present your application only to users whose +you enable Google Play to present your application only to users whose devices meet the application's feature requirements, rather than presenting it to all users.
For important information about how -Android Market uses features as the basis for filtering, please read Android Market and Feature-Based Filtering, +Google Play uses features as the basis for filtering, please read Google Play and Feature-Based Filtering, below.
Declared <uses-feature>
elements are informational only, meaning
that the Android system itself does not check for matching feature support on
the device before installing an application. However, other services
-(such as Android Market) or applications may check your application's
+(such as Google Play) or applications may check your application's
<uses-feature>
declarations as part of handling or interacting
with your application. For this reason, it's very important that you declare all of
the features (from the list below) that your application uses.
<uses-permission>
Android Market filters the applications that are visible to users, so that +
Google Play filters the applications that are visible to users, so that users can see and download only those applications that are compatible with -their devices. One of the ways Market filters applications is by feature +their devices. One of the ways it filters applications is by feature compatibility.
To determine an application's feature compatibility with a given user's -device, the Android Market service compares:
+device, Google Play compares:When the user launches the Market application, the application queries the +
When the user launches Google Play, the application queries the Package Manager for the list of features available on the device by calling {@link android.content.pm.PackageManager#getSystemAvailableFeatures()}. The -Market application then passes the features list up to the Android Market -service when establishing the session for the user.
+Store application then passes the features list up to Google Play +when establishing the session for the user. -Each time you upload an application to the Android Market Publisher Site, -Android Market scans the application's manifest file. It looks for +
Each time you upload an application to the Google Play publisher site,
+Google Play scans the application's manifest file. It looks for
<uses-feature>
elements and evaluates them in combination
with other elements, in some cases, such as <uses-sdk>
and
<uses-permission>
elements. After establishing the
@@ -253,17 +253,17 @@ application's set of required features, it stores that list internally as
metadata associated with the application .apk
and the application
version.
When a user searches or browses for applications using the Android Market +
When a user searches or browses for applications using the Google Play application, the service compares the features needed by each application with the features available on the user's device. If all of an application's required -features are present on the device, Android Market allows the user to see the +features are present on the device, Google Play allows the user to see the application and potentially download it. If any required feature is not -supported by the device, Android Market filters the application so that it is +supported by the device, Google Play filters the application so that it is not visible to the user and not available for download.
Because the features you declare in <uses-feature>
-elements directly affect how Android Market filters your application, it's
-important to understand how Android Market evaluates the application's manifest
+elements directly affect how Google Play filters your application, it's
+important to understand how Google Play evaluates the application's manifest
and establishes the set of required features. The sections below provide more
information.
"true"
), or whether the application prefers to use the feature
if available, but is designed to run without it ("false"
).
-Android Market handles explicitly declared features in this way:
+Google Play handles explicitly declared features in this way:
<uses-feature android:name="android.hardware.camera" android:required="true" />
<uses-feature android:name="android.hardware.camera" android:required="false" />
android:required
attribute, Android Market assumes that the feature
+android:required
attribute, Google Play assumes that the feature
is required and sets up filtering on it. In general, if your application is designed to run on Android 1.6 and earlier
versions, the android:required
attribute is not available in the
-API and Android Market assumes that any and all
+API and Google Play assumes that any and all
<uses-feature>
declarations are required.
Note: By declaring a feature explicitly and
including an android:required="false"
attribute, you can
-effectively disable all filtering on Android Market for the specified feature.
+effectively disable all filtering on Google Play for the specified feature.
To account for the cases above, Android Market attempts to discover an +
To account for the cases above, Google Play attempts to discover an
application's implied feature requirements by examining other elements
declared in the manifest file, specifically,
<uses-permission>
elements.
If an application requests hardware-related permissions, Android Market +
If an application requests hardware-related permissions, Google Play
assumes that the application uses the underlying hardware features and
therefore requires those features, even though there might be no
corresponding to <uses-feature>
declarations. For such
-permissions, Android Market adds the underlying hardware features to the
+permissions, Google Play adds the underlying hardware features to the
metadata that it stores for the application and sets up filters for them.
For example, if an application requests the CAMERA
permission
but does not declare a <uses-feature>
element for
-android.hardware.camera
, Android Market considers that the
+android.hardware.camera
, Google Play considers that the
application requires a camera and should not be shown to users whose devices do
not offer a camera.
If you don't want Android Market to filter based on a specific implied +
If you don't want Google Play to filter based on a specific implied
feature, you can disable that behavior. To do so, declare the feature explicitly
in a <uses-feature>
element and include an
android:required="false"
attribute. For example, to disable
@@ -366,30 +366,30 @@ the feature as shown below.
It's important to understand that the permissions that you
request in <uses-permission>
elements can directly affect how
-Android Market filters your application. The reference section Permissions that Imply Feature Requirements,
below, lists the full set of permissions that imply feature requirements and
therefore trigger filtering.
Android Market applies slightly different rules than described above, when +
Google Play applies slightly different rules than described above, when determining filtering for Bluetooth.
If an application declares a Bluetooth permission in a
<uses-permission>
element, but does not explicitly declare
-the Bluetooth feature in a <uses-feature>
element, Android
-Market checks the version(s) of the Android platform on which the application is
+the Bluetooth feature in a <uses-feature>
element, Google
+Play checks the version(s) of the Android platform on which the application is
designed to run, as specified in the <uses-sdk>
element.
As shown in the table below, Android Market enables filtering for the +
As shown in the table below, Google Play enables filtering for the
Bluetooth feature only if the application declares its lowest or targeted
-platform as Android 2.0 (API level 5) or higher. However, note that Android
-market applies the normal rules for filtering when the application explicitly
+platform as Android 2.0 (API level 5) or higher. However, note that Google
+Play applies the normal rules for filtering when the application explicitly
declares the Bluetooth feature in a <uses-feature>
element.
android.hardware.bluetooth
feature.android.hardware.bluetooth
feature (including
older releases).The examples below illustrate the different filtering effects, based on how -Android Market handles the Bluetooth feature.
+Google Play handles the Bluetooth feature.<uses-feature>
element.<manifest ...> @@ -439,7 +439,7 @@ declares a Bluetooth permission, but does not declare the Bluetooth feature in a
android:required="false"
attribute.You can use the aapt
tool, included in the Android SDK, to
-determine how Android Market will filter your application, based on its declared
+determine how Google Play will filter your application, based on its declared
features and permissions. To do so, run aapt
with the dump
badging
command. This causes aapt
to parse your
-application's manifest and apply the same rules as used by Android Market to
+application's manifest and apply the same rules as used by Google Play to
determine the features that your application requires.
To use the tool, follow these steps:
@@ -529,7 +529,7 @@ densities: '160'The tables below provide reference information about hardware and software -features and the permissions that can imply them on Android Market.
+features and the permissions that can imply them on Google Play.<uses-feature>
system.
-To prevent those apps from being made available unintentionally, Android -Market assumes that certain hardware-related permissions indicate that the +
To prevent those apps from being made available unintentionally, Google
+Play assumes that certain hardware-related permissions indicate that the
underlying hardware features are required by default. For instance, applications
that use Bluetooth must request the BLUETOOTH
permission in a
-<uses-permission>
element — for legacy apps, Android
-Market assumes that the permission declaration means that the underlying
+<uses-permission>
element — for legacy apps, Google
+Play assumes that the permission declaration means that the underlying
android.hardware.bluetooth
feature is required by the application
and sets up filtering based on that feature.
This element also affects the installation of the application on a particular device and - the availability of the application in Android Market: + the availability of the application on Google Play:
diff --git a/docs/html/guide/topics/manifest/uses-permission-element.jd b/docs/html/guide/topics/manifest/uses-permission-element.jd index 967fc5a..6c71fb4 100644 --- a/docs/html/guide/topics/manifest/uses-permission-element.jd +++ b/docs/html/guide/topics/manifest/uses-permission-element.jd @@ -8,21 +8,21 @@ parent.link=manifest-intro.html
<uses-permission>
and filtering on Android Market.
<uses-permission>
and filtering on Google Play.
In some cases, the permissions that you request
through <uses-permission>
can affect how
-your application is filtered by Android Market.
If you request a hardware-related permission —
-CAMERA
, for example — Android Market assumes that your
+CAMERA
, for example — Google Play assumes that your
application requires the underlying hardware feature and filters the application
from devices that do not offer it.
To control filtering, always explicitly declare
hardware features in <uses-feature>
elements, rather than
-relying on Android Market to "discover" the requirements in
+relying on Google Play to "discover" the requirements in
<uses-permission>
elements. Then, if you want to disable
filtering for a particular feature, you can add a
android:required="false"
attribute to the
diff --git a/docs/html/guide/topics/manifest/uses-sdk-element.jd b/docs/html/guide/topics/manifest/uses-sdk-element.jd
index 99c91f6..8fa39d1 100644
--- a/docs/html/guide/topics/manifest/uses-sdk-element.jd
+++ b/docs/html/guide/topics/manifest/uses-sdk-element.jd
@@ -33,16 +33,16 @@ major version or the sum of the major and minor versions).
Android Market and <uses-sdk> attributes
-Android Market filters the applications that are visible to users, so + +
Google Play and <uses-sdk> attributes
+Google Play filters the applications that are visible to users, so
that users can only see and download applications that are compatible with their
-devices. One of the ways Market filters applications is by Android
-version-compatibility. To do this, Market checks the <uses-sdk>
+devices. One of the ways it filters applications is by Android
+version-compatibility. To do this, Google Play checks the <uses-sdk>
attributes in each application's manifest to establish its version-compatibility
range, then shows or hides the application based on a comparison with the API
Level of the user's Android system version. For more information, see Market Filters.
An application declaring maxSdkVersion="5"
in its
- manifest is published on Android Market. A user whose device is running Android
+ manifest is published on Google Play. A user whose device is running Android
1.6 (API Level 4) downloads and installs the app. After a few weeks, the user
receives an over-the-air system update to Android 2.0 (API Level 5). After the
update is installed, the system checks the application's
@@ -143,7 +143,7 @@ the corresponding platform version.
maxSdkVersion
attribute during
-installation or re-validation. Android Market will continue to use the attribute
+installation or re-validation. Google Play will continue to use the attribute
as a filter, however, when presenting users with applications available for
download. For a list of camera features, see the manifest Features Reference.
-Adding camera features to your manifest causes Android Market to prevent your application from +
Adding camera features to your manifest causes Google Play to prevent your application from being installed to devices that do not include a camera or do not support the camera features you -specify. For more information about using feature-based filtering with Android Market, see Android -Market and Feature-Based Filtering.
+specify. For more information about using feature-based filtering with Google Play, see Google +Play and Feature-Based Filtering.If your application can use a camera or camera feature for proper operation, but does not require it, you should specify this in the manifest by including the {@code android:required} attribute, and setting it to {@code false}:
@@ -1260,7 +1260,7 @@ supported.If your application requires certain camera features in order to function properly, you can require them through additions to your application manifest. When you declare the use of specific -camera features, such as flash and auto-focus, the Android Market restricts your application from +camera features, such as flash and auto-focus, Google Play restricts your application from being installed on devices which do not support these features. For a list of camera features that can be declared in your app manifest, see the manifest Features diff --git a/docs/html/guide/topics/network/sip.jd b/docs/html/guide/topics/network/sip.jd index 276adb6..600da78 100644 --- a/docs/html/guide/topics/network/sip.jd +++ b/docs/html/guide/topics/network/sip.jd @@ -147,7 +147,7 @@ href="{@docRoot}guide/topics/manifest/uses-sdk-element.html"><uses-sdk>
To control how your application is filtered from devices that do not support -SIP (for example, in Android Market), add the following to your application's +SIP (for example, on Google Play), add the following to your application's manifest:
uses-feature
element so that your application shows up in the Android
-Market only for devices that have NFC hardware:
+ uses-feature
element so that your application shows up in Google
+Play only for devices that have NFC hardware:
<uses-feature android:name="android.hardware.nfc" android:required="true" />@@ -660,7 +660,7 @@ certainty that your application is started when an NFC tag is scanned. An AAR ha of an application embedded inside an NDEF record. You can add an AAR to any NDEF record of your NDEF message, because Android searches the entire NDEF message for AARs. If it finds an AAR, it starts the application based on the package name inside the AAR. If the application is not present on the device, -Android Market is launched to download the application. +Google Play is launched to download the application.
AARs are useful if you want to prevent other applications from filtering for the same intent and potentially handling specific tags that you have deployed. AARs are only supported at the @@ -678,7 +678,7 @@ the intent also matches the AAR, start the Activity.
Note that this code comments out an AAR, which you can remove. If you enable the AAR, the application specified in the AAR always receives the Android Beam message. If the application is not -present, the Android Market is started to download the application. Therefore, the following intent +present, Google Play launches to download the application. Therefore, the following intent filter is not technically necessary for Android 4.0 devices or later if the AAR is used:
diff --git a/docs/html/guide/topics/resources/localization.jd b/docs/html/guide/topics/resources/localization.jd index 9affb15..c2b668d 100755 --- a/docs/html/guide/topics/resources/localization.jd +++ b/docs/html/guide/topics/resources/localization.jd @@ -186,7 +186,7 @@ speak. and can include other types of resources such as animations. res/drawable/
(required directory holding at least
- one graphic file, for the application's icon in the Market) res/layout/
(required directory holding an XML
file that defines the default layout) res/anim/
(required if you have any
@@ -507,7 +507,7 @@ the new locale.
The Android Market is +
The Google Play is the main application distribution system for Android devices. To publish a localized application, you need to sign your application, version it, and go through all the other steps described in href="{@docRoot}guide/publishing/app-signing.html#strategies">Signing Strategies.
Each option is discussed in the following sections.
@@ -633,9 +633,9 @@ whether there's a pressure sensor on a device: } -If you are publishing your application on Android Market you can use the +
If you are publishing your application on Google Play you can use the
<uses-feature>
element in your manifest file to filter your application from devices that do not
have the appropriate sensor configuration for your application. The
@@ -650,7 +650,7 @@ following is an example manifest entry that filters apps that do not have an acc
If you add this element and descriptor to your application's manifest, users will see your -application on Android Market only if their device has an accelerometer.
+application on Google Play only if their device has an accelerometer.You should set the descriptor to android:required="true"
only if your application
relies entirely on a specific sensor. If your application uses a sensor for some functionality, but
diff --git a/docs/html/guide/topics/ui/actionbar.jd b/docs/html/guide/topics/ui/actionbar.jd
index e59fa0f..bf7369a 100644
--- a/docs/html/guide/topics/ui/actionbar.jd
+++ b/docs/html/guide/topics/ui/actionbar.jd
@@ -349,7 +349,7 @@ of the following:
Example frequent actions: "New message" in the Messaging app and -"Search" in Android Market.
+"Search" on Google Play.