Getting Started with SubmitOps CLI

Introduction to the SubmitOps CLI

The SubmitOps CLI puts the power of iOS deployment automation at your fingertips. Designed for developers who love the command line, our CLI tool lets you manage app releases, metadata, and deployments with simple, intuitive commands.

Installation

npm install -g submitops

Once installed, you can verify the installation by running:

submitops --version

Initial Setup

First, authenticate with your Apple Developer account:

submitops auth login

The CLI will guide you through connecting your App Store Connect API credentials. For security, we recommend using API Keys rather than traditional username/password authentication.

Creating Your First Release

Initialize your project with the configuration wizard:

submitops init

This creates a `submitops.config.js` file in your project root where you can define your app's metadata, build settings, and release preferences.

Basic Release Commands

Submit a new version for review:

submitops release --version 1.2.0 --build-path ./build/YourApp.ipa

Check the status of your releases:

submitops status --app-id 1234567890

View detailed logs for a specific release:

submitops logs --release-id abc123

Advanced Features

CI/CD Integration

The CLI integrates seamlessly with popular CI/CD platforms. Here's an example GitHub Actions workflow:

name: Release to App Store
on:
  push:
    tags:
      - 'v*.*.*'
jobs:
  release:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Setup Node.js
        uses: actions/setup-node@v3
        with:
          node-version: '18'
      - name: Install SubmitOps
        run: npm install -g submitops
      - name: Submit to App Store
        run: submitops release --version ${{ github.ref_name }}

Best Practices

Follow these guidelines to maximize your CLI experience: