如何向我的 Cocoa 应用程序添加 Applescript 支持？

Question

我是 Cocoa 编程领域的新手，我想向我的应用程序添加 Applescript 支持。苹果网站上的例子似乎已经过时了。

如何向我的 Cocoa 应用程序添加 Applescript 支持？

Answer 1

1. 如果您想从应用程序发送 AppleScript 并需要沙盒应用程序，则需要创建临时权利

2. 您需要在 info.plist 中添加这两个密钥

   NSAppleScriptEnabled
   <真/>
   OSAScriptingDefinition
   <字符串>MyAppName.sdef
   

...当然您必须将“MyAppName”更改为您的应用程序名称

3. 创建一个 .sdef 文件并将其添加到您的项目中。
   现在进一步的课程很大程度上取决于您的应用程序的需求，有：

   1. 类元素（从 AppleScript 创建对象）
   2. 命令元素（覆盖 NSScriptCommand 并执行“类似动词”的命令）
   3. 枚举元素
   4. 记录类型元素
   5. 值类型元素 (KVC)
   6. 可可元素

   -

   转到此处查找有关其实现的详细说明和许多细节：https://developer.apple.com/library/content/documentation/Cocoa/Conceptual/ScriptableCocoaApplications/SApps_script_cmds/SAppsScriptCmds.html

4. 我发现可以使用类和 KVC 元素非常复杂，因为我只想执行一个命令，没什么花哨的。因此，为了帮助其他人，这里有一个示例，说明如何使用一个参数创建一个新的简单命令。在此示例中，它将“查找”一个字符串，如下所示：

   告诉应用程序“MyAppName”
       查找“某个字符串”
   结束告诉
   

5. 此命令的 .sdef 文件如下所示：

   
   
   
   <字典标题=“MyAppName”>
       <套件名称=“MyAppName Suite”代码=“MApN”描述=“MyAppName 脚本”>
           <命令名称=“lookup”代码=“lkpstrng”描述=“查找字​​符串，搜索条目”>
               <可可类=“MyLookupCommand”/>
               
                   <类型类型=“文本”/>
               
           
       
   
   

6. 创建 NSScriptCommand 的子类并将其命名为 MyLookupCommand

   MyLookupCommand.h

   #import ;
   
   @interface MyLookupCommand : NSScriptCommand
   
   @结尾
   

   MyLookupCommand.m

   #import "MyLookupCommand.h"
   
   @实现MyLookupCommand
   
   -(id)performDefaultImplementation {
   
       // 获取参数
       NSDictionary *args = [自我评估参数];
       NSString *stringToSearch = @"";
       if(args.count) {
           stringToSearch = [args valueForKey:@""]; // 获取直接参数
       } 别的 {
           // 引发错误
           [自我设置脚本错误编号：-50]；
           [self setScriptErrorString:@"参数错误：动词“查找”需要一个参数（您必须指定要查找的内容！）。"];
       }
       // 实现你的代码逻辑（在这个例子中，我只是发布一个内部通知）
       [[NSNotificationCenter defaultCenter] postNotificationName:@"AppShouldLookupStringNotification" 对象:stringToSearch];
       返回零；
   }
   
   @结尾
   

   基本上就是这样。其秘诀在于继承NSScriptCommand并覆盖performDefaultImplementation。我希望这可以帮助某人更快地获得它...

Answer 2

现代版本的 Cocoa 可以直接解释脚本定义 (.sdef) 属性列表，因此对于基本 AppleScript 支持，您所需要做的就是根据文档创建 sdef，将其添加到“复制捆绑资源”阶段并声明 AppleScript 支持在你的 Info.plist 中。要访问 NSApp 以外的对象，您需要定义对象说明符，以便每个对象都知道其在脚本世界层次结构中的位置。这使您能够对对象属性进行 kvc 操作，并能够将对象方法用作简单的脚本命令。

Answer 3

一个简单的例子可以帮助您入门，

将一个脚本（名为对话框）放入文档文件夹中，然后您可以从 Xcode 运行它。

NSArray *arrayPaths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
    NSString *docDirectory = [arrayPaths objectAtIndex:0];
    NSString *filePath = [docDirectory stringByAppendingString:@"/dialog.scpt"];

     NSAppleScript *scriptObject = [[NSAppleScript alloc] initWithContentsOfURL:[NSURL fileURLWithPath:filePath] error:nil];

 [scriptObject executeAndReturnError:nil];

将脚本保留在外部的好处是能够在 Xcode 之外对其进行编辑。
如果您确实开始编辑，我建议添加错误检查，因为 applescript 可能无法编译，

也许可以检查

if(scriptObject.isCompiled){