Menu

Generating Kitcast .ipa file for In-House distribution

How to Generate Kitcast .ipa for In-House Distribution

Step 0. Requirements

– Subscription for Apple Developer Program or Apple Enterprise Developer Program
Xcode 11.3 or newer
– 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.

That’s it. Later you’ll need to download this certificate via Xcode

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.

Step 5. Downloading your certificates with Xcode

  1. Launch Xcode. We recommend you to stay on the latest and most up-to-date version of it.
  2. Go to Xcode Preferences from the Main Menu.
  3. Select the Accounts tab from the Preferences.
  4. Make sure you’ve logged in with the Apple ID you’ve used to generate certificates.
  5. Click Download Manual Profiles.

Step 6. Building an .ipa file

  1. Launch Kitcast Builder.
  2. Select Certificate created in step 3 from the drop-down list.
  3. Select Provisioning Profile created in step 4 from the drop-down list.
  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.

Congratulations on your Kitcast build that is ready for distribution!