Skip to main content

Publish your iOS app

To begin, create a developer account (it's free), then submit a new app.

Upload your IPA​

Requirements​

When you upload an IPA, it must meet the Rootpk Store's requirements:

  • A maximum size of 200MB (contact us for a size increase).
  • Target iOS 16 or higher.

Manual upload​

curl https://api.rootpk.com/ipa/upload \
  -F appId=YOUR_APP_ID \
  -F secretKey=YOUR_APP_SECRET_KEY \
  -F file=@path/to/example.ipa
note

The @ character after file= is mandatory.

Automatic upload using GitHub Actions​

Follow these steps to automate the process of uploading an IPA using GitHub Actions:

Step 1 - Setup the GitHub Action in your repository​

.github/workflows/rootpk-ios.yml
name: Upload IPA to the Rootpk Store

on:
  release:
    types: [published]

jobs:
  upload:
    name: Upload
    runs-on: ubuntu-latest
    steps:
      - name: Download release assets
        uses: robinraju/release-downloader@efa4cd07bd0195e6cc65e9e30c251b49ce4d3e51 # v1.8
        with:
          repository: "{owner}/{repo}" # Replace with your repository's owner and name
          latest: true
          fileName: "myapp.ipa" # Replace with your IPA's filename
          out-file-path: "assets"
          #token: ${{ secrets.GITHUB_TOKEN }} # Required if your repo is private
      - name: Upload IPA to the Rootpk Store
        working-directory: ./assets/
        env:
          ROOTPK_APP_ID: ${{ secrets.ROOTPK_APP_ID }}
          ROOTPK_APP_SECRET_KEY: ${{ secrets.ROOTPK_APP_SECRET_KEY }}
        run: |
          curl https://api.rootpk.com/ipa/upload \
            -F appId="$ROOTPK_APP_ID" \
            -F secretKey="$ROOTPK_APP_SECRET_KEY" \
            -F file=@myapp.ipa # Make sure this matches your IPA's filename
note

The @ character after file= is mandatory.

GitHub automatically creates a GITHUB_TOKEN secret for you to use in your workflow, so you don't need to set it up manually.

Step 2 - Configure the repository secrets​

Create two repository secrets: ROOTPK_APP_ID and ROOTPK_APP_SECRET_KEY. You can follow the GitHub documentation on creating encrypted secrets for a repository to set them up.

Step 3 - Create a release​

Create a release by following the GitHub documentation on creating a release. Remember to attach your IPA with the release.

After clicking "Publish release," the workflow will be triggered, and your IPA should be automatically uploaded to the Rootpk Store. 🎉