KKodaGuide
Guide/Deploy your app

Shipping

Deploy your app

Connect Apple Developer, then turn the current Xcode project into a signed IPA, validate it with Apple, and upload it to App Store Connect.

01

Connect Apple Developer

Before you archive or upload, connect your Apple Developer account so Koda can talk to App Store Connect.

  1. 1

    Open Integrations in the sidebar. Expand Apple Developer and review Consent & Access.

    Integrations is where you connect Apple Developer. The card shows whether that account is connected.
  2. 2

    In App Store Connect, create a new API key with access to the apps Koda may upload.

  3. 3

    Copy the Issuer ID and Key ID into Koda.

    Expand Apple Developer to review Consent & Access, then enter Issuer ID, Key ID, and the .p8 private key before selecting Connect Apple Developer.
  4. 4

    Download the .p8 file once, open it in a text editor, and paste the entire private-key block.

  5. 5

    Select Connect Apple Developer. Koda checks the credentials and shows the connected state.

Good to knowTreat the .p8 contents like a password. Use Clear if the key is replaced or revoked.

02

Prepare

  • Open Deploy from the app’s rocket button and confirm the Selected app.
    Open Deploy from an app’s rocket button. Confirm the Selected app and that Apple Developer no longer shows Required.
  • Select a development team in the app’s settings.
  • Confirm the app exists in App Store Connect with the same Bundle ID. If it does not, Deploy shows the App name, Bundle ID, SKU, and language to use.
  • Make sure the app builds and runs in Koda’s simulator before archiving.
03

1. Archive and export IPA

  1. 1

    Open Deploy from the app card and confirm the Selected app.

  2. 2

    Choose the scheme and development team.

    Expand 1. Archive and export IPA to set the team, scheme, Bundle ID, version, and build number, then select Archive and Export IPA.
  3. 3

    Review Bundle ID, Version, and Build number. A new upload needs a higher build number.

  4. 4

    Optionally change the output directory.

  5. 5

    Select Archive and Export IPA and wait for both the Xcode archive and IPA export to finish.

04

2. Validate and upload

  1. 1

    Use the IPA path produced by Archive.

    Expand 2. Validate and upload to confirm the IPA path and App Store Connect values, then run Validate with App Store Connect before Upload to App Store Connect.
  2. 2

    Select Validate with App Store Connect first. Resolve any issue shown in the troubleshooting panel.

    When validation finishes cleanly, Koda shows Validation succeeded and turns the Validate button green. You can then upload.
  3. 3

    When validation succeeds, select Upload to App Store Connect.

    After Upload to App Store Connect succeeds, Koda shows Upload succeeded with delivery details. Finish TestFlight or App Store submission in App Store Connect.
  4. 4

    Open App Store Connect to finish metadata, screenshots, compliance questions, testing, and submission.

05

When something fails

  • Read What Xcode reported or What App Store Connect reported before retrying.
  • Follow the suggested How to fix it steps, then run the failed stage again.
  • Use Artifacts/Logs to open the output folder, copy paths, or inspect the full archive, validation, and upload logs.
    Artifacts/Logs shows where the archive, export folder, and IPA were written, plus buttons to open the archive, validation, and upload logs.