From b4dc1c80a29dfab920eb0bcd6a239629e9700c16 Mon Sep 17 00:00:00 2001 From: Dirk Dougherty Date: Wed, 3 Oct 2012 19:36:08 -0700 Subject: Revert "Doc change: Add core quality and tablet quality docs, tablet developer stories." This reverts commit c395f4a39cef3e0c2eaac8318b5e1723eac7d696 Change-Id: If74bdf2e567f60fc1af9e2c272531ef58e2cee41 --- docs/html/distribute/distribute_toc.cs | 36 +- .../html/distribute/googleplay/about/monetizing.jd | 5 +- .../distribute/googleplay/publish/preparing.jd | 93 +-- docs/html/distribute/googleplay/quality/core.jd | 783 --------------------- docs/html/distribute/googleplay/quality/index.jd | 46 -- docs/html/distribute/googleplay/quality/tablet.jd | 555 --------------- docs/html/distribute/googleplay/spotlight/index.jd | 46 -- .../distribute/googleplay/spotlight/tablets.jd | 283 -------- .../googleplay/strategies/app-quality.jd | 33 +- docs/html/images/distribute/instapaper.png | Bin 359093 -> 0 bytes docs/html/images/distribute/mint.png | Bin 471615 -> 0 bytes docs/html/images/distribute/tinyvillage.png | Bin 945561 -> 0 bytes docs/html/images/ui-ex-multi-pane.png | Bin 10074 -> 0 bytes docs/html/images/ui-ex-single-panes.png | Bin 11434 -> 0 bytes 14 files changed, 53 insertions(+), 1827 deletions(-) delete mode 100644 docs/html/distribute/googleplay/quality/core.jd delete mode 100644 docs/html/distribute/googleplay/quality/index.jd delete mode 100644 docs/html/distribute/googleplay/quality/tablet.jd delete mode 100644 docs/html/distribute/googleplay/spotlight/index.jd delete mode 100644 docs/html/distribute/googleplay/spotlight/tablets.jd delete mode 100644 docs/html/images/distribute/instapaper.png delete mode 100644 docs/html/images/distribute/mint.png delete mode 100644 docs/html/images/distribute/tinyvillage.png delete mode 100644 docs/html/images/ui-ex-multi-pane.png delete mode 100644 docs/html/images/ui-ex-single-panes.png diff --git a/docs/html/distribute/distribute_toc.cs b/docs/html/distribute/distribute_toc.cs index ad3121c6a994..84103b907721 100644 --- a/docs/html/distribute/distribute_toc.cs +++ b/docs/html/distribute/distribute_toc.cs @@ -28,7 +28,9 @@
  • Publishing Checklist
    • - +
  • + App Quality +
    • @@ -77,26 +79,6 @@ - -
  • -
    - App Quality -
    - -
    • - - +
  • diff --git a/docs/html/distribute/googleplay/about/monetizing.jd b/docs/html/distribute/googleplay/about/monetizing.jd index d5c6dfad2df2..4980edaecbbe 100644 --- a/docs/html/distribute/googleplay/about/monetizing.jd +++ b/docs/html/distribute/googleplay/about/monetizing.jd @@ -42,7 +42,7 @@ manages the application download.

    Convenient payment options

    Users can purchase your products on Google Play using several convenient -payment methods—credit cards, Direct Carrier Billing, gift cards, and Google Play balance.

    +payment methods—credit cards, Direct Carrier Billing, and Google Play balance.

    Credit card is the most common method of payment. Users can pay using any credit card that they’ve registered in Google Play. To make it easy for users to get started, @@ -52,9 +52,8 @@ registration is offered as a part of initial device setup process.

    Payment methods on Google Play

      -
    • Credit card
      • +
    • Credit Card
    • Direct Carrier Billing
      • -
    • Gift card
    • Google Play balance (stored value)
    diff --git a/docs/html/distribute/googleplay/publish/preparing.jd b/docs/html/distribute/googleplay/publish/preparing.jd index 463343d2d7e5..6ea0f53946ec 100644 --- a/docs/html/distribute/googleplay/publish/preparing.jd +++ b/docs/html/distribute/googleplay/publish/preparing.jd @@ -6,21 +6,20 @@ page.title=Publishing Checklist for Google Play
    1. 1. Understand the publishing process
    2. 2. Understand Google Play policies
      3. -
    3. 3. Test for Core App Quality
      4. -
    4. 4. Determine your content rating
      5. -
    5. 5. Determine country distribution
      6. -
    6. 6. Confirm the app's overall size
      7. -
    7. 7. Confirm app compatibility ranges
      8. -
    8. 8. Decide on free or priced
      9. -
    9. 9. Consider In-app Billing
      10. -
    10. 10. Set prices for your apps
      11. -
    11. 11. Start localization early
      12. -
    12. 12. Prepare promotional graphics
      13. -
    13. 13. Build the release-ready APK
      14. -
    14. 14. Complete the product details
      15. -
    15. 15. Use Google Play badges
      16. -
    16. 16. Final checks and publishing
      17. -
    17. 17. Support users after launch
      18. +
    18. 3. Determine your content rating
      19. +
    19. 4. Determine country distribution
      20. +
    20. 5. Confirm the app's overall size
      21. +
    21. 6. Confirm app compatibility ranges
      22. +
    22. 7. Decide on free or priced
      23. +
    23. 8. Consider In-app Billing
      24. +
    24. 9. Set prices for your apps
      25. +
    25. 10. Start localization
      26. +
    26. 11. Prepare promotional graphics
      27. +
    27. 12. Build the release-ready APK
      28. +
    28. 13. Complete the product details
      29. +
    29. 14. Use Google Play badges and links to your promotional campaigns
      30. +
    30. 15. Final checks and publishing
      31. +
    31. 16. Support users after launch
    @@ -87,39 +86,7 @@ violations, termination of your developer account.

    -

    3. Test for Core App Quality

    - -

    Before you publish an app on Google Play, it's important to make sure that -it meets the basic quality expectations for all Android apps, on all of the devices that you -are targeting. You can check your app's quality by setting up a test -environment and testing the app against a short set of core app quality criteria. -For complete information, see the Core App Quality Guidelines. -

    - -

    If your app is targeting tablet devices, make sure that it delivers a rich, compelling -experience to your tablet customers. See the Tablet App Quality Checklist -for recommendations on ways to optimize your app for tablets.

    - - - - - -

    Related resources:

    - -
    - -

    4. Determine your app's content rating

    +

    3. Determine your app's content rating

    Google Play requires you to set a content rating for your app, which informs Google Play users of its maturity level. Before you publish, you should confirm @@ -148,7 +115,7 @@ are required in your app binary.

    -

    5. Determine country distribution

    +

    4. Determine country distribution

    Google Play lets you control what countries and territories your app is distributed to. For widest reach and the largest potential customer base, you @@ -182,7 +149,7 @@ launch target date.

    -

    6. Confirm the app's overall size

    +

    5. Confirm the app's overall size

    The overall size of your app can affect its design and how you publish it on Google Play. Currently, the maximum size for an APK published on Google Play is @@ -213,7 +180,7 @@ creating your release-ready APK.

    -

    7. Confirm the app's platform and screen compatibility ranges

    +

    6. Confirm the app's platform and screen compatibility ranges

    Before publishing, it's important to make sure that your app is designed to run properly on the Android platform versions and device screen sizes that you @@ -250,7 +217,7 @@ charts.

    -

    8. Decide whether your app will be free or priced

    +

    7. Decide whether your app will be free or priced

    On Google Play, you can publish apps as free to download or priced. Free apps can be downloaded by any Android user in Google Play. @@ -282,7 +249,7 @@ you need set up a Checkout Merchant Account before you can publish.

    -

    9. Consider using In-app Billing

    +

    8. Consider using In-app Billing

    Google Play In-app Billing lets you sell digital content in your applications. You can use the @@ -308,7 +275,7 @@ before creating your release-ready APK.

    -

    10. Set prices for your products

    +

    9. Set prices for your products

    If your app is priced or you will sell in-app products, Google Play lets you set prices for your products in a variety of currencies, for users in markets @@ -341,7 +308,7 @@ in all available currencies through the Developer Console.

    -

    11. Start localization

    +

    10. Start localization

    With your country targeting in mind, it's a good idea to assess your localization needs and start the work of localizing well in advance of your target @@ -377,7 +344,7 @@ when you upload assets and configure your product details.

    -

    12. Prepare promotional graphics

    +

    11. Prepare promotional graphics

    When you publish on Google Play, you can supply a variety of high-quality graphic assets to showcase your app or brand. After you publish, these appear on @@ -408,7 +375,7 @@ advance of your target publishing date.

    -

    13. Build and upload the release-ready APK

    +

    12. Build and upload the release-ready APK

    When you are satisfied that your app meets your UI, compatibility, and quality requirements, you can build the release-ready version of the app. The @@ -440,7 +407,7 @@ recent version before publishing.

    -

    14. Complete the app's product details

    +

    13. Complete the app's product details

    On Google Play, your app's product information is shown to users on its product details page, the page that users visit to learn more about your app and @@ -464,10 +431,6 @@ page in the Developer Console. As you collect the information and assets for the page, make sure that you can enter or upload it to the Developer Console, until the page is complete and ready for publishing.

    -

    If your app is targeting tablet devices, make sure to include at least one screen -shot of the app running on a tablet, and highlight your app's support for tablets -in the app description, release notes, promotional campaigns, and elsewhere.

    -

    Related resources:

    @@ -481,7 +444,7 @@ in the app description, release notes, promotional campaigns, and elsewhere.

    -

    15. Use Google Play badges and links in your promotional +

    14. Use Google Play badges and links in your promotional campaigns

    Google Play badges give you an officially branded way of promoting your app @@ -510,7 +473,7 @@ and reviews, or any other channel available.

    -

    16. Final checks and publishing

    +

    15. Final checks and publishing

    When you think you are ready to publish, sign in to the Developer Console and take a few moments for a few final checks:

    @@ -548,7 +511,7 @@ final checks:

    -

    17. Support users after launch

    +

    16. Support users after launch

    After you publish an app or an app update, it's crucial for you to support your customers. Prompt and courteous support can provide a better experience for diff --git a/docs/html/distribute/googleplay/quality/core.jd b/docs/html/distribute/googleplay/quality/core.jd deleted file mode 100644 index 3d017e64b9a5..000000000000 --- a/docs/html/distribute/googleplay/quality/core.jd +++ /dev/null @@ -1,783 +0,0 @@ -page.title=Core App Quality Guidelines -@jd:body - -

    - -

    App quality directly influences the long-term success of your app -— in terms of installs, user rating and reviews, engagement, and user -retention. Android users expect high quality design and performance from apps, -even more so if they puchased the apps or purchased their in-app products.

    - -

    This document helps you assess basic aspects of quality in your app through a -compact set of core app quality criteria and associated tests. All -Android apps should meet these criteria.

    - -

    Before launching your app, make sure to test it against these criteria to -ensure that it functions well on many devices, meets Android standards for -navigation and design, and is prepared for promotional opportunities in the -Google Play Store. Your testing will go well beyond what's described here -— the purpose of this document is to specify the essential characteristics -of basic quality so that you can include them in your test plans.

    - -

    If your app is targeting tablet devices, make sure that it delivers a rich, -compelling experience to your tablet customers. See the Tablet App Quality -Checklist for recommendations on ways to optimize your app for tablets.

    - - -

    Visual Design and User Interaction

    - -

    These criteria ensure that your app provides standard Android visual design -and interaction patterns where appropriate, for a consistent and intuitive -user experience.

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    - Area - - ID - - Description - - Tests -
    Standard design - UX-B1 - -

    App follows Android Design guidelines and uses common UI patterns and icons:

    -
      -
    1. App does not redefine the expected function of a system icon (such as the Back button).
      2. -
    2. App does not replace a system icon with a completely different icon if it triggers the standard UI behavior.
      3. -
    3. If the app provides a customized version of a standard system icon, the icon strongly resembles the system icon and triggers the standard system behavior.
      4. -
    4. App does not redefine or misuse Android UI patterns, such that icons or behaviors could be misleading or confusing to users.
      5. -
    -     		CR-all
    Navigation - UX-N1 - -

    App supports standard system Back button navigation and does not make use of any custom, on-screen "Back button" prompts.

    -     		CR-3
    - UX-N2 - -

    All dialogs are dismissable using the Back button.

    -     		CR-3
    - UX-N3 - - Pressing the Home button at any point navigates to the Home screen of the device. - CR-1
    - - - - - -

    Related resources:

    -
      -
    • Android Design — Overview of design and user experience best practices for Android apps.
      • -
    • Navigation with Back and Up — Android Design document describing standard navigation patterns and related topics.
      • -
    • Action Bar — Android Design document describing how to use the Action Bar.
      • -
    • Iconography — Android Design document that shows how to use various types of icons.
      • -
    -
    - -

    Functionality

    - -

    These criteria ensure that your app provides expected functional behavior with the appropriate level of permissions.

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    - Area - - ID - - Description - - Tests -
    Permissions - FN-P1 - App requests only the absolute minimum permissions that it needs to support core functionality. - CR-11
    - FN-P2 -

    App does not request permissions to access sensitive data (such as Contacts or the System Log) or services that can cost the user money (such as the Dialer or SMS), unless related to a core capability of the app. -

    Install location - FN-L1 - -

    App functions normally when installed on SD card (if supported by app).

    - -

    Supporting installation to SD card is recommended for most large apps (10MB+). See the App Install Location developer guide for information about which types of apps should support installation to SD card.

    -     		SD-1 -
    Audio - FN-A1 - - Audio does not play when the screen is off, unless this is a core feature (for example, the app is a music player). - CR-7
    - FN-A2 - - Audio does not play behind the lock screen, unless this is a core feature. - CR-8
    - FN-A3 - - Audio does not play on the home screen or over another app, unless this is a core feature. - CR-1,
    CR-2
    - FN-A4 - - Audio resumes when the app returns to the foreground, or indicates to the user that playback is in a paused state. - CR-1, CR-8
    UI and Graphics - FN-U1 - -

    App supports both landscape and portrait orientations (if possible).

    - -

    Orientations expose largely the same features and actions and preserve functional parity. - Minor changes in content or views are acceptable.

    -     		CR-5
    - FN-U2 - -

    App uses the whole screen in both orientations and does not letterbox to account for orientation changes.

    -

    Minor letterboxing to compensate for small variations in screen geometry is acceptable.

    -     		CR-5
    - FN-U3 - -

    App correctly handles rapid transitions between display orientations without rendering problems.

    -     		CR-5
    User/app state - FN-S1 - -

    App should not leave any services running when the app is in the background, unless related to a core capability of the app.

    -

    For example, the app should not leave services running to maintain a network connection for notifications, to maintain a Bluetooth connection, or to keep the GPS powered-on.

    -     		CR-6
    - FN-S2 - -

    App correctly preserves and restores user or app state.

    -

    App preserves user or app state when leaving the foreground and prevents accidental data loss due to back-navigation and other state changes. When returning to the foreground, the app must restore the preserved state and any significant stateful transaction that was pending, such as changes to editable fields, game progress, menus, videos, and other sections of the app or game.

    -
      -
    1. When the app is resumed from the Recents app switcher, the app returns the user to the exact state in which it was last used.
      2. -
    2. When the app is resumed after the device wakes from sleep (locked) state, the app returns the user to the exact state in which it was last used.
      3. -
    3. When the app is relaunched from Home or All Apps, the app restores the app state as closely as possible to the previous state.
      4. -
    4. On Back keypresses, the app gives the user the option of saving any app or user state that would otherwise be lost on back-navigation.
      5. -
    -     		CR-1, CR-3, CR-5
    - - - - - -

    Related resources:

    - -
    - - -

    Performance and Stability

    - -

    To ensure a high user rating, your app needs to perform well and stay -responsive on all of the devices and form factors and screens that it is -targeting. These criteria ensure that the app provides the basic performance, -stability, and responsiveness expected by users.

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    - Area - - ID - - Description - - Tests -
    Stability - PS-S1 - - App does not crash, force close, freeze, or otherwise function abnormally on any targeted device. - CR-all, SD-1, HA-1
    Performance - PS-P1 - - App loads quickly or provides onscreen feedback to the user (a progress indicator or similar cue) if the app - takes longer than two seconds to load. - - CR-all, SD-1 -
    - PS-P2 - - With StrictMode enabled (see StrictMode Testing, below), no red flashes (performance warnings from StrictMode) are visible when exercising the app, including - during game play, animations and UI transitions, and any other part of the app. - - PM-1 -
    Media - PS-M1 - - Music and video playback is smooth, without crackle, stutter, or other artifacts, during normal app usage and load. - - CR-all, SD-1, HA-1 -
    Visual quality - PS-V1 - -

    App displays graphics, text, images, and other UI elements without noticeable distortion, blurring, or pixelation.

    - -
      -
    1. App provides high-quality graphics for all targeted screen sizes and form factors, including for larger-screen devices such as tablets.
      2. -
    2. No aliasing at the edges of menus, buttons, and other UI elements.
      3. -
    -     		CR-all
    - PS-V2 - -

    App displays text and text blocks in an acceptable manner.

    - -
      -
    1. Composition is acceptable in all supported form factors, including for larger-screen devices such as tablets.
      2. -
    2. No cut-off letters or words.
      3. -
    3. No improper word wraps within buttons or icons.
      4. -
    4. Sufficient spacing between text and surrounding elements.
      5. -
    - - - -
    - - - - - - - - -

    Related resources:

    - -
    - - -

    Google Play

    - -

    To launch your app successfully on Google Play, raise its ratings, and make -sure that it is ready for promotional activities in the store, follow the -criteria below.

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    - Area - - ID - - Description - - Tests -
    Policies - GP-P1 - - App strictly adheres to the terms of the Google Play Developer Content Policy and does not offer inappropriate content, does not use intellectual property or brand of others, and so on. - - GP-all -
    - GP-P2 - -

    App maturity level is set appropriately, based on the - Content Rating Guidelines.

    - -

    Especially, note that apps that request permission to use the device location cannot be given the maturity level "Everyone".

    -     		- GP-1 -
    App Details Page - GP-D1 - -

    App feature graphic follows the guidelines outlined in this - blog post. Make sure that:

    - -
      -
    1. The app listing includes a high-quality feature graphic.
      2. -
    2. The feature graphic does not contain device images, screenshots, or small text that will be illegible when scaled down and displayed on the smallest screen size that your app is targeting.
      3. -
    3. The feature graphic does not resemble an advertisement.
      4. -
    - - -     		- GP-1, GP-2 -
    - GP-D2 - - App screenshots and videos do not show or reference non-Android devices. - GP-1
    - GP-D3 - - App screenshots or videos do not - represent the content and experience of your app in a misleading way. -
    User Support - GP-X1 - Common user-reported bugs in the Reviews tab of the Google Play page are addressed if they are - reproducible and occur on many different devices. If a bug occurs on only a few devices, - you should still address it if those devices are particularly popular or new. - - GP-1 -
    - - - - -

    Related resources:

    - -
    - - -

    Setting Up a Test Environment

    - -

    To assess the quality of your app, you need to set up a suitable -hardware or emulator environment for testing.

    - -

    The ideal test environment would -include a small number of actual hardware devices that represent key form -factors and hardware/software combinations currently available to consumers. -It's not necessary to test on every device that's on the market — -rather, you should focus on a small number of representative devices, even using -one or two devices per form factor.

    - -

    If you are not able to obtain actual hardware devices for testing, you should -set up emulated devices (AVDs) to represent the most common form factors and -hardware/software combinations.

    - -

    To go beyond basic testing, you can add more devices, more form factors, or -new hardware/software combinations to your test environment. You can also -increase the number or complexity of tests and quality criteria.

    - - -

    - Test Procedures -

    - -

    These test procedures help you discover various types of quality issues in your app. You can combine the tests or integrate groups of tests together in your own test plans. See the sections above for references that associate specific criteria with specific tests.

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    - Type - - Test - - Description -
    Core Suite - CR-0 -

    Navigate to all parts of the app — all screens, dialogs, settings, and all user flows.

    - -
      -
    1. If the application allows for editing or content creation, game play, or media playback, make sure to enter those flows to create or modify content.
      2. -
    2. While exercising the app, introduce transient changes in network connectivity, battery function, GPS or location availability, system load, and so on.
      3. -
    -
    - CR-1 - From each app screen, press the device's Home key, then re-launch the app from the All Apps screen. -
    - CR-2 - From each app screen, switch to another running app and then return to the app under test using the Recents app switcher. -
    - CR-3 - From each app screen (and dialogs), press the Back button. -
    - CR-5 - From each app screen, rotate the device between landscape and portrait orientation at least three times. -
    - CR-6 - Switch to another app to send the test app into the background. Go to Settings and check whether the test app has any services running while in the background. In Android 4.0 and higher, go to the Apps screen and find the app in the "Running" tab. In earlier versions, use "Manage Applications" to check for running services. -
    - CR-7 - - Press the power button to put the device to sleep, then press the power button again to - awaken the screen. -
    - CR-8 - - Set the device to lock when the power button is pressed. Press the power button to put the device to sleep, then press the power button again to - awaken the screen, then unlock the device. -
    - CR-9 - - For devices that have slide-out keyboards, slide the keyboard in and out at least once. For devices that have keyboard docks, attach the device to the keyboard dock. -
    - CR-10 - - For devices that have an external display port, plug-in the external display. -
    - CR-11 - Examine the permissions requested by the app by going to Settings > App Info. -
    Install on SD Card - SD-1 - -

    Repeat Core Suite with app installed to device SD card (if supported by app).

    - -

    To move the app to SD card, you can use Settings > App Info > Move to SD Card.

    -
    Hardware acceleration - HA-1 - -

    Repeat Core Suite with hardware acceleration enabled.

    - -

    To force-enable hardware acceleration (where supported by device), add hardware-accelerated="true" to the <application> in the app manifest and recompile.

    -
    Performance Monitoring - PM-1 - -

    Repeat Core Suite with StrictMode profiling enabled as described below.

    Pay close attention to garbage collection and its impact on the user experience.

    -
    Google Play - GP-1 - - Sign into the Developer Console to review your developer profile, app description, screenshots, feature graphic, maturity settings, and user feedback. -
    - GP-2 - - Download your feature graphic and screenshots and scale them down to match the display sizes on the devices and form factors you are targeting. -
    - GP-4 - - Review all graphical assets, media, text, code libraries, and other content packaged in the app or expansion file download. -
    Payments - GP-5 - - Navigate to all screens of your app and enter all in-app purchase flows. -
    - -

    -Testing with StrictMode -

    - -

    For performance testing, we recommend enabling StrictMode in your app and using it to catch operations on the main thread and other threads that could affect performance, network accesses, file reads/writes, and so on. - -You can set up a monitoring policy per thread using the ThreadPolicy builder and enable all supported monitoring in the ThreadPolicy using detectAll().

    - -

    Make sure to enable visual notification of policy violations for the ThreadPolicy using penaltyFlashScreen().

    - diff --git a/docs/html/distribute/googleplay/quality/index.jd b/docs/html/distribute/googleplay/quality/index.jd deleted file mode 100644 index ffbcbabf09f9..000000000000 --- a/docs/html/distribute/googleplay/quality/index.jd +++ /dev/null @@ -1,46 +0,0 @@ -page.title=App Quality -@jd:body - -

    App quality directly influences the long-term success of your app -— in terms of installs, user rating and reviews, engagement, and user -retention. Android users expect high quality from apps, even more so if they -puchased the apps or purchased their in-app products. At the same time, they -enjoy and value apps that put a priority on high quality and continuous -improvement.

    - -

    Before you publish an app on Google Play, it's important to make sure that -the app meets the basic quality expectations of users, across all of the form -factors and device types that the app is targeting. The documents in this -section help you assess your app's fundamental quality and they provide -resources to help you address issues that you find.

    - -
    -   -
    -
    -
    -

    - Core App Quality -

    -

    - A set of core quality criteria that all Android apps should meet on all targeted devices. -

    Learn more » -
    -
    -

    - Tablet App Quality -

    -

    - A set recommendations for delivering the best possible experience to tablet users. -

    Learn more » -
    -
    -

    - Improving App Quality -

    -

    - Tips on continuously improving your app's quality, ratings, reviews, downloads, and engagement. -

    Learn more - » -
    -
    diff --git a/docs/html/distribute/googleplay/quality/tablet.jd b/docs/html/distribute/googleplay/quality/tablet.jd deleted file mode 100644 index b8a7a60acef5..000000000000 --- a/docs/html/distribute/googleplay/quality/tablet.jd +++ /dev/null @@ -1,555 +0,0 @@ -page.title=Tablet App Quality Checklist -@jd:body - - - - -

    Before you publish an app on Google Play, it's important to make sure that -the app meets the basic expectations of tablet users, through compelling features -and an intuitive, well-designed UI.

    - -

    Tablets are a growing part of the Android installed base that offers new -opportunities for user engagement -and monetization. If your app is targeting tablet users, this document helps -you focus on key aspects of quality, feature set, and UI that can have a -significant impact on the app's success. Each focus area is given as checklist -item, with each one comprising several smaller tasks or best practices.

    - -

    Although the checklist tasks below are numbered for convenience, -you can handle them in any order and address them to the extent that you feel -is right for your app. In the interest of delivering the best possible product -to your customers, follow the checklist recommendations -to the greatest extent possible.

    - -

    As you move through the checklist, you'll find links to support resources -that can help you address the topics raised in each task.

    - - -

    1. Test for Core 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 and form factors that the app is -targeting. For complete information, see the Core App Quality Checklist. -

    - -

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

    - - -

    2. Optimize your layouts for larger screens

    - -

    Android makes it easy to develop an app that runs well on a wide range of -device screen sizes and form factors. This broad compatibility works in your -favor, since it helps you design a single app that you can distribute widely to -all of your targeted devices. However, to give your users the best possible -experience on each screen configuration — in particular on tablets -— you need to optimize your layouts and other UI components for each -targeted screen configuration. On tablets, optimizing your UI lets you take -full advantage of the additional screen available, such as to offer new features, -present new content, or enhance the experience in other ways to deepen user -engagement.

    - -

    If you developed your app for handsets and now want to distribute it to -tablets, you can start by making minor adjustments to your layouts, fonts, and -spacing. In some cases — such as for 7-inch tablets or for a game with -large canvas — these adjustments may be all -you need to make your app look great. In other cases, such as for larger -tablets, you can redesign parts of your UI to replace "stretched UI" with an -efficient multipane UI, easier navigation, and additional content.

    - -

    Here are some suggestions:

    - -
    - -

    Get rid of "stretched" UI: On tablets, single-pane layouts lead to awkward whitespace and excessive line lengths. Use padding to reduce the width of UI elements and consider using multi-pane layouts.

    -
    - - - -

    In particular, make sure that your layouts do not appear "stretched" -across the screen:

    - - - - - - - -

    Related resources:

    - -
    - - -

    3. Take advantage of extra screen area available on tablets

    - -
    - -

    Multi-pane layouts result in a better visual balance on tablet screens, while offering more utility and legibility.

    -
    - -

    Tablet screens provide significantly more screen real estate to your app, -especially when in landscape orientation. In particular, 10-inch tablets offer a -greatly expanded area, but even 7-inch tablets give you more space for -displaying content and engaging users.

    - -

    As you consider the UI of your app when running on tablets, make sure that it -is taking full advantage of extra screen area available on tablets. Here are -some suggestions:

    - - - - - - - -

    Related resources:

    -
      -
    • Multi-pane Layouts — Android Design guide for using multi-pane UI, including examples of how to flatten navigation and integrate more content into your tablet UI.
      • -
    • 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.
      • -
    • Designing for Multiple Screens — Android Training class that walks you through the essentials of planning an intuitive, effective navigation for tablets and other devices.
      • -
    -
    - - -

    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. -Specifically, you should create sets of alternative bitmap drawables for each -density in the range commonly supported by tablets.

    - -

    Raw asset sizes for icon types. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Density LauncherAction BarSmall/ContextualNotification
    mdpi48x48px32x32px16x16px24x24px
    hdpi72x72px48x48px24x24px36x36px
    tvdpi(use hdpi)(use hdpi)(use hdpi)(use hdpi)
    xhdpi96x96px64x64px32x32px48x48px
    - -

    Other points to consider:

    - - - - - - - -

    Related resources:

    -
      -
    • Iconography — Android Design document that shows how to use various types of icons.
      • -
    • Providing Resources — Developer documentation on how to provide sets of layouts and drawable resources for specific ranges of device screens.
      • -
    • Supporting Multiple Screens — API Guide documentation that explains the details of managing UI for best display on multiple screen sizes.
      • -
    • Supporting Different Screens — Android Training class that takes you through the process of optimizing the user experience for different screen sizes and densities.
      • -
    -
    - - -

    5. Adjust font sizes and touch targets for tablet screens

    - -

    To make sure your app is easy to use on tablets, take some time to adjust the -font sizes and touch targets in your tablet UI, for all of the screen -configurations you are targeting. You can adjust font sizes through styleable attributes or dimension -resources, and you can adjust touch targets through layouts and bitmap -drawables, as discussed above.

    - -

    Here are some considerations:

    - - - - - - -

    Related resources:

    -
      -
    • Metrics and Grids - — Android Design document that explains how to arrange and size touch targets and other UI elements on the screen.
      • -
    • Typography — Android Design document that gives an overview of how to use typography in your apps.
      • -
    • Supporting Multiple Screens — Developer documentation that explains the details of managing UI for best display on multiple screen sizes.
      • -
    • Supporting Different Densities — Android Training class that shows you how to provide sets of layouts and drawable resources for specific ranges of device screens.
      • -
    -
    - - -

    6. Adjust sizes of home screen widgets for tablet screens

    - -

    If your app includes a home screen widget, here are a few points to consider -to ensure a great user experience on tablet screens:

    - - - - - - - -

    Related resources:

    - -
    - - -

    7. Offer the app's full feature set to tablet users

    - -

    Let your tablet users experience the best features of your app. Here are -some recommendations:

    - - - - -

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

    - -

    Handsets and tablets typically offer slightly different hardware support for -sensors, camera, telephony, and other features. For example, many tablets are -available in a "Wi-Fi" configuration that does not include telephony support.

    - -

    To ensure that you can deliver a single APK broadly across the -your full customer base, make sure that your app does not have built-in -requirements for hardware features that aren't commonly available on tablets. -

    - - - -

    In all cases, the app must function normally when the hardware features it -uses are not available and should offer “graceful degradation” and alternative -functionality where appropriate. For example, if GPS is not supported on the device, -your app could let the user set their location manually. The app should do -run-time checking for the hardware capability that it needs and handle as needed.

    - - - - - -

    Related resources:

    - -
    - - -

    9. Declare support for tablet screen configurations

    - -

    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:

    - - - - - - - -

    Related resources:

    -
      -
    • <supports-screens> -— Description and reference documentation for the <supports-screens> -manifest element.
      • -
    • Declaring Screen Size -Support — Developer documentation that explains the details of managing UI -for best display on multiple screen sizes.
      • -
    -
    - - -

    10. Follow best practices for publishing in Google Play

    - - - - - - - -

    Related resources:

    - -
    - -

    Setting Up a Test Environment for Tablets

    - -

    To assess the quality of your app on tablets — both for core app quality -and tablet app quality — you need to set up a suitable -hardware or emulator environment for testing.

    - -

    The ideal test environment would -include a small number of actual hardware devices that represent key form -factors and hardware/software combinations currently available to consumers. -It's not necessary to test on every device that's on the market — -rather, you should focus on a small number of representative devices, even using -one or two devices per form factor. The table below provides an overview of -devices you could use for testing.

    - -

    If you are not able to obtain actual hardware devices for testing, you should -set up emulated devices (AVDs) to represent the most common form factors and -hardware/software combinations. See the table below for suggestions on the emulator -configurations to use.

    - -

    To go beyond basic testing, you can add more devices, more form factors, or -new hardware/software combinations to your test environment. For example, you -could include mid-size tablets, tablets with more or fewer hardware/software -features, and so on. You can also increase the number or complexity of tests -and quality criteria.

    - -

    Table 1. A typical tablet test environment might -include one or two devices from each row in the table below, with one of the -listed chipsets, platform versions, and hardware feature configurations.

    - - - - - - - - - - - - - - - - - - - - - - - - -
    TypeSizeDensityVersionAVD Skin
    7-inch tabletlarge or
    -sw600    		hdpi,
    tvdpi    		Android 4.0+WXGA800-7in
    10-inch tabletxlarge or
    -sw800    		mdpi,
    hdpi    		Android 3.2+WXGA800
    \ No newline at end of file diff --git a/docs/html/distribute/googleplay/spotlight/index.jd b/docs/html/distribute/googleplay/spotlight/index.jd deleted file mode 100644 index 6acd91433e64..000000000000 --- a/docs/html/distribute/googleplay/spotlight/index.jd +++ /dev/null @@ -1,46 +0,0 @@ -page.title=Spotlight -walkthru=0 -header.hide=0 - -@jd:body - - -

    Android developers, their apps, and their successes with Android and Google Play.

    - - - -
    -
    -

    Developer Story: Robot Invader

    - -
    -

    Robot Invader chose - Android and Google Play as the launch platform for their first game,
    - Wind-up - Knight. -

    -

    - Hear from the developers how Android helped them reach millions of users - and more than 100 device models with a single app binary, then iterate rapidly to ensure - a great user experience. -

    -
    - -
    -
    \ No newline at end of file diff --git a/docs/html/distribute/googleplay/spotlight/tablets.jd b/docs/html/distribute/googleplay/spotlight/tablets.jd deleted file mode 100644 index 641b7940b64d..000000000000 --- a/docs/html/distribute/googleplay/spotlight/tablets.jd +++ /dev/null @@ -1,283 +0,0 @@ -page.title=Developer Stories: The Opportunity of Android Tablets -walkthru=0 -header.hide=0 - -@jd:body - - -

    More and more, developers are investing in a full tablet experience -for their apps and are seeing those investments pay off big. The increased -screen area on tablets opens up a world of possibilities, allowing for more -engagement with the user — which can mean an increase in usage as well as -more monetization opportunities. And with the growing wave of Android tablets that -continue to hit the market, it’s an important piece of any developer’s mobile -offering.

    - -

    Here are some stories from developers who are seeing real results as they -expand their offering to include Android tablets.

    - - -
    - -

    Mint: More screen real estate = more engagement

    - - - -
    - - -
    About the app
    - - - - -
    Tablet Results
    - -
      -
    • Able to offer richer UI features
      • -
    • Much higher user engagement
      • -
    • Longer sessions — more Android tablet users have sessions longer than 5 minutes
      • -
    - -
    - - Android app on Google Play - - -
    -
    - -
    -

    When Intuit was thinking about -expanding their Mint mobile offering to include a version optimized for Android -tablets, they knew that taking the layout that worked for phones and simply -showing an enlarged version wouldn’t take full advantage of the opportunities -that tablets afford.

    - -

    “We knew we had a lot more real estate, and we wanted to provide a more -immersive experience for our users” said Ken Sun, Intuit Group Product Manager -at Mint.

    - -

    Intuit’s Mint app, which has a 4-star rating on Google Play, brings a number -of features to Android tablets that aren’t available for phones, including a -more visual presentation of personal financial data.

    - -

    “Whereas our app for phones is used throughout the day for quick sessions, -we’ve seen a larger percentage of our tablet usage happen in the evening, for -much longer sessions,” said Sun. “People are doing a lot more than just checking -their spending. They’re looking at historical trends, re-categorizing -transactions, analyzing the data and setting financial goals for the future -— digging much deeper and being more thoughtful. One example is how much -users are interacting with their own budgets in the tablet app. Customer budget -operations (view, edit, drill-down, etc.) are 7x higher on Android tablets than -they are on phones.”

    - -

    Fifty percent more Android tablet users have Mint sessions of 5 minutes or -longer than they do on phones. “We’ve found that phone usage is indicative of a -customer’s regular financial check-in, while tablet usage points towards more -analysis and interaction with that customer’s personal financial data. This is -the sort of immersive engagement experience we were looking for; the tablet and -phone apps serve as great complements to each other."

    -
    - -
    - - - -
    -

    Making the most of tablet screens: Mint used the extra screen area on tablets to offer quick access to additional tools and information.

    -
    - -
    - -
    - - -
    - - -

    TinyCo: Monetization opportunities abound on tablets

    - - - - -
    - -
    About the app
    - -
      -
    • Tiny Village by TinyCo
      • -
    • Game targeting 7- to 10-inch tablets and phones
      • -
    - -
    Tablet Results
    - -
      -
    • 35% higher average revenue per paying user (ARPPU)
      • -
    • Consistent increase in user retention
      • -
    • 3x increase in downloads to Android tablets in the last 6 months
      • -
    - -
    - - Android app on Google Play - - -
    -
    - -
    -

    Over a year ago, developer -TinyCo, makers of games such as Tiny Monsters, switched to a -simultaneous launch strategy for their products. They chose Android as one of their -primary launch platforms because of its large installed base and global reach. They -also knew that the growing base of Android tablet users represented a huge -opportunity.

    - -

    Tiny Village was their first title to take advantage of the strategy, and -it proved to be a winning one — especially in terms of Android -tablets.

    - -

    “With continued optimization of the gameplay experience and a genuine -commitment to our Android offering through our Griffin engine, all of our -metrics started to rise,” said Rajeev Nagpal, Head of Product at TinyCo. In -fact, they’ve seen Android tablet downloads more than triple in the last six -months.

    - -

    One of the first things they noticed about usage of Tiny Village on -tablets was an increase in average revenue per paying user (ARPPU)—about 35% -higher than on smaller-screen devices such as phones. Additionally, average -revenue per user ARPU is now about 35% higher as well. “The game is just much -more immersive on tablet.”

    - -

    In addition to an increase in monetization metrics, they’ve also seen a -consistent increase in retention over other platforms. “These are really -important metrics for games — if you can get users to both stay around -longer and spend more while they’re there, you have a recipe for success.”

    -
    - -
    - - - -
    -

    More monetization -on tablets: On Android tablets TinyCo has seen higher ARPPU and user -retention than on phones.

    -
    - -
    - -
    - - -
    - -

    Instapaper: Riding the growing wave of Android tablets

    - - - - - -
    - - - - -
    About the app
    -
      -
    • Instapaper by Mobelux
      • -
    • Content-browsing utility that targets 7- to 10-inch tablets and phones
      • -
    - -
    Tablet Results
    - -
      -
    • Tablets are now 50% of the app's installed base.
      • -
    - -
    - - Android app on Google Play - - -
    -
    - -
    -

    Instapaper for Android is an app -for saving web content to read later. Developer Mobelux decided that creating a -great UI for Android tablet users would be an essential part of their initial launch -plan.

    - -

    The app launched at the beginning of the summer of 2012, just in time to -take advantage of a new tide of Android tablets, including the Nexus 7 tablet. The app has since seen huge -popularity among tablet users, in particular, on Nexus 7. On the day that -pre-orders of Nexus 7 began arriving, Mobelux saw a 600% jump in downloads of -its app on Google Play.

    - -

    “We saw a promising new set of Android tablets about to hit the market -and wanted to position ourselves to be ready for them” said Jeff Rock of -Mobelux. “It was a market that others were hesitant to explore, but the decision -to prioritize tablets has paid off very well for us.”

    - -

    Since that initial 600% jump in downloads, Instapaper for Android has -continued to see a successful run on Android tablets. In fact, Android tablets -now represent about 50% of their installed base. “With more and more Android -tablets coming online, we’re excited to see how our investment in Android -tablets continues to pay off.”

    -
    - -
    - - - -
    -

    Popular with -tablet users: A great tablet UI and browsing convenience make Instapaper -popular with Android tablet users.

    -
    - -
    - -
    - - - diff --git a/docs/html/distribute/googleplay/strategies/app-quality.jd b/docs/html/distribute/googleplay/strategies/app-quality.jd index ecc51dc9b5ac..6ea862be732e 100644 --- a/docs/html/distribute/googleplay/strategies/app-quality.jd +++ b/docs/html/distribute/googleplay/strategies/app-quality.jd @@ -1,10 +1,10 @@ -page.title=Improving App Quality After Launch +page.title=Improving App Quality @jd:body @@ -29,7 +22,7 @@ With thousands of new apps being published in Google Play every week, it's impor

    A better app can go a very long way: a higher quality app will translate to higher user ratings, generally better rankings, more downloads, and higher retention (longer install periods). High-quality apps also have a much higher likelihood of getting some unanticipated positive publicity such as being featured in Google Play or getting social media buzz.

    -The upside to having a higher-quality app is obvious. However, it's not always clear how to make an app "better". This document looks at some of the key factors in app quality and ways of improving your app over time, after you've launched the app.

    +The upside to having a higher-quality app is obvious. However, it's not always clear how to make an app "better". The path to improving app quality isn't always well-lit. The term "quality" — along with "polish" and "fit and finish" — aren't always well-defined. Here we'll light the path by looking at some of the key factors in app quality and ways of improving your app along these dimensions.

    Listen to Your Users

    @@ -59,14 +52,15 @@ One sure-fire way to lose your users is to give them a slow, unresponsive UI. Re

    You can improve your apps's UI responsiveness by moving long-running operations off the main thread to worker threads. Android offers built-in debugging facilities such as StrictMode for analyzing your app's performance and activities on the main thread. You can see more recommendations in Writing Zippy Android Apps, a developer session from Google I/O 2010,

    +
    -

    More resources

    +

    More resources

    @@ -79,16 +73,17 @@ Lastly, pointed out in the blog post Improve Usability

    In usability and in app design too, you should listen carefully to your users. Ask a handful of real Android device users (friends, family, etc.) to try out your app and observe them as they interact with it. Look for cases where they get confused, are unsure of how to proceed, or are surprised by certain behaviors. Minimize these cases by rethinking some of the interactions in your app, perhaps working in some of the user interface patterns the Android UI team discussed at Google I/O.

    +

    +In the same vein, two problems that can plague some Android user interfaces are small tap targets and excessively small font sizes. These are generally easy to fix and can make a big impact on usability and user satisfaction. As a general rule, optimize for ease of use and legibility, while minimizing, or at least carefully balancing, information density.

    -

    -As you are designing or evaluating your app's UI, make sure to read and become familiar with the Android Design guidelines. Included are many examples of UI patterns, styles, and building blocks, as well as tools for the design process.

    +

    More resources

    +
      +As you are designing or evaluating your app's UI, make sure to read and become familiar with the Android Design guidelines. Included are many examples of UI patterns, styles, and building blocks, as well as tools for the design process. +
    -

    -In the same vein, two problems that can plague some Android user interfaces are small tap targets and excessively small font sizes. These are generally easy to fix and can make a big impact on usability and user satisfaction. As a general rule, optimize for ease of use and legibility, while minimizing, or at least carefully balancing, information density.

    -

    Another way to incrementally improve usability, based on real-world data, is to implement Analytics throughout your app to log usage of particular sections. Consider demoting infrequently used sections to the overflow menu in the Action bar, or removing them altogether. For often-used sections and UI elements, make sure they're immediately obvious and easily accessible in your app's UI so that users can get to them quickly.

    diff --git a/docs/html/images/distribute/instapaper.png b/docs/html/images/distribute/instapaper.png deleted file mode 100644 index ffbf05295239..000000000000 Binary files a/docs/html/images/distribute/instapaper.png and /dev/null differ diff --git a/docs/html/images/distribute/mint.png b/docs/html/images/distribute/mint.png deleted file mode 100644 index 50d90d5bf82d..000000000000 Binary files a/docs/html/images/distribute/mint.png and /dev/null differ diff --git a/docs/html/images/distribute/tinyvillage.png b/docs/html/images/distribute/tinyvillage.png deleted file mode 100644 index cde77f09a66b..000000000000 Binary files a/docs/html/images/distribute/tinyvillage.png and /dev/null differ diff --git a/docs/html/images/ui-ex-multi-pane.png b/docs/html/images/ui-ex-multi-pane.png deleted file mode 100644 index 188bb8bc116e..000000000000 Binary files a/docs/html/images/ui-ex-multi-pane.png and /dev/null differ diff --git a/docs/html/images/ui-ex-single-panes.png b/docs/html/images/ui-ex-single-panes.png deleted file mode 100644 index dff24a707b92..000000000000 Binary files a/docs/html/images/ui-ex-single-panes.png and /dev/null differ -- cgit v1.2.3-59-g8ed1b