Certificate Management

Certificate management.

There is one important prerequisite for building an app Android or iOS binary file: your account should have at least one certificate file.

Certificate management can be accessed under the Resources > Certificates tab: this is where all of your certificates are stored:

12281228

🚧

Keeping Track of your Certificates

We strongly recommend that you store all of your certificates locally and don’t remove them for any reason.

To add certificates to your account, you can import or automatically generate them.

Importing Certificates

  1. Go to the Resources > Certificates tab:
12331233
  1. Click Import Certificates and select the platform you need.
  2. Then click Choose file and select the certificate file saved on your drive (should be prepared beforehand).
  3. Type your password for this certificate and click Import certificate:
  4. Once the file and platform are chosen, type the certificate name and its password. Click Import certificate to upload the file:
325325
  1. Make sure, you enter the correct password, otherwise you will get the Password verification failed message.

πŸ“˜

Important: iOS Certificates

More details on importing iOS certificates can be found here.

Generating Certificates

To generate a certificate for exporting your Appery.io project(s), first of all, select the platform you need to create the certificate for: iOS or Android and click Next:

12391239

For Android

Android certificates can be automatically generated in one step. To do so, after selecting Android, click Next. Type the certificate name and password, and then click Generate:

12391239

The generated certificate will be listed with all of the others:

12401240

The certificate can be set to use by default. That means that all applications will use this certificate if another isn’t specified in App settings. Check Default to make the certificate used by default.

πŸ“˜

Permissions

If you are a team member, the Team Admin or Team Lead should give you permission for this action.

You will get the Certificate Become Default message.

For iOS

πŸ‘

Before You Get Started

Before you can build an iOS binary, you need to sign up for the iOS Developer Program and provide all of the developer information and certificates below. If you are new to this, here is a good link to get you started: Managing Your Signing And Provisioning Assets. You also will need a Mac to submit the binary to the App Store.

iOS certificates can be automatically generated in three simple steps.

  1. In the first step, after selecting the iOS platform and clicking Next, click the button to download the Certificate Signing Request (CSR) file and then save it to your drive:
507507
  1. In the second step, the saved file will be exchanged for a certificate generated by Apple (.cer):
506506

πŸ‘

Important!

Note that you will be required to sign up for the iOS Developer Program.
You check out more details here.

So, to exchange the downloaded CSR file for an Apple certificate (.cer):

927927
  • Select Apple Development or Apple Distribution:
18731873

πŸ‘

Release and Publish Builds

Note that the Apple Distribution certificate type must be selected if you are generating the certificate for the Release and Publish build type:

13631363
  • Select the CSR file you just downloaded:
12121212
  • Download the generated Apple certificate and save it to your drive:
12221222
  1. In the third step, to generate an iOS certificate, go back to the App Builder Resources tab and choose the saved Apple certificate (.cer).
    Then, provide a name for your certificate, enter the password and click Generate:
507507

The generated certificate will be listed with all of the others:

12371237

Managing Certificates

Android Certificates

  1. Type a new name for the certificate, and click Apply to change the certificate name. By clicking Export, the certificate will be downloaded to your desktop.
  2. By clicking Export to zip the certificate will be downloaded as a ZIP archive. The archive will also contain additional text files with certificate passwords. Click Delete to remove the certificate.

Once the certificates are uploaded, they can be chosen from the application settings. To choose a certificate for Android binary, go to App settings > Android binary, scroll down and choose a certificate: AndroidBinaryDefault.

When [use default] is selected, the certificate marked as the default in the Certificates tab will be used:

12801280

πŸ“˜

Android Certificate File

More information about Android certificate files can be found here.

In the same way, certificates can be set for all binaries.

πŸ“˜

Error Message

If you delete a certificate that’s used in any application, you’ll get an error.

iOS Certificates

  1. Switch to the iOS Binary tab in the App Settings and scroll down to select the needed certificate:
12741274
  1. After registering with Apple as a developer you can get provisioning profile files or generate them. In the App Builder, click Change to open the Files Manager (Step 1).
  2. Upload your file(s) (Step 2).

🚧

At least one certificate must be provided to build a certain binary.
Otherwise, when exporting this binary in the builder you will get an error.

  1. Select it (Step 3).
  2. Click Apply (Step 4):
12381238