トラブルシューティング¶
TurboModuleRegistry.getEnforcing(...): 'DeaSdk' could not be found¶
原因: SDK のネイティブ側がアプリのバイナリに含まれていません。パッケージのインストール後にアプリを リビルドしていない、New Architecture が無効になっている、またはアプリが Expo Go で実行されているかのいずれかです。
解決策: New Architecture が有効であることを確認し(React Native 0.76 からデフォルトです)、JavaScript の リロードではなくネイティブアプリをリビルドします。
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 になる¶
原因: 次のいずれかです。
- ユーザーが同意していないため、何も記録されていない。
- セッションのアクションがモデルの要求数(組み込みモデルでは 8)に達しておらず、結果が
insufficientに なっている。証拠を参照してください。 - 取得が一時停止され、再開されていない。
- SDK がスコアリングできない(
started.readyがfalse)ため、結果がinsufficientになっている。 - 自動化検出が SDK を停止した。
stopped()がオブジェクトで resolve され、結果がinsufficientになっている。stopped()がオブジェクトで resolve されるを参照してください。 - 結果が
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() が空のオブジェクトを返す¶
原因: 次のいずれかです。
- アプリが本番環境の
appIdで実行されている。ネイティブ SDK はそこではカウンターを拒否するため、 集計は常に空です。 initにcountTargets: trueが渡されていない。
解決策: 本番環境の appId では手段はありません。ビューの名前付けについては
ビューに名前を付けるを参照してください。
attest() が unsupported を返す¶
原因: 次のいずれかです。
initにappKeyが渡されていない。detailはno appKeyで始まります。- 署名キーを生成できなかった。端末に安全なキー保管領域がありません。
解決策: このプラットフォームのアプリのために 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 日後にアプリがフォアグラウンドに戻ったときにも行われます。