Quickstart

Installe les modules Appwin dont ton app a besoin, en quelques minutes.

Le SDK repose sur Appwin Core, le module principal : il gère la connexion, la session et l'identité de l'appareil. Les autres modules (Community, Support, Notifications, Analytics) ajoutent leurs fonctionnalités. Tous partagent le même App ID, donc tu ne configures Core qu'une fois.

1. 1

   Sélectionne les modules à installer

   Les extraits de code des étapes suivantes s'adaptent à ta sélection.

   Analytics

   Support

   Notifications

   Community

2. 2

   Installe et configure le SDK

   Choisis ta plateforme ci-dessous : le code s'adapte tout seul à ta sélection.

   iOSFlutterAndroidReact NativeWeb

   Dans Xcode, ouvre File → Add Package Dependencies, puis ajoute le dépôt https://github.com/appwin-dev/appwin-ios. Le code généré indique les produits Swift à lier à ta cible.

   Dépendances

   swift

   .package(url: "https://github.com/appwin-dev/appwin-ios", from: "0.9.1")
   
   .target(name: "MyApp", dependencies: [
       .product(name: "AppwinCore", package: "Appwin"),
       .product(name: "AppwinCommunity", package: "Appwin"),
       .product(name: "AppwinSupport", package: "Appwin"),
   ])
   

   Appwin Core est une dépendance obligatoire, ajoutée d'office avec tes modules. Il gère l'identité, la session et le réseau.

   Initialisation

   swift

   import AppwinCore
   import AppwinCommunity
   import AppwinSupport
   import SwiftUI
   
   @main
   struct MyApp: App {
       init() {
           AppwinCore.configure(projectAppId: "your-app-id")
       }
   
       var body: some Scene {
           WindowGroup {
               ContentView()
                   .task {
                       let community = await AppwinCommunity.initialize()
                       let support = await AppwinSupport.initialize()
                   }
           }
       }
   }
   

   • •Chaque initialize() répond au lieu de lever une erreur. Conditionne ton propre point d'entrée à ce résultat : le SDK ne possède pas ta navigation, il ne peut pas cacher ton onglet à ta place.
   • •La session s'ouvre toute seule. Une fois ton utilisateur connecté, appelle AppwinCore.identify(externalId) une fois : l'id est gardé d'un lancement à l'autre. AppwinCore.updateUser(attributes) quand un attribut change, AppwinCore.logout() à la déconnexion. Les produits n'ont pas de login à eux.
3. 3

   Vérifie la connexion du SDK

   Une fois configure exécuté, affiche l'identifiant de l'appareil. S'il n'est pas nul, Appwin Core est bien configuré pour ton projet ; la session s'ouvre toute seule au premier appel qui en a besoin. Les appels à initialize présents dans le code généré indiquent ensuite si chaque module est disponible.

   iOSFlutterAndroidReact NativeWeb

   swift

   print(AppwinCore.deviceId ?? "configure n'a pas été appelé")
   

Ajouter les fonctionnalités à ton app

Le SDK est maintenant installé, mais Community et Support doivent encore être reliés à ta navigation, tandis que Notifications et Analytics demandent une configuration propre à leur usage. Les pages suivantes reprennent chaque module à partir de ce point et expliquent aussi ce qui se pilote depuis le dashboard.