Prise en main

Installer

Vous pouvez utiliser notre configuration assistée par IA pour installer le plugin. Ajoutez les skills Capgo à votre outil d'IA avec la commande suivante :

bunx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Utilisez ensuite le prompt suivant :

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-supabase` plugin in my project.

Si vous préférez une installation manuelle, installez le plugin en exécutant les commandes suivantes et suivez les instructions spécifiques à chaque plateforme ci-dessous :

bun add @capgo/capacitor-supabase
bunx cap sync

Démarrage rapide

import { CapacitorSupabase } from '@capgo/capacitor-supabase';

await CapacitorSupabase.initialize({
  supabaseUrl: 'https://xyzcompany.supabase.co',
  supabaseKey: 'your-anon-key'
});

Exemple : signInWithPassword

import { CapacitorSupabase } from '@capgo/capacitor-supabase';

const { session, user } = await CapacitorSupabase.signInWithPassword({
  email: 'user@example.com',
  password: 'password123'
});
console.log('JWT:', session?.accessToken);

Exemple : signUp

import { CapacitorSupabase } from '@capgo/capacitor-supabase';

const { session, user } = await CapacitorSupabase.signUp({
  email: 'newuser@example.com',
  password: 'password123',
  data: { name: 'John Doe' }
});

Erreurs courantes

• Écouteurs: supprimez les handles lors du démontage des écrans.
• Initialiser une seule fois: exécutez le setup lors du bootstrap de l'app.
• Source de vérité : fiez-vous src/definitions.ts au repo GitHub.

Android minimum SDK

L'implémentation Android nécessite Android 8.0 ou version ultérieure. Définissez minSdkVersion = 26 dans android/variables.gradle.

Initialiser le client

import { CapacitorSupabase } from '@capgo/capacitor-supabase';

await CapacitorSupabase.initialize({
  supabaseUrl: 'https://your-project.supabase.co',
  supabaseKey: 'your-anon-key',
});

Se connecter et accéder au JWT

const { session, user } = await CapacitorSupabase.signInWithPassword({
  email: 'user@example.com',
  password: 'password123',
});

console.log('User', user?.id);
console.log('JWT available', Boolean(session?.accessToken));

Écouter les changements d'auth

const listener = await CapacitorSupabase.addListener('authStateChange', ({ event, session }) => {
  console.log('Auth event', event);
  console.log('Current JWT available', Boolean(session?.accessToken));
});

await listener.remove();

Associer Native Auth à supabase-js

import { createClient } from '@supabase/supabase-js';

const { session } = await CapacitorSupabase.getSession();

const supabase = createClient('https://your-project.supabase.co', 'your-anon-key', {
  global: {
    headers: {
      Authorization: `Bearer ${session?.accessToken}`,
    },
  },
});

const { data } = await supabase.from('table').select('*');
console.log(data);

Helpers de base de données native

const { data, error } = await CapacitorSupabase.select({
  table: 'users',
  columns: 'id, name, email',
  filter: { active: true },
  limit: 10,
  orderBy: 'created_at',
  ascending: false,
});

console.log(data, error);

Usage recommandé

• Utilisez ce plugin pour l'authentification et la gestion de session.
• Gardez Realtime, Storage, Edge Functions et les requêtes avancées dans @supabase/supabase-js.
• Passez le JWT natif au client JavaScript dès que vous avez besoin du reste de la surface d’API Supabase.

Continuer depuis Getting Started

Si vous utilisez Prise en main pour planifier le travail sur les plugins natifs, connectez-l’à Capgo Répertoire des plugins pour le workflow produit dans Capgo Plugin Directory, Plugins Capacitor par Capgo pour les détails d'implémentation dans Plugins Capacitor par Capgo, Ajouter ou mettre à jour des plugins pour les détails d'implémentation dans Adding or Updating Plugins, Alternatives aux plugins Ionic Enterprise pour le workflow produit dans les alternatives aux plugins Ionic Enterprise, et Capgo Native Build pour le workflow produit dans Capgo Native Builds.