JavaScript for Automation

Transcription

1 Services #WWDC14 JavaScript for Automation Session 306 Sal Soghoian Product Manger Automation Technologies 2014 Apple Inc. All rights reserved. Redistribution or public display not permitted without written permission from Apple.

2

3 Automation in Mavericks Notifications Code signing use statements Script libraries Speakable workflows

4 Automation in Yosemite Code-signed workflows Enhanced script libraries Script progress indicators Dictation commands

5 JavaScript for Automation

6 Script Editor

7

8 Slider

9 Script Slider

10 Script Slider Event Log

11

12 Compile

13 Run

14 Stop

15 Language

16

17 AppleScript

18 JavaScript

19 Language

20

21 Script Keynote = Application('Keynote') documents = Keynote.documents progress = $.NSProgress.currentProgress progress.totalunitcount = documents.length destinationpath = $('~/Movies').stringByExpandingTildeInPath for (i in documents) { document = documents[i] exportname = document.name().replace('.key','.m4v') document.export({ to: Path(destinationPath.js + '/' + exportname), as: 'QuickTime movie' }) progress.completedunitcount = i } progress.completedunitcount = documents.length

22 Script Keynote = Application('Keynote') documents = Keynote.documents progress = $.NSProgress.currentProgress progress.totalunitcount = documents.length destinationpath = $('~/Movies').stringByExpandingTildeInPath for (i in documents) { document = documents[i] exportname = document.name().replace('.key','.m4v') document.export({ to: Path(destinationPath.js + '/' + exportname), as: 'QuickTime movie' }) progress.completedunitcount = i } progress.completedunitcount = documents.length Progress Indicator Event Log // Target app "Keynote" Application("Keynote").documents.length --> 3 /* Progress: 1 of 3 */ Application("Keynote").documents[0].name() --> New Product Design.key" Application("Keynote").export([object ObjectSpecifier], {to:[object ObjectSpecifier], as:'quicktime movie }) /* Progress: 33% completed */

23 Script Keynote = Application('Keynote') documents = Keynote.documents progress = $.NSProgress.currentProgress progress.totalunitcount = documents.length destinationpath = $('~/Movies').stringByExpandingTildeInPath for (i in documents) { document = documents[i] exportname = document.name().replace('.key','.m4v') document.export({ to: Path(destinationPath.js + '/' + exportname), as: 'QuickTime movie' }) progress.completedunitcount = i } progress.completedunitcount = documents.length Progress Indicator Event Log

24 Script Keynote = Application('Keynote') documents = Keynote.documents progress = $.NSProgress.currentProgress progress.totalunitcount = documents.length destinationpath = $('~/Movies').stringByExpandingTildeInPath for (i in documents) { document = documents[i] exportname = document.name().replace('.key','.m4v') document.export({ to: Path(destinationPath.js + '/' + exportname), as: 'QuickTime movie' }) progress.completedunitcount = i } progress.completedunitcount = documents.length Progress Indicator Event Log Application("Keynote").documents[1].name() --> Wind Power.key /* Progress: 2 of 3 */ Application("Keynote").export([object ObjectSpecifier], {to:[object ObjectSpecifier], as:'quicktime movie'}) /* Progress: 66% completed */

25 Script Keynote = Application('Keynote') documents = Keynote.documents progress = $.NSProgress.currentProgress progress.totalunitcount = documents.length destinationpath = $('~/Movies').stringByExpandingTildeInPath for (i in documents) { document = documents[i] exportname = document.name().replace('.key','.m4v') document.export({ to: Path(destinationPath.js + '/' + exportname), as: 'QuickTime movie' }) progress.completedunitcount = i } progress.completedunitcount = documents.length Progress Indicator Event Log

26 Script Keynote = Application('Keynote') documents = Keynote.documents progress = $.NSProgress.currentProgress progress.totalunitcount = documents.length destinationpath = $('~/Movies').stringByExpandingTildeInPath for (i in documents) { document = documents[i] exportname = document.name().replace('.key','.m4v') document.export({ to: Path(destinationPath.js + '/' + exportname), as: 'QuickTime movie' }) progress.completedunitcount = i } progress.completedunitcount = documents.length Event Log Application("Keynote").documents[2].name() --> "Community Projects.key" Application("Keynote").export([object ObjectSpecifier], {to:[object ObjectSpecifier], as:'quicktime movie'}) /* Progress: 3 of 3 */ /* Progress: 100% completed */ // Stop targeting Result: 3

27

28

29

30 General Settings

31 Default Language

32 AppleScript

33 JavaScript

34

35 Script Menu

36 Script Menu Script Menu

37 Formatting

38 Formatting

39

40

41

42 Language

43 Language

44 Language AppleScript

45 AppleScript Language JavaScript

46 AppleScript Language JavaScript Objective-C

47

48 Model Viewer

49 Suite

50 Suite Methods

51 Methods Suite Class

52 Methods Elements Suite Class

53 Methods Elements Suite Class Properties

54 Definition Viewer

55 Class Elements Properties Methods

56

57 Script Editor

58 JavaScript for Automation David Steinberg Automation Engineer

59 JavaScript for Automation Application scripting Libraries and applets UI scripting Using system APIs

60 Automation

61 Automation Automate tasks

62 Automation Automate tasks

63 Automation Interact with applications

64 Automation Interact with applications + + +

65 Demo

66 Automation

67 Automation Cocoa Scripting

68 Automation Object Model Object Model Object Model Cocoa Scripting

69 Automation Object Model Object Model Object Model Cocoa Scripting

70 Automation Object Model Object Model Object Model Apple Events Cocoa Scripting

71 Automation Object Model Object Model Object Model Apple Events Cocoa Scripting

72 Automation AppleScript Objective-C Perl Python Object Model Object Model Object Model Apple Events Ruby Cocoa Scripting

73 Automation Object model

74 Automation Object model

75 Automation Object model application application "Mail"

76 Automation Object model application inbox inbox of application "Mail"

77 Automation Object model application inbox messages inbox of application "Mail"

78 Automation Object model application inbox messages message 1 message 2... message 2 of inbox of application "Mail"

79 JavaScript

80 JavaScript and Automation

81 JavaScript and Automation Object Model Object Model Object Model Apple Events Cocoa Scripting

82 JavaScript and Automation Object Model Object Model Object Model JavaScript Core JavaScript AE Bridge Apple Events Cocoa Scripting

83 Application Scripting

84 Application Scripting Application object

85 Application Scripting Application object Name: Application('Safari')

86 Application Scripting Application object Name: Application('Safari') Bundle ID: Application('com.apple.mail')

87 Application Scripting Application object Name: Application('Safari') Bundle ID: Application('com.apple.mail') Path: Application('/Applications/TextEdit.app')

88 Application Scripting Application object Name: Application('Safari') Bundle ID: Application('com.apple.mail') Path: Application('/Applications/TextEdit.app') Process ID: Application(763)

89 Application Scripting Application object Name: Application('Safari') Bundle ID: Application('com.apple.mail') Path: Application('/Applications/TextEdit.app') Process ID: Application(763) Current Application: Application.currentApplication()

90 Application Scripting Syntax

91 Application Scripting Syntax Properties: Safari.name

92 Application Scripting Syntax Properties: Safari.name Elements: Safari.documents[0]

93 Application Scripting Syntax Properties: Safari.name Elements: Safari.documents[0] Commands: Safari.open(...)

94 Application Scripting Syntax Properties: Safari.name Elements: Safari.documents[0] Commands: Safari.open(...) Classes: Safari.Document(...)

95 Application Scripting Getting and setting properties

96 Application Scripting Getting and setting properties Safari = Application( Safari')

97 Application Scripting Getting and setting properties Safari = Application( Safari') doc = Safari.document[0]

98 Application Scripting Getting and setting properties Safari = Application( Safari') doc = Safari.document[0] url = doc.url()

99 Application Scripting Getting and setting properties Safari = Application( Safari') doc = Safari.document[0] url = doc.url() doc.url = '

100 Application Scripting Element arrays

101 Application Scripting Element arrays Safari = Application('Safari')

102 Application Scripting Element arrays Safari = Application('Safari') window = Safari.windows[0]

103 Application Scripting Element arrays Safari = Application('Safari') window = Safari.windows[0] window = Safari.windows['Apple']

104 Application Scripting Element arrays Safari = Application('Safari') window = Safari.windows[0] window = Safari.windows['Apple'] window = Safari.windows['#412']

105 Demo

106 Application Scripting Filtering arrays

107 Application Scripting Filtering arrays Mail = Application( Mail')

108 Application Scripting Filtering arrays Mail = Application( Mail') js s = Mail.inbox.messages.whose({subject:'JavaScript'})

109 Application Scripting Sending commands

110 Application Scripting Sending commands Mail = Application('Mail')

111 Application Scripting Sending commands Mail = Application('Mail') message = Mail.inbox.messages[0]

112 Application Scripting Sending commands Mail = Application('Mail') message = Mail.inbox.messages[0] message.open()

113 Application Scripting Sending commands Mail = Application('Mail') message = Mail.inbox.messages[0] message.open() Mail.open(message)

114 Application Scripting Sending commands Mail = Application('Mail') message = Mail.inbox.messages[0] message.open() Mail.open(message) response = message.reply({ replyall: true, openingwindow: false })

115 Application Scripting Paths

116 Application Scripting Paths TextEdit = Application('TextEdit')

117 Application Scripting Paths TextEdit = Application('TextEdit') path = Path( /Users/username/Desktop/foo.rtf')

118 Application Scripting Paths TextEdit = Application('TextEdit') path = Path( /Users/username/Desktop/foo.rtf') TextEdit.open(path)

119 Application Scripting Creating objects

120 Application Scripting Creating objects TextEdit = Application( TextEdit')

121 Application Scripting Creating objects TextEdit = Application( TextEdit') doc = TextEdit.Document()

122 Application Scripting Creating objects TextEdit = Application( TextEdit') doc = TextEdit.Document() TextEdit.documents.push(doc)

123 Application Scripting Creating objects TextEdit = Application( TextEdit') doc = TextEdit.Document() TextEdit.documents.push(doc) doc.text = 'Hello world

124 Application Scripting Creating objects TextEdit = Application( TextEdit') doc = TextEdit.Document() TextEdit.documents.push(doc) doc.text = 'Hello world jsdoc = TextEdit.Document({text:'JavaScript for Automation'}) TextEdit.documents.push(jsDoc)

125 Application Scripting Standard additions

126 Application Scripting Standard additions app = Application.currentApplication()

127 Application Scripting Standard additions app = Application.currentApplication() app.includestandardadditions = true

128 Application Scripting Standard additions app = Application.currentApplication() app.includestandardadditions = true app.beep(3)

129 Application Scripting Standard additions app = Application.currentApplication() app.includestandardadditions = true app.beep(3) app.say('hello world')

130 Application Scripting Standard additions app = Application.currentApplication() app.includestandardadditions = true app.beep(3) app.say('hello world') app.displayalert('finished task')

131 Libraries

132 Libraries Home Library Script Libraries toolbox.scpt function log(message,format) { }...

133 Libraries Home Library Script Libraries toolbox.scpt function log(message,format) { }... toolbox = Library('toolbox') toolbox.log('hello world')

134 Applets

135 Applets Event handlers

136 Applets Event handlers function run() {... }

137 Applets Event handlers function run() {... } function opendocuments(docs) {... }

138 Applets Event handlers function run() {... } function opendocuments(docs) {... } function printdocuments(docs) {... }

139 Applets Event handlers function run() {... } function opendocuments(docs) {... } function printdocuments(docs) {... } function idle() {... }

140 Applets Event handlers function run() {... } function opendocuments(docs) {... } function printdocuments(docs) {... } function idle() {... } function reopen() {... }

141 Applets Event handlers function run() {... } function opendocuments(docs) {... } function printdocuments(docs) {... } function idle() {... } function reopen() {... } function quit() {... }

142 Demo

143 UI Scripting

144 UI Scripting Built on accessibility

145 UI Scripting Built on accessibility

146 UI Scripting Built on accessibility System Events

147 UI Scripting Built on accessibility UI Scripting System Events

148 UI Scripting Clicking and typing

149 UI Scripting Clicking and typing SystemEvents = Application('System Events )

150 UI Scripting Clicking and typing SystemEvents = Application('System Events ) notesui = SystemEvents.processes[ Notes']

151 UI Scripting Clicking and typing SystemEvents = Application('System Events ) notesui = SystemEvents.processes[ Notes'] notesui.windows[0].buttons[0].click()

152 UI Scripting Clicking and typing SystemEvents = Application('System Events ) notesui = SystemEvents.processes[ Notes'] notesui.windows[0].buttons[0].click() Notes = Application('Notes') Notes.activate()

153 UI Scripting Clicking and typing SystemEvents = Application('System Events ) notesui = SystemEvents.processes[ Notes'] notesui.windows[0].buttons[0].click() Notes = Application('Notes') Notes.activate() SystemEvents.keystroke('m', { }) using: 'command down'

154 Using System APIs

155 Using System APIs ObjC and $

156 Using System APIs ObjC and $ ObjC.wrap(...)

157 Using System APIs ObjC and $ ObjC.wrap(...) ObjC.unwrap(...) ObjC.deepUnwrap(...)

158 Using System APIs ObjC and $ ObjC.wrap(...) ObjC.unwrap(...) ObjC.deepUnwrap(...) ObjC.import(...)

159 Using System APIs ObjC and $ ObjC.wrap(...) ObjC.unwrap(...) ObjC.deepUnwrap(...) ObjC.import(...) $.NSString

160 Using System APIs ObjC and $ ObjC.wrap(...) ObjC.unwrap(...) ObjC.deepUnwrap(...) ObjC.import(...) $.NSString $('foo')

161 Using System APIs Calling methods

162 Using System APIs Calling methods str = [[NSString alloc] initwithutf8string: bar ]; [str writetofile:@"/tmp/foo" atomically:yes];

163 Using System APIs Calling methods str = [[NSString alloc] initwithutf8string: bar ]; [str writetofile:@"/tmp/foo" atomically:yes]; str = $.NSString.alloc.initWithUTF8String( bar') str.writetofileatomically('/tmp/foo', true)

164 Demo

165 Using System APIs Accessing properties

166 Using System APIs Accessing properties task = $.NSTask.alloc.init

167 Using System APIs Accessing properties task = $.NSTask.alloc.init task.running

168 Using System APIs Accessing properties task = $.NSTask.alloc.init task.running task.launchpath = '/bin/sleep'

169 Using System APIs Bridged nil

170 Using System APIs Bridged nil error = $()

171 Using System APIs Bridged nil error = $() doc = $.NSXMLDocument.alloc.initWithXMLStringOptionsError( xmlstring, undefined, error )

172 Using System APIs Bridged nil error = $() doc = $.NSXMLDocument.alloc.initWithXMLStringOptionsError( xmlstring, undefined, error ) if (doc.isnil()) { } $.NSLog(error.userInfo.description)

173 Using System APIs Subclassing

174 Using System APIs Subclassing ObjC.registerSubclass({ })

175 Using System APIs Subclassing ObjC.registerSubclass({ name: AppDelegate', })

176 Using System APIs Subclassing ObjC.registerSubclass({ name: AppDelegate', superclass: NSObject, })

177 Using System APIs Subclassing ObjC.registerSubclass({ name: AppDelegate', superclass: NSObject, protocols: [ NSApplicationDelegate'], })

178 Using System APIs Subclassing ObjC.registerSubclass({ name: AppDelegate', superclass: NSObject, protocols: [ NSApplicationDelegate'], properties: { window: 'id' }, })

179 Using System APIs Subclassing ObjC.registerSubclass({ name: AppDelegate', superclass: NSObject, protocols: [ NSApplicationDelegate'], properties: { window: 'id' }, methods: { 'applicationdidfinishlaunching:': { types: ['void', ['id']], implementation: function (notification) { $.NSLog('Application finished launching'); } } } })

180 Demo

181 Using System APIs Release notes

182 Using System APIs Release notes Binding C functions

183 Using System APIs Release notes Binding C functions Explicit pass-by-reference

184 Using System APIs Release notes Binding C functions Explicit pass-by-reference Passing functions as blocks

185 Where to Use It

186 JavaScript for Automation System-wide scripting

187 JavaScript for Automation System-wide scripting Script Editor

188 JavaScript for Automation System-wide scripting Script Editor Applets/Droplets

189 JavaScript for Automation System-wide scripting Script Editor Applets/Droplets Script Menu

190 JavaScript for Automation System-wide scripting Script Editor Automator Applets/Droplets Script Menu

191 JavaScript for Automation System-wide scripting Script Editor Automator Applets/Droplets Services Script Menu

192 JavaScript for Automation System-wide scripting Script Editor Automator Applets/Droplets Services Script Menu osascript

193 Demo

194 JavaScript for Automation Summary

195 JavaScript for Automation Summary Built on JavaScriptCore and OSA

196 JavaScript for Automation Summary Built on JavaScriptCore and OSA Integrated system-wide

197 JavaScript for Automation Summary Built on JavaScriptCore and OSA Integrated system-wide Offers many options for scripting

198 JavaScript for Automation Call to action

199 JavaScript for Automation Call to action Script applications

200 JavaScript for Automation Call to action Script applications Make your applications scriptable

201 JavaScript for Automation Call to action Script applications Make your applications scriptable Tell others to make their applications scriptable

202 More Information Evangelism Documentation JavaScript for Automation Release Notes Apple Developer Forums

203 Lab Automation Lab Services Lab B Friday 12:45PM

204