可编写脚本的应用程序示例

时间:2016-04-16 11:18:01

标签: objective-c macos cocoa applescript scriptable

显然,有一种方法可以使我的GUI应用程序可以使用AppleScript编写脚本。因此,例如,我可以使用命令行应用程序(如从LaunchDaemon运行),告诉我的GUI应用程序发布侧边栏通知。有没有人有一个简单的例子来解释这个?我在Apple网站上看到的一切都很难理解。

我想创建一条AppleScript消息,如:

tell "My App" to notify with title "Title" subtitle "subtitle" text "some text"

在我的CLI应用程序中,然后我的GUI应用程序唤醒,接收并处理它。

1 个答案:

答案 0 :(得分:1)

这比我想象的要容易!有些事情需要注意:

  • 您必须启用Cocoa应用,才能在Info.plist文件中接收带有两个特殊参数的AppleScript事件:NSAppleScriptEnabledOSAScriptingDefinition
  • 一个名为sdef文件的特殊XML文件将AppleScript语法直接映射到Objective C类来处理它。
  • 该类必须子类NSScriptCommand及其方法performDefaultImplementation,然后您可以访问[self directParameter][self evaluatedArguments]
  • 因此,当您发送AppleScript命令时,您的应用程序会自动打开(即使已关闭),并且不会加载它的多个实例,这很不错。然后,如果AppleScript中的语法正确,它会将其发送到该类以进行处理。 sdef文件指示哪个类。
  • 如果你想要的话,你的命令也可以发回一个回复。或者它可以选择不这样做。

1。打开要接收AppleScript事件的OSX Cocoa应用程序项目。

2。添加具有以下内容的commands.sdef文件:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE dictionary SYSTEM "file://localhost/System/Library/DTDs/sdef.dtd">
<dictionary xmlns:xi="http://www.w3.org/2003/XInclude">
    <!-- commented out next line because it has a bug ".sdef warning for argument 'FileType' of command 'save' in suite 'Standard Suite': 'saveable file format' is not a valid type name" -->
    <!-- <xi:include href="file:///System/Library/ScriptingDefinitions/CocoaStandard.sdef" xpointer="xpointer(/dictionary/suite)"/> -->
    <suite name="Acceptable Commands" code="SVrb" description="">
        <command name="notify user with title" code="SVrbDpCm" description="">
            <cocoa class="myCommand"/>
            <direct-parameter description="">
                <type type="text"/>
            </direct-parameter>
            <parameter name="subtitle" code="arg2" type="text" optional="yes"
                    description="">
                    <cocoa key="subtitle"/>
            </parameter>
            <parameter name="text" code="arg3" type="text" optional="yes"
                    description="">
                    <cocoa key="text"/>
            </parameter>
            <!-- uncomment below if you want to return a result string -->
            <!-- <result type="text" description=""/> -->
        </command>
    </suite>
</dictionary>

3。添加myCommand.mm文件,其中包含以下内容:

#import <Cocoa/Cocoa.h>

@interface myCommand : NSScriptCommand
@end

@implementation myCommand : NSScriptCommand

- (id)performDefaultImplementation {
    NSString *sResult = @"";
    NSString *sTitle = [self directParameter];
    NSDictionary *asArgs = [self evaluatedArguments];
    NSString *sSubTitle = [asArgs objectForKey:@"subtitle"];
    NSString *sText = [asArgs objectForKey:@"text"];
    sResult = [sResult stringByAppendingFormat:@"TITLE=%@ SUBTITLE=%@ TEXT=%@",sTitle,sSubTitle,sText];
    NSUserNotification *n = [[NSUserNotification alloc] init];
    n.title = sTitle;
    if (![sSubTitle isEqualToString:@""]) {
        n.subtitle = sSubTitle;
    }
    n.informativeText = sText;
    [NSUserNotificationCenter.defaultUserNotificationCenter deliverNotification:n];
    [[NSRunLoop currentRunLoop] runUntilDate:[NSDate dateWithTimeIntervalSinceNow:0.1]];
    return sResult;
}

@end

4。确保AppKit.framework是一个像往常一样的链接二进制文件。

5。编辑Info.plist文件并添加两个参数。 (注意,下面是它们的原始密钥名称。)

NSAppleScriptEnabled =是
OSAScriptingDefinition = commands.sdef

6。编译您的项目。然后,右键单击XCode中黄色Products文件夹下的产品,并选择Show in Finder。

7。单击您在Finder中看到的应用程序图标,然后按下左侧的Option键。然后,在按住Option键的同时,转到Finder的“编辑”菜单,然后选择“复制路径名”。这会将您的应用程序的长路径名(在将其安装到/ Applications中之前)放在剪贴板上。

8。只是为了测试它,打开一个终端窗口,然后键入它,将下面的路径替换为Cocoa应用程序的路径。

osascript -e 'tell app "/crazy/long/path/Example.app" to notify user with title "My Title" subtitle "my sub" text "my text"'

9。如果应用程序尚未打开,您应该会看到您的应用程序打开了停靠栏图标,然后在右上角,您会看到侧边栏通知中显示通知。如果已安装GUI应用程序,它还将具有GUI应用程序的图标。请注意,如果多次运行该命令,AppleScript很智能,并且不会多次加载您的应用程序。另请注意,如果单击侧边栏通知,它将打开您的应用程序屏幕(而不是仅将其显示到扩展坞)。

更多信息

•您可以修改步骤2和3中的代码,以执行不同的命令并以不同的方式对其执行操作。

•如果您需要,可以修改您的sdef(请参阅注释行)以返回结果。 (非常适合调试!)

•您的sdef文件可以有单独的命令进入单独的类。有关如何完成此操作,请参阅Apple's example

•sdef文件有一些奇怪的语法,例如&#34; code&#34;参数。更多info is available here

•如果您的应用程序与LaunchDaemon一起使用但LaunchDaemon需要发送侧边栏通知,则此AppleScript连接非常有用。当然,有这样的代码可以实现这一点,甚至可以使LaunchDaemon图标显示您的应用程序图标而不是终端图标,但它不能做的一件事就是制作它这样,当您单击侧边栏通知时,它会打开GUI应用程序。相反,当单击该侧边栏通知时,它会打开LaunchDaemon,这是一个不受欢迎的结果。因此,您可以使用此AppleScript技术唤醒LaunchDaemon并通知其GUI应用程序伴随发送通知。这样,当单击侧边栏通知时,它会打开GUI应用程序,而不是LaunchDaemon。

•让另一个应用程序发送一些AppleScript是微不足道的:

NSString *sScript = @"tell app \"/Applications/Calculator.app\" to activate";
NSAppleScript *oScript = [[NSAppleScript alloc] initWithSource:sScript];
NSDictionary *errorDict; 
NSAppleEventDescriptor *result = [oScript executeAndReturnError:&errorDict];