¿Cómo agrego el soporte de Applescript a mi aplicación Cocoa?

Question

Soy nuevo en el mundo de la programación de Cocoa y deseo agregar el soporte de Applescript a mi aplicación. Los ejemplos en el sitio web de Apple parecen desactualizados.

¿Cómo agrego el soporte de Applescript a mi aplicación Cocoa?

Answer 1

Las versiones modernas de Cocoa pueden interpretar directamente la lista de propiedades de definición de scripts (.sdef), por lo que todo lo que necesita hacer para obtener soporte AppleScript básico es crear el sdef según los documentos, agréguelo a su fase "copiar paquetes de recursos" y declara compatibilidad con AppleScript en tu Info.plist. Para acceder a objetos distintos de NSApp, debe definir especificadores de objetos, de modo que cada objeto conozca su posición en la jerarquía del mundo de scripting. Eso le permite manipular kvc las propiedades del objeto y la capacidad de usar métodos de objetos como simples comandos de scripts.

Answer 2

1. Si desea enviar AppleScript de su aplicación y necesita una aplicación de un recinto de seguridad, es necesario crear un derecho temporal

2. Es necesario añadir esas dos llaves en su info.plist

   <key>NSAppleScriptEnabled</key> 
   <true/> 
   <key>OSAScriptingDefinition</key> 
   <string>MyAppName.sdef</string> 
   

... por supuesto que tiene que cambiar "MyAppName" a nombre de su aplicación

3. Cree un archivo .sdef y agréguelo a su proyecto. El curso ulterior ahora depende en gran medida de las necesidades de su aplicación, se encuentran:

   1. Clase Elementos (crear un objeto a partir de AppleScript)
   2. los elementos de mando (anular NSScriptCommand y ejecutar comandos "verbo-como")
   3. Enumeración Elementos
   4. de Registros Tipo Elementos
   5. valor de tipo de elementos (KVC)
   6. cacao Elementos

   -

   Ir aquí para encontrar una descripción detallada y muchos detalles sobre su aplicación: https://developer.apple.com/library/content/documentation/Cocoa/Conceptual/ScriptableCocoaApplications/SApps_script_cmds/SAppsScriptCmds.html

4. me encontré trabajando con clase y KVC elementos muy complicado, ya que sólo quería ejecutar un solo comando, nada sofisticado. Entonces, para ayudar a otros, aquí hay un ejemplo de cómo crear un nuevo comando simple con un argumento. En este ejemplo se va a "lookup" una cadena como esta:

   tell application "MyAppName" 
       lookup "some string" 
   end tell 
   

5. El archivo .sdef para este comando es el siguiente:

   <?xml version="1.0" encoding="UTF-8"?> 
   <!DOCTYPE dictionary SYSTEM "file://localhost/System/Library/DTDs/sdef.dtd"> 
   
   <dictionary title="MyAppName"> 
       <suite name="MyAppName Suite" code="MApN" description="MyAppName Scripts"> 
        <command name="lookup" code="lkpstrng" description="Look up a string, searches for an entry"> 
         <cocoa class="MyLookupCommand"/> 
         <direct-parameter description="The string to lookup"> 
          <type type="text"/> 
         </direct-parameter> 
        </command> 
       </suite> 
   </dictionary> 
   

6. crear una subclase de NSScriptCommand y el nombre de MyLookupCommand

   The MyLookupCommand.h

   #import <Foundation/Foundation.h> 
   
   @interface MyLookupCommand : NSScriptCommand 
   
   @end 
   

   El MyLookupCommand.m

   #import "MyLookupCommand.h" 
   
   @implementation MyLookupCommand 
   
   -(id)performDefaultImplementation { 
   
       // get the arguments 
       NSDictionary *args = [self evaluatedArguments]; 
       NSString *stringToSearch = @""; 
       if(args.count) { 
        stringToSearch = [args valueForKey:@""]; // get the direct argument 
       } else { 
        // raise error 
        [self setScriptErrorNumber:-50]; 
        [self setScriptErrorString:@"Parameter Error: A Parameter is expected for the verb 'lookup' (You have to specify _what_ you want to lookup!)."]; 
       } 
       // Implement your code logic (in this example, I'm just posting an internal notification) 
       [[NSNotificationCenter defaultCenter] postNotificationName:@"AppShouldLookupStringNotification" object:stringToSearch]; 
       return nil; 
   } 
   
   @end 
   

   Eso es básicamente la misma. El secreto para esto es crear la subclase NSScriptCommand y anular realizar la ejecución predeterminada de Default. Espero que esto ayude a alguien para conseguir que sea más rápido ...

Answer 3

Un ejemplo sencillo para que pueda empezar,

lugar un guión (llamado de diálogo) en la carpeta de documentos, entonces puede ejecutarlo desde Xcode

Lo bueno de mantener el script externo es la posibilidad de editarlo fuera de Xcode. Yo recomendaría la adición de comprobar el error si se hizo comenzar a editar como el applescript no puede compilar

quizá comprobar con

if(scriptObject.isCompiled){