Kısayollar için en iyi uygulamalar

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

Tasarım yönergelerine uyun

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 izleyin.

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

API, uygulamanız için 15'e kadar statik ve dinamik kısayolun bir kombinasyonunu desteklese de, başlatıcıdaki görsel görünümlerinin iyileştirilmesi için yalnızca dört ayrı kısayol yayınlamanızı öneririz.

Kısayolları başlatıcıda görüntülemenin yanı sıra Google Asistan gibi Google yüzeylerinde görüntülemek için Google Kısayollar Entegrasyon Kitaplığı'nı kullanın. Bu kitaplık, sınırsız sayıda dinamik kısayol aktarmayı destekler. Bu kitaplığı çok sayıda kısayolu uygulamak için kullanıyorsanız setRank() yöntemini çağırarak desteklenen başlatıcılarda görünmesi gereken kısayolların rank kadarını ayarlamanızı öneririz.

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

Menüde, başlatıcıda uygulamanızın kısayollarını gösteren alan sınırlıdır. Mümkün olduğunda bir kısayolun "kısa açıklamasının" uzunluğunu 10 karakterle, "uzun açıklamanın" ise uzunluğunu 25 karakterle sınırlandırın.

Statik kısayol etiketleri hakkında daha fazla bilgi için Özellik değerlerini özelleştirme konusunu okuyun. Dinamik ve sabitlenmiş kısayollar için setLongLabel() ve setShortLabel() ile ilgili referans belgelerini okuyun.

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

Oluşturduğunuz her kısayol için bir kullanıcının aynı görevi doğrudan uygulamanızda gerçekleştirebileceği farklı yolları düşünün. Bu durumların her birinde reportShortcutUsed() çağrısını çağırarak başlatıcının, bir kullanıcının kısayollarınızı temsil eden işlemleri ne sıklıkta yaptığı hakkında doğru bir geçmiş bilgisi tutmasını sağlayın.

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

Dinamik ve sabitlenmiş kısayolları değiştirirken, yalnızca updateShortcuts() kodunu, anlamını koruyan bir kısayolun bilgilerini değiştirirken ç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:

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

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

Kullanıcı, verilerini yeni bir cihaza geri yüklediğinde dinamik kısayollar korunmaz. Bu nedenle, uygulamanızı her başlattığınızda getDynamicShortcuts() tarafından döndürülen nesnelerin 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.