API 2 Documentation?

A month or so ago I saw some documentation on the API version 2 and using executeAsModal with a single history state. I can’t find the documentation for this anymore and lost the bookmark I had for it. Could someone post a link for where to find the API 2 documentation?

OK, so I found the link but it now gives a 404 error. I can’t find any documents at all for SPI version 2. Was all the documentation removed? Or was it moved somewhere else?

https://www.stage.adobe.io/photoshop/uxp/ps_reference/media/executeAsModal/

These stage links are not working most of the time, so might again be temporary

Please try again – should be working again.

It is working, thanks.

For the API 2, is that going to be in the public release of 22.5? I’m assuming whatever is in the beta will also be in the public release? For my next UXP release, I want to just build it using API 2 and release with the min version set to 22.5.

Just to confirm, is the API 2 functional yet in the 22.5 beta release?

When switching to API 2 in the manifest, I can’t get the plugin to do anything… not even do a basic app.showAlert.

Before I start to troubleshoot, I just want to ensure that that the API 2 is functional so I don’t spend a bunch of time troubleshooting if it the API is not functional yet.

OK, I figured out some things about API 2. So in case this helps someone else…

  1. You must use executeAsModal. It’s not optional to be able to just run batchPlay without it… at least I don’t think it is.

  2. If you have your batchPlay setup with options, you must change modalBehavior to “execute” or just let it default. If you have it set to “fail” then it won’t work… which makes sense.

  3. Showing an alert is now done this way
    require('photoshop').core.showAlert("message");

and not this way
require('photoshop').app.showAlert("message");

3 Likes