diff options
author | Ivan Komissarov <abbapoh@gmail.com> | 2021-02-25 12:16:43 +0100 |
---|---|---|
committer | Ivan Komissarov <ABBAPOH@gmail.com> | 2021-03-30 14:26:13 +0000 |
commit | 57fc1cf85bdec6928fc088729c99fb8720c7c804 (patch) | |
tree | b66262a273b0e208508f43cb3de249edb35f2813 | |
parent | 119ae17573193dc81969e954f2dde47172437fa9 (diff) | |
download | qbs-57fc1cf85bdec6928fc088729c99fb8720c7c804.tar.gz |
doc: Add how-to about signing for Apple platforms
Change-Id: Ic2f84fbe24a6980f6ac78201ca418aef83490fa2
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: Christian Kandeler <christian.kandeler@qt.io>
-rw-r--r-- | doc/howtos.qdoc | 43 |
1 files changed, 43 insertions, 0 deletions
diff --git a/doc/howtos.qdoc b/doc/howtos.qdoc index 72cac2357..47c1cafe8 100644 --- a/doc/howtos.qdoc +++ b/doc/howtos.qdoc @@ -54,6 +54,7 @@ \li \l{How do I define a reusable Group of files that can be included in other \QBS files?} \li \l{How do I print the value of a property?} \li \l{How do I debug \QBS scripts?} + \li \l{How do I sign an application for an Apple platform?} \endlist \section1 How do I build a Qt-based project? @@ -776,4 +777,46 @@ \code qbs status config:release \endcode + + \section1 How do I sign an application for an Apple platform? + + To sign an application for an Apple platform, you need to use the \l{codesign} module. + + \code + Depends { name: "codesign" } + \endcode + + Several properties should be set to do signing as shown below. + + Make sure that bundle and team indentifiers match the one used for signing: + + \code + bundle.identifierPrefix: "com.johndoe" + codesign.teamIdentifier: "John Doe" + \endcode + + It is also possible to use an ID of the team identifier instead of a name: + \code + codesign.teamIdentifier: "1234ABCDEF" + \endcode + + \QBS will then try to find the matching signing identity and provisioning profile based on + \l{codesign::signingType}{codesign.signingType}. + + It is also possible to specify \l{codesign::signingIdentity}{codesign.signingIdentity} + manually: + + \code + codesign.signingIdentity: "Apple Development: johndoe@apple.com (ABCDEF1234)" + \endcode + + It is also possible to use an ID of the signing identity instead of a name: + \code + codesign.signingIdentity: "ABCDEF1234567890ABCDEF1234567890ABCDEF12" + \endcode + + If \QBS cannot find the suitable provisioning profile, you can specify it manually as well: + \code + codesign.provisioningProfile: "abcdef12-1234-5678-1111-abcdef123456" + \endcode */ |