diff options
Diffstat (limited to 'doc/howtos.qdoc')
-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 */ |