Notarisation for dummies

[orange]

@trillbilly

Ok to recap all the things, the below process is the way I use. Be careful with the spaces and other chars with these codes:

---

PLUGIN DISTRIBUTION PROCESS FOR macOS

1) Export the plugin from HISE

---

2) Sign the plugin: In the below example, my plugin folder is /Volumes/UnsignedPlugins/ For plugin signing, you need your Developer ID Application Certificate. Below code if for .vst, and similarly it will be same for vst3 and au plugins, only the file extension will be changed. So the code will be like this:

codesign --force -s "Developer ID Application: John Doe" "/Volumes/UnsignedPlugins/MyPlugin.vst"

This code is for checking the plugin signing process if it is successful or not:

pkgutil --check-signature "/Volumes/UnsignedPlugins/MyPlugin.vst"

---

3) Create a .pkg installer with WhiteBox Packages (without adding the Developer ID Installer Certificate). In this example the installer name is MyPlugin_Installer_v1.0.0.pkg

---

4) Sign the installer: My unsigned installer folder is /Volumes/UnsignedInstallers/. Put the created .pkg installer (in step 3) into this folder. Also, my signed installer folder is /Volumes/SignedInstallers/. Below code will create a new signed installer file which will be placed to signed installer folder. For the installer signing, you also need your Developer ID Installer Certificate So the code will be like this:

productsign --sign "Developer ID Installer: John Doe" "/Volumes/UnsignedInstallers/MyPlugin_Installer_v1.0.0.pkg" "/Volumes/SignedInstallers/MyPlugin_Installer_v1.0.0.pkg"

This code is for checking the installer signing process if it is successful or not:

pkgutil --check-signature "/Volumes/SignedInstallers/MyPlugin_Installer_v1.0.0.pkg"

---

5) Notarize the installer: For this, you'll need an app specific password. In the below notarization code, the app specific password is (for example) abcd-efgh-ijkl-mnop You can use one password for all of your products, or you can use individual. But be aware that there is a limit for app specific passwords, so IMO less is better. The notarization code will be this:

xcrun altool --notarize-app -f "/Volumes/SignedInstallers/MyPlugin_Installer_v1.0.0.pkg" --primary-bundle-id com.myplugininstaller.pkg --username "johndoe@gmail.com" --password "abcd-efgh-ijkl-mnop"

After applying the notarization code to the Terminal, wait for the upload process is done. After the upload finished, wait for the Apple email for the "notarization is successful" notification. After the uploading, mostly it takes with in 15 minutes. rarely it can take 4-5 hours but it is so uncommon. If you haven't got the email yet, wait for it. Don't try to re-notarize, the Apple email will come soon or later. Sequential notarization attempts cause fucked up failures.

---

6) Time Staple the Installer: After the "notarization is successful" email, the last step comes, Time Stamp. The code is this:

xcrun stapler staple "/Volumes/SignedInstallers/MyPlugin_Installer_v1.0.0.pkg"

That's it :)

Also, after the Time Stamp, you can check the notarization status with below code. If you get "status: Accepted", then that means the notarization process is successful:

spctl -a -vvv -t install "/Volumes/SignedInstallers/MyPlugin_Installer_v1.0.0.pkg"

[A Former User]

@orange That's a great explanation, Thank You!

[trillbilly]

All hail @orange

[trillbilly]

@orange Ive gotten to waiting for the email. Ill post update after.

UPDATE: Success. Thanks again!

[Fortune]

@orange Thnx for this epic information! All of the required information is here. You're awesome

@Christoph-Hart could you add this information to the Hise Documentation, please? I will be so helpful for the newbies.

[d.healey]

@fortune said in Notarisation for dummies:

could you add this information to the Hise Documentation, please?

https://docs.hise.audio/working-with-hise/project-management/documentation/contributing.html

[trillbilly]

@nesta99 Here it is. The instructions are just a few posts above. This is with installers. I think the process is a bit different if you do it without installers.

[Sawer]

Hello everyone. After code sign the plugin I'm still not able to open my plugin on Logic Pro. I have the latest version of logic on a Monterey OS. Is it required to notarise the plugin before making it work o a daw?
Thanks

[d.healey]

@nesta99 said in Notarisation for dummies:

Is it required to notarise the plugin before making it work o a daw?

In Logic almost certainly, other DAWs might be more tolerant.

[Sawer]

@d-healey Thanks so much. Another question: I'm having an issue with dealing with the packaging, most precisely on the destination folder:

As shown in the picture above I wasn't able to place the .component in the Audio/Plugins/Component folder.
Now when the end user will install the product, the .component fill will be place in the wrong place, making it complicated.
Any solution?

[d.healey]

@nesta99 Are you using Whitebox Packages?

[Sawer]

@d-healey
This:

[d.healey]

@nesta99 Yep, you need to setup your install paths in there.

[Lindon]

@nesta99 said in Notarisation for dummies:

Hello everyone. After code sign the plugin I'm still not able to open my plugin on Logic Pro. I have the latest version of logic on a Monterey OS. Is it required to notarise the plugin before making it work o a daw?
Thanks

I have NEVER had to notarize any plugin anywhere - codesign - yes but notarize no, I strongly suspect its not that its not notarized, have you run auval against your compiled component plugin?

[Sawer]

@d-healey Ok, thanks.
How can I Kindly do it, pretty new to whitebox?

[Sawer]

@lindon To be honest, I dont know what auval is and since I never remember to use it, then no.

[d.healey]

@nesta99 said in Notarisation for dummies:

@d-healey Ok, thanks.
How can I Kindly do it, pretty new to whitebox?

The documentation is probably the best resource - http://s.sudre.free.fr/Software/documentation/Packages/en_2017/index.html

[Sawer]

@d-healey said in Notarisation for dummies:

http://s.sudre.free.fr/Software/documentation/Packages/en_2017/index.html

Thanks man.

[Sawer]

@d-healey So based on my understanding , on the path section, I just need to put this /Library/Audio/Plugins/Components , right?

[d.healey]

@nesta99 said in Notarisation for dummies:

I just need to put this /Library/Audio/Plugins/Components , right?

No idea, I haven't used it for over a year. Just try it and see, and then share your wisdom.