TipKit

Uygulamanızdaki özellikleri keşfetmeye yardımcı ipuçları görüntüleyin.

Genel Bakış

TipKit, kullanıcıların henüz keşfetmediği yeni, ilginç veya kullanılmayan özellikleri vurgulamak için bağlamsal ipuçları (tip) göstermenize olanak tanır. Tip protokolüyle ipucu içeriğinizi ve görünme koşullarını tanımlayın, ardından TipView ile yeni özelliklere dikkat çekin.

İpuçlarını tasarlarken kullanıcıları bunaltmamaya özen gösterin. İpuçlarını, kullanıcıların kendi başlarına keşfetmediği belirgin olmayan özellikleri vurgulamak için tutumlu kullanın. Her uygulama açılışında ipucu görüntülemekten kaçının — gereksiz yere beliren ipuçları dikkat dağıtıcı olabilir. İpuçlarını uygulama rehberi veya tanıtım amaçlı kullanmayın.

import SwiftUI
import TipKit

// İpucu içeriğinizi tanımlayın.
struct FavoriteLandmarkTip: Tip {
    var title: Text {
        Text("Favori Olarak Kaydet")
    }

    var message: Text? {
        Text("Favori yer işaretleriniz her zaman listenin en üstünde görünür.")
    }

    var image: Image? {
        Image(systemName: "star")
    }
}

@main
struct LandmarkTips: App {
    var favoriteLandmarkTip = FavoriteLandmarkTip()

    var body: some Scene {
        WindowGroup {
            VStack {
                // İpucu görünümünü vurgulamak istediğiniz özelliğin yakınına yerleştirin.
                TipView(favoriteLandmarkTip, arrowEdge: .bottom)

                Image(systemName: "star")
                    .imageScale(.large)
                Spacer()
            }
            .task {
                // Uygulama başlatımında ipuçlarını yapılandırın ve yükleyin.
                do {
                    try Tips.configure()
                }
                catch {
                    print("TipKit başlatılırken hata: \(error.localizedDescription)")
                }
            }
        }
    }
}

*iOS 17.0+, iPadOS 17.0+, Mac Catalyst 17.0+, macOS 14.0+, tvOS 16.0+, visionOS 1.0+, watchOS 10.0+ sürümlerinde kullanılabilir.*

Konular

Temeller

İpucu protokolü, ipucu grupları ve TipKit ile uygulama özelliklerini vurgulama.

• TipKit ile Uygulama Özelliklerini Vurgulama: İpuçları kullanarak uygulamanızdaki yeni özelliklere dikkat çekin.
• Tip Protokolü: İpucu içeriğini ve görüntülenme koşullarını belirleyen tip.
• TipGroup: Belirli bir sıra veya uygunluk durumuna göre tek tek sunulabilen ipucu koleksiyonu.

Görünümler

SwiftUI, UIKit ve AppKit ile ipucu görüntüleme ve özelleştirme.

• TipView: Satır içi ipucu temsil eden SwiftUI görünümü.
• popoverTip: Popover tarzında ipucu görüntüleme.
• UIKit Görünümleri: TipUIView, TipUIPopoverViewController ve koleksiyon görünümleri.
• AppKit Görünümleri: TipNSView ve TipNSPopover.
• Görünüm Stilleri: Özel görünüm stilleri oluşturma.

Kurallar ve Yapılandırma

İpuçlarının ne zaman görüntüleneceğini kontrol etme ve uygulama düzeyinde yapılandırma.

• Rule: İpucu görüntülemeden önce karşılanması gereken koşul.
• Parameter: Uygulama durumunu izleyen tip.
• Event: Tekrarlanabilir kullanıcı tanımlı eylem.
• Yapılandırma Seçenekleri: Gösterim sıklığı, veri deposu ve CloudKit ayarları.
• Davranış Seçenekleri: MaxDisplayCount, MaxDisplayDuration, IgnoresDisplayFrequency.

Test ve Yardımcı Tipler

İpucu test API'leri, hata tipleri ve yardımcı yapılar.

• Test API'leri: showAllTipsForTesting, hideTipsForTesting, resetDatastore.
• AnyTip: Tip-silinmiş ipucu değeri.
• TipKitError: Yerelleştirilmiş TipKit hata yapısı.
• TipOption: İpucu davranışı özelleştirme protokolü.