💡
BETA mode. Your feedback is highly appreciated!

This is the official CLI (ta-cli) for TestApp.io app distribution to upload your Android (APK) and iOS (IPA) directly from this command line and notify your team members about the new releases if you enable it.

Latest version: v1.0.4 released on 27 Mar 2021

Installation

macOS & Linux

curl -Ls https://github.com/testappio/cli/releases/latest/download/install | bash

Windows

Currently, we are not supporting ta-cli config for Windows.

Download the latest windows release and unzip it

ta-cli.exe publish --api_token=[Your API Token] --app_id=[Your AppID] --release=android --apk=C:/path/to/app.apk

OR using the config json:

Create the config file in $HOME/.ta-cli.json or any other place and add the following:

You can use vim if installed vim $HOME/.ta-cli.json

{
  "api_token": "Your API Token",
  "app_id": "Your App ID",
  "release": "android",
  "apk": "/user/path/to/android/app.apk",
  "ipa": "",
  "release_notes": "",
  "git_release_notes": true,
  "git_commit_id": false,
  "archive_latest_release": false,
  "notify": true
}

From your terminal navigate to the extracted folder

ta-cli.exe publish

Direct command

Navigate to the latest releases and download the zip file relative to your OS to run the command ./ta-cli or ./ta-cli.exe directly without adding it to the OS binary folder.

Configuration

ta-cli config
Key Description Default
--config path to your ta-cli.json config file [Optional] $HOME/.ta-cli.json
--api_token You can get it from https://portal.testapp.io/settings/api-credentials
--app_id You can get it from your app page at https://portal.testapp.io/apps
--release It can be either both or Android or iOS
--apk_file Path to the Android APK file
--ipa_file Path to the iOS IPA file
--release_notes Manually add the release notes to be displayed for the testers
--git_release_notes Collect release notes from the latest git commit message to be displayed for the testers true
--git_commit_id Include the last commit ID in the release notes (works with both release notes options) false
--notify Send notifications to your team members about this release false
--archive_latest_release Automatically archive the current latest release upon successful upload false

The default configuration file will be at $HOME/.ta-cli.json

Publish

ta-cli publish

To override any value in the config:

ta-cli publish --release=android --release_notes="my release notes" --git_release_notes=true --git_commit_id=true

Config path

Default directories in the following order if exist:

  1. input path from --config=
  2. .ta-cli.json
  3. $HOME/.ta-cli.json
ta-cli publish --config=ta-cli.json

For more info about the list of options:

ta-cli publish -h

Feedback & Support

Developers built TestApp.io to solve the pain of app distribution for mobile app development teams.

Join our Slack channel for feedback and support.

Happy releasing 🎉