From 4d7bc65538c7cd9fbb1fbbcf22d1da47fcee1219 Mon Sep 17 00:00:00 2001 From: Dirk Dougherty Date: Fri, 27 Jan 2012 17:56:49 -0800 Subject: Doc change: String changes for Android Market Change-Id: I823812a4fd24021bec906ad856479c92a8d2a759 --- docs/html/guide/practices/compatibility.jd | 42 +++++++++++----------- docs/html/guide/practices/design/accessibility.jd | 7 ++-- docs/html/guide/practices/optimizing-for-3.0.jd | 14 ++++---- docs/html/guide/practices/screens-distribution.jd | 14 ++++---- docs/html/guide/practices/screens_support.jd | 4 +-- .../ui_guidelines/activity_task_design.jd | 2 +- .../ui_guidelines/icon_design_launcher.jd | 30 ++++++++-------- .../ui_guidelines/icon_design_launcher_archive.jd | 12 +++---- 8 files changed, 62 insertions(+), 63 deletions(-) (limited to 'docs/html/guide/practices') diff --git a/docs/html/guide/practices/compatibility.jd b/docs/html/guide/practices/compatibility.jd index bb7a72e..5e514c4 100644 --- a/docs/html/guide/practices/compatibility.jd +++ b/docs/html/guide/practices/compatibility.jd @@ -7,7 +7,7 @@ page.title=Android Compatibility

See also

  1. Market Filters
    2. +href="{@docRoot}guide/appendix/market-filters.html">Filtering on Google Play
  2. Providing Alternative Resources
  3. your apps to do that, while at the same time letting you maintain control of what types of devices your app is available to. With a bit of forethought and some minor changes in your app's manifest file, you can ensure that users -whose devices can’t run your app will never see it in the Android Market, and +whose devices can’t run your app will never see it on Google Play, and will not get in trouble by downloading it. This page explains how you can control which devices have access to your apps, and how to prepare your apps to make sure they reach the right audience.

    @@ -64,7 +64,7 @@ every class and every API for that API level.

    corresponding hardware or feature. But that’s not a problem: we also designed Android to prevent apps from being visible to devices which don’t have features the apps require. We’ve built support for this right into the SDK tools, and -it’s part of the Android platform itself, as well as Android Market.

    +it’s part of the Android platform itself, as well as part of Google Play.

    As a developer, you have complete control of how and where your apps are available. Android provides tools as a first-class part of the platform that let @@ -79,9 +79,9 @@ only the devices capable of running them.

  4. You state the features your app requires by declaring <uses-feature> elements its manifest file.
    5. -
  5. Devices are required to declare the features they include to Android -Market.
    6. -
  6. Android Market uses your app’s stated requirements to filter it from devices +
  7. Devices are required to declare the features they include to Google +Play.
    8. +
  8. Google Play uses your app’s stated requirements to filter it from devices that don’t meet those requirements.
@@ -103,24 +103,24 @@ instead use the fine-grained controls Android provides.

- -

Filtering on Android Market

+ +

Filtering on Google Play

-

Android Market filters the applications that are visible to users, so +

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. To do this, Market checks the +

One of the ways Google Play filters applications is by +feature compatibility. 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.

For information about other filters that you can use to control the availability of your apps, see the -Market -Filters document.

+Filters on Google Play +document.

@@ -142,8 +142,8 @@ future versions, new feature IDs will be added as well.

When you write your application, you specify which features your app requires by listing their feature IDs in <uses-feature> elements in -the AndroidManifest.xml file. This is the information that Android -Market uses to match your app to devices that can run it. For instance, if you +the AndroidManifest.xml file. This is the information that Google +Play uses to match your app to devices that can run it. For instance, if you state that your app requires android.software.live_wallpapers, it won’t be shown to devices that don’t support Live Wallpapers.

@@ -170,12 +170,12 @@ audience size and minimizing development costs.

business or legal reasons. For instance, an app that displays train schedules for the London Underground is unlikely to be useful to users outside the United Kingdom. Other apps might not be permitted in certain countries for business or -legal reasons. For cases such as these, Android Market itself provides +legal reasons. For cases such as these, Google Play itself provides developers with filtering options that allow them control their app’s availability for non-technical reasons.

-

The help information for Android Market provides full details, but in a -nutshell, developers can use the Market publisher UI to:

+

The help information for Google Play provides full details, but in a +nutshell, developers can use the Google Play publisher UI to:

@@ -682,7 +682,7 @@ your applications. For example:

<uses-feature android:name="android.hardware.telephony" />

By default, this declares that your application requires telephony features. So, -external services such as Android Market use this information to filter your application from +external services such as Google Play use this information to filter your application from devices that do not offer telephony.

If, however, your application uses, but does not require the feature, you should diff --git a/docs/html/guide/practices/screens-distribution.jd b/docs/html/guide/practices/screens-distribution.jd index 60c9c95..a7c4a8e 100644 --- a/docs/html/guide/practices/screens-distribution.jd +++ b/docs/html/guide/practices/screens-distribution.jd @@ -37,7 +37,7 @@ href="{@docRoot}guide/practices/optimizing-for-3.0.html">Optimizing Apps for And configurations of screen size and density, you can instead choose to limit the distribution of your application to certain types of screens, such as only tablets and other large devices or only handsets and similar-sized devices. To do so, you can enable filtering by external services such as -Android Market by adding elements to your manifest file that specify the screen configurations your +Google Play by adding elements to your manifest file that specify the screen configurations your application supports.

However, before you decide to restrict your application to certain screen configurations, you @@ -58,7 +58,7 @@ might discover that your application can't scale up well or perhaps you've decid versions of your application for different screen configurations. In such a case, you can use the {@code <compatible-screens>} element to manage the distribution of your application based on -combinations of screen size and density. External services such as Android Market use this +combinations of screen size and density. External services such as Google Play use this information to apply filtering to your application, so that only devices that have a screen configuration with which you declare compatibility can download your application.

@@ -68,7 +68,7 @@ configuration with which you declare compatibility can download your application compatible, using both the {@code android:screenSize} and {@code android:screenDensity} attributes. Each {@code <screen>} element must include both attributes to specify an individual screen configuration—if either attribute is missing, then the element is invalid -(external services such as Android Market will ignore it).

+(external services such as Google Play will ignore it).

For example, if your application is compatible with only small and normal size screens, regardless of screen density, you must specify eight different {@code <screen>} elements, @@ -173,7 +173,7 @@ Tools for Managing Screen Sizes.

href="{@docRoot}guide/topics/manifest/supports-screens-element.html">{@code <supports-screens>} element for the reverse scenario (when your application is not compatible with larger screens) and set the larger screen size attributes to {@code "false"}, then -external services such as Android Market do not apply filtering. Your application +external services such as Google Play do not apply filtering. Your application will still be available to larger screens, but when it runs, it will not resize to fit the screen. Instead, the system will emulate a handset screen size (about 320dp x 480dp; see Screen Compatibility Mode for more @@ -197,13 +197,13 @@ configurations.

Publishing Multiple APKs for Different Screens

-

Although we recommend that you publish one APK for your application, Android Market allows +

Although we recommend that you publish one APK for your application, Google Play allows you to publish multiple APKs for the same application when each APK supports a different set of screen configurations (as declared in the manifest file). For example, if you want to publish both a handset version and a tablet version of your application, but you're unable to make the same APK work for both screen sizes, you can actually publish two APKs for the same application listing. Depending on each device's -screen configuration, Android Market will deliver it the APK that you've declared to support that +screen configuration, Google Play will deliver it the APK that you've declared to support that device's screen.

Beware, however, that publishing multiple APKs for the same application is @@ -212,5 +212,5 @@ APK that can support a wide range of device configurations. Supporting sizes, especially, is within reason using a single APK, as long as you follow the guide to Supporting Multiple Screens.

-

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/practices/screens_support.jd b/docs/html/guide/practices/screens_support.jd index fb121bd..29dff26 100644 --- a/docs/html/guide/practices/screens_support.jd +++ b/docs/html/guide/practices/screens_support.jd @@ -882,8 +882,8 @@ application requires is the smallest possible on any device.

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/practices/ui_guidelines/activity_task_design.jd b/docs/html/guide/practices/ui_guidelines/activity_task_design.jd index 9be72ee..f8ca3f8 100644 --- a/docs/html/guide/practices/ui_guidelines/activity_task_design.jd +++ b/docs/html/guide/practices/ui_guidelines/activity_task_design.jd @@ -886,7 +886,7 @@ href="{@docRoot}guide/topics/intents/intents-filters.html">Intents and Intent Fi You can perform this test when initializing the user interface. For instance, you could disable the user control that initiates the Intent object, or display a message to the user that lets them go - to a location, such as the Market, to download its application. + to a location, such as Google Play, to download its application. In this way, your code can start the activity (using either startActivity() or startActivityForResult()) only if the intent has tested to resolve to an activity that is actually present. diff --git a/docs/html/guide/practices/ui_guidelines/icon_design_launcher.jd b/docs/html/guide/practices/ui_guidelines/icon_design_launcher.jd index 6b686b1..4b6768f 100644 --- a/docs/html/guide/practices/ui_guidelines/icon_design_launcher.jd +++ b/docs/html/guide/practices/ui_guidelines/icon_design_launcher.jd @@ -49,9 +49,9 @@ across the range of devices on which your application can be installed. See Tips for Designers for suggestions on how to work with multiple sets of icons.

-

A high-resolution version of your application launcher icon is also required by Android Market +

A high-resolution version of your application launcher icon is also required by Google Play for use in application listings. For more details on this, see Application Icons in Android Market below.

+href="#icons_in_market">Application Icons on Google Play below.

Note: @@ -81,7 +81,7 @@ need to review the old guidelines, see the

  1. Promote the brand and tell the story of the app.
    2. -
  2. Help users discover the app in Android Market.
    3. +
  3. Help users discover the app on Google Play.
  4. Function well in the Launcher.
@@ -100,19 +100,19 @@ app is about. Thus, you should:

-

Help users discover the app in Android Market

+

Help users discover the app on Google Play

-

App launcher icons are the first look that prospective users will get of your app in Android -Market. A high quality app icon can influence users to find out more as they scroll through lists of +

App launcher icons are the first look that prospective users will get of your app on Google Play. +A high quality app icon can influence users to find out more as they scroll through lists of applications.

Quality matters here. A well-designed icon can be a strong signal that your app is of similarly high quality. Consider working with an icon designer to develop the app’s launcher icon.

-

Note: Android Market requires a high-resolution version of your -icon; for more details on this, see Application Icons in Android -Market below.

+

Note: Google Play requires a high-resolution version of your +icon; for more details on this, see Application Icons in Google +Play below.

Function well in the Launcher

@@ -239,21 +239,21 @@ This padding can also be used to make room for a subtle drop shadow, which can h that launcher icons are legible across on any background color.

-

Application Icons in Android Market

+

Application Icons on Google Play

If you are publishing your application on -Android Market, you will also need to provide a 512 x 512 pixel, high-resolution application icon -in the developer console at upload time. This icon -will be used in various locations in Android Market and does not replace your launcher icon.

+Google Play, you will also need to provide a 512 x 512 pixel, high-resolution application icon +in the developer console at upload time. This icon +will be used in various locations on Google Play and does not replace your launcher icon.

For tips and recommendations on creating high-resolution launcher icons that can easily be scaled up to 512x512, see Tips for Designers.

-

For information and specifications about high-resolution application icons in Android Market, see +

For information and specifications about high-resolution application icons on Google Play, see the following article:

-Graphic Assets for your Application (Android Market Help) » +Graphic Assets for your Application (Google Play Help) »

diff --git a/docs/html/guide/practices/ui_guidelines/icon_design_launcher_archive.jd b/docs/html/guide/practices/ui_guidelines/icon_design_launcher_archive.jd index ea036cd..85a3cc8 100644 --- a/docs/html/guide/practices/ui_guidelines/icon_design_launcher_archive.jd +++ b/docs/html/guide/practices/ui_guidelines/icon_design_launcher_archive.jd @@ -56,13 +56,13 @@ suggestions on how to work with multiple sets of icons.

-

Application Icons in Android Market

+

Application Icons on Google Play

If you are publishing -your application on Android Market, you will also need to provide a 512x512 +your application on Google Play, you will also need to provide a 512x512 pixel, high-resolution application icon in the developer console at upload-time. -This icon will be used in various locations in Android Market and does +href="http://play.google.com/apps/publish">developer console at upload-time. +This icon will be used in various locations on Google Play and does not replace your launcher icon.

For tips and recommendations on creating high-resolution launcher icons that @@ -71,11 +71,11 @@ can easily be scaled up to 512x512, see Tips for Designers.

For information and specifications about high-resolution application -icons in Android Market, see the following article:

+icons on Google Play, see the following article:

- Graphic Assets for your Application (Android Market Help) » + Graphic Assets for your Application (Google Play Help) » -- cgit v1.1