前言

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/foundation

    var before = args[2];

    // 注意，日志输出请直接使用log函数。不要使用console.log()
    if (isData) {
    	// 打印byte对象
      var after = new ObjC.Object(args[2]); // 打印NSData
      var outValue = after.bytes().readUtf8String(after.length()) // 将data转换为string
      log(`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);	// 打印函数调用栈
  }
}

• 常用frida-trace命令

跟踪单个方法：frida-trace -UF -m "-[DetailViewController obj]"

跟踪多个方法：frida-trace -UF -m "-[DetailViewController obj]" -m "+[NSURL URLWithString:]"

跟踪某个类的所有方法：frida-trace -UF -m "*[DetailViewController *]"

跟踪某个类的所有方法并排除viewDidLoad方法：frida-trace -UF -m "*[DetailViewController *]" -M "-[DetailViewController viewDidLoad]"

跟踪整个App中包含sendMsg关键词的所有方法：frida-trace -UF -m "*[* *sendMsg*]"

需要忽略某个字母的大小写，请使用?代替sendMsg中的M:frida-trace -UF -m "*[* *send?sg*]"

日志过多时，可保存到文件：frida-trace -UF -m "*[* *sendMsg*]" -o run.log

跟踪某个动态库：frida-trace -UF -I "libcommonCrypto*"

跟踪某个c函数：frida-trace -UF -i "CC_MD5"

跟踪sub_1007B7D48函数：frida-trace -UF -a xxxxx\!0x7B7D48

总结

以上就是关于frida-trace的基本使用，希望能帮助到大家。同时也建议大家阅读官方文档：https://frida.re/docs/frida-trace/

提示：阅读此文档的过程中遇到任何问题，请关注公众号【移动端Android和iOS开发技术分享】或加QQ群【812546729】