Upload an app using CircleCI

Learn how to upload an app to your app repository using CircleCI.

For more information, see Official Orb Registry for Kobiton.

Before you start

You’ll need to complete the following:

Optional: add the Kobiton orb

If you haven’t already, you’ll need to add the Kobiton orb to your circleci/config.yml. In the terminal, open your project.

Example

cd ~/my-project

Open circleci/config.yml in a text editor.

Example

nano ./circleci/config.yml

Set CircleCI to version 2.1 at the top of the file.

version: 2.1

Add Kobiton to your list of orbs.

orbs:
    kobiton: kobiton/kobiton@1.1.0

Create a workflow

CircleCI workflows can be used to create a complex set of jobs, commands, and steps that enable you to leverage continuous integration in your project. You can order the jobs and commands in your CircleCI workflow in a variety of ways. Use the following table to create your workflow, then save your circleci/config.yml file:

PARAMETER DESCRIPTION REQUIRED DEFAULT TYPE

PARAMETER	DESCRIPTION	REQUIRED	DEFAULT	TYPE
`KOBITON_API_KEY`	Specific key to access Kobiton API (required as env variable in project settings)	No	`KOBITON_API_KEY`	`env_var_name`
`KOBITON_APP_ACCESS`	You can either make this app private or available for everyone in the organization (private vs. public)	No	`public`	`enum`
`KOBITON_APP_ID`	App ID in Kobiton - use this in case you want to upload a new version of an existing app in Kobiton (optional)	No	`''`	`string`
`KOBITON_APP_NAME`	Title of the app to be built (optional)	No	`demo-app`	`string`
`KOBITON_APP_PATH`	Path to the app .apk or .ipa file (should be in the same repo and start with ../ for example: ../test.apk) (required as parameter in config file)	Yes	`-`	`string`
`KOBITON_APP_TYPE`	Type of the app to be uploaded - Android (apk) or iOS (ipa)	No	`apk`	`enum`
`KOBITON_USERNAME`	The user to upload to Kobiton (required as env variable in project settings)	No	`KOBITON_USERNAME`	`env_var_name`

KOBITON_API_KEY

Specific key to access Kobiton API (required as env variable in project settings)

KOBITON_API_KEY

env_var_name

KOBITON_APP_ACCESS

You can either make this app private or available for everyone in the organization (private vs. public)

public

enum

KOBITON_APP_ID

App ID in Kobiton - use this in case you want to upload a new version of an existing app in Kobiton (optional)

''

string

KOBITON_APP_NAME

Title of the app to be built (optional)

demo-app

string

KOBITON_APP_PATH

Path to the app .apk or .ipa file (should be in the same repo and start with ../ for example: ../test.apk) (required as parameter in config file)

Yes

-

string

KOBITON_APP_TYPE

Type of the app to be uploaded - Android (apk) or iOS (ipa)

apk

enum

KOBITON_USERNAME

The user to upload to Kobiton (required as env variable in project settings)

KOBITON_USERNAME

env_var_name

Example

The following workflow uploads a new .apk and .ipa for an existing app, with the .apk set to public and the .ipa is set to private:

version: '2.1'
orbs:
  kobiton: kobiton/kobiton@<version>
workflows:
  main:
    jobs:
      - kobiton/upload-app:
          KOBITON_APP_PATH: ../test.apk
      - kobiton/upload-app:
          KOBITON_APP_ACCESS: public
          KOBITON_APP_ID: '275643'
          KOBITON_APP_NAME: android-app
          KOBITON_APP_PATH: ../demo/android-test.apk
      - kobiton/upload-app:
          KOBITON_APP_ACCESS: private
          KOBITON_APP_NAME: ios-app
          KOBITON_APP_PATH: ../demo/ios-test.ipa
          KOBITON_APP_TYPE: ipa