Error codes and error messages for altool notarize-app

Is there a document that lists the error codes and messages for notary service by Apple? This would be useful when we need to treat error codes on our automation.

When I get error code of (-1011), the second retry usually succeeds, but sometimes it fails too. It would be good to know what those error codes mean, so that we can decide on when to retry(or do any other action)

Is there a document that lists the error codes and messages for notary service by Apple?

There is not unfortunately. This would be an enhancement request. If you do receive a response that you do not expect, you can check the status of your Notary request using the following command:

% xcrun altool --notarization-info 2EFE2717-52EF-43A5-96DC-0797E4CA1041 -p "@keychain:AC_PASSWORD"

Which may produce something like the following:

   RequestUUID: 2EFE2717-52EF-43A5-96DC-0797E4CA1041
          Date: 2021-07-02 20:32:01 +0000
        Status: invalid
    LogFileURL: https://osxapps.itunes.apple.com/...
   Status Code: 2 
Status Message: Package Invalid

And this could instruct your automation on what the next step would be; retry again or fail the step.

Matt Eaton
DTS Engineering, CoreOS
meaton3@apple.com

This would be useful when we need to treat error codes on our automation.

If you’re building automation today, I encourage to not do that on top of altool. altool has been deprecated for the purposes of notarisation. Switch to notarytool; it’s better, stronger, and faster. For the details, see WWDC 2021 Session 10261 Faster and simpler notarization for Mac apps.

Having said that, we don’t have a comprehensive list of its errors either. You could file an enhancement request for that but that doesn’t seem particularly helpful. It would be better for notarytool to return explicit information as to whether a retry is reasonable and, if so, what delay to apply. Or, better yet, just do the retries for you.

Share and Enjoy

Quinn “The Eskimo!” @ Developer Technical Support @ Apple
let myEmail = "eskimo" + "1" + "@" + "apple.com"

Error codes and error messages for altool notarize-app
 
 
Q