Clerk Android (ネイティブ)
このスキルは、現在の clerk-android SDK とドキュメントのパターンに従って、ネイティブ Android プロジェクトに Clerk を実装します。
アクティベーションルール
以下のいずれかの条件が true の場合に、このスキルをアクティベートします。
- ユーザーが明示的に Android、Kotlin、Jetpack Compose、または Android 上のネイティブモバイル Clerk 実装を要求した場合。
- プロジェクトがネイティブ Android であるように見える場合 (例:
build.gradle(.kts)に Android プラグイン、AndroidManifest.xml、app/src/main/java、Compose UI ファイルがあるなど)。
以下のいずれかの条件が true の場合は、このスキルをアクティベートしないでください。
- プロジェクトが Expo である場合。
- プロジェクトが React Native である場合。
Expo/React Native の兆候がある場合は、代わりに一般的なセットアップスキルにルーティングします。
必要なもの
| タスク | 参照先 |
|---|---|
| プリビルド AuthView / UserButton (最速) | references/prebuilt.md |
| カスタム API 駆動の認証フロー (完全制御) | references/custom.md |
クイックスタート
| ステップ | アクション |
|---|---|
| 1 | プロジェクトタイプがネイティブ Android であり、Expo/React Native でないことを確認 |
| 2 | フローの種類 (prebuilt または custom) を決定し、対応する参照ファイルをロード |
| 3 | 実際の Clerk 発行可能キーが存在することを確認 (または開発者に依頼) |
| 4 | 選択したフローに適切な Clerk アーティファクトがインストールされていることを確認 |
| 5 | 公式 Android クイックスタートを読み、必要なセットアップ (Native API、最小 SDK/Java、マニフェスト、初期化) を確認 |
| 6 | 選択したフローに関連する clerk-android のソース/サンプルパターンを検査 |
| 7 | 選択した参照チェックリストのみに従ってフローを実装 |
決定木
ユーザーが Android/Kotlin での Clerk を要求
|
+-- Expo/React Native プロジェクトが検出されたか?
| |
| +-- YES -> このスキルは使用しない
| |
| +-- NO -> 続行
|
+-- 既存の認証 UI が検出されたか?
| |
| +-- プリビルドビューが検出された -> references/prebuilt.md をロード
| |
| +-- カスタムフローが検出された -> references/custom.md をロード
| |
| +-- 新規実装 -> 開発者に prebuilt/custom を尋ね、一致する参照をロード
|
+-- 発行可能キーと SDK 初期化パスを確認
|
+-- 正しい Android アーティファクトがインストールされていることを確認
|
+-- プロジェクトでクイックスタートの前提条件を確認
|
+-- 選択したフロー参照を使用して実装
フロー参照
フローの種類が決まったら、正確に 1 つをロードします。
- プリビルドフロー: references/prebuilt.md
- カスタムフロー: references/custom.md
開発者が明示的にハイブリッドアプローチを要求しない限り、1 つの実装で 2 つの参照を混在させないでください。
インタラクション契約
実装の編集を行う前に、エージェントは以下の両方を保持している必要があります。
- フローの選択:
prebuiltまたはcustom - 実際の Clerk 発行可能キー
ユーザーのリクエスト/コンテキストにいずれかの値が欠けている場合:
- ユーザーに不足している値を尋ねる
- 回答を待つために一時停止する
- まだファイルを編集したり、依存関係をインストールしたりしない
ユーザーがこの会話で既に明示的に値を提供している場合にのみ、尋ねることをスキップします。
ソース駆動テンプレート
このスキルに実装例をハードコードしないでください。実装前に、インストールされた SDK バージョンの現在の clerk-android ソース/ドキュメントを検査してください。
| ユースケース | 信頼できる情報源 |
|---|---|
SDK アーティファクトと依存関係の分割 (clerk-android-api vs clerk-android-ui) | clerk-android README および Android インストールドキュメント |
| SDK の初期化と発行可能キーの配線 | Android クイックスタートおよび source/api/.../Clerk.kt |
| プリビルドの認証とプロファイルの動作 | source/ui/.../AuthView.kt、source/ui/.../UserButton.kt、およびプリビルドサンプル |
| カスタム認証のシーケンスとファクター処理 | source/ui/auth/*、source/api/auth/*、およびカスタムフローサンプル |
| インスタンス設定による機能/機能ゲーティング | Clerk の public フィールド (例: enabledFirstFactorAttributes、socialProviders、isGoogleOneTapEnabled、mfaIsEnabled) および環境モデルソース |
| 必要な Android セットアップチェックリスト | 公式 Android クイックスタート (/docs/android/getting-started/quickstart) |
実行ゲート (スキップ禁止)
- 前提条件を満たす前の実装編集禁止
- フローの種類が確認され、有効な発行可能キーが利用可能になるまで、プロジェクトファイルを編集しないでください。
- フローまたはキーが欠けている場合は質問をトリガーする
- フローの選択が欠けている場合は、明示的に「プリビルドビューとカスタムフロー」を尋ねます。
- 発行可能キーが欠けている / プレースホルダー / 無効な場合は、明示的に実際のキーを要求します。
- 両方の回答が提供されるまで続行しないでください。
- 発行可能キーの配線モードは必須
- デフォルトでは、開発者が提供したキーを
Clerk.initialize(...)に直接配線します。 - 明示的に要求されない限り、シークレット管理の間接化を導入しないでください。
- アーティファクトインストールポリシーは必須
- プリビルドフロー:
clerk-android-uiを使用します (API を含む)。 - カスタムフロー: プリビルドコンポーネントが明示的に要求されない限り、
clerk-android-apiを使用します。 - Clerk アーティファクトが欠けている場合は、利用可能な最新の安定版リリースを追加します。
- Android クイックスタート準拠は必須
- Clerk アプリで Native API が有効になっていることを確認します。
- プロジェクトに Android クイックスタートの要件 (最小 SDK と Java ターゲット、マニフェストのインターネット権限、アプリレベルの Clerk 初期化) が実装されていることを確認します。
- アプリが認証準備状態と見なす前に、SDK の初期化 (
Clerk.isInitialized) を待つことを確認します。
- 機能駆動の動作は必須
- Clerk のランタイム機能/設定状態 (例: 有効なファクター、ソーシャルプロバイダー、MFA フラグ) を使用してフローの動作をゲートします。
- ダッシュボードの設定と競合する可能性のあるファクターの仮定をハードコードしないでください。
- 参照ファイルの規律は必須
- フローが選択されたら、実装と検証のためにそのフロー参照ファイルのみに従います。
- カスタムフローの構造パリティは必須
customフローの場合、マルチステップの認証進行とファクター固有の処理を維持します (デフォルトでは単一の全フィールドフォームにしない)。- UI、状態オーケストレーション、および Clerk API 統合を別々のモジュールに保持します。
- 選択された場合のプリビルド優先は必須
prebuiltフローの場合、明示的に要求されない限り、カスタム API 呼び出しで認証フォームを再構築しないでください。- デフォルトの構成要素として
AuthView/UserButtonを使用します。
ワークフロー
- ネイティブ Android と Expo/React Native を検出します。
- フローの種類が明示的に提供されていない場合は、ユーザーに
prebuiltまたはcustomを尋ねます。 - 発行可能キーが明示的に提供されていない場合は、ユーザーにそれを尋ねます。
- ファイルを変更する前に、両方の回答を待ちます。
- 一致するフロー参照ファイルをロードします。
Clerk.initialize(...)のパスと発行可能キーの配線が有効であることを確認します。- 依存関係/アーティファクトが選択したフローと一致することを確認します。
- Android クイックスタートの要件を確認し、プロジェクトに不足しているセットアップを適用します。
- 選択した参照チェックリストを使用して実装します。
- 選択した参照チェックリストと共有ゲートを使用して検証します。
よくある落とし穴
| レベル | 問題 | 防止策 |
|---|---|---|
| CRITICAL | 実装前に不足しているフローの選択を尋ねない | prebuilt vs custom を尋ね、編集前に待つ |
| CRITICAL | 実装前に不足している発行可能キーを尋ねない | キーを尋ね、編集前に待つ |
| CRITICAL | フローの種類が確認される前に実装を開始する | 最初にフローを確認し、一致する参照をロードする |
| CRITICAL | Android クイックスタートの前提条件をスキップする | 公式 Android クイックスタートから必要なセットアップを確認し適用する |
| CRITICAL | アプリレベルの Clerk.initialize(...) 呼び出しがない | Application の起動パスから Clerk を初期化する |
| HIGH | 選択したフローに間違ったアーティファクト | プリビルド: clerk-android-ui; カスタム: clerk-android-api |
| HIGH | SDK 初期化が完了する前に認証 UI をレンダリングする | Clerk.isInitialized 状態で UI をゲートする |
| HIGH | 認証ファクター/ソーシャルプロバイダーをハードコードする | Clerk ランタイム機能フィールドから動作を駆動する |
| HIGH | このスキルを Expo/React Native に使用する | 実装前に検出してルーティングする |
関連情報
- 最上位の Clerk ルーティング用の
clerkスキル - クロスフレームワークのクイックスタートセットアップ用の
clerk-setupスキル https://github.com/clerk/clerk-androidhttps://clerk.com/docs/android/getting-started/quickstart