如何创建Apple Mail插件

Question

我将为OS X Mail.app应用程序创建一个邮件插件，以提供一些其他功能。

我不知道从哪里开始，因为没有插件的官方文档。

谁能帮我，我如何开始这个项目。 是否有任何初始链接或教程，请提出建议？

Answer 1

如前所述，编写Apple Mail插件并不是一件容易的事，因为它只有一个私有的插件API，该API完全没有文档记录，并且可以随Mail.app的任何新版本进行更改。 最好的代码示例是GPGMail ，它是开源的并且仍然处于活动状态（已经在优胜美地支持下工作 ）。 这是我成功完成的入门工作（完成后将其放置在github上）：

如何构建最小的Apple Mail插件（自Mavericks和Xcode 6.0.1起）

1. 您需要在XCode中创建OSX“捆绑”项目
2. 包装扩展名是mailbundle （在“项目”“构建”设置中的“包装”下）
3. 捆绑软件需要存储在~/Library/Mail/Bundles （在构建阶段添加“复制文件”操作，将其作为绝对路径目标，并将* .mailbundle从构建/文件夹中添加为要复制的项目）
4. 为了进行开发，我在运行方案中将/Applications/Mail.app设置为可执行文件，以便在XCode中运行将对其进行构建，复制分发包并开始发送邮件； 请注意，此时您将从Mail中收到一个错误，提示您的插件无法启动且已被禁用
5. 您需要在Info.plist中提供SupportedPluginCompatibilityUUIDs的列表，我从GPGMail那里偷走了 ，这些随着新的Mail / OSX版本而改变
6. 使用类转储从Mail.app的专用API生成头文件
7. 起始点是MVMailBundle ，您必须从MVMailBundle继承它，并且它具有registerBundle方法来吸引您
   • 我从一个小的MVMailBundle.h头文件中的巨大头文件中提取了该文件，以包含所需的位置（由GPGMail完成）
8. 创建一个新类MyMailBundle ，从NSObject继承
   • 它需要一个initialize方法
   • 并将其设置为Info.plist中的“ Principle类”，以便在Mail.app加载捆绑包时运行

#import <Cocoa/Cocoa.h>

@interface MyMailBundle : NSObject

+ (void)initialize;
@end

9. initialize实现：以前，您可以使用简单的方法并像Letterbox一样直接继承 ，但是， 由于Objective-C的64位运行时必须像GPGMail那样使用动态方式 ：
   • 使用NSClassFromString动态获取MVMailBundle类
   • 和class_setSuperclass从<objc/runtime.h>有自己的类继承它
   • 然后调用registerBundle它铸成MVMailBundle （需要包括MVMailBundle.h ）

#import <objc/runtime.h>
#import "MVMailBundle.h"
#import "MyMailBundle.h"

@implementation MyMailBundle

+ (void)initialize
{
    NSLog(@"Loading MyMail plugin...");

    // since 64-bit objective-c runtimes, you apparently can't load
    // symbols directly (i.e. through class inheritance) and have to
    // resort to NSClassFromString
    Class mvMailBundleClass = NSClassFromString(@"MVMailBundle");

    // If this class is not available that means Mail.app
    // doesn't allow plugins anymore or has changed the API
    if (!mvMailBundleClass)
        return;

    // dynamically change super class hierarchy
#pragma GCC diagnostic push
#pragma GCC diagnostic ignored "-Wdeprecated"
    class_setSuperclass([self class], mvMailBundleClass);
#pragma GCC diagnostic pop

    // register our plugin bundle in mail
    [[((MyMailBundle *)self) class] registerBundle];

    NSLog(@"Done registering MyMail plugin.");
}
@end

10. 添加一些NSLog日志调用以验证是否发生了正确的事情，当您从XCode中运行/调试Mail.app或在Console.app的系统日志中，它们将在XCode的控制台中可见。
11. 这应该可以在Mail中成功运行插件，并且没有错误！
12. 下一步涉及疯狂的事情，例如MethodSwizzling和ClassPosing来修改Mail的行为，其中GPGMail可能是一个有用的示例 。 （我自己还没去过那里）

供参考，以下是一些帮助我的资源：

• GPG邮件
• 亚当·纳什（Adam Nash）：准备编写适用于Mac OS X的Apple Mail.app插件 -一些不错的链接，但显然他从未完成项目，因此没有代码
• James R. Eagan：揭秘Leopard上的Mail.app插件 -使用PyObjC用Python编写插件，解释了基本的机理，非常有用
• Aaron Harnly：邮件插件模板 -适用于XCode 2我认为，不幸的是，该模板（下载zip）不再用作Xcode中的模板，但是该代码对于查看仍然有用
• 亚伦·哈恩利（Aaron Harnly）：Letterbox消息来源 -来自同一个人，但也来自2007年，非常过时； 包含模板中的自述文件 ，但是如果您不能使用模板 ，它并没有真正的帮助。

Answer 2

没有官方支持的方法来构建这种工具-您需要在没有任何官方支持的情况下开始尝试挂接到Mail.app。

如果您想坚持这种事情，那么您需要了解Mail.app内部的工作原理，这是一堆使用调试器和类转储来检查其他应用中的库的方法：

https://github.com/nygard/class-dump

您可能还需要一种将代码注入其他应用程序的方法，例如：

https://github.com/rentzsch/mach_inject

每次Apple更新Mail.app时，您都可能需要重做所有内容：）