Generating Kitcast .ipa file for In-House distribution

Step 0. Requirements

– Subscription for Apple Developer Program or Apple Enterprise Developer Program
Docker for MacGuide
Apple Configurator 2
Kitcast Builder
– USB-C cable or MDM provider

Step 1. Register your devices with Developer Portal (not required for Apple Enterprise Developer Program members)

  1. Obtain device UDID
    option A: Device is managed by MDM - follow your vendor instructions for obtaining UDID, no physical connection required.
    option B: Physical connection:
    a. Connect your device to your Mac via USB-C cable.
    b. Launch Apple Configurator and select your device.
    c. Copy UDID value.
  2. Follow Registering Individual Device guide.
  3. Repeat for any subsequent device, or optimize the process by registering multiple devices at once.

Step 2. Registering an App ID

  1. Sign in to developer.apple.com/account, and click Certificates, IDs & Profiles.
  2. Under Identifiers, select App IDs.
  3. Click the Add button (+) in the upper-right corner.
  4. Enter Kitcast in the name field.
  5. Select Explicit App ID and enter [your company prefix].tv.kitcast.app.player (e.g. acmeinc.tv.kitcast.app.player) into the Bundle ID field.
  6. Click Continue.
  7. Click Register.

Step 3. Generating a Distribution Certificate

  1. Sign in to developer.apple.com/account, and click Certificates, IDs & Profiles.
  2. Under Certificates, select Production.
  3. Click the Add button (+) in the upper-right corner.
  4. Apple Enterprise Developer Program Members:
    • Select Production > In-House and Ad Hoc.
  5. Apple Developer Program Members:
    • Select Production > App Store and Ad Hoc.
  6. Follow instructions on the page and save CSR file to disk, press Continue.
  7. Upload saved CSR file and press Continue.
  8. Download generated certificate and then double-click the .cer file to install in Keychain Access.
  9. Launch Keychain Access, select Certificates on the bottom-left menu.
  10. Locate a certificate named iPhone Distribution: Your Name (ABCDEFGHIJ), right-click and press Export.
  11. You’ll be using this file often, so pick an appropriate name and directory for storage.
  12. Click Save.
  13. Pick a password. Again, you’ll be using this password often, so make sure to remember it or keep it somewhere safe. If lost, you can regenerate .p12 file by going back to step 3.9.
  14. Click OK.

Step 4. Generating a Provisioning Profile

  1. Sign in to developer.apple.com/account, and click Certificates, IDs & Profiles.
  2. Under Provisioning Profiles, select Distribution.
  3. Click the Add button (+) in the upper-right corner.
  4. Apple Enterprise Developer Program Members:
    1. Select Distribution > tvOS In-House
    2. Select an App ID created on step 2, press Continue.
    3. Select a certificate created on step 3, press Continue.
    4. Pick an appropriate profile name, e.g. Kitcast In-House Distribution and enter it into the name field, press Continue.
  5. Apple Developer Program Members:
    1. Select Distribution > tvOS Ad Hoc.
    2. Select an App ID created on step 2, press Continue.
    3. Select a certificate created on step 3, press Continue.
    4. Click on Select All button.
    5. Pick an appropriate profile name, e.g. Kitcast Ad-Hoc Distribution and enter it into the name field, press Continue.
  6. Download generated provisioning profile and keep it near the certificate created in step 3. You’ll be needing this file often, too.

Step 5. Building an .ipa file

  1. Launch Kitcast Builder.
  2. Select Certificate created in step 3.
  3. Select Provisioning Profile created in step 4.
  4. Change Output Folder, if necessary.
  5. Click Download & Build.
  6. Enter your password for .p12 Certificate file.
  7. Wait for completion.
  8. Finder will open on your new, rebuilt .ipa.