TipKit pour Swift : Guide complet pour créer des astuces utilisateur

TipKit est une bibliothèque puissante et moderne d'Apple, présentée à la WWDC 2023, conçue pour créer des astuces contextuelles et former les utilisateurs dans les applications SwiftUI et UIKit. Elle permet aux développeurs d'intégrer facilement des astuces interactives qui aident les utilisateurs à maîtriser rapidement l'interface, à découvrir les nouvelles fonctionnalités et à améliorer l'engagement global dans l'application.

L'objectif principal de TipKit est de remplacer les solutions d'onboarding obsolètes et lourdes (comme les vues personnalisées ou les bibliothèques tierces) par un outil standardisé, flexible et performant. TipKit gère automatiquement l'affichage des astuces : il les montre au bon moment, les masque après interaction, prend en compte la fréquence d'affichage et permet de personnaliser la logique d'apparition en fonction des actions de l'utilisateur ou de l'état de l'application.

La bibliothèque est idéale pour iOS 17+, macOS 14+, tvOS 17+ et watchOS 10+. Elle s'intègre étroitement avec les frameworks Apple, prend en charge les animations, l'adaptabilité aux différentes tailles d'écran et fonctionne aussi bien avec SwiftUI qu'avec UIKit (via UIViewRepresentable). Dans cet article, nous allons détailler toutes les fonctionnalités de TipKit, de l'installation aux scénarios d'utilisation avancés.

Installation

TipKit fait partie de l'écosystème Apple et ne nécessite pas d'installation via des gestionnaires de paquets tiers. Pour utiliser la bibliothèque, il suffit de l'ajouter à votre projet Xcode via le Swift Package Manager (SPM) standard ou manuellement.

Via Xcode (méthode recommandée)

1. Ouvrez votre projet dans Xcode.
2. Sélectionnez File → Add Package Dependencies....
3. Dans la barre de recherche, saisissez : https://github.com/apple/sample-tipkit.git (le dépôt officiel Apple avec des exemples) ou utilisez le paquet intégré s'il est disponible dans votre version de Xcode.
4. Assurez-vous que la branche main ou la dernière version stable est sélectionnée.
5. Cliquez sur Add Package et choisissez votre cible.

Important : À partir de Xcode 15, TipKit est intégré au SDK, donc dans la plupart des cas, il suffit d'importer le module dans le code. Si vous utilisez une version plus ancienne de Xcode, ajoutez le paquet manuellement.

Via Package.swift (pour les projets SPM)

// swift-tools-version: 5.9
import PackageDescription

let package = Package(
    name: "VotreProjet",
    dependencies: [
        .package(url: "https://github.com/apple/sample-tipkit.git", from: "1.0.0")
    ],
    targets: [
        .target(
            name: "VotreCible",
            dependencies: ["TipKit"]
        )
    ]
)

Après avoir ajouté le paquet, importez la bibliothèque dans le fichier souhaité :

import TipKit

Démarrage rapide : exemple minimal fonctionnel

Créons une astuce simple qui apparaîtra au premier lancement de l'application et expliquera à l'utilisateur comment utiliser un bouton.

import SwiftUI
import TipKit

// 1. Définir la structure de l'astuce
struct AstuceBienvenue: Tip {
    var title: Text {
        Text("Bienvenue !")
    }
    
    var message: Text? {
        Text("Appuyez sur ce bouton pour commencer à utiliser l'application.")
    }
    
    var image: Image? {
        Image(systemName: "hand.wave")
    }
}

// 2. Utiliser l'astuce dans la vue
struct ContentView: View {
    // 3. Créer une instance de l'astuce
    private let astuceBienvenue = AstuceBienvenue()
    
    var body: some View {
        VStack {
            Button("Commencer") {
                // Action du bouton
                print("Bouton pressé !")
            }
            .popoverTip(astuceBienvenue) // 4. Lier l'astuce au bouton
            .padding()
        }
        .padding()
        .task {
            // 5. Configurer TipKit au démarrage
            try? await Tips.confi