コンテンツにスキップ

トラブルシューティング

TurboModuleRegistry.getEnforcing(...): 'DeaSdk' could not be found

原因: SDK のネイティブ側がアプリのバイナリに含まれていません。パッケージのインストール後にアプリを リビルドしていない、New Architecture が無効になっている、またはアプリが Expo Go で実行されているかのいずれかです。

解決策: New Architecture が有効であることを確認し(React Native 0.76 からデフォルトです)、JavaScript の リロードではなくネイティブアプリをリビルドします。

cd ios && pod install && cd ..
npx react-native run-ios
npx react-native run-android

Expo Go は SDK を読み込めません。Expo を参照してください。

pod install が失敗する: Unable to find a specification for DeaSDK

原因: パッケージの iOS 側はネイティブ iOS SDK(DeaSDK、DeaBase、DeaAutomationDetection)に依存 していますが、これらはどの pod レジストリにもありません。Podfile がこれらの pod をパスで指定していないか、 ダウンロードしたパッケージの横に podspec がありません。

解決策: iOS のセットアップに従ってください。アーカイブをダウンロードし、3 つの podspec を書き、Podfile で 3 つの pod を @dea/react-native と同じバージョンで指定します。

Android のビルドが失敗する: Could not find ai.dea:dea-sdk

原因: パッケージの Android 側は、自身と同じバージョンの ai.dea:dea-sdk に依存しており、この アーティファクトは Maven Central にありません。アプリのリポジトリに、そのリリースに対応する DEA の Maven リポジトリが含まれていません。

解決策: Android のセットアップのとおりにリポジトリを追加し、その URL に @dea/react-native のバージョンを指定してください。

すべての呼び出しが DeaSdk.init has not been called で reject される

原因: init が resolve される前、または dispose() の後に呼び出しが実行されました。

解決策: 他の呼び出しの前に init を await します。たとえば、その promise を保持しておきます。

import * as Dea from '@dea/react-native';

export const deaStarted = Dea.init({appId: 'YOUR_APP_ID'});

// elsewhere
await deaStarted;
const {result} = await Dea.getClassification();

init が … is not supported で reject される

原因: アプリが React Native Web など、Android と iOS 以外の React Native ターゲットで実行されています。

解決策: SDK は Android と iOS でのみ呼び出します。

import {Platform} from 'react-native';

if (Platform.OS === 'android' || Platform.OS === 'ios') {
  await Dea.init({appId: 'YOUR_APP_ID'});
}

Web ビルドには Web SDK を使用してください。

started.ready が false になる

原因: このビルドで SDK のスコアリングエンジンが起動できませんでした。取得は続きますがスコアはなく、分類は insufficient のままです。started.coreFault が理由を示します。

解決策: coreFault をログに記録し、DEA サポートに問い合わせる際に添えてください。@dea/react-native の バージョンと、それが解決するネイティブ SDK のバージョンが同じリリースであることを確認してください。

started.ready が false の間に停止するもの(Android と iOS で同じ):

停止するもの アプリから見えるもの
スコア getClassification() は insufficient で resolve される
モデルの復元と更新 何も復元されず、更新の確認も行われない。SDK に組み込まれたモデルがそのまま使われる
自動化検出 開始しない
証明: record、sendProof、getProof 何も署名されない。ネイティブのログに dea.reason: no_core の proof.not_signed が出る
sdk.ready 代わりにネイティブのログに sdk.core_failed が出る。init は { ready: false, coreFault } で resolve される

取得、インテグレーション、attest()、スコアを含まない signRequest は動作を続けます。

stopped() がオブジェクトで resolve される

原因: automationDetection: true のとき、ネイティブ SDK は自動化がアプリを操作している確実な兆候を 見つけました。SDK はすべての処理を直ちに停止しました。これはすべてのアカウントとビルドに当てはまり、 テストビルドも含みます。停止は reset() または新しい起動まで続きます。

解決策: たとえば次のセッションで reset() を呼び出すか、SDK を再び起動してください。アプリを起動し直すか、 dispose() の後に init を呼び出します。resume() と setConsent(true) では停止は解除されません。 自動化が続くと、SDK は再び停止します。自社の自動テストでは automationDetection をオフのままにしてください。 ステージングビルドまたはテストビルドでは、ネイティブのログに、発生したシグナルとともに automation.detected が出て、続けて dea.reason: automated とともに sdk.stopped が出ます。

automationDetection がオンのとき、root 化された Android 端末や jailbreak された iPhone でも SDK は停止します。 ステージングビルドは見つけた痕跡とともに sdk.device_compromised をログに書き、続けて sdk.stopped を 書きます。reset() で停止は解除されますが、同じ端末では SDK は再び停止します。テストビルドはログに書くだけで、 動作を続けます。

Android の外付けタッチスクリーンでは SDK は停止しません。ステージングビルドまたはテストビルドはそれを automation.soft_signal としてログに書き、SDK は動作を続けます。

停止するもの アプリから見えるもの
取得 何も記録されない。resume() と setConsent(true) では再開しない
スコア getClassification() は、actions が 0 ですべての数値が null の insufficient で resolve される
モデルの更新 更新の確認は行われない
アテステーション attest() と renewAttestation() は要求なしで verdict: 'failed' で resolve される。自動更新は停止する
証明: record、sendProof、getProof 要求なしで、何も署名されない。ネイティブのログに dea.reason: automated の proof.not_signed が出る
インテグレーション それ以上は何も送られない。停止前に送られたものは送信済みのまま

reset() で停止は解除され、dispose() はいつもどおり動作します。

getClassification() が常に insufficient または undetermined になる

原因: 次のいずれかです。

  1. ユーザーが同意していないため、何も記録されていない。
  2. セッションのアクションがモデルの要求数(組み込みモデルでは 8)に達しておらず、結果が insufficient に なっている。証拠を参照してください。
  3. 取得が一時停止され、再開されていない。
  4. SDK がスコアリングできない(started.ready が false)ため、結果が insufficient になっている。
  5. 自動化検出が SDK を停止した。stopped() がオブジェクトで resolve され、結果が insufficient になっている。 stopped() がオブジェクトで resolve されるを参照してください。
  6. 結果が undetermined で、スコアがモデルの bot しきい値以上かつ human しきい値未満になっている。

解決策: 順に確認します。

console.log('consent:', await Dea.getConsent()); // must be 'granted'
console.log('stopped:', await Dea.stopped());    // must be null
console.log(await Dea.getClassification());
// result leaves 'insufficient' at 8 actions with the built-in model; compare value with both thresholds

すべての pause() に対応する resume() があることを確認してください。

getClassification() が threshold_missing で reject される

原因: 読み込まれたスコアリングモデルに bot しきい値がなく、SDK が分類の基準を持てません。エラーの userInfo.modelVersion がそのモデルを示します。

解決策: DEA サポートに問い合わせる際に、そのモデルバージョンを添えてください。SDK は独自のしきい値を 適用しないため、アプリ側でこれを回避する設定はありません。

try {
  const classification = await Dea.getClassification();
} catch (error: any) {
  if (error.code === Dea.THRESHOLD_MISSING) {
    console.warn('model without thresholds:', error.userInfo?.modelVersion);
  }
}

debug: true でも画面に触れた後に何もログに出ない

原因: Android SDK のビルドが test チャネルのビルドではありません。debug はそこでのみ出力し、出荷する SDK は何も出力しません。それ以外の場合は、何も記録されていません。通常はユーザーがまだ同意していないためで、 そうでなければ取得が一時停止しています。iOS では debug は効果がありません。

解決策: setConsent(true) で同意を記録し(ユーザー同意を参照)、 対応する resume() のない pause() がないか確認します。Android では adb logcat | grep dea で出力を読み取ります。

getTargetTally() が空のオブジェクトを返す

原因: 次のいずれかです。

  1. アプリが本番環境の appId で実行されている。ネイティブ SDK はそこではカウンターを拒否するため、 集計は常に空です。
  2. init に countTargets: true が渡されていない。

解決策: 本番環境の appId では手段はありません。ビューの名前付けについては ビューに名前を付けるを参照してください。

attest() が unsupported を返す

原因: 次のいずれかです。

  1. init に appKey が渡されていない。detail は no appKey で始まります。
  2. 署名キーを生成できなかった。端末に安全なキー保管領域がありません。

解決策: このプラットフォームのアプリのために DEA が発行した appKey を渡してください。 アカウントとキーを参照してください。それ以外の場合は実機でテストして ください。

ログに sdk.app_id_missing が出る

原因: init に appId が渡されていない、appId が空、または unknown-app です。このエントリは、 ステージングまたはテストのネイティブビルドのネイティブのログに出ます。SDK は DEA が登録していない本番の appId で動作しています。

解決策: DEA がこのアプリ向けに発行した appId を渡してください。 アカウントとキーを参照してください。

モデルが更新されない

原因: 更新がオフになっています。(await getModel()).updateFault が理由を示します。null は更新が 動作していることを意味します。

updateFault 原因 解決策
no_core スコアリングエンジンが読み込まれなかった started.ready が false になるを参照
disabled init に modelUpdates: false が渡された それを取り除く
no_storage iOS: 渡した modelDirectory、または Application Support を開けなかった アプリが書き込めるフォルダを渡す、または modelDirectory を設定しない
no_context Android: modelDirectory も Context もない modelDirectory を設定しない、または絶対パスを渡す

解決策: 読み取った値の行を適用してください。null の場合、更新は動作しています。確認は起動のたびに 行われ、最後の確認から 1 日後にアプリがフォアグラウンドに戻ったときにも行われます。