> ## Documentation Index
> Fetch the complete documentation index at: https://sandbox.it-centrex.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Installez le CLI OnePub, authentifiez-vous et ajoutez le SDK Flutter GimPay à votre projet.

## Installer le CLI OnePub

**1. Installez le CLI (une fois par machine)**

```bash theme={null}
dart pub global activate onepub
```

> [!NOTE]
>
> Vérifiez que le répertoire des exécutables pub (`%LOCALAPPDATA%\Pub\Cache\bin` sous Windows, `~/.pub-cache/bin` sous macOS/Linux) est dans votre `PATH`.

**2. Authentifiez-vous**

```bash theme={null}
onepub login
```

Une page de connexion s'ouvre dans le navigateur, utilisez le compte avec lequel vous avez été invité. La commande écoute sur `http://127.0.0.1:42666/` pour récupérer le token : si un pare-feu bloque le port TCP 42666, débloquez-le temporairement.

**3. Ajoutez la dépendance**

Dans le dossier de votre projet Flutter :

```bash theme={null}
onepub pub add gimpay_sdk
flutter pub get
```

La commande ajoute au `pubspec.yaml` une dépendance `hosted:` pointant vers le dépôt privé et configure le token d'accès.

### Équivalent manuel

Si vous préférez éditer le `pubspec.yaml` directement (l'URL `hosted` exacte figure sur votre profil OnePub) :

```yaml pubspec.yaml theme={null}
dependencies:
  gimpay_sdk:
    version: ^0.13.0
    hosted: https://onepub.dev/api/<id-organisation>
```

> [!NOTE]
>
> Vérifiez la contrainte de version exacte sur votre profil OnePub avant de figer un numéro

## Intégration continue (CI)

Votre pipeline ne peut pas ouvrir un navigateur : il utilise un **token membre exporté** plutôt que `onepub login`.

**1. Exportez votre token**

Sur votre poste déjà authentifié :

```bash theme={null}
onepub export
```

Copiez la valeur affichée.

**2. Stockez-le dans les secrets de votre CI**

Sous le nom `ONEPUB_TOKEN` (GitHub Secrets, GitLab CI variables...).

> [!WARNING]
>
> Ne committez jamais ce token : il donne accès au dépôt privé avec vos droits.

**3. Utilisez-le dans le pipeline**

Avant `flutter pub get` :

```bash theme={null}
dart pub global activate onepub
onepub import   # lit ONEPUB_TOKEN depuis l'environnement
flutter pub get
```

## Étapes suivantes

> **[Démarrage rapide](https://sandbox.it-centrex.com/sdks/quickstart.md)**
>
> Initialisez le SDK et effectuez votre premier appel.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.