This article details the steps required to generate an iOS app using the Mobile output option in RoboHelp.
Note:
The article does not describe all the options in the Mobile App settings tab. For details on these options, see the Generate Mobile App output section in the RoboHelp online help documentation.
-
Digital certificate
Specify the Digital certificate.
For details on how to create a Digital certificate, see Create Digital certificate.
Certificate Password
Password of digital certificate.
For details, see Generate a certificate signing request.
Provisioning profile
This contains details of the registered testing device. Until the APP is not posted on the App store, it can be installed only on registered testing devices.
For details, see Generate provisioning profile (Mobile provision).
Once the app is generated scan the QR code on the registered device for testing. This will download and install the app on the device.
To create digital certificate you need a Apple developer ID. It has an annual cost. However, this cost is applicable only for creating an APP.
To Create Apple Developer ID go to My Apple ID.
After setting up your Apple developer account and ID, perform the following steps to create a digital certificate.
- Generate a certificate signing request (CSR): This can be created on Mac as well as Windows devices (with some installations). Though it is easier to create on Mac.
- Associate CSR with Apple ID on Apple developer site.
- Then Download Apple .cer file and convert it into digital certificate
-
Download and Install Visual C++ 2008 Redistributables files, listed on the Open SSL download page.
-
Create the private key by entering the following in the command line:
openssl genrsa -out <key file name> <encryption bit level>
For example, to create a private key name mykey with 2048 encryption bit level:
openssl genrsa -out mykey.key 2048
Note:
When using OpenSSL, do not ignore error messages. If OpenSSL generates an error message, it still generate a key file. However, this key file may not be usable. If you encounter any errors, check your syntax and run the command again.
-
Create the CSR file by entering the following in the command line:
openssl req -new -key mykey.key -out CertificateSigningRequest.certSigningRequest -subj "/emailAddress=<your email address>, CN=<certificate name>, C=<country code>"
For example, to create a CSR file with email myemail.@mydomain.com, certificate name My Certificate and country code US:
openssl req -new -key mykey.key -out CertificateSigningRequest.certSigningRequest -subj "/emailAddress=myemail.@mydomain.com, CN=My Certificate , C=US"
-
You will be prompted for a password.
Keep a note of this password. This is your certificate password that you will provide while generating the APP in RoboHelp. See step 4 in the procedure described above.
- Open Keychain Access. The Keychain Access application is in the Utilities subdirectory of the Applications directory.
- On the Keychain Access menu, select Preferences.
- In the Preferences dialog box, click Certificates.
- Set Online Certificate Status Protocol and Certificate Revocation List to Off. Close the dialog box.
- On the Keychain Access menu, select Certificate Assistant > Request a Certificate from a Certificate Authority.
- Enter the e-mail address and name that matches your iPhone developer account ID.
- Select Request is saved to Disk.
- Click the Continue button.
- Save the file (CertificateSigningRequest.certSigningRequest).
Upload the CSR file (created in previous step) on the Apple iPhone developer site. Click Certificates on the site.
In the following procedures (for Windows and iOS), you require the .cer file. You will receive this file from Apple in your e-mail provided in previous procedure as iPhone developer account ID.
-
You can now generate a valid P12 file, based on the key and the PEM version of the iPhone developer certificate:
openssl pkcs12 -export -inkey “mykey.key” -in -out
For example:
openssl pkcs12 -export -inkey mykey.key –in “C:\RHAPP\iOS_development.PEM” -out “C:\RHAPP\iOS_development.P12”
The mykey.key is created during the Generating Certificate signing request procedure described above.
- Open the Keychain Access application (in the Applications/Utilities folder).
- Select File > Import and navigate to the certificate file (the .cer file).
- Select the Keys category in Keychain Access.
- Select the private key associated with your iPhone Development Certificate.
- Command-click the iPhone Developer certificate and select, Export "iPhone Developer: Name...".
- Save your keystore in the Personal Information Exchange (.p12) file format.
- You will be prompted to create a password. Write down the password.
This is your certificate password that yuo will need to provide while generating the APP in RoboHelp.
- Go to the Apple Developer portal.
- Go to Device section. Under Manage tab, provide Device Name and Device ID (40 hex characters). To know your device id click this link.
- Go to the Apple Developer portal.
- Go to Provisioning section. Create a new profile under the Development tab.
- Fill the form with Profile Name (File name), Certificates (the .cer file created above), App ID and your development device.
Download the provision profile and keep it safe. To use for generating iOS Mobile APP. You need to specify this profile in step 4 of the Generate iOS Mobile output app in RoboHelp procedure.