frida-agent-builder

Frida エージェントビルダー

再利用可能な Frida エージェントや複数スクリプトのプロジェクトでは、このスキルを使用してください。

プロジェクトの構成

スクリプトが単一のフックを超えて大きくなる場合は、小規模な TypeScript エージェントを使用してください。

agent/
├── package.json
├── tsconfig.json
├── src/
│   ├── index.ts
│   ├── log.ts
│   └── hooks/
└── dist/

Frida 17 と、バンドルされたエージェント内の Java API を使用する場合は、ビルド時や実行時の方式に応じて frida-java-bridge を含めてください。

ビルドのルール

• フックの種類ごとにファイルを分けてください。
• フックの種類ごとに init() 関数をエクスポートし、src/index.ts から呼び出してください。
• 複雑な値にはタグと JSON を使った構造化ログを使用してください。
• ホスト側から操作するアクションやテスト用プローブに限り、rpc.exports を追加してください。
• タスクで明示的に必要とされていない限り、広範囲に適用されるグローバルフックは避けてください。
• リポジトリの慣例で管理対象に含める場合を除き、生成された成果物はソース管理の対象外にしてください。

スキャフォールドスクリプト

scripts/scaffold-frida-agent.py を使って、最小限の TypeScript Frida エージェントを作成してください。

python3 /path/to/frida-agent-builder/scripts/scaffold-frida-agent.py ./agent --java

続いて、インストールしてビルドしてください。

npm install
npm run build

リファレンス

プロジェクトの規約、RPC パターン、ホストコマンドの例、パッケージ化に関する注意事項については、references/agent-patterns.md を参照してください。