スタートガイド

インストール

AIアシストによるセットアップでプラグインをインストールできます。以下のコマンドを使用して、お使いのAIツールに Capgo のスキルを追加してください：

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

次に、以下のプロンプトを使用します：

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

手動セットアップを希望する場合は、以下のコマンドを実行してプラグインをインストールし、下記のプラットフォーム別の手順に従ってください：

bun add @capgo/capacitor-supabase
bunx cap sync

クイックスタート

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

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

例: signInWithPassword

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

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

例: signUp

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

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

よくある落とし穴

• リスナー: 画面がアンマウントされたらハンドルを削除します。
• 一度だけ初期化: アプリの起動時にセットアップを実行します。
• 信頼できる情報源: 信頼 src/definitions.ts GitHub リポジトリ内。

Android の最小 SDK

Android での実装には Android 8.0 以降が必要です。以下を設定してください。 minSdkVersion = 26 における android/variables.gradle.

クライアントの初期化

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

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

サインインと 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));

認証状態の変化を検知する

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

await listener.remove();

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);

Native Databaseヘルパー

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);

推奨される使用方法

• 認証とセッション管理には、このプラグインを使用してください。
• Realtime、Storage、Edge Functions、高度なクエリ機能を @supabase/supabase-js.
• Supabaseのその他の機能が必要なときは、ネイティブのJWTをJavaScriptクライアントに渡してください。

Getting Startedの続きを進める

使用している場合 スタートガイド ネイティブプラグインの作業を計画するには、次と連携してください： Capgo プラグインディレクトリ Capgo プラグインディレクトリのプロダクトワークフローについては、 Capgo による Capacitor プラグイン Capgo による Capacitor プラグインの実装詳細については、 プラグインの追加または更新 プラグインの追加または更新に関する実装詳細については、 Ionic Enterprise プラグインの代替案 Ionic Enterprise Plugin Alternatives のプロダクトワークフロー、および Capgo Native Build Capgo Native Builds のプロダクトワークフローについては、