前言

frida-trace是一个用于动态跟踪函数调用的工具。支持android和ios。安装教程请参考官网。工欲善其事必先利其器。本文将以某App为示范，演示frida-trace的各种方法在iOS中的应用。

一、目标

让看文章的你在使用frida-trace时更得心应手。

二、工具

mac系统
frida：动态调试工具
已越狱iOS设备：脱壳及frida调试

三、使用

1.命令格式

frida-trace [options] target

iOS常用的可选参数：

// 设备相关
-D	连接到指定的设备，多个设备时使用。示例:frida-trace -D 555315d66cac2d5849408f53da9eea514a90547e -F 
-U	连接到USB设备，只有一个设备时使用。示例fria-trace -U -F// 应用程序相关
-f	目标应用包名。spawn模式。示例:frida-trace -U -f com.apple.www
-F	当前正在运行的程序。attach模式示例。示例:frida-trace -U -F或frida-trae -UF
-n	正在运行的程序的名字。attach模式。示例:frida-trace -U -n QQ
-N	正在运行的程序的包名。attach模式。示例:frida-trace -U -N com.apple.www
-p	正在运行的程序的pid。attach模式。示例:frida-trace -U -p 2302// 方法相关，以下参数在一条跟踪命令中可重复使用
-I	包含模块。示例:frida-trace -UF -I "libcommonCrypto*"
-X	不包含模块。示例:frida-trace -UF -X "libcommonCrypto*"
-i 	包含c函数。示例:frida-trace -UF -i "CC_MD5"
-x 	不包名c函数。示例:frida-trace -UF -i "*MD5" -x "CC_MD5"
-a 	包含模块+偏移跟踪。示例:frida-trace -UF -a 模块名\!0x7B7D48
-m 	包含某个oc方法。示例:frida-trace -UF -m "+[NSURL URLWithString:]"
-M 	不包含某个oc方法。示例:frida-trace -UF -M "+[NSURL URLWithString:]"// 日志相关
-o	日志输出到文件。示例:frida-trace -UF -m "*[* URL*]" -o run.log

2.常用命令

frida-trace中的方法匹配命令支持模糊匹配，星号匹配0个或多个字符，问号匹配1个字符：

-m "-[NSURL *]"	// 匹配NSURL类的所有实例方法
-m "+[NSURL *]"	// 匹配NSURL类的所有类方法
-m "*[NSURL *]" // 匹配NSURL类的所有方法
-m "*[*URL *]"	// 匹配以URL结尾类的所有方法
-m "*[URL* *]" 	// 匹配以URL开头类的所有方法
-m "*[*URL* *]"	// 匹配包含URL的类的所有方法
-m "*[*URL* *login*]"	// 匹配包含URL的类的带login的所有方法
-m "*[????? *]"	// 匹配类名只有五个字符的类的所有方法

简而言之:

当你不确定你要跟踪的方法是类方法还是实例方法时，用星号代替

当你只知道部分类名时，不确定的地方用星号代替

当你只知道部分方法名时，不确定的地方用星号代替

当你不知道方法名时，直接用星号代替

当你不知道某个字母是大小写时，用问号代替

frida-trace命令会在当前目录生成./__handlers__/文件夹内生成对应函数的js代码。当你需要打印入参，返回值。或修改入参，返回值时，可编辑对应的js文件。

打印或修改OC方法的入参

$ frida-trace -UF -m "-[DetailViewController setObj:]"
Instrumenting...
-[DetailViewController setObj:]: Auto-generated handler at "/Users/witchan/__handlers__/DetailViewController/setObj_.js"
Started tracing 1 function. Press Ctrl+C to stop.

js源码如下：

{onEnter(log, args, state) {var self = new ObjC.Object(args[0]);  // 当前对象var method = args[1].readUtf8String();  // 当前方法名log(`[${self.$className} ${method}]`);var isData = false;// 字符串// var str = ObjC.classes.NSString.stringWithString_("hi wit!")  // 对应的oc语法：NSString *str = [NSString stringWithString:@"hi with!"];// args[2] = str  // 修改入参// array// var // 数组// var array = ObjC.classes.NSMutableArray.array();  // 对应的oc语法：NSMutableArray array = [NSMutablearray array];// array.addObject_("item1");  // 对应的oc语法：[array addObject:@"item1"];// array.addObject_("item2");  // 对应的oc语法：[array addObject:@"item2"];// args[2] = array; // 修改入参// 字典// var dictionary = ObjC.classes.NSMutableDictionary.dictionary(); // 对应的oc语法:NSMutableDictionary *dictionary = [NSMutableDictionary dictionary];// dictionary.setObject_forKey_("value1", "key1"); // 对应的oc语法：[dictionary setObject:@"value1" forKey:@"key1"]// dictionary.setObject_forKey_("value2", "key2"); // 对应的oc语法：[dictionary setObject:@"value2" forKey:@"key2"]// args[2] = dictionary; // 修改入参// 字节var data = ObjC.classes.NSMutableData.data(); // 对应的oc语法：NSMutableData *data = [NSMutableData data];var str = ObjC.classes.NSString.stringWithString_("hi wit!")  // 获取一个字符串。 对应的oc语法：NSString *str = [NSString stringWithString:@"hi with!"];var subData = str.dataUsingEncoding_(4);  // 将str转换为data,编码为utf-8。对应的oc语法：NSData *subData = [str dataUsingEncoding:NSUTF8StringEncoding];data.appendData_(subData);  // 将subData添加到data。对应的oc语法：[data appendData:subData];args[2] = data; // 修改入参isData = true;// 更多数据类型：https://developer.apple.com/documentation/foundationvar before = args[2];// 注意，日志输出请直接使用log函数。不要使用console.log()if (isData) {// 打印byte对象var after = new ObjC.Object(args[2]); // 打印NSDatavar outValue = after.bytes().readUtf8String(after.length()) // 将data转换为stringlog(`before:=${before}=`);log(`after:=${outValue}=`);} else {// 打印字符串、数组、字段var after = new ObjC.Object(args[2]); // 打印出来是个指针时，请用该方式转换后再打印log(`before:=${before}=`);log(`after:=${after}=`);}// 如果是自定义对象时，使用以上方法无法打印时，请使用以下方法：// var customObj = new ObjC.Object(args[0]); // 自定义对象// // 打印该对象所有属性// var ivarList = customObj.$ivars;// for (key in ivarList) {//   log(`key${key}=${ivarList[key]}=`);// }// // 打印该对象所有方法// var methodList = customObj.$methods;// for (var i=0; i<methodList.length; i++) {//   log(`method=${methodList[i]}=`);// }},onLeave(log, retval, state) {}
}

修改OC方法的返回值

$ frida-trace -UF -m "-[DetailViewController obj]"
Instrumenting...
-[DetailViewController obj]: Loaded handler at "/Users/witchan/__handlers__/DetailViewController/obj.js"
Started tracing 1 function. Press Ctrl+C to stop.

js源码如下：

{onEnter(log, args, state) {},onLeave(log, retval, state) {// 字符串var str = ObjC.classes.NSString.stringWithString_("hi wit!")  // 对应的oc语法：NSString *str = [NSString stringWithString:@"hi with!"];retval.replace(str)  // 修改返回值var after = new ObjC.Object(retval); // 打印出来是个指针时，请用该方式转换后再打印log(`before:=${retval}=`);log(`after:=${after}=`);// 其他数据类型，请往上看}
}

打印C函数的入参和返回值

$ frida-trace -UF -i "CC_MD5"
Instrumenting...
CC_MD5: Loaded handler at "/Users/witchan/__handlers__/libcommonCrypto.dylib/CC_MD5.js"
Started tracing 1 function. Press Ctrl+C to stop.

js源码如下:

{onEnter(log, args, state) {// 注意。c方法里的参数直接从下标0开始this.args0 = args[0];	this.args2 = args[2];this.backtrace = 'CC_MD5 called from:\n' +Thread.backtrace(this.context, Backtracer.ACCURATE).map(DebugSymbol.fromAddress).join('\n') + '\n';},onLeave(log, retval, state) {var ByteArray = Memory.readByteArray(this.args2, 16);var uint8Array = new Uint8Array(ByteArray);var str = "";for(var i = 0; i < uint8Array.length; i++) {var hextemp = (uint8Array[i].toString(16))if(hextemp.length == 1){hextemp = "0" + hextemp}str += hextemp;}log(`CC_MD5(${this.args0.readUtf8String()})`);   log(`CC_MD5()=${str}=`);log(this.backtrace);	// 打印函数调用栈}
}