Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Crie widgets adaptáveis do Android que podem ser escalonados sem problemas. Use nossos tamanhos
padrão recomendados como ponto de partida e teste seus layouts em diferentes
dimensões para garantir a melhor legibilidade e experiência do usuário.
Tamanhos padrão
Ofereça uma experiência de widget refinada otimizando seu layout para pelo menos um
dos tamanhos recomendados. Garanta a posição e a visibilidade corretas no seletor de widgets
definindo os atributos targetCellWidth e targetCellHeight para dispositivos
portáteis e tablets.
Esses valores são baseados em dispositivos Pixel. Use esses tamanhos como ponto de partida
para o design do widget. Teste o widget em diferentes tamanhos e em
vários dispositivos para garantir uma experiência de qualidade para o usuário.
Filmagem manual
Tamanhos
Largura mínima
Largura máxima
Altura mínima
Altura máxima
2x1
109
306
56
130
2x2
109
306
115
276
2x3
109
306
185
422
4x1
245
624
56
130
4x2
245
624
115
276
4x3
245
624
185
422
Tablet
Tamanhos
Largura mínima
Largura máxima
Altura mínima
Altura máxima
2x1
180
304
64
120
2x2
180
304
184
304
2x3
180
304
304
488
3x1
328
488
64
120
3x2
298
488
184
304
3x3
298
488
304
488
3x4
298
488
424
672
Pontos de interrupção
Os pontos de interrupção são essenciais para criar widgets adaptáveis e redimensionáveis
fáceis de usar. Ao testar seu design, você pode identificar os limites de tamanho em que os ajustes
de layout são necessários. Implemente pontos de interrupção para acionar essas mudanças,
garantindo que o widget mantenha o apelo visual e a funcionalidade em qualquer tamanho.
Os pontos de interrupção também oferecem a flexibilidade de incluir ou excluir
conteúdo adicional de forma condicional, otimizando a utilização do espaço com base nas
dimensões do widget.
Figura 1:use pontos de interrupção para fazer mudanças de layout em tamanhos diferentes.
Preencha os limites
Uma das principais razões pelas quais os usuários removem widgets é devido ao desalinhamento com
outros elementos da tela inicial. Para evitar isso, verifique se o widget sempre preenche completamente o
espaço alocado na grade.
check_circle
O que fazer
Verifique se o contêiner se estende de ponta a ponta em todos os tamanhos.
cancel
O que não fazer
Adicione um padding personalizado. O widget precisa ocupar toda a tela.
check_circle
O que fazer
Para manter a consistência visual, verifique se a forma não retangular toca a grade no eixo vertical ou horizontal.
cancel
O que não fazer
Use formas quadradas fixas. Em vez disso, use contêineres retangulares responsivos que se adaptam a várias dimensões de grade.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-27 UTC."],[],[],null,["# Sizing\n\nDesign adaptable Android widgets that scale seamlessly. Use our recommended\ndefault sizes as a starting point, and test your layouts across different\ndimensions to ensure optimal readability and user experience.\n\nDefault sizes\n-------------\n\nDeliver a polished widget experience by optimizing your layout for at least one\nof our recommended sizes. Ensure correct placement and visibility in the widget\npicker by defining `targetCellWidth` and `targetCellHeight` attributes for both\nhandheld and tablet devices.\n\nThese values are based off Pixel devices. Use these sizes as a starting point\nfor your widget design. Thoroughly test your widget at different sizes and on\nvarious devices to ensure a quality user experience. \n\n### Handheld\n\n\n| Sizes | Min width | Max width | Min height | Max height |\n|-------|-----------|-----------|------------|------------|\n| 2x1 | 109 | 306 | 56 | 130 |\n| 2x2 | 109 | 306 | 115 | 276 |\n| 2x3 | 109 | 306 | 185 | 422 |\n| 4x1 | 245 | 624 | 56 | 130 |\n| 4x2 | 245 | 624 | 115 | 276 |\n| 4x3 | 245 | 624 | 185 | 422 |\n\n\u003cbr /\u003e\n\n### Tablet\n\n\n| Sizes | Min width | Max width | Min height | Max height |\n|-------|-----------|-----------|------------|------------|\n| 2x1 | 180 | 304 | 64 | 120 |\n| 2x2 | 180 | 304 | 184 | 304 |\n| 2x3 | 180 | 304 | 304 | 488 |\n| 3x1 | 328 | 488 | 64 | 120 |\n| 3x2 | 298 | 488 | 184 | 304 |\n| 3x3 | 298 | 488 | 304 | 488 |\n| 3x4 | 298 | 488 | 424 | 672 |\n\n\u003cbr /\u003e\n\n| **Note:** Widget dimensions in the table encompass all device orientations, including landscape mode on phones, to ensure optimal functionality in a variety of scenarios.\n\nBreakpoints\n-----------\n\nBreakpoints are essential for crafting adaptable, user-friendly resizable\nwidgets. By testing your design, you can pinpoint size thresholds where layout\nadjustments are necessary. Implement breakpoints to trigger these changes,\nensuring your widget maintains visual appeal and functionality at any size.\n\nBreakpoints also offer the flexibility to conditionally include or exclude\nsupplemental content, optimizing space utilization based on the widget's\ndimensions.\n**Figure 1:** Use breakpoints to make layout changes at different sizes.\n\nFill the bounds\n---------------\n\nOne of the primary reasons users remove widgets is due to misalignment with\nother home screen elements. To prevent this, ensure your widget always fills its\nallocated grid space completely. \ncheck_circle\n\n### Do\n\nMake sure the container stretches edge-to-edge at all sizes. \ncancel\n\n### Don't\n\nAdd custom padding. Your widget should go seamlessly edge-to-edge. \ncheck_circle\n\n### Do\n\nEnsure your non-rectangular shape touches the grid on either the vertical or horizontal axis for visual consistency. \ncancel\n\n### Don't\n\nUse fixed square shapes. Instead, use responsive rectangular containers that adapt to various grid dimensions."]]