diff options
Diffstat (limited to 'docs/build.osx.rst')
| -rw-r--r-- | docs/build.osx.rst | 75 |
1 files changed, 43 insertions, 32 deletions
diff --git a/docs/build.osx.rst b/docs/build.osx.rst index 48836a7..7e145a5 100644 --- a/docs/build.osx.rst +++ b/docs/build.osx.rst @@ -1,7 +1,22 @@ osx build ============= -sign the release +Cheat-sheet +------------------ + +tl;dr: + +.. code:: bash + export RELEASE=yes + export OSXAPPPASS=my-apple-app-pass + make clean && make vendor && make build + make installer + make sign_installer + make notarize_installer + make notarize_staple + make create_dmg + +Sign the release ------------------- in recent osx releases, it's not ok to just sign the insallers anymore. you @@ -12,11 +27,10 @@ integration of this process in the more or less official Qt tools (QTIFW). First, we build the regular installer (use RELEASE=yes to do a codesign step with macqtdeploy, note that this increases build time considerably): -``` -make build -RELEASE=yes make installer -make sign_installer -``` +.. code:: bash + make build + RELEASE=yes make installer + make sign_installer Now we export the app-specific password and we proceed to notarization. If you don't know what is this pass, you can create one in your Apple developer @@ -36,40 +50,37 @@ reference to a keychain item, as shown in the previous example. This assumes the keychain holds a keychain item named AC_PASSWORD with an account value matching the username AC_USERNAME. -``` -export OSXAPPPASS=my-apple-app-pass -make notarize_installer -``` +.. code:: bash + + export OSXAPPPASS=my-apple-app-pass + make notarize_installer Between the output of the last command, you will get a Request UUID. You should pass that request uid in the appropriate environment variable to check the status of the notarization process. Obviously, since the recent changes in Apple policies, you need to be in posession of a valid membership -``` -altool[5281:91963] No errors uploading 'build/installer/RiseupVPN-installer-0.20.4-175-gee4eb90.zip'. -RequestUUID = fe9a4324-bdcb-4c52-b857-f089dc904695 - -OSXMORDORUID=fe9a4324-bdcb-4c52-b857-f089dc904695 make notarize_check -xcrun altool --notarization-info fe9a4324-bdcb-4c52-b857-f089dc904695 -u "info@leap.se" -p my-apple-app-pass -2020-12-11 22:21:59.940 altool[5787:96428] No errors getting notarization info. - - RequestUUID: fe9a4324-bdcb-4c52-b857-f089dc904695 - Date: 2020-12-11 21:13:10 +0000 - Status: success - LogFileURL: https://osxapps-ssl.itunes.apple.com/itunes-assets/Enigma114/v4/0f/c9/1e/0fc91e64-2c9f-74e5-3cf6-96b8f3bf7170/developer_log.json?accessKey=1607916119_6680812212684569509_nLlPw6tYxTSiWZfFTb0atP9zZ3CEGDfW0btWV51xhjWHiCFqBt%2BneXd5Vp40eQCSx8e1W5PYCIe2db7JGbhoTeJsYxl7UmYssRvYpTxYJl8z90uwB9jkbS1fsd7niaAn%2BQs7xHdv%2BB9jaKQI8LJ%2BwYY8RPq1QaeCJxBIdeG44DY%3D - Status Code: 0 -Status Message: Package Approved -``` +.. code:: bash + altool[5281:91963] No errors uploading 'build/installer/RiseupVPN-installer-0.20.4-175-gee4eb90.zip'. + RequestUUID = fe9a4324-bdcb-4c52-b857-f089dc904695 + + OSXMORDORUID=fe9a4324-bdcb-4c52-b857-f089dc904695 make notarize_check + xcrun altool --notarization-info fe9a4324-bdcb-4c52-b857-f089dc904695 -u "info@leap.se" -p my-apple-app-pass + 2020-12-11 22:21:59.940 altool[5787:96428] No errors getting notarization info. + + RequestUUID: fe9a4324-bdcb-4c52-b857-f089dc904695 + Date: 2020-12-11 21:13:10 +0000 + Status: success + LogFileURL: https://osxapps-ssl.itunes.apple.com/itunes-assets/Enigma114/v4/0f/c9/1e/0fc91e64-2c9f-74e5-3cf6-96b8f3bf7170/developer_log.json?accessKey=1607916119_6680812212684569509_nLlPw6tYxTSiWZfFTb0atP9zZ3CEGDfW0btWV51xhjWHiCFqBt%2BneXd5Vp40eQCSx8e1W5PYCIe2db7JGbhoTeJsYxl7UmYssRvYpTxYJl8z90uwB9jkbS1fsd7niaAn%2BQs7xHdv%2BB9jaKQI8LJ%2BwYY8RPq1QaeCJxBIdeG44DY%3D + Status Code: 0 + Status Message: Package Approved If everything is ok, now you can finish the process, stapling the notarization info and creating the dmg. -``` -make notarize_staple -make create_dmg -``` +.. code:: bash + make notarize_staple + make create_dmg If everything went well, you should have a .dmg for your release under the `deploy` folder. -``` -created: /Users/admin/leap/bitmask-vpn/deploy/RiseupVPN-0.20.4-175-gee4eb90.dmg -``` +.. code:: bash + created: /Users/admin/leap/bitmask-vpn/deploy/RiseupVPN-0.20.4-175-gee4eb90.dmg |