Livro Delivery SDK Integration

1 Présentation

Cette documentation décrit les différentes étapes suivies pour intégrer le Livro Delivery SDK dans l'application Livro Boutique. L'objectif est de permettre à l'application Boutique de communiquer avec la plateforme Livro afin de créer et suivre des demandes de livraison en toute simplicité.

2 Prérequis

Avant de commencer l'intégration, vérifiez que vous disposez des éléments suivants :

3 Installation du SDK

Installez le package dans votre projet Flutter en exécutant la commande suivante dans votre terminal :

flutter pub add livro_delivery_sdk

Une fois l'installation terminée, importez le SDK dans vos fichiers Dart :

import 'package:livro_delivery_sdk/livro_delivery_sdk.dart';

4 Gestion des dépendances

Lors de l'intégration, un conflit peut survenir si une version antérieure de geolocator est déjà présente. Le SDK requiert :

Mettez à jour cette dépendance dans votre fichier pubspec.yaml, puis réinstallez les packages :

flutter pub get

5 Configuration des clés d'authentification

Récupérez vos identifiants sur la plateforme officielle :

1. Connectez-vous sur : https://livro-plateforme.dihas.tech/
2. Après authentification, rendez-vous dans l'onglet Développeurs.
3. Copiez votre Public Key et votre Secret Key.

6 Initialisation du SDK

Initialisez le SDK dans votre fichier main.dart avant le lancement de l'application :

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await SDKBubbleService.initialize();

  LivroSDK.initialize(
    baseUrl: "YOUR_API_BASE_URL",
    token: "YOUR_API_TOKEN",
    externalApp: true,
    externalClientId: "YOUR_CLIENT_ID",
    externalClientName: "YOUR_CLIENT_NAME",
    publicKey: "YOUR_PUBLIC_KEY",
    secretKey: "YOUR_SECRET_KEY",
    onExit: () {
      LivroSDK.navigatorKey.currentState?.popUntil(
        (route) => route.isFirst,
      );
    },
  );

  runApp(const MyApp());
}

7 Configuration du MaterialApp

Intégrez les éléments du SDK directement dans votre MaterialApp. Le navigatorKey permet au SDK de gérer sa navigation interne, tandis que SDKFloatingBubble affiche automatiquement la bulle flottante lorsqu'une livraison est en cours.

MaterialApp(
  navigatorKey: LivroSDK.navigatorKey,

  builder: (context, child) {
    return SDKFloatingBubble(
      child: child!,
    );
  },

  home: const HomePage(),
)

8 Intégration dans Livro Boutique

Une fois le SDK initialisé, vous pouvez ouvrir l'interface Livro depuis n'importe quel bouton de votre application. L'exemple ci-dessous utilise un FloatingActionButton, mais vous pouvez également utiliser un ElevatedButton, un TextButton, un GestureDetector ou tout autre widget déclenchant une action.

Exemple : FloatingActionButton

floatingActionButton: FloatingActionButton(
  onPressed: () {
    final draft = CourseDraft();

    draft.setSupplier(
      LatLng(6.4158538, 2.3429723),
      'Rue Vincent Guézodjè',
      'FOOD House',
      '+229 12345678',
    );

    LivroSDK.openCoursesHome(
      context,
      draft: draft,
    );
  },
  child: const Icon(Icons.add),
)

9 Fonctionnalités disponibles

Une fois l'intégration finalisée, vous profitez instantanément de :