Scirocco Cloud APIの使い方とCI連携

APIキーを取得

1. Scirocco CloudにログインしてAPIキー画面を開きます。
2. 「APIキーを生成」ボタンを押下して、APIキーを作成します。

テスト対象のプロジェクトのID(project_id)を調べる

1. Scirocco API > projects > GET /api/v1/projectsを開きます。
2. api_keyを指定して「Try it out!」 ボタンを押下すると、プロジェクトの一覧が表示されます。

テスト対象のクラスのID(test_class_id)を調べる

1. Scirocco API > tests > GET /api/v1/testsを開きます。
2. api_key,project_idを指定して「Try it out!」 ボタンを押下すると、テストクラスの一覧が表示されます。

Jenkinsからapkのアップロードとテストの実行をする

Jenkinsサーバの用意

• サーバにJenkinsをインストールします。
• 上記のサーバにscirocco-rbをインストールします。

$ gem install scirocco -v 0.1.4

Jenkinsの設定

• Jenkinsで新規のジョブを作成(フリースタイル・プロジェクトのビルド)
• ビルド手順の追加 > シェルの実行
• 「シェルスクリプト」欄に以下のように入力します

# Configuration
API_KEY=XXXXX
PROJECT_ID=XXX
APP_PATH=./MainActivity.apk
TEST_CLASS_ID=XXX

# Set available device id
DEVICE_ID=`scirocco get_device_id --project-id=$PROJECT_ID --status=available --api-key=$API_KEY`
if [ -n "$DEVICE_ID" ]; then
  # When available device is not found, set not available device id
  DEVICE_ID=`scirocco get_device_id --project-id=$PROJECT_ID --api-key=$API_KEY`
fi

# Upload apk
scirocco upload_app --project-id=$PROJECT_ID --app-path=$APP_PATH --api-key=$API_KEY

# Get device_id
scirocco get_device_id --project-id=$PROJECT_ID --status=available --api-key=$API_KEY

# Do the test
scirocco run_test --test-class-id=$TEST_CLASS_ID --device-id=$DEVICE_ID --poll --api-key=$API_KEY

• 設定を保存します。
• ビルドの実行を行い、コンソール出力で結果を確認してください。