dpearson2699/tipkit

Was macht tipkit?

Implementieren, überprüfen oder verbessern Sie In-App-Tipps und Onboarding mit Apple's TipKit-Framework. Verwenden Sie dies beim Hinzufügen von Tooltips zur Feature-Entdeckung, Onboarding-Abläufen, kontextuellen Tipps, Ersterfahrungen, Coach-Marks oder bei der Arbeit mit dem Tip-Protokoll, TipView, popoverTip, Tipp-Regeln, Tipp-Ereignissen oder der UI zur Feature-Schulung.

Überblick

TipKit ist ein von Apple bereitgestelltes Framework, das es Entwicklern ermöglicht, kontextuelle Tipps und Anleitungen in ihre Apps zu integrieren. Es hilft Benutzern, neue oder wichtige Funktionen zu entdecken, Onboarding-Abläufe zu absolvieren und kontextuelle Hilfe zu erhalten, ohne die App zu verlassen.

Funktionen

• Tip-Protokoll: Definieren Sie benutzerdefinierte Tipps mit Eigenschaften wie Titel, Nachricht, Bild und Aktionen.
• TipView: Eine SwiftUI-Ansicht zur Anzeige eines Tipps mit anpassbarem Stil.
• popoverTip: Ein View-Modifier, der einen Tipp als Popover über einer bestimmten Ansicht anzeigt.
• Tipp-Regeln: Steuern Sie, wann ein Tipp angezeigt wird, basierend auf Bedingungen wie Datum, Ereignissen oder benutzerdefinierten Parametern.
• Tipp-Ereignisse: Verfolgen Sie Benutzerinteraktionen, um Tipps auszulösen oder zu unterdrücken.
• Coach-Marks: Leiten Sie Benutzer durch bestimmte UI-Elemente mit visuellen Hinweisen.

Verwendung

1. Tip implementieren: Erstellen Sie eine Struktur, die dem Tip-Protokoll entspricht.
2. TipView verwenden: Fügen Sie TipView in Ihre SwiftUI-Ansicht ein.
3. popoverTip anwenden: Verwenden Sie den .popoverTip() Modifier an der entsprechenden Stelle.
4. Regeln und Ereignisse konfigurieren: Definieren Sie, wann und wie Tipps erscheinen sollen.

Beispiel

import SwiftUI
import TipKit

struct MyTip: Tip {
  var title: Text {
    Text("Neue Funktion: Filter")
  }

  var message: Text? {
    Text("Sie können jetzt Ihre Ergebnisse nach Datum filtern.")
  }

  var image: Image? {
    Image(systemName: "line.3.horizontal.decrease.circle")
  }
}

struct ContentView: View {
  var myTip = MyTip()

  var body: some View {
    VStack {
      Text("Willkommen")
        .popoverTip(myTip)
    }
  }
}

Unterstützte Plattformen

• iOS 17.0+
• macOS 14.0+
• tvOS 17.0+
• watchOS 10.0+

Ressourcen

• Apple Developer Documentation: TipKit
• WWDC 2023: Bring features to life with TipKit