Preparing an iOS project for Buildozer

Make sure your workspace is set up for ad hoc builds

If you want to use Buildozer to automatically build apps, your Xcode project may need a couple of changes:

  • Make sure your scheme is shared. Go to 'manage schemes' in Xcode and tick the box 'shared' next to your scheme. This will generate xcscheme files on disk that you will have to add to your repository. 
  • Make sure you have at least one configuration that has 'iOS Distribution' as its signing identity in build settings. You can use the default 'release' configuration but we recommend to create a duplicate called 'distribution'.

Getting a signing certificate 

  • Open your Keychain app and go to My Certificates.
  • Find your signing certificate (it's usually called "iOS Distribution: <your company name>"). If you don't have one you may need to ask your team agent. 
  • Open it by clicking the little +, so that you can see both the certificate and your key.
  • Select both feet and key, right click and select 'export'
  • Choose a password to protect the exported file and remember where you stored the file. When setting up the project in Buildozer you are going to need this file.

Getting an ad hoc provisioning profile

If you don't already have an ad hoc provisioning profile, follow these steps:

  • Log in to the member center section of
  • In the provisioning profile section, click the '+' button to add a new one
  • Select 'ad hoc' as type and press 'continue' 
  • Select your app ID from the drop down and tap 'continue' 
  • Select the same certificate as in the previous paragraph (the expiration date should be the same)
  • The name of the profile is arbitrary but it's a best practice to name it 'YourApp Ad Hoc' so it's clear this is an ad hoc profile
  • Download the file and remember where you stored it. 


Have more questions? Submit a request


Please sign in to leave a comment.