diff --git a/docs/html/distribute/googleplay/quality/tablet.jd b/docs/html/distribute/googleplay/quality/tablet.jd index 6d7e3e2cbb059..a54348b738a63 100644 --- a/docs/html/distribute/googleplay/quality/tablet.jd +++ b/docs/html/distribute/googleplay/quality/tablet.jd @@ -12,15 +12,15 @@ page.title=Tablet App Quality Checklist
  • 5. Adjust fonts and touch targets
  • 6. Adjust homescreen widgets
  • 7. Offer the app's full feature set
  • -
  • 8. Don’t require hardware features
  • -
  • 9. Declare tablet screen support
  • -
  • 10. Showcase your tablet UI
  • -
  • 11. Follow publishing best practices
  • +
  • 8. Target Android versions properly
  • +
  • 9. Declare dependencies properly
  • +
  • 10. Declare tablet screens support
  • +
  • 11. Showcase your tablet UI
  • +
  • 12. Follow publishing best practices
  • Testing

      -
    1. Basic Technical Checks for Tablets
    2. Setting Up a Test Environment
    @@ -47,12 +47,7 @@ to the greatest extent possible.

    that can help you address the topics raised in each task.

    -

    1. Test for Core Tablet App Quality

    - -

    Before publishing, make sure that your app and it's store listing meet the - core quality guidlines below.

    - -
    Core app quality
    +

    1. Test for basic tablet app quality

    The first step in delivering a great tablet app experience is making sure that it meets the core app quality criteria for all of the devices @@ -60,68 +55,22 @@ and form factors that the app is targeting. For complete information, see the Core App Quality Guidelines.

    -
    Basic technical checks for tablets

    - Before publishing, you should also ensure that your app passes several basic - technical checks, such as: + Before publishing, also ensure that your app passes several basic + technical checks and launch criteria, such as:

    -

    - For details, see Basic Technical - Checks. -

    +

    The sections that follow provide more information about these and other +quality guidelines for tablet apps.

    -
    Tablet screenshots and other promotional tools
    - -

    Make sure that you upload screenshots of your tablet UI to the - Developer Console and highlight your tablet experience in your app description, - video, and promotional campaigns. For details, see Showcase your - tablet UI in Google Play.

    - -
    Test environment
    - -

    - To assess the quality of your app on tablets, you need to set up a suitable - hardware or emulator environment for testing. For more information, see - Setting Up a Test Environment. -

    -

    - Note that a successful tablet app will go well beyond the core and tablet - app quality criteria to offer a custom tablet experience to users. Read - the sections below for ideas on how to plan and develop a great tablet UI for - your app. -

    - - -
    -

    - Related resources -

    - - -

    2. Optimize your layouts for larger screens

    @@ -288,7 +237,7 @@ different layouts in the appropriate screen size buckets (such as
  • Planning for Multiple + "{@docRoot}training/design-navigation/multiple-sizes.html">Planning for Multiple Touchscreen Sizes—Android Training class that walks you through the essentials of planning an intuitive, effective navigation for tablets and other devices. @@ -304,7 +253,8 @@ different layouts in the appropriate screen size buckets (such as -

    4. Use Icons and other assets that are designed for tablet screens

    +

    4. Use Icons and other assets that are designed +for tablet screens

    So that your app looks its best, make sure to use icons and other bitmap assets that are created specifically for the densities used by tablet screens. @@ -362,6 +312,8 @@ resource qualifiers to ensure that the proper set of alternative resources gets loaded.

  • +

    At a minimum, your app should supply custom drawables and assets for common tablet screen densities, tagged with the qualifiers hdpi, xhdpi, or xxhdpi.

    +

    Related resources @@ -375,7 +327,7 @@ gets loaded.
  • Providing + "{@docRoot}guide/topics/resources/providing-resources.html">Providing Resources—Developer documentation on how to provide sets of layouts and drawable resources for specific ranges of device screens. @@ -390,7 +342,7 @@ gets loaded.
  • Supporting Different + "{@docRoot}training/basics/supporting-devices/screens.html">Supporting Different Screens—Android Training class that takes you through the process of optimizing the user experience for different screen sizes and densities. @@ -527,9 +479,25 @@ that it is not accessible to users or that it offers “graceful degradation” to a replacement feature (also see the section below on hardware features).
  • +

    8. Target Android versions properly

    -

    8. Don’t require hardware features that might not be - available on tablets

    +

    To ensure the broadest possible distribution to tablets, make sure that your +app is targeting the Android versions that support tablets. You can declare +the targeted range of Android versions in the +<uses-sdk> +element in the app manifest.

    + +

    At a minimum, your app's +<uses-sdk> +should declare support for Android versions as follows:

    + + + +

    9. Declare hardware feature dependencies properly

    Handsets and tablets typically offer slightly different hardware support for sensors, camera, telephony, and other features. For example, many tablets are @@ -579,13 +547,13 @@ run-time checking for the hardware capability that it needs and handle as needed

    -

    9. Declare support for tablet screen configurations

    +

    10. Declare support for tablet screens

    -

    To ensure that you can distribute your app to a broad range of tablets, -declare all the screen sizes that your app supports in its manifest:

    +

    To ensure that you can distribute your app to a broad range of tablets, your app should +declare support for tablet screen sizes in the +<supports-screens> +element in the app manifest, as follows:

    +

    If the app declares a +<compatible-screens> +element in the manifest, the element should include attributes that specify +all of the size and density combinations for tablet screens that the +app supports. Note that, if possible, you should avoid using the +<supports-screens> +element in your app.

    +

    Related resources

    -

    10. Showcase your tablet UI in Google Play

    +

    11. Showcase your tablet UI in Google Play

    After you've done the work to create an rich, optimized UI for your tablet @@ -659,10 +623,9 @@ you should avoid using this element in your app.

    Tablet users want to know what your app is like on a tablet device, not on a - phone. Capitalize on their interest by showing them screenshots of your - tablet UI on your app's store listing page. You can upload tablet screenshots - from the Developer Console. Here are some tips and guidelines: -

    + phone. If you developed a tablet app, make sure to upload screenshots + of your tablet UI to the Developer Console. Here are some guidelines: +

    -

    11. Follow best practices for publishing in Google Play

    +

    12. Follow best practices for publishing in Google Play

    -

    Make sure that your app follows key best practices that ensure broad - distribution to tablet devices.

    +Here are some best practices to consider when publishing a tablet app on Google Play.

    -
    Verify basic technical checks
    +
    Check the app's filtering
    - +

    After you've uploaded the app to the Developer Console, check the APK's Supported Devices list to make sure that the app is not filtered from tablet devices that you want to target.

    -
    - Distribute as a single APK -
    +
    Distribute as a single APK

    It's recommended that you publish your app as a single APK for all screen @@ -841,7 +793,7 @@ you should avoid using this element in your app.

    If necessary, you can alternatively choose to deliver your app using Multiple APK Support, + "{@docRoot}google/play/publishing/multiple-apks.html">Multiple APK Support, although in most cases using a single APK to reach all devices is strongly recommended.

    @@ -858,189 +810,6 @@ you should avoid using this element in your app. -

    Basic Technical Checks for Tablets

    - -

    - This section lists specific details on basic technical checks that you should - perform before publishing. The checks ensure that your app is properly targeted to a - broad range of tablet devices. Make sure that the app meets all of the checks - listed below. -

    - -

    - To verify the basic technical checks, follow the Test - Procedures listed below. Before you start, you need to obtain need the - application source code. -

    - -
    -Technical checks -
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    - Area - - ID - - Description - - Tests -
    Android Versions - TB-R1 - -

    App does target minimum Android versions - that support tablets:

    -
      -
    1. targetSdkVersion is declared with value 11 or higher, OR
    2. -
    3. minSdkVersion is declared with value 11 or higher.
    4. -
    -
    TA-1
    - TB-R2 - -

    App does not limit targeting to - exclude Android versions that support tablets:

    -
      -
    1. maxSdkVersion, if declared, must have a value of 12 - or higher.
    2. -
    -

    Note that, in most cases, the use of - maxSdkVersion is not recommended.

    -
    TA-1
    Feature Dependencies - TB-R3 - -

    App does not limit distribution to - tablets by requiring hardware features not normally available on tablets, - whether or implied by - permissions. -

    -
      -
    1. the app must not declare a <uses-feature> element for - android.hardware.telephony unless the element is specifically - marked with the android:required="false" attribute. -
    2. -
    -

    For details, see Hardware Requirements - earlier in this document.

    -
    TA-1
    Screens Support - TB-R4 - -

    App does not limit distribution to common - tablet screen sizes:

    -
      -
    1. If declared, <supports-screens> element must not specify - android:largeScreens="false" or android:xlargeScreens="false".
    2. -
    3. For a minSdkVersion value less than 13, a <supports-screens> - element must be declared with both android:largeScreens="true" - and android:xlargeScreens="true".
    4. -
    -
    TA-1
    - TB-R5 - -

    App does supply custom drawables and - assets for common tablet screen densities. Specifically, the APK must include - corresponding resource directories tagged with these qualifiers:

    -
      -
    1. An hdpi qualifier, OR
    2. -
    3. An xhdpi qualifier, OR
    4. -
    5. An xxhdpi qualifier
    6. -
    - -

    For details, see Icons and Other Assets - earlier in this document.

    -
    TA-2
    - -

    If you use multiple APK - support to deliver size- or version-specific APKs, the APKs and their - characteristics must meet all of the criteria listed above, either individually - or as a cumulative set.

    - -
    - Test procedures -
    - - - - - - - - - - - - -
    - Procedure - - Description -
    - TA-1 - -

    Obtain the APK and inspect the manifest.xml file. Check for the required attribute values.

    -
    - TA-2 - -

    Obtain the APK and inspect the resources - directories. Make sure that the app includes custom drawables and assets - directories tagged with the required qualifiers.

    -
    - -
    -

    - Related resources -

    - - -

    Setting Up a Test Environment for Tablets