我们在写插件的时候都知道很多时候用到theos去写更为方便
因为theos在线调试后可以直接hook我们需要的东西

比如广告，基址，地址，等各种UIView或者conterller等

今天就记录一下我们theos在写插件的时候用的语法等一些记录

创建项目

首先我们需要创建项目，这些问题我不在强调了
终端输入nic.pl创建tweak项目
创建后我们需要打开tweak.x文件去写代码

注释：
你也可以xcode安装monkeydev直接创建logos插件
这样也是同样的打开xm文件去写代码
xm文件可以写oc，c，swift，logos等代码，但是需要知道xm文件没有代码提示
或者直接删除文件引用m的oc或者swift文件解决

开始记录

%group

%group Groupname

group用于条件初始化或代码组织。分组可用于管理与旧代码的向后兼容性。

以组名开头的hook group。group不能在另一个%group块内。所有未分组的hook都在隐式“_ungrouped” group中。如果没有其他group，则会为您初始化_ungrouped组。您可以使用%init指令手动初始化它。其他组必须使用%init(Groupname)指令初始化。

%group iOS8
%hook IOS8_SPECIFIC_CLASS
    // your code here
%end // end hook
%end // end group ios8

%group iOS9
%hook IOS9_SPECIFIC_CLASS
    // your code here
%end // end hook
%end // end group ios9

%ctor {
    if (kCFCoreFoundationVersionNumber > 1200) {
        %init(iOS9);
    } else {
        %init(iOS8);
    }
}

%hook

%hook Classname

为名为类名的类打开一个hook块。

可以在%group块内。

这里有一个微不足道的例子：

%hook SBApplicationController
-(void)uninstallApplication:(SBApplication *)application {
    NSLog(@"Hey, we're hooking uninstallApplication:!");
    %orig; // Call the original implementation of this method
    return;
}
%end

%new

`%new
%new(signature)`

通过在方法定义上方添加此指令，将新方法添加到hook类或子类中。签名是新方法的Objective-C类型编码；如果省略，将生成一个。

必须位于%hook块内。

您还应该在界面中声明新方法，因为Logos不会自动声明。例如：

@interface TheClass (TweakMethods)
-(void)yourNewMethod;
@end

%hook TheClass
%new
-(void)yourNewMethod { /* code */ }
%end

%subclass

%subclass Classname: Superclass

子类块-该类在运行时创建并填充方法。尚未支持ivars（使用关联对象）。对于超类中不存在的方法，需要%new说明符。要实例化新类的对象，您可以使用%c运算符。

可以在%group块内。

这里有一个例子：

%subclass MyObject : NSObject

- (id)init {
    self = %orig;
    [self setSomeValue:@"value"];
    return self;
}

//the following two new methods act as `@property (nonatomic, retain) id someValue;`
%new
- (id)someValue {
    return objc_getAssociatedObject(self, @selector(someValue));
}

%new
- (void)setSomeValue:(id)value {
    objc_setAssociatedObject(self, @selector(someValue), value, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
}

%end

%ctor {
    MyObject *myObject = [[%c(MyObject) alloc] init];
    NSLog(@"myObject: %@", [myObject someValue]);
}

%property

将属性添加到%subclass中，就像使用@property添加到正常的Objective-C子类中一样，并在%hook中向现有类添加新属性。

必须位于%subclass或%hook块内。

%end

%end

关闭组/钩子/子类块。

%config

%config(Key=Value);

设置logos标致

%hookf

%hookf(rtype, symbolName, args…) { … }

为名为symbolName的函数生成一个函数钩子。如果名称作为字面字符串传递，则将动态查找该函数。

// Given the function prototype
FILE *fopen(const char *path, const char *mode);
// The hook is thus made
%hookf(FILE *, fopen, const char *path, const char *mode) {
    NSLog(@"Hey, we're hooking fopen to deny relative paths!");
    if (path[0] != '/') {
        return NULL;
    }
    return %orig; // Call the original implementation of this function
}

人们通常会挂钩其地址在运行时解析的函数，例如MGGetBoolAnswer，例如：

bool (*orig_MGGetBoolAnswer)(CFStringRef);
bool fixed_MGGetBoolAnswer(CFStringRef string)
{
    if (CFEqual(string, CFSTR("StarkCapability"))) {
        return kCFBooleanTrue;
    }
    return orig_MGGetBoolAnswer(string);
}

%ctor {
    MSHookFunction(((void *)MSFindSymbol(NULL, "_MGGetBoolAnswer")), (void *)fixed_MGGetBoolAnswer, (void **)&orig_MGGetBoolAnswer);
    ...
}

您还可以做：

%hookf(bool, MGGetBoolAnswer, CFStringRef string)
{
    if (CFEqual(string, CFSTR("StarkCapability"))) {
        return true;
    }
    return %orig;
}
%ctor() {
    %init(MGGetBoolAnswer = MSFindSymbol(NULL, "_MGGetBoolAnswer"));
}

并将MSFindSymbol（NULL，“_MGGetBoolAnswer”）替换为函数指针的任何表达式。

%ctor

%ctor { … }

生成匿名构造函数（默认优先级）。

%dtor

%dtor { … }

生成一个匿名解构函数（默认优先级）。

%init

%init;
%init([=, …]);
%init(Group[, [+|-]=, …]);

初始化组（或默认组）。不传递组名将初始化“_ungrouped”，传递class=expr参数将在初始化时用给定的表达式替换这些类。+ sigil（如Objective-C中的类方法）可以前置于类名，以替换元类的表达式。如果没有指定，sigil默认为-，以替换类本身。如果没有指定，元类就是从类派生出来的。类名替换对于包含不能用作%hook指令的类名令牌的类，例如空格和点，类名替换特别有用。

Usage:

%hook SomeClass
-(id)init {
    return %orig;
}
%end

%ctor {
    %init(SomeClass=objc_getClass("class with spaces or dots in the name"));
}

%class

%class Class;

向前宣布一个类。过时%c，但仍然存在。创建一个$Class变量，并使用“_ungrouped”组初始化它。

%c

%c([+|-]Class)

在运行时向Class进行评估。如果指定了+ sigil，它将计算为MetaClass而不是Class。如果没有指定，sigil默认为-，评估为类。

%orig

%orig

%orig(arg1, …)

调用原始挂钩方法。它在%new’d方法中不起作用。奇怪的是，它在子类中工作，因为MobileSubstrate将在钩子时间生成一个超级调用闭包。（如果挂钩方法在我们挂钩的类中不存在，它会创建一个仅调用超类实现的存根。）args传递给原始函数-不包括self和_cmd，Logos会为您这样做。

%log

%log;

%log([(), …]);

将方法参数转储到syslog。%Log中包含的类型参数也将被记录。

文件扩展名

.x文件将由Logos处理，然后作为 objective-c进行预处理和编译。
.xm文件将由Logos处理，然后作为 objective-c++进行预处理和编译。
.xi文件将首先作为 objective-c进行预处理，然后Logos将处理结果，然后进行编译。
.xmi文件将首先作为 objective-c++进行预处理，然后Logos将处理结果，然后编译。

xi或xmi文件可以在#define宏中使用Logos指令。

默认情况下，Logos预处理器只会在构建时处理一个.xm文件。但是，可以将徽标挂钩代码拆分为多个文件。

首先，主文件必须重命名为.xmi文件。然后，可以使用#include指令包含其他.xm文件。Logos预处理器将在处理之前将这些文件添加到主文件中。

通常，无法在多个徽标文件中初始化钩子组，但有一个变通办法可用于解锁此功能。这是通过将组初始化包装在静态方法中来完成的，然后可以从其他文件调用。

请查看以下代码。它所做的就是在SpringBoard应用程序启动完成后记录一条消息。它位于一个名为TweakGroup的组内，该组在名为InitGroup()的静态函数中初始化。

// Group.xm
#import "Shared.h"

%group TweakGroup
%hook SpringBoard

- (void)applicationDidFinishLaunching:(id)arg1 {
    %orig;
    NSLog(@"[Group Test] SpringBoard has finished launching");
}

%end
%end

extern "C" void InitGroup() {
    %init(TweakGroup);
}

您可能已经注意到，Group.xm的顶部有一个Shared.h的导入。这只是一个头文件，将导入到我们的主Logos文件中，以便我们可以在那里调用该函数：

// Shared.h
extern "C" void InitGroup();

最后，Shared.h可以导入包含构造函数的Logos文件中。调用静态函数将从Group.xm初始化组并运行其hook：

// Tweak.xm
#import "Shared.h"

%ctor {
    NSLog(@"[Group Test] Our hook for SpringBoard should show up below this");
    InitGroup();
}

如果操作正确且编译没有错误，这应该可以记录两条消息：一条来自构造函数，另一条来自组内的方法。请记住，这不适用于不在组内的hook。

需要注意的几件事：

这在正常的C中不起作用，因此您必须为您的组和构造函数使用.xm文件。
你必须注意你调用初始化的次数，因为Logos将不再告诉你它是否被调用不止一次。

您可以使用logify.pl从头文件创建Logos源文件，该标头文件将记录该标头文件的所有功能。以下是logify.pl生成的非常简单的徽标调整示例

给定一个标题文件：

@interface SSDownloadAsset : NSObject
- (NSString *)finalizedPath;
- (NSString *)downloadPath;
- (NSString *)downloadFileName;
+ (id)assetWithURL:(id)url type:(int)type;
- (id)initWithURLRequest:(id)urlrequest type:(int)type;
- (id)initWithURLRequest:(id)urlrequest;
- (id)_initWithDownloadMetadata:(id)downloadMetadata type:(id)type;
@end

您可以在$THEOS/bin/logify.pl上找到logify.pl，并以这样使用它：

$THEOS/bin/logify.pl ./SSDownloadAsset.h

打印的结果应该是：

%hook SSDownloadAsset
- (NSString *)finalizedPath { %log; NSString * r = %orig; NSLog(@" = %@", r); return r; }
- (NSString *)downloadPath { %log; NSString * r = %orig; NSLog(@" = %@", r); return r; }
- (NSString *)downloadFileName { %log; NSString * r = %orig; NSLog(@" = %@", r); return r; }
+ (id)assetWithURL:(id)url type:(int)type { %log; id r = %orig; NSLog(@" = %@", r); return r; }
- (id)initWithURLRequest:(id)urlrequest type:(int)type { %log; id r = %orig; NSLog(@" = %@", r); return r; }
- (id)initWithURLRequest:(id)urlrequest { %log; id r = %orig; NSLog(@" = %@", r); return r; }
- (id)_initWithDownloadMetadata:(id)downloadMetadata type:(id)type { %log; id r = %orig; NSLog(@" = %@", r); return r; }
%end

这样，我们就可以轻松的运用我们的tweak进行hook了

更多交流后期会有教程！

版权声明 1、本网站名称：Apibug
2、本站永久网址：https://www.apibug.com
3、本网站的文章部分内容可能来源于网络，仅供大家学习与参考，如有侵权，请联系站长进行删除处理。
4、本站一切资源不代表本站立场，并不代表本站赞同其观点和对其真实性负责。
5、本站一律禁止以任何方式发布或转载任何违法的相关信息，访客发现请向站长举报
6、本站资源大多存储在云盘，如发现链接失效，请联系我们我们会第一时间更新。

THE END