Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Standart widget düzenleri

Öncelikle temel içeriğinizi belirleyerek etkili widget düzenleri oluşturun. Düzeniniz, widget'ınızdaki bilgilerin ve etkileşimli öğelerin nasıl düzenleneceğini belirler. Android, bu süreci kolaylaştırmak için araç çubukları, metin, liste ve ızgara türü widget'lar için önceden oluşturulmuş çeşitli düzenler sunar.

Android becerileri

GitHub'da görüntüle

Glance standart widget düzenleri

Jetpack Glance standart düzenlerini kullanarak ana ekran widget'ları oluşturmak için Glance standart widget düzenleri Android becerisini kullanın.

Beceriyi Android KSA'dan yüklemek için şu komutu çalıştırın:

android skills add glance-canonical-layouts

Metin

Metin düzenleri, kısa ve öz bilgiler göstermek için idealdir. İsteğe bağlı olarak metnin yanına resim ekleyerek widget'ınızın görsel çekiciliğini artırın.

Yalnızca metin

Başlıklar, durum güncellemeleri, kısa açıklamalar veya tek satırlık metnin mesajı etkili bir şekilde ilettiği her senaryo için idealdir.

Metin ve resim

Görsel etkiyi artırmak için bir resim ekleyin. Bu düzeni farklı ekran boyutlarına nasıl uyarlayacağınızı öğrenmek için Kesme noktaları başlıklı makaleyi inceleyin.

Araç çubukları

Araç çubuğu düzenlerini kullanarak kullanıcıların uygulamanızda sık kullanılan görevlere hızlıca erişmesini sağlayın. Bu düzenler, widget boyutlarına göre uyarlanabilen esnek bir yapıya sahiptir.

Arama Araç Çubuğu

Arama araç çubuğu düzeni, araç çubuğundaki birincil işlem olarak aramaya odaklanacak şekilde tasarlanmıştır. Ek kullanışlı düğmeler, sık kullanılan işlevlere hızlı erişim sağlayabilir.

Araç çubuğu

Araç çubukları, uygulama markasını ve ardından açılıp kapatılabilir ayarlar veya görev bağlantıları için ideal olan en çok kullanılan görevlerin düğmelerini gösterir. Yeniden boyutlandırma sırasında, daha yaygın işlemlerin gösterilmesi için daha az kullanılan seçenekler gizlenebilir. Yer olduğunda yeni bir minimum 48 dp dokunulabilir düğme eklemek için kesme noktalarını kullanın.

Listeler

Birden fazla öğeyi net ve taranabilir bir biçimde düzenlemek için liste düzenlerini kullanın. Bu, haber başlıkları, yapılacaklar listeleri veya mesajlar için idealdir. İçeriği yapılandırılmış, taranabilir bir liste halinde düzenleyin. İçerik ihtiyaçlarınıza göre kapsayıcılı veya kapsayıcısız sunum arasında seçim yapın.

Metin ve resim listesi

Taranabilir metin ve resim listeleri; haber başlıkları, albüm kapağı içeren oynatma listeleri veya mesajlar gibi birden fazla içerik türünü sergilemek için idealdir.

Yapılacaklar listesi

Kontrol listesi düzeni, görevleri göstermek için idealdir. Kullanıcıların öğeleri hızlıca tamamlandı olarak işaretleyebileceği net dokunma hedefleri sunar.

İşlem listesi

İşlem listeleriyle sezgisel kontrol gruplandırması sağlayın. Bu listelerde görsel açık/kapalı durumları, öğe durumları hakkında anında geri bildirim sunar.

Tam çerçeve resim

Android 17 ve sonraki sürümlerde tam taşan, etkileyici resimler göstermek için ideal olan bu düzende, her bir alt öğenin widget kapsayıcısının yüksekliğiyle mükemmel şekilde hizalanması için hızlı kaydırma kullanılır.

Izgara

Resimleri, isteğe bağlı etiketlerle birlikte kompakt, esnek ve görsel açıdan zengin bir ızgarada sunun. Farklı ekran boyutlarına uyum sağlayan sütunlar ve satırlar kullanın.

Yalnızca resim

Yalnızca resimlerden oluşan ızgaralar kullanarak görsel olarak etkileyici, kaydırılabilir resim galerileri oluşturun. Satırlar ve sütunlar, en iyi sunum için çeşitli ekran boyutlarına otomatik olarak uyum sağlar.

Resim ve metin

Ayrıca, metin etiketleri ve açıklamaları da ekleyerek resim ızgarası içeriğinizi daha fazla bağlam ve bilgiyle zenginleştirebilirsiniz.

Kod örnekleri

Aşağıdaki tabloda, her bir standart düzenin Android Platform Samples GitHub deposundaki karşılık gelen Jetpack Glance uygulamasıyla eşlemesi gösterilmektedir.

Standart düzen	Referans dosyaları	Rehberlik
İşlem Listesi Düzeni	ActionListAppWidget.kt ActionListLayout.kt ListItem.kt RoundedScrollingLazyColumn.kt RoundedScrollingLazyVerticalGrid.kt EmptyListContent.kt NoDataContent.kt FakeActionListDataRepository.kt sample_action_list_widget_info.xml dimens.xml strings.xml sample_home_icon.xml sample_power_settings_icon.xml sample_bulb_icon.xml sample_thermostat_icon.xml sample_ac_icon.xml sample_door_icon.xml sample_arrow_right_icon.xml sample_no_data_icon.xml sample_add_icon.xml	Glance işlem geri çağırmalarıyla liste öğesi işlemlerini yönetin ve durum güncellemelerinin doğru şekilde yapılmasını sağlayın.
Liste Düzenini Kontrol Etme	CheckListAppWidget.kt CheckListLayout.kt ListItem.kt RoundedScrollingLazyColumn.kt EmptyListContent.kt NoDataContent.kt FakeCheckListDataRepository.kt sample_check_list_widget_info.xml dimens.xml strings.xml sample_pin_icon.xml sample_checked_circle_icon.xml sample_circle_icon.xml sample_delete_icon.xml sample_edit_icon.xml sample_snooze_icon.xml sample_no_data_icon.xml sample_add_icon.xml	Toplama öğelerini güncellemek için işlem parametrelerini veya geri çağırmaları kullanarak onay kutusu durumunu değiştirme işlevini uygulayın. Bir onay kutusuna dokunma gibi tıklama etkinliklerini işlemek için widget'ın `onClick` parametrelerinde `actionRunCallback`, `ActionCallback(actionParametersOf(...))` veya `actionStartActivity(...)` gibi Glance işlem geri çağırmalarını kullanın.
Etkileyici Araç Çubuğu Düzeni	ExpressiveToolbarAppWidget.kt ExpressiveToolbarLayout.kt sample_expressive_toolbar_widget_info.xml Buttons.kt LayoutComponents.kt dimens.xml strings.xml four_side_cookie_background.xml sample_edit_icon.xml sample_share_icon.xml sample_delete_icon.xml sample_info_icon.xml sample_add_icon.xml sample_file_upload_icon.xml sample_mic_icon.xml sample_camera_icon.xml	`ColorProvider` içe aktarma hatalarından kaçının: `androidx.glance.unit.ColorProvider` öğesini içe aktarın ve `androidx.glance.color.ColorProvider(dayColor, nightColor)` öğesini kullanın. Düz arka plan renkleri için `ColorProvider` yerine doğrudan `GlanceModifier.background(Color)` kullanın.
Resim Izgara Düzeni	ImageGridAppWidget.kt ImageGridLayout.kt RoundedScrollingLazyVerticalGrid.kt EmptyListContent.kt NoDataContent.kt FakeImageGridDataRepository.kt sample_image_grid_widget_info.xml ImageUtils.kt dimens.xml strings.xml sample_placeholder_image.png sample_grid_icon.xml sample_refresh_icon.xml sample_no_data_icon.xml sample_add_icon.xml	Bir resim yükleme kitaplığı yapılandırılmadığı veya istenmediği sürece, resim öğeleri için düz renkler (`GlanceModifier.background`) veya yerel çizilebilir öğeler kullanın.
Resim Metin Listesi Düzeni	ImageTextListAppWidget.kt ImageTextListLayout.kt ListItem.kt RoundedScrollingLazyColumn.kt EmptyListContent.kt NoDataContent.kt FakeImageTextListDataRepository.kt sample_image_text_list_widget_info.xml ImageUtils.kt dimens.xml strings.xml sample_placeholder_image.png sample_image_icon.xml sample_heart_icon.xml sample_refresh_icon.xml sample_no_data_icon.xml sample_add_icon.xml	Yaygın kullanım alanları: haber feed'leri, makale listeleri, egzersiz geçmişleri, mesaj feed'leri ve dikey küçük resim listeleri. Küçük resimleri birincil/ikincil metinle birleştirirken liste satırı yüksekliği ve metin kırpma arasında denge kurun.
Uzun Metin Düzeni	LongTextAppWidget.kt LongTextLayout.kt FakeLongTextRepository.kt sample_long_text_widget_info.xml FontUtils.kt dimens.xml strings.xml sample_text_icon.xml sample_refresh_icon.xml	`2 * padding` gibi `Dp` değerlerini çarparsanız `androidx.compose.ui.unit.times` değerini içe aktarın. Boyutlandırma kurallarına uyun: Dolgu ve tipografi ölçeklendirme için `dimens.xml` dosyasındaki boyutların kullanıldığından emin olun.
Arama Araç Çubuğu Düzeni	SearchToolBarAppWidget.kt SearchToolBarLayout.kt sample_search_toolbar_widget_info.xml Buttons.kt LayoutComponents.kt dimens.xml strings.xml sample_search_icon.xml sample_mic_icon.xml sample_camera_icon.xml sample_videocam_icon.xml sample_share_icon.xml	`ColorProvider` içe aktarma hatalarını önleyin: `androidx.glance.unit.ColorProvider` öğesini içe aktarın ve `androidx.glance.color.ColorProvider(dayColor, nightColor)` öğesini kullanın. Düz arka plan renkleri için ColorProvider yerine doğrudan `GlanceModifier.background(Color)` kullanın.
Tam Sayfa Resim Düzeni / Anlık Kaydırma	FullBleedImageAppWidget.kt FullBleedImageLayout.kt sample_full_bleed_image_widget_info.xml FontUtils.kt dimens.xml strings.xml sample_scrim_gradient.xml sample_placeholder_image.png sample_app_logo.xml sample_info_icon.xml sample_no_data_icon.xml	Snap kaydırma için LazyColumn'da `verticalScrollMode = VerticalScrollMode.SnapScrollMatchHeight(size.height)` değerini ayarlayın. Kaydırma özelliğini kullanıyorsanız Glance 1.3.0-alpha02 veya sonraki sürümler, SDK 37 (Baklava) veya sonraki sürümler ve Android Gradle eklentisi (AGP) 9.1.0 veya sonraki sürümler gerekir. Widget sağlayıcı sınıfında `override val sizeMode: SizeMode = SizeMode.Exact` değerini ayarlayın.
Standart Araç Çubuğu Düzeni	ToolBarAppWidget.kt ToolBarLayout.kt sample_toolbar_widget_info.xml Buttons.kt LayoutComponents.kt dimens.xml strings.xml sample_app_logo.xml sample_search_icon.xml sample_add_icon.xml sample_edit_icon.xml sample_share_icon.xml sample_mic_icon.xml sample_camera_icon.xml sample_videocam_icon.xml	"ColorProvider" içe aktarma hatalarını önlemek için Sorun giderme bölümüne bakın: "androidx.glance.color.ColorProvider(dayColor, nightColor)" kullanın. Düz arka plan renkleri için `ColorProvider` yerine doğrudan `GlanceModifier.background(Color)` kullanın.
Resim düzeniyle metin	TextWithImageAppWidget.kt TextWithImageLayout.kt FakeTextWithImageRepository.kt sample_text_with_image_widget_info.xml FontUtils.kt dimens.xml strings.xml sample_text_icon.xml sample_refresh_icon.xml sample_placeholder_image.png sample_info_icon.xml sample_no_data_icon.xml	Metin ve resmi yan yana veya üst üste yerleştirmek için mevcut widget boyutlarına göre duyarlı düzen boyutlandırma kurallarına uyun.