Kısayol oluşturma

Uygulamanızın kısayollarını tasarlarken ve oluştururken aşağıdaki yönergelere uyun:

Tasarım yönergelerini uygulayın

Uygulamanızın kısayollarını, sistem uygulamaları için kullanılan kısayollarla görsel olarak tutarlı hale getirmek için Uygulama Kısayolları Simge Tasarımı Yönergeleri'ni uygulayın.

Yalnızca dört farklı kısayol yayınlama

API, uygulamanız için 15 adede kadar statik ve dinamik kısayol kombinasyonunu desteklese de başlatıcıdaki görsel görünümlerini iyileştirmek için yalnızca dört farklı kısayol yayınlamanızı öneririz.

Başlatıcıda kısayolları göstermenin yanı sıra, Google Asistan gibi Google platformlarında kısayolları göstermek için Google Kısayolları Entegrasyon Kitaplığı'nı kullanın. Bu kitaplık, sınırsız sayıda dinamik kısayolun gönderilmesini destekler. Bu kitaplığı çok sayıda kısayolu göndermek için kullanıyorsanız setRank() yöntemini çağırarak desteklenen başlatıcılarda görünmesi gereken kısayolların rank değerini ayarlamanızı öneririz.

Kısayol açıklaması uzunluğunu sınırlama

Menüde, başlatıcıdaki uygulama kısayollarınızı gösteren alan sınırlıdır. Mümkün olduğunda kısayolun "kısa açıklama"sını 10 karakterle, "uzun açıklama"sını ise 25 karakterle sınırlayın.

Statik kısayolların etiketleri hakkında daha fazla bilgi için Özellik değerlerini özelleştirme başlıklı makaleyi inceleyin. Dinamik ve sabitlenmiş kısayollar için setLongLabel() ve setShortLabel() ile ilgili referans belgeleri okuyun.

Kısayol ve işlem kullanım geçmişini koruma

Oluşturduğunuz her kısayol için, kullanıcının aynı görevi doğrudan uygulamanızda gerçekleştirebileceği farklı yolları göz önünde bulundurun. Başlatıcı, kullanıcının kısayollarınızı temsil eden işlemleri ne sıklıkta gerçekleştirdiğine dair doğru bir geçmiş tutabilsin diye bu durumların her birinde reportShortcutUsed() işlevini çağırın.

Kısayolları yalnızca anlamları korunduğunda güncelleme

Dinamik ve sabitlenmiş kısayolları değiştirirken yalnızca anlamını koruyan bir kısayolun bilgilerini değiştirirken updateShortcuts() işlevini çağırın. Aksi takdirde, yeniden oluşturduğunuz kısayolun türüne bağlı olarak aşağıdaki yöntemlerden birini kullanın:

• Dinamik kısayollar: pushDynamicShortcut().

• Sabitlenmiş kısayollar: requestPinShortcut().

  Örneğin, bir süpermarkete gitmek için kısayol oluşturursanız süpermarketin adı değişir ancak konumu aynı kalırsa kısayolu güncellemeniz uygun olur. Ancak kullanıcı farklı bir süpermarkette alışveriş yapmaya başlarsa yeni bir kısayol oluşturmak daha iyi olur.

Uygulamanızı her başlattığınızda dinamik kısayolları kontrol edin

Dinamik kısayollar kullanıcı verilerini yeni bir cihaza geri yüklediğinde korunmaz. Bu nedenle, uygulamanızı her başlattığınızda getDynamicShortcuts() tarafından döndürülen nesne sayısını kontrol etmenizi ve Yedekleme ve geri yükleme bölümündeki kod snippet'inde gösterildiği gibi, gerektiğinde dinamik kısayolları yeniden yayınlamanızı öneririz.