• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1page.title=Tablet App Quality Checklist
2@jd:body
3
4<div id="qv-wrapper"><div id="qv">
5<h2>Checklist</h2>
6<ol>
7
8<li><a href="#core-app-quality">1. Test for Basic Tablet App Quality</a></li>
9<li><a href="#optimize-layouts">2. Optimize your layouts</a></li>
10<li><a href="#use-extra-space">3. Use the extra screen area</a></li>
11<li><a href="#use-tablet-icons">4. Use assets designed for tablets</a></li>
12<li><a href="#adjust-font-sizes">5. Adjust fonts and touch targets</a></li>
13<li><a href="#adjust-widgets">6. Adjust homescreen widgets</a></li>
14<li><a href="#offer-full-feature-set">7. Offer the app's full feature set</a></li>
15<li><a href="#android-versions">8. Target Android versions properly</a></li>
16<li><a href="#hardware-requirements">9. Declare dependencies properly</a></li>
17<li><a href="#support-screens">10. Declare tablet screens support</a></li>
18<li><a href="#google-play">11. Showcase your tablet UI</a></li>
19<li><a href="#google-play-best-practices">12. Follow publishing best practices</a></li>
20
21</ol>
22<h2>Testing</h2>
23<ol>
24<li><a href="#test-environment">Setting Up a Test Environment</a></li>
25</ol>
26</div></div>
27
28<p>Before you publish an app on Google Play, it's important to make sure that
29the app meets the basic expectations of tablet users through compelling features
30and an intuitive, well-designed UI. </p>
31
32<p>Tablets are a growing part of the Android installed base that offers new
33opportunities for <a
34href="{@docRoot}distribute/googleplay/spotlight/tablets.html">user engagement
35and monetization</a>. If your app is targeting tablet users, this document helps
36you focus on key aspects of quality, feature set, and UI that can have a
37significant impact on the app's success. Each focus area is given as checklist
38item, with each one comprising several smaller tasks or best practices.</p>
39
40<p>Although the checklist tasks below are numbered for convenience,
41you can handle them in any order and address them to the extent that you feel
42is right for your app. In the interest of delivering the best possible product
43to your customers, follow the checklist recommendations
44to the greatest extent possible. </p>
45
46<p>As you move through the checklist, you'll find links to support resources
47that can help you address the topics raised in each task.</p>
48
49
50<h2 id="core-app-quality" style="margin-top:1.5em;">1. Test for basic tablet app quality</h2>
51
52<p>The first step in delivering a great tablet app experience is making sure
53that it meets the <em>core app quality criteria</em> for all of the devices
54and form factors that the app is targeting. For complete information, see the <a
55href="{@docRoot}distribute/googleplay/quality/core.html">Core App Quality Guidelines</a>.
56</p>
57
58<p>
59  Before publishing, also ensure that your app passes several basic
60  technical checks and launch criteria, such as:
61</p>
62
63<ul>
64  <li><a href="#android-versions">Targets appropriate Android versions</a></li>
65  <li><a href="#hardware-requirements">Specifies any hardware dependencies properly</a></li>
66  <li><a href="#support-screens">Declares support for appropriate screens</a></li>
67  <li><a href="#use-extra-space">Uses all of the available screen space</a></li>
68  <li><a href="#google-play">Screenshots are uploaded to Google Play</a></li>
69</ul>
70
71<p>If your app is already uploaded to the Google Play Developer Console, you
72  can see how it is doing against these checks
73  by visiting the <a href="#google-play-optimization-tips">Optimization
74  Tips page</a>.</p>
75
76
77<h2 id="optimize-layouts">2. Optimize your layouts for larger screens</h2>
78
79<p>Android makes it easy to develop an app that runs well on a wide range of
80device screen sizes and form factors. This broad compatibility works in your
81favor, since it helps you design a single app that you can distribute widely to
82all of your targeted devices. However, to give your users the best possible
83experience on each screen configuration &mdash; in particular on tablets
84&mdash; you need to optimize your layouts and other UI components for each
85targeted screen configuration. On tablets, optimizing your UI lets you take
86full advantage of the additional screen available, such as to offer new features,
87present new content, or enhance the experience in other ways to deepen user
88engagement.</p>
89
90<p>If you developed your app for handsets and now want to distribute it to
91tablets, you can start by making minor adjustments to your layouts, fonts, and
92spacing. In some cases &mdash; such as for 7-inch tablets or for a game with
93large canvas &mdash; these adjustments may be all
94you need to make your app look great. In other cases, such as for larger
95tablets, you can redesign parts of your UI to replace "stretched UI" with an
96efficient multipane UI, easier navigation, and additional content. </p>
97
98<p>Here are some suggestions:</p>
99
100<div style="width:390px;float:right;margin:1.5em;margin-top:0em;">
101<img src="{@docRoot}images/training/app-navigation-multiple-sizes-multipane-bad.png"
102style="width:390px;padding:4px;margin-bottom:0em;">
103<p class="image-caption" style="padding:0em .5em .5em 2em"><span
104style="font-weight:500;">Get rid of "stretched" UI</span>: On tablets, single-pane
105layouts lead to awkward whitespace and excessive line lengths. Use padding to
106reduce the width of UI elements and consider using multi-pane layouts.</p>
107</div>
108
109<ul>
110<li>Provide custom layouts as needed for <code>large</code> and
111<code>xlarge</code> screens. You can also provide layouts that are loaded based
112on the screen's <a href="{@docRoot}guide/practices/screens_support.html#NewQualifiers">shortest
113dimension</a> or the <a href="{@docRoot}guide/practices/screens_support.html#NewQualifiers">minimum
114available width and height</a>. </li>
115<li>At a minimum, customize dimensions such as font sizes, margins, spacing for
116larger screens, to improve use of space and content legibility. </li>
117<li>Adjust positioning of UI controls so that they are easily accessible to
118users when holding a tablet, such as toward the sides when in
119landscape orientation.</li>
120<li>Padding of UI elements should normally be larger on tablets than on handsets. A
121<a href="{@docRoot}design/style/metrics-grids.html#48dp-rhythm">48dp rhythm</a> (and a 16dp
122grid) is recommended.</li>
123<li>Adequately pad text content so that it is not aligned directly along screen edges.
124Use a minimum <code>16dp</code> padding around content near screen edges.</li>
125</ul>
126
127<p>In particular, make sure that your layouts do not appear "stretched"
128across the screen:</p>
129
130<ul>
131<li>Lines of text should not be excessively long &mdash; optimize for a maximum
132100 characters per line, with best results between 50 and 75.</li>
133<li>ListViews and menus should not use the full screen width.</li>
134<li>Use padding to manage the widths of onscreen elements or switch to a
135multi-pane UI for tablets (see next section).</li>
136</ul>
137
138<div class="rel-resources">
139  <h3>
140    Related resources
141  </h3>
142
143  <ul>
144    <li>
145      <a href=
146      "{@docRoot}design/style/metrics-grids.html">Metrics
147      and Grids</a>&mdash;Android Design document that explains how to create
148      layouts based on density-independent grids.
149    </li>
150
151    <li>
152      <a href=
153      "{@docRoot}design/style/devices-displays.html">Devices
154      and Displays</a>&mdash;Android Design document that explains how to
155      design a UI that works well on different devices and
156      screen sizes.
157    </li>
158
159    <li>
160      <a href="{@docRoot}guide/practices/screens_support.html">Supporting Multiple
161      Screens</a>&mdash;Developer documentation that explains the details of
162      managing UI for best display on multiple screen sizes.
163    </li>
164
165    <li>
166      <a href=
167      "{@docRoot}guide/practices/screens_support.html#ConfigurationExamples">
168      Configuration examples</a>&mdash;Examples of how to declare layouts and
169      other resources for specific screen sizes.
170    </li>
171  </ul>
172</div>
173
174
175<h2 id="use-extra-space">3. Take advantage of extra screen area available on tablets</h2>
176
177<div style="width:290px;float:right;margin:1.5em;margin-bottom:0;margin-top:0;">
178<img src="{@docRoot}images/training/app-navigation-multiple-sizes-multipane-good.png"
179style="width:280px;padding:4px;margin-bottom:0em;">
180<p class="image-caption" style="padding:0em .5em .5em 1.5em"><span
181style="font-weight:500;">Multi-pane layouts</span> result in a better visual
182balance on tablet screens, while offering more utility and legibility.</p>
183</div>
184
185<p>Tablet screens provide significantly more screen real estate to your app,
186especially when in landscape orientation. In particular, 10-inch tablets offer a
187greatly expanded  area, but even 7-inch tablets give you more space for
188displaying content and engaging users. </p>
189
190<p>As you consider the UI of your app when running on tablets, make sure that it
191is taking full advantage of extra screen area available on tablets. Here are
192some suggestions:</p>
193
194<ul>
195<li>Look for opportunities to include additional content or use an alternative
196treatment of existing content.</li>
197<li>Use <a href="{@docRoot}design/patterns/multi-pane-layouts.html">multi-pane
198layouts</a> on tablet screens to combine single views into a compound view. This
199lets you use the additional screen area more efficiently and makes it easier for
200users to navigate your app. </li>
201<li>Plan how you want the panels of your compound views to reorganize when
202screen orientation changes.</li>
203
204<div style="width:490px;margin:1.5em auto 1.5em 0;">
205<div style="">
206<img src="{@docRoot}images/ui-ex-single-panes.png"
207style="width:490px;padding:4px;margin-bottom:0em;" align="middle">
208<img src="{@docRoot}images/ui-ex-multi-pane.png" style="width:490px;padding:4px;margin-bottom:0em;">
209<p class="image-caption" style="padding:.5em"><span
210style="font-weight:500;">Compound views</span> combine several single views from a
211handset UI <em>(above)</em> into a richer, more efficient UI for tablets
212<em>(below)</em>. </p>
213</div>
214</div>
215
216<li>While a single screen is implemented as an {@link android.app.Activity}
217subclass, consider implementing individual content panels as {@link
218android.app.Fragment} subclasses. This lets you
219maximize code reuse across different form factors and across screens that
220share content.</li>
221<li>Decide on which screen sizes you'll use a multi-pane UI, then provide the
222different layouts in the appropriate screen size buckets (such as
223<code>large</code>/<code>xlarge</code>) or minimum screen widths (such as
224<code>sw600dp</code>/<code>sw720</code>).</li>
225</ul>
226
227<div class="rel-resources">
228  <h3>
229    Related resources
230  </h3>
231
232  <ul>
233    <li>
234      <a href="{@docRoot}design/patterns/multi-pane-layouts.html">Multi-pane
235      Layouts</a>&mdash;Android Design guide for using multi-pane UI, including
236      examples of how to flatten navigation and integrate more content into
237      your tablet UI.
238    </li>
239
240    <li>
241      <a href=
242      "{@docRoot}training/design-navigation/multiple-sizes.html">Planning for Multiple
243      Touchscreen Sizes</a>&mdash;Android Training class that walks you through
244      the essentials of planning an intuitive, effective navigation for tablets
245      and other devices.
246    </li>
247
248    <li>
249      <a href="{@docRoot}training/multiscreen/index.html">Designing for
250      Multiple Screens</a>&mdash;Android Training class that walks you through
251      the essentials of planning an intuitive, effective navigation for tablets
252      and other devices.
253    </li>
254  </ul>
255</div>
256
257
258<h2 id="use-tablet-icons">4. Use Icons and other assets that are designed
259for tablet screens</h2>
260
261<p>So that your app looks its best, make sure to use icons and other bitmap
262assets that are created specifically for the densities used by tablet screens.
263Specifically, you should create sets of alternative bitmap drawables for each
264density in the range commonly supported by tablets.</p>
265
266<p class="table-caption"><strong>Table 1</strong>. Raw asset sizes for icon types.<table>
267<tr>
268<th>Density </th>
269<th colspa>Launcher</th>
270<th>Action Bar</th>
271<th>Small/Contextual</th>
272<th>Notification</th>
273</tr>
274<tr>
275<td><code>mdpi</code></td>
276<td>48x48px</td>
277<td>32x32px</td>
278<td>16x16px</td>
279<td>24x24px</td>
280</tr>
281<tr>
282<td><code>hdpi</code></td>
283<td>72x72px</td>
284<td>48x48px</td>
285<td>24x24px</td>
286<td>36x36px</td>
287</tr>
288<tr>
289<td><code>tvdpi</code></td>
290<td><em>(use hdpi)</em></td>
291<td><em>(use hdpi)</em></td>
292<td><em>(use hdpi)</em></td>
293<td><em>(use hdpi)</em></td>
294</tr>
295<tr>
296<td><code>xhdpi</code></td>
297<td>96x96px</td>
298<td>64x64px</td>
299<td>32x32px</td>
300<td>48x48px</td>
301</tr>
302
303</table>
304
305<p>Other points to consider: </p>
306
307<ul>
308<li>Icons in the action bar, notifications, and launcher should be designed
309according to the icon design guidelines and have the same physical size on
310tablets as on phones.</li>
311<li>Use density-specific <a
312href="{@docRoot}guide/topics/resources/providing-resources.html#AlternativeResources">
313resource qualifiers</a> to ensure that the proper set of alternative resources
314gets loaded.</li>
315</ul>
316
317<p style="margin-bottom:.5em;">At a minimum, your app should supply sets of
318  custom drawables and assets for common tablet screen densities,
319  tagged with these qualifiers as appropriate:</p>
320
321<ul>
322  <li><code>hdpi</code>, OR</li>
323  <li><code>xhdpi</code>, OR</li>
324  <li><code>xxhdpi</code></li>
325</ul>
326
327<div class="rel-resources">
328  <h3>
329    Related resources
330  </h3>
331
332  <ul>
333    <li>
334      <a href="{@docRoot}design/style/iconography.html">Iconography</a>&mdash; Android
335      Design document that shows how to use various types of icons.
336    </li>
337
338    <li>
339      <a href=
340      "{@docRoot}guide/topics/resources/providing-resources.html">Providing
341      Resources</a>&mdash;Developer documentation on how to provide
342      sets of layouts and drawable resources for specific ranges of device
343      screens.
344    </li>
345
346    <li>
347      <a href="{@docRoot}guide/practices/screens_support.html">Supporting
348      Multiple Screens</a>&mdash;API Guide documentation that
349      explains the details of managing UI for best display on multiple screen
350      sizes.
351    </li>
352
353    <li>
354      <a href=
355      "{@docRoot}training/basics/supporting-devices/screens.html">Supporting Different
356      Screens</a>&mdash;Android Training class that takes you
357      through the process of optimizing the user experience for different
358      screen sizes and densities.
359    </li>
360  </ul>
361</div>
362
363
364<h2 id="adjust-font-sizes">5. Adjust font sizes and touch targets for tablet screens</h2>
365
366<p>To make sure your app is easy to use on tablets, take some time to adjust the
367font sizes and touch targets in your tablet UI, for all of the screen
368configurations you are targeting. You can adjust font sizes through <a
369href="{@docRoot}guide/topics/ui/themes.html">styleable attributes</a> or <a
370href="{@docRoot}guide/topics/resources/more-resources.html#Dimension">dimension
371resources</a>, and you can adjust touch targets through layouts and bitmap
372drawables, as discussed above. </p>
373
374<p>Here are some considerations:</p>
375<ul>
376<li>Text should not be excessively large or small on tablet screen sizes and
377densities. Make sure that labels are sized appropriately for the UI elements they
378correspond to, and ensure that there are no improper line breaks in labels,
379titles, and other elements.</li>
380<li>The recommended touch-target size for onscreen elements is 48dp (32dp
381minimum) &mdash; some adjustments may be needed in your tablet UI. Read <a
382href="{@docRoot}design/style/metrics-grids.html">Metrics and
383Grids
384</a> to learn about implementation strategies to help most of your users. To
385meet the accessibility needs of certain users, it may be appropriate to use
386larger touch targets. </li>
387<li>When possible, for smaller icons, expand the touchable area to more than
38848dp using {@link android.view.TouchDelegate}
389or just centering the icon within the transparent button.</li>
390</ul>
391
392<div class="rel-resources">
393  <h3>
394    Related resources
395  </h3>
396
397  <ul>
398    <li>
399      <a href=
400      "{@docRoot}design/style/metrics-grids.html">Metrics
401      and Grids</a> &mdash;Android Design document that explains how to arrange
402      and size touch targets and other UI elements on the screen.
403    </li>
404
405    <li>
406      <a href="{@docRoot}design/style/typography.html">Typography</a>&mdash;Android
407      Design document that gives an overview of how to use typography in your
408      apps.
409    </li>
410
411    <li>
412      <a href="{@docRoot}guide/practices/screens_support.html">Supporting Multiple
413      Screens</a>&mdash;Developer documentation that explains the details of
414      managing UI for best display on multiple screen sizes.
415    </li>
416
417    <li>
418      <a href="{@docRoot}training/multiscreen/screendensities.html">Supporting
419      Different Densities</a>&mdash;Android Training class that shows you how
420      to provide sets of layouts and drawable resources for specific ranges of
421      device screens.
422    </li>
423  </ul>
424</div>
425
426
427<h2 id="adjust-widgets">6. Adjust sizes of home screen widgets for tablet screens</h2>
428
429<p>If your app includes a home screen widget, here are a few points to consider
430to ensure a great user experience on tablet screens: </p>
431
432<ul>
433<li>Make sure that the widget's default height and width are set appropriately
434for tablet screens, as well as the minimum and maximum resize height and width.
435</li>
436<li>The widget should be resizable to 420dp or more, to span 5 or more home
437screen rows (if this is a vertical or square widget) or columns (if this is a
438horizontal or square widget). </li>
439<li>Make sure that 9-patch images render correctly.</li>
440<li>Use default system margins.</li>
441<li>Set the app's <code>targetSdkVersion</code> to 14 or higher, if
442possible.</li>
443</ul>
444
445<div class="rel-resources">
446  <h3>
447    Related resources
448  </h3>
449
450  <ul>
451    <li>
452      <a href="{@docRoot}guide/topics/appwidgets/index.html#MetaData">Adding the
453      AppWidgetProviderInfo Metadata</a> &mdash;API Guide that explains how to
454      set the height and width dimensions of a widget.
455    </li>
456
457    <li>
458      <a href="{@docRoot}guide/practices/ui_guidelines/widget_design.html">App Widget
459      Design Guidelines</a>&mdash;API Guide that provides best practices and
460      techniques for designing and managing the size of widgets.
461    </li>
462  </ul>
463</div>
464
465
466<h2 id="offer-full-feature-set">7. Offer the app's full feature set to tablet users</h2>
467
468<p>Let your tablet users experience the best features of your app. Here are
469some recommendations:</p>
470
471<ul>
472<li>Design your app to offer at least the same set of features on tablets as it does on
473handsets. </li>
474<li>In exceptional cases, your app might omit or replace certain features on
475tablets if they are not supported by the hardware or use-case of most tablets.
476For example:
477<ul>
478<li>If the handset uses telephony features but telephony is not available on the
479current tablet, you can omit or replace the related functionality.</li>
480<li>Many tablets have a GPS sensor, but most users would not normally carry
481their tablets while running. If your phone app provides functionality to let the
482user record a GPS track of their runs while carrying their phones, the app would not need to
483provide that functionality on tablets because the use-case is not
484compelling.</li>
485</ul>
486</li>
487<li>If you will omit a feature or capability from your tablet UI, make sure
488that it is not accessible to users or that it offers “graceful degradation”
489to a replacement feature (also see the section below on hardware features).</li>
490</ul>
491
492<h2 id="android-versions">8. Target Android versions properly</h2>
493
494<p>To ensure the broadest possible distribution to tablets, make sure that your
495app properly targets the Android versions that support tablets. Initial support for
496tablets was added in <a href="{@docRoot}about/versions/android-3.0">Android 3.0</a> (API level 11). Unified UI
497framework support for tablets, phones, and other devices was introduced in <a href="{@docRoot}about/versions/android-4.0">Android 4.0</a> (API level 14) and is supported in later versions.
498
499<p>You can set the app's
500range of targeted Android versions in the manifest file, in the
501<a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html"><code>&lt;uses-sdk&gt;</code></a> element. In most cases, you can target Android versions properly by setting the element's <code>targetSdkVersion</code> attribute to the highest API level available.</p>
502
503<p style="margin-bottom:.5em;">At a minimum, check the <a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html"><code>&lt;uses-sdk&gt;</code></a>
504  element to make sure that:</p>
505
506      <ol style="list-style-type:lower-alpha;margin-top:0em;">
507        <li><code>targetSdkVersion</code> is declared with value 11 or higher (14 or higher is recommended), OR</li>
508        <li><code>minSdkVersion</code> is declared with value 11 or higher.</li>
509        <li>If a <code>maxSdkVersion</code> attribute is declared, it must have a value of 11 or higher. Note that, in general, the use of <code>maxSdkVersion</code> is <em>not recommended</em>.</li>
510</ol>
511
512<div class="rel-resources">
513<h3>
514  Related resources
515</h3>
516
517<ul>
518  <li>
519    <a href=
520    "{@docRoot}guide/topics/manifest/uses-sdk-element.html#ApiLevels">Android API
521    Levels</a>&mdash;Introduces API levels and how they relate to compatibility.
522    A reference of available API levels is included.
523  </li>
524  <li>
525    <a href="{@docRoot}training/basics/supporting-devices/platforms.html">Supporting Different Platform Versions</a>&mdash;Training class showing how to declare support for
526    minimum and target API levels in your app.
527  </li>
528</ul>
529</div>
530
531<h2 id="hardware-requirements">9. Declare hardware feature dependencies properly</h2>
532
533<p>
534  Handsets and tablets typically offer slightly different hardware support for
535  sensors, camera, telephony, and other features. For example, many tablets are
536  available in a "Wi-Fi" configuration that does not include telephony support.
537</p>
538
539<p>
540  So that you can distribute a single APK broadly across your full customer
541  base of phones and tablets, make sure that your app doesn't declare
542  requirements for hardware features that aren't commonly available on tablets.
543  Instead, properly declare the hardware features as <em>not required</em> in the app
544  manifest, as described below.
545</p>
546
547<ul>
548<li>In your app manifest, locate any <a href="{@docRoot}guide/topics/manifest/uses-feature-element.html"><code>&lt;uses-feature&gt;</code></a>
549elements. In particular, look for hardware features that might not be
550available on some tablets, such as:
551
552<ul>
553<li><code>android.hardware.telephony</code></li>
554<li><code>android.hardware.camera</code> (refers to back camera), or</li>
555<li><code>android.hardware.camera.front</code></li>
556</ul></li>
557
558<li>Declare the <a href="{@docRoot}guide/topics/manifest/uses-feature-element.html"><code>&lt;uses-feature&gt;</code></a>
559elements as <em>not required</em> by including the <code>android:required=”false”</code>
560attribute.
561
562<p>
563  For example, here's the proper way to declare a dependency on
564  <code>android.hardware.telephony</code>, such that you can still
565  distribute the app broadly, even to devices that don't offer telephony:
566</p>
567
568<pre>&lt;uses-feature android:name="android.hardware.telephony" android:required="false" /&gt;</pre></li>
569
570<li>Similarly, check the manifest for <a href="/guide/topics/manifest/permission-element.html"><code>&lt;permission&gt;</code></a> elements that
571<a href="/guide/topics/manifest/uses-feature-element.html#permissions">imply hardware
572feature requirements</a> that not be appropriate for tablets. If you find such
573permissions, make sure to explicitly declare a corresponding
574<code>&lt;uses-feature&gt;</code> element for the features and includes the
575<code>android:required=”false”</code> attribute.</li>
576</ul>
577
578
579<p>
580  After declaring hardware features as <em>not required</em>, make sure to test
581  your app on a variety of devices. The app should function normally when the
582  hardware features it uses are not available, and it should offer "graceful
583  degradation" and alternative functionality where appropriate.
584</p>
585
586<p>
587  For example, if an app normally uses GPS to set the location but GPS is not
588  supported on the device, the app could let the user set the location manually
589  instead. The app can check for device hardware capabilities at runtime and handle
590  as needed.
591</p>
592
593<div class="rel-resources">
594<h3>
595  Related resources
596</h3>
597
598<ul>
599  <li>
600    <a href=
601    "{@docRoot}guide/topics/manifest/uses-feature-element.html#permissions">Permissions
602    that Imply Feature Requirements</a>&mdash;A list of permissions that may
603    cause unwanted filtering if declared in your app's manifest.
604  </li>
605  <li>
606    <a href=
607    "{@docRoot}guide/topics/manifest/uses-feature-element.html"><code>&lt;uses-feature&gt;</code></a>&mdash;Description
608    and reference documentation for the <code>&lt;uses-feature&gt;</code>
609    manifest element.
610  </li>
611
612  <li>
613    <a href="{@docRoot}guide/topics/manifest/uses-feature-element.html#testing">Testing
614    the features required by your application</a>&mdash;Description of how to
615    determine the actual set of hardware and software requirements (explicit or
616    implied) that your app requires.
617  </li>
618</ul>
619</div>
620
621<h2 id="support-screens">10. Declare support for tablet screens</h2>
622
623<p>To ensure that you can distribute your app to a broad range of tablets, your app should
624declare support for tablet screen sizes in its manifest file, as follows:</p>
625
626<ul>
627  <li>A
628  <a href="{@docRoot}guide/topics/manifest/supports-screens-element.html"><code>&lt;supports-screens&gt;</code></a>
629  element, if declared, must not specify <code>android:largeScreens="false"</code>
630  or <code>android:xlargeScreens="false"</code>.</li>
631  <li>For apps targeting <code>minSdkVersion</code> value less than 13, a
632  <a href="{@docRoot}guide/topics/manifest/supports-screens-element.html"><code>&lt;supports-screens&gt;</code></a>
633  element must be declared with both <code>android:largeScreens="true"</code> and
634  <code>android:xlargeScreens="true"</code>.</li>
635</ul>
636
637<p>If the app declares a
638<a href="{@docRoot}guide/topics/manifest/compatible-screens-element.html"><code>&lt;compatible-screens&gt;</code></a>
639element in the manifest, the element should include attributes that specify
640<em>all of the size and density combinations for tablet screens</em> that the
641app supports. Note that, if possible, you should avoid using the
642<a href="{@docRoot}guide/topics/manifest/compatible-screens-element.html"><code>&lt;compatible-screens&gt;</code></a>
643element in your app.</p>
644
645<div class="rel-resources">
646  <h3>
647    Related resources
648  </h3>
649
650  <ul>
651    <li>
652      <a href=
653      "{@docRoot}guide/practices/screens_support.html#DeclaringScreenSizeSupport">Declaring
654      Screen Size Support</a>&mdash;Developer documentation that explains the
655      details of managing UI for best display on multiple screen sizes.
656    </li>
657  </ul>
658</div>
659
660
661<h2 id="google-play">11. Showcase your tablet UI in Google Play</h2>
662
663<p>
664  After you've done the work to create an rich, optimized UI for your tablet
665  app, make sure that you let your customers know about it! Here are some key
666  ways to promote your tablet app to users on Google Play.
667</p>
668
669<h4>
670  Upload screenshots of your tablet UI
671</h4>
672
673<p>
674  Tablet users want to know what your app is like on a tablet device, not on a
675  phone. If you developed a tablet app, make sure to upload screenshots
676  of your tablet UI to the Google Play Developer Console. Here are some guidelines:
677  </p>
678
679<ul style="margin-top:0;">
680  <li>Your screenshots should show the core functionality of your app, not a
681  startup or sign-in page. Wherever users will spend most of their time, that's
682  what you should show in your screenshots.
683  </li>
684
685  <li>Add screenshots taken on both 7-inch and 10-inch tablets.
686  </li>
687
688  <li>It's recommended that you add screenshots taken in both landscape and
689  portrait orientations, if possible.
690  </li>
691
692  <li>Use screen captures if possible. Avoid showing actual device hardware in your
693  screenshots.</li>
694
695  <li>The recommended resolution of your tablet screenshots is <strong>1280 x 720</strong>
696  or higher in each orientation.
697  </li>
698
699  <li>You can upload as many as 8 screenshots of your tablet UI for 7-inch tablets
700  and an additional 8 for 10-inch tablets.
701  </li>
702</ul>
703
704<h4>
705  Update your app description and release notes
706</h4>
707
708<ul>
709  <li>In your app description, make sure to highlight that your app offers
710  tablet-optimized UI and great features for tablet users. Consider adding some
711  detail about how your tablet UI works and why users will like it.
712  </li>
713
714  <li>Include information about tablet support in the app's release notes and
715  update information.
716  </li>
717</ul>
718
719<h4>
720  Update your promotional video
721</h4>
722
723<p>
724  Many users view an app's promotional video to get an idea of what the app is
725  like and whether they'll enjoy it. For tablet users, capitalize on this
726  interest by highlighting your app's tablet UI in your promotional video. Here
727  are some tips and guidelines:
728</p>
729
730<ul>
731  <li>Add one or more shots of your app running on a tablet. To engage with
732  tablet users most effectively, it's recommended that you promote your tablet
733  UI in approximately equal proportion to your phone UI.
734  </li>
735
736  <li>Show your tablet UI as early as possible in the video. Don't assume that
737  tablet users will wait patiently through a feature walkthrough on a phone UI.
738  Ideally, you should engage them immediately by showing the tablet UI within
739  the first 10 seconds, or at the same point that you introduce the phone UI.
740  </li>
741
742  <li>To make it clear that you are showing a tablet UI, include shots of your
743  app running on a hand-held tablet device.
744  </li>
745
746  <li>Highlight your app's tablet UI in the video's narrative or voiceover.
747  </li>
748</ul>
749
750<h4>
751  Feature your tablet UI in your promotional campaigns
752</h4>
753
754<p>
755  Make sure to let tablet users know about your tablet UI in your promotional
756  campaigns, web site, social posts, advertisements, and elsewhere. Here are
757  some suggestions:
758</p>
759
760<ul>
761  <li>Plan a marketing or advertising campaign that highlights the use of your
762  app on tablets.</li>
763
764  <li>Show your tablet app at its best in your promotional campaigns&mdash;use the <a href=
765  "{@docRoot}distribute/promote/device-art.html">Device Art Generator</a> to
766  quickly generate a high-quality promotional image of your app running on a
767  7-inch or 10-inch tablet, in the orientation of your choice, with or without
768  drop-shadow and screen glare. It's as simple as capture, drag, and drop.
769  </li>
770
771  <li>Include a Google Play badge in your online promotions to let users link
772  directly to your app's store listing. You can generate a badge in a variety
773  of languages using the <a href=
774  "{@docRoot}distribute/googleplay/promote/badges.html">Badge Generator</a>.
775  </li>
776</ul>
777
778<div class="rel-resources">
779  <h3>
780    Related resources
781  </h3>
782
783  <ul>
784    <li>
785      <a href="{@docRoot}distribute/googleplay/publish/preparing.html">Publishing
786      Checklist</a>
787      &mdash;Recommendations on how to prepare your app for publishing, test
788      it, and launch successfully on Google Play.
789    </li>
790
791    <li>
792      <a href="https://play.google.com/apps/publish/">Google Play
793      Developer Console</a>&mdash;The tools console for publishing
794      your app to Android users.
795    </li>
796    <li>
797      <a href=
798      "{@docRoot}distribute/googleplay/promote/badges.html">Google Play
799      Badge Generator</a>&mdash;Create "Get it on Google Play" badges for your
800      app in a variety of languages with a single click.
801    </li>
802    <li>
803      <a href=
804      "{@docRoot}distribute/googleplay/promote/device-art.html">Device Art
805      Generator</a>&mdash;Drag and drop tool that lets you instantly create production-
806      ready art showing your app running on a tablet device.
807    </li>
808  </ul>
809</div>
810
811<h2 id="google-play-best-practices">12. Follow best practices for publishing in Google Play</h2>
812
813<p>Here are some best practices for delivering a successful tablet app on Google Play.</p>
814
815<h4 id="google-play-optimization-tips">Check out your app's Optimization Tips</h4>
816
817<p>The Google Play Developer Console now offers an Optimization Tips page that
818lets you quickly check how your app is doing against basic guidelines for tablet app
819distribution and quality. To visit the page, sign into the Developer Console,
820load the app from All Applications, and click Optimization Tips in
821the left navigation.</p>
822
823<div class="sidebox-wrapper">
824<div class="sidebox">
825<h2 style="line-height:1em;">How to send feedback</h2>
826
827<p>Please use the link below to send
828feedback or request a manual review of your Optimization Tips.</p>
829
830<p>Make sure to read the relevant sections of the Tablet App Quality
831Guidelines prior to sending feedback.</p>
832
833<p><strong><a href="https://support.google.com/googleplay/android-developer/contact/tabletq"
834target="_googleplay" style="white-space:nowrap">Designed for Tablets Contact Form &raquo;</a></strong></p>
835</div>
836</div>
837
838<p>The Developer Console creates your app's Optimization Tips page
839by running a series of checks to verify basic quality
840criteria. If it finds any issues, it alerts you to them as "To Do"
841items in the Optimization Tips page.</p>
842
843<p>If you've developed a tablet experience for your app, make sure
844to visit the Optimization Tips page to see how your app is doing
845against the basic checks.  If there are any issues listed, we
846recommend addressing them in your app and uploading a new binary for
847distribution, if needed. </p>
848
849<p>If the Optimization Tips page lists "To Do" issues that you feel don't
850apply to your app or affect its quality on tablets, please notify us
851using the <a href="https://support.google.com/googleplay/android-developer/contact/tabletq"
852target="_googleplay" style="white-space:nowrap">Designed for Tablets Contact Form &raquo;</a>. We
853will review your app and update your Optimization Tips page as
854appropriate.</p>
855
856
857<h4>Confirm the app's filtering</h4>
858
859<p>After you've uploaded the app to the <a href="https://play.google.com/apps/publish/">Developer Console</a>, check the APK's Supported Devices list to make sure that the app is not filtered from tablet devices that you want to target.</p>
860
861<h4>Distribute as a single APK</h4>
862
863<p>
864  It's recommended that you publish your app as a single APK for all screen
865  sizes (phones and tablets), with a single Google Play listing. This approach
866  has several important advantages.
867</p>
868
869<ul style="margin-top:.25em;">
870  <li>Easier for users to find your app from search, browsing, or promotions
871  </li>
872
873  <li>Easier for users to restore your app automatically if they get a new
874  device.
875  </li>
876
877  <li>Your ratings and download stats are consolidated across all devices.
878  </li>
879
880  <li>Publishing a tablet app in a second listing can dilute ratings for your
881  brand.
882  </li>
883</ul>
884
885<p>
886  If necessary, you can alternatively choose to deliver your app using <a href=
887  "{@docRoot}google/play/publishing/multiple-apks.html">Multiple APK Support</a>,
888  although in most cases using a single APK to reach all devices is strongly
889  recommended.
890</p>
891
892<div class="rel-resources">
893<h3>Related resources</h3>
894<ul>
895<li><a href="{@docRoot}distribute/googleplay/publish/preparing.html">Publishing
896      Checklist</a>&mdash;
897  Recommendations on how to prepare your app for publishing, test it, and launch
898  successfully on Google Play.</li>
899<li><a href="https://play.google.com/apps/publish/">Google Play Developer
900  Console</a>&mdash;The tools console for publishing your app to Android users.</li>
901</ul>
902</div>
903
904
905<h2 id="test-environment">Setting Up a Test Environment for Tablets</h2>
906
907<p>To assess the quality of your app on tablets &mdash; both for core app quality
908and tablet app quality &mdash; you need to set up a suitable
909hardware or emulator environment for testing. </p>
910
911<p>The ideal test environment would
912include a small number of actual hardware devices that represent key form
913factors and hardware/software combinations currently available to consumers.
914It's not necessary to test on <em>every</em> device that's on the market &mdash;
915rather, you should focus on a small number of representative devices, even using
916one or two devices per form factor.  The table below provides an overview of
917devices you could use for testing.</p>
918
919<p>If you are not able to obtain actual hardware devices for testing, you should
920<a href="{@docRoot}tools/devices/index.html">set up emulated devices (AVDs)</a>
921to represent the most common form factors and
922hardware/software combinations. See the table below for suggestions on the emulator
923configurations to use. </p>
924
925<p>To go beyond basic testing, you can add more devices, more form factors, or
926new hardware/software combinations to your test environment. For example, you
927could include mid-size tablets, tablets with more or fewer hardware/software
928features, and so on. You can also increase the number or complexity of tests
929and quality criteria. </p>
930
931<p class="table-caption"><strong>Table 1</strong>. A typical tablet test environment might
932include one or two devices from each row in the table below, with one of the
933listed platform versions, screen configurations, and hardware feature configurations.</p>
934
935<table>
936<tr>
937<th>Type</th>
938<th>Size</th>
939<th>Density</th>
940<th>Version</th>
941<th>AVD Skin</th>
942</tr>
943
944<tr>
945<td>7-inch tablet</td>
946<td><span style="white-space:nowrap"><code>large</code> or</span><br /><code>-sw600</code></td>
947<td><code>hdpi</code>,<br /><code>tvdpi</code></td>
948<td>Android 4.0+ (API level 14 and higher)</td>
949<td>WXGA800-7in</td>
950</tr>
951<tr>
952<td><span style="white-space:nowrap">10-inch</span> tablet</td>
953<td><span style="white-space:nowrap"><code>xlarge</code> or</span><br /><code>-sw800</code></td>
954<td><code>mdpi</code>,<br /><code>hdpi</code>,<br /><code>xhdpi</code></td>
955<td>Android 3.2+ (API level 13 and higher)</td>
956<td>WXGA800</td>
957</tr>
958</table>