概要

Appium は、スマホやタブレットのテスト自動化を実現するためのテストフレームワークのひとつです。以前より Remote TestKit では仮想 ADB 機能や Xcode 連携機能 (Xcode connector) を用いることで、ローカル PC 上に構築された Appium 環境を用いたテスト自動化が可能でした。新しく、 Remote TestKit Appium Cloud により、 Appium サーバ環境を構築することなく簡便に Appium のテストスクリプトを実行することが可能となり、 CI 環境との連携も容易に実現することが可能となりました。
※ Remote TestKit Appium Cloud は、 Flat 3以上のプランをご契約しているお客様のみご利用いただけます。

Remote TestKit がサポートする Appium 連携について

■Remote TestKit を用いない場合の Appium 環境

Appium によるテスト自動化を行うためには、一般的には図に示すように、 Appium を動作させるローカル PC 内に Node.js や Appium Server などの実行環境を整えた上で、テストスクリプトを作成してスクリプトを実行させる必要がありました。またテストスクリプトで用いる端末もローカル PC に接続された実機端末のみが対象となり、 Android / iOS シミュレータを用いらざるを得ないケースも多々ありました。

■Remote TestKit の仮想 adb 機能 / Xcode 連携を用いた Appium 環境

Remote TestKit では、従来より仮想 ADB 機能や Xcode 連携機能 (Xcode connector) を用いることで、クラウド上の端末を用いた Appium 環境を構築することが可能です。この構成では低レイヤーでクラウド上の端末と連携するため、 Appium 以外のテストフレームワークとの連携が可能というメリットがあります。
※ iOS 端末においては Xcode を用いたデバッグで一部機能制限があります。

■Remote TestKit Appium Cloud を用いた Appium 環境

Remote TestKit Appium Cloud を利用することで、 Appium を用いたテスト自動化においてはユーザがテストスクリプトさえ用意すれば、 Node.js や Appium server 等の実行環境を整えることなく動作可能となりました。また、本機能を用いることで社内外の CI 環境との連携も容易に実現することが可能となり、本来業務としてのテストスクリプトの開発に集中することができます。新機能を用いた Appium 環境は図のとおりです。
※現時点では Android 4.4 以上または iOS 10.3 以上の端末に対応
※ Remote TestKit Appium Cloud は、 Flat 3以上のプランをご契約しているお客様のみご利用いただけます。

各種 Appium 環境との比較

前述した3つの環境についての比較は下記表のとおりとなります。

解決される課題

テスト自動化に取り組まれている企業で課題となるのが CI（継続的インテグレーション）での実機検証です。市中の CI サービスは海外のサービスが多く、端末ラインナップも海外端末がほとんどです。一方、 Jenkins 等を用いて自社内に CI 環境を構築する場合は、実機検証環境を用意し運用することは大変です。今回リリースされる Remote TestKit の新しい Appium 機能を用いることで、 CI 環境から実機検証を比較的容易に実現することが可能となります。

Remote TestKit Appium Cloud を用いた Appium 連携の手順

基本的には、ローカル PC 上の Appium 環境で動かしているテストスクリプトの Capabilities の設定を変更するだけで、 Appium 自動テストクラウドをご利用いただけます。以下、 Python 言語によるテストスクリプトの例を挙げながら説明いたします。まずはじめに、 Python が実行可能なPCを準備してください。

Appium Client ライブラリのインストール

Appium Client ライブラリを下記の手順でインストールします。

pip install Appium-Python-Client

接続先の説明

Appium クライアント（テストスクリプト）の接続先として、通常ローカル PC 上で実行しているときに "http://localhost:4723/wd/hub" としている部分を "https://gwjp.appkitbox.com/wd/hub" に変更します。

・python でのコード例

caps = {
    ...
}
options = AppiumOptions()
for k in caps:
    options.set_capability(k, caps[k])
self.driver = webdriver.Remote(
    # 'http://localhost:4723/wd/hub', options=options
    "https://gwjp.appkitbox.com/wd/hub", options=options
)

ユーザ認証

Appium クライアントの接続時の認証には、 Remote TestKit のユーザ名・パスワードを Capabilities に指定するか、アクセストークンを Capabilities に指定します。アクセストークンはソフトウェア版のメニューから生成することが可能です。

・Python でのコード例（ユーザ名・パスワード認証の場合）

caps = {
    ...
    'userName': 'Remote TestKit のユーザ名',
    'password': 'Remote TestKit のパスワード',
    ...
}

・Python でのコード例（アクセストークン認証の場合）

caps = {
    ...
    'accessToken': 'Remote TestKit のアクセストークン',
    ...
}

・アクセストークンの取得方法

ソフトウェア版のメニューから生成することが可能です。ソフトウェア版の右上メニューからアクセストークン設定をクリックすることで、アクセストークンを取得することができます。アクセストークンを再生成する場合は、再生成ボタンをクリックしてください。

Appium のバージョン指定

Android 端末に対しては、指定可能な Appium のバージョンは以下のとおりです。

1.7.2, 1.8.0, 1.8.1, 1.9.0, 1.9.1, 1.10.0, 1.10.1, 1.11.0, 1.11.1, 1.12.0, 1.12.1, 1.13.0, 1.14.0, 1.14.2, 1.15.1, 1.16.0, 1.17.0, 1.17.1, 1.18.0, 1.18.1, 1.18.2, 1.18.3, 1.19.0, 1.19.1, 1.20.0, 1.20.1, 1.20.2, 1.21.0, 1.22.0, 1.22.1, 1.22.2, 1.22.3, 2.0.0, 2.0.1, 2.1.3, 2.2.2, 2.3.0, 2.4.1, 2.5.0, 2.5.1, 2.5.4, 2.6.0, 2.7.0, 2.8.0, 2.9.0, 2.10.1, 2.10.2, 2.10.3, 2.11.0, 2.11.1, 2.11.2

iOS 端末は詳細なバージョン指定をすることが出来ません。iOS 端末が接続されているサーバで設定された Appium のバージョンに依存した、固定のバージョンとなります。iOSのバージョンにより1.xと2.xのバージョンを上記Capabilitiesで指定することで切り替えることが可能です。

端末指定

「機種名のみ」「機種名 & バージョン」の二種類の方法で、 Appium を実行する端末を指定できます。機種名には正規表現も指定することができます。指定する端末は、 Web クライアントや PC クライアントで確認します。

機種名のみで指定する場合

下記の Capabilities を指定します。

・Python でのコード例（Pixel 7を指定）

caps = {
    ...
    platformName: 'Android',
    deviceName: 'Pixel 7',
    ...
}

機種名 & バージョンで指定する場合

下記の Capabilities を指定します。機種名で絞り込んだ後、バージョンやデバイス ID で判定されて、端末が決定されます。

・Python でのコード例（Pixel 9 の version 15 を指定）

caps = {
    ...
    'platformName': 'Android',
    'deviceName': 'Pixel 9',
    'platformVersion': '15',
    ...
}

・Python でのコード例（iPhone 16 の version 18 とデバイスID を指定）

caps = {
    ...
    'platformName': 'iOS',
    'deviceName': 'iPhone 16',
    'platformVersion': '18',
    'udid': 'XXXXXXXX',
    ...
}

アプリのインストール

方法1. 自社サーバーからインストール

Remote TestKit からアクセス可能なお客様ご自身の公開サーバ等に apk または ipa をアップロードして、下記の Capabilities を指定します。※ 必要に応じて、社内の Firewall 等の設定に Remote TestKit からのアクセス許可設定を追加してください。アクセス元 IP アドレスは FAQ に記載があります。

・Python でのコード例

caps = {
    ...
    'app': 'https://github.com/remotetestkit/sample-code/raw/master/appium/apk/RTKappium.apk',
    ...
}

方法2. Remote TestKit の共有ストレージからインストール

Remote TestKit のクライアント版にログインして、メニュ－よりアプリストレージ機能を使って apk または ipa をアップロードした後に、下記の Capabilities を指定してください。

・Python でのコード例

caps = {
    ...
    'app': 'RTKappium.apk',
    ...
}

自動再署名機能の指定

ipa をインストールする際、自動再署名が行われます。必要に応じて下記の Capabilities を指定していただく事で、自動再署名を OFF にできます。

・Python でのコード例

caps = {
    ...
    'resigningEnabled': True,
    ...
}

実行中の画面の確認

Appium サーバに接続後に画面を取得するための snapshotUrl および screenUrl が発行されます。 capability を使って snapshotUrl または screenUrl を取得しブラウザで開くことで、現在実行中の画面が閲覧可能です。 snapshotUrl はワンショットで静止画像を取得する機能に対して、 screenUrl は定期的に静止画像が更新され動画風に画面を確認できる機能となっております。プログラム内から画像を取得する場合には snapshotUrl 機能を用い、ブラウザで確認する場合には screenUrl 機能を用いると便利です。

・Pythonでのコード例

snapshotUrl = self.driver.capabilities['snapshotUrl']

実行中の Appium 実行ログの確認

Appium サーバの実行ログを取得するためには、ログレベルを Capabilities に指定し、 capability を使って serverLogUrl を取得してブラウザ等で開いてください。取得可能な Appium ログはセッションを開始してから取得時までのすべてのログとなり、最終出力（通常はセッション終了ログ）から10分間、取得可能です。

・Python でのコード例

caps = {
    ...
    'logLevel': 'info',
    ...
}

serverLogUrl = @driver.capabilities['serverLogUrl']

Appium セッションの強制削除

Appium のテストケースを実行時にエラーが発生するなどした際、クライアントが強制終了するなどで正常にセッションの削除が実行されないとセッションが残りますが、同一の端末指定条件で再度テストを行えば、セッションを上書きして再度同一端末でテストを実行することが可能です。ただし、この場合はセッションが上書きされるため、同一ケーパビリティで複数端末を同時にテストすることができません。複数端末を同時にテストしたい場合には、 "noSessionOverwriting" ケーパビリティに True (真偽値)を指定してください。これにより、 Appium Cloud のセッションで利用中の端末が端末選択からスキップされて、セッションが上書きされないようになります。

・Python でのコード例

caps = {
    ...
    'noSessionOverwriting': True,
    ...
}

端末レンタルの自動返却

指定の時間 Appium サーバ経由で同一端末にアクセスがない場合には、自動返却が行われます。指定が無い場合、10分後に自動返却されます。

・Python でのコード例

caps = {
    ...
    'deviceKeepingTimeout': 15 * 60 * 1000,
    ...
}

端末レンタルの自動延長

レンタル残り時間が10分未満になった場合に、 Appium サーバ経由で同一端末にアクセスがあれば、自動的に30分間のレンタル自動延長が行われます。

端末レンタルの強制返却

端末は利用がないと自動返却されますが、すぐに別の端末で自動検証を行いたいときには強制的に端末を返却することが可能です。テストコードを実行中に returnDeviceUrl が発行されます。 capability を使って returnDeviceUrl を取得し、テストコードの中で該当 URL へアクセスすることで強制的に端末を返却できます。

・Python でのコード例

returnDeviceUrl = self.driver.capabilities['returnDeviceUrl']
exec_command = 'curl ' + returnDeviceUrl
subprocess.Popen(exec_command, shell=True)

最新の Chrome Driver での実行

最新の Chrome Driver で動作しない場合は、 Capability に下記設定を追記する必要があります。

・Python での設定例の抜粋

caps = {
    ...
    'chromeOptions': {'w3c': False},
    ...
}

サンプルコード

Google 検索を行う Python のテストスクリプト

以下のスクリプトを test.py 等の名前でローカル PC に保存してください。

import os
import sys
import unittest

from time import sleep
from appium import webdriver
from selenium.webdriver.common.by import By
from appium.options.common import AppiumOptions
import warnings

# get userName, password from Environment variable
RTK_USERNAME = os.environ.get('RTK_USERNAME')
RTK_PASSWORD = os.environ.get('RTK_PASSWORD')
if not RTK_USERNAME or not RTK_PASSWORD:
    print("Environment variable error")
    sys.exit()


class OpenUrlTest(unittest.TestCase):
    def setUp(self):
        caps = {
            'userName': RTK_USERNAME,
            'password': RTK_PASSWORD,
            'deviceName': 'Pixel',
            'platformName': 'Android',
            'browserName': 'Chrome',
            'appiumVersion': '2.11.2',
            'automationName': 'UiAutomator2',
            'chromeOptions': {'w3c': False}
        }
        warnings.filterwarnings("ignore", category=DeprecationWarning)
        options = AppiumOptions()
        for k in caps:
            options.set_capability(k, caps[k])
        self.driver = webdriver.Remote(
            "https://gwjp.appkitbox.com/wd/hub", options=options
        )
        print(self.driver)

    def tearDown(self):
        self.driver.quit()

    def test_google_search(self):
        print(self.driver.capabilities['snapshotUrl'])
        # Open URL
        url = "https://www.google.com/"
        print("Open URL: " + url)
        self.driver.get(url)
        element = self.driver.find_element(By.CSS_SELECTOR, 'textarea')
        sleep(5)
        self.driver.save_screenshot('capture_01.png')

        # Input keys
        word = "Remote testKit"
        print("Input Keys: " + word)
        element.send_keys(word)
        element.submit
        sleep(5)
        self.driver.save_screenshot('capture_02.png')

        # Get value
        value = self.driver.find_element(By.CSS_SELECTOR, 'textarea').get_attribute('value')
        print("Text field value=" + value)
        self.assertEqual(value, "Remote testKit")


if __name__ == '__main__':
    suite = unittest.TestLoader().loadTestsFromTestCase(OpenUrlTest)
    unittest.TextTestRunner(verbosity=2).run(suite)

iPhone 端末で電卓で計算を行う Python のテストスクリプト

以下のスクリプトを test.py 等の名前でローカル PC に保存してください。

import os
import sys
import unittest

from appium import webdriver
from appium.webdriver.common.appiumby import AppiumBy
from appium.options.common import AppiumOptions
import warnings

# get userName, password from Environment variable
RTK_USERNAME = os.environ.get('RTK_USERNAME')
RTK_PASSWORD = os.environ.get('RTK_PASSWORD')
if not RTK_USERNAME or not RTK_PASSWORD:
    print("Environment variable error")
    sys.exit()


class OpenUrlTest(unittest.TestCase):
    def setUp(self):
        caps = {
            'userName': RTK_USERNAME,
            'password': RTK_PASSWORD,
            'logLevel': 'info',
            'platformName': 'iOS',
            'deviceName': 'iPhone 7.*',
            'platformVersion': '12',
            'bundleId': 'com.apple.calculator',
            'automationName': 'XCUITest'
        }
        warnings.filterwarnings("ignore", category=DeprecationWarning)
        options = AppiumOptions()
        for k in caps:
            options.set_capability(k, caps[k])
        self.driver = webdriver.Remote(
            "https://gwjp.appkitbox.com/wd/hub", options=options
        )
        print(self.driver)

    def tearDown(self):
        self.driver.quit()

    def test_calculator(self):
        print(self.driver.capabilities['snapshotUrl'])

        driver = self.driver
        self.driver.save_screenshot('capture_01.png')

        el1 = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "1")
        el1.click()
        self.driver.save_screenshot('capture_02.png')

        is_lang_english = True
        try:
            el2 = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "multiply")
            el2.click()
        except Exception:
            is_lang_english = False
            el2 = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "乗算")
            el2.click()
        self.driver.save_screenshot('capture_03.png')

        el3 = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "3")
        el3.click()
        self.driver.save_screenshot('capture_04.png')

        el2.click()
        self.driver.save_screenshot('capture_05.png')

        el3.click()
        self.driver.save_screenshot('capture_06.png')

        if is_lang_english:
            el4 = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "equals")
            el4.click()
            self.driver.save_screenshot('capture_07.png')

            el5 = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "Result")
            value = el5.get_attribute('value')

            print("Text field value=" + value)
            self.assertEqual(value, "9")

            el6 = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "clear")
            el6.click()
            self.driver.save_screenshot('capture_08.png')
        else:
            el4 = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "計算実行")
            el4.click()
            self.driver.save_screenshot('capture_07.png')

            el5 = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "結果")
            value = el5.get_attribute('value')

            print("Text field value=" + value)
            self.assertEqual(value, "9")

            el6 = driver.find_element(AppiumBy.ACCESSIBILITY_ID, "消去")
            el6.click()
            self.driver.save_screenshot('capture_08.png')


if __name__ == '__main__':
    suite = unittest.TestLoader().loadTestsFromTestCase(OpenUrlTest)
    unittest.TextTestRunner(verbosity=2).run(suite)

本テストスクリプトを実行するに当たり、環境変数に Remote TestKit のユーザ名、パスワードを設定します。ターミナルより以下を実行します。

export RTK_USERNAME=xxxx
export RTK_PASSWORD=xxxx

Proxy を通して Appium Cloud に接続したい場合

Proxy 対応はテストスクリプトを記述するライブラリによってサポートの有無が異なります。
例えば Python は標準で Proxy 対応のサポートがないため、以下のように MonkeyPatch を利用します。
サンプルコード内の PROXY_URL はご自身の環境に合わせて設定してください。

import os
import sys
import unittest
from time import sleep
from appium import webdriver
from selenium.webdriver.common.by import By
from appium.options.common import AppiumOptions

# ------------------------------------------------------------------------------------------
# The original selenium.webdriver.remote.remote_connection is not implemented to access
# the endpoint via proxy. So We wrote a monkey patch for the proxy.
import certifi
import urllib3
from selenium.webdriver.remote.remote_connection import RemoteConnection

RemoteConnection.__org__init__ = RemoteConnection.__init__


def patch_init(self, remote_server_addr, keep_alive=False, ignore_proxy=False):
    print("\nMonkey patch version: selenium.webdriver.remote.remote_connection")
    RemoteConnection.__org__init__(self, remote_server_addr, keep_alive=keep_alive, ignore_proxy=ignore_proxy)

    if keep_alive:
        # Define proxy. Default value is squid port.
        PROXY_URL = "http://localhost:3128"
        self._conn = urllib3.ProxyManager(proxy_url=PROXY_URL, timeout=self._timeout)

        # If basic authentication is required, uncomment the following and define it.
        # headers = urllib3.util.make_headers(proxy_basic_auth="userid:password")
        # self._conn = urllib3.ProxyManager(
        #     proxy_url=PROXY_URL, proxy_headers=headers, cert_reqs='CERT_REQUIRED', ca_certs=certifi.where())


RemoteConnection.__init__ = patch_init
# ------------------------------------------------------------------------------------------

# Specify userName, password to Environment variable
RTK_ACCESSTOKEN = os.environ.get('RTK_ACCESSTOKEN')

if not RTK_ACCESSTOKEN:
    print("Environment variable error")
    sys.exit()


class OpenUrlTest(unittest.TestCase):
    def setUp(self):
        caps = {
            'accessToken': RTK_ACCESSTOKEN,
            'deviceName': 'Pixel',
            'platformName': 'Android',
            'browserName': 'Chrome',
            'appiumVersion': '1.22.3',
            'automationName': 'UiAutomator2',
            'chromeOptions': {'w3c': False}
        }
        # Specify the endpoint
        options = AppiumOptions()
        for k in caps:
            options.set_capability(k, caps[k])
        self.driver = webdriver.Remote(
            "https://gwjp.appkitbox.com/wd/hub", options=options
        )
        print(f"command_executor={self.driver.command_executor}")
        print(f"proxy={self.driver.command_executor._conn.proxy}")

    def tearDown(self):
        self.driver.quit()

    def test_google_search(self):
        # print(self.driver.capabilities['snapshotUrl'])
        # Open URL
        url = "https://www.google.com/"
        print("Open URL: " + url)
        self.driver.get(url)
        element = self.driver.find_element(By.CSS_SELECTOR, 'textarea')
        sleep(5)
        self.driver.save_screenshot('capture_01.png')

        # Input keys
        word = "Remote testKit"
        print("Input Keys: " + word)
        element.send_keys(word)
        element.submit
        sleep(5)
        self.driver.save_screenshot('capture_02.png')

        # Get value
        value = self.driver.find_element(By.CSS_SELECTOR, 'textarea').get_attribute('value')
        print("Text field value=" + value)
        self.assertEqual(value, "Remote testKit")


if __name__ == '__main__':
    suite = unittest.TestLoader().loadTestsFromTestCase(OpenUrlTest)
    unittest.TextTestRunner(verbosity=2).run(suite)

Rest API

API を使った共有ストレージへのアプリのアップロード

Remote TestKit にはアプリストレージ機能というものがあります。これは、 PC クライアントのメニューからアプリケーションファイルをストレージへアップロードする機能です。
このメニューの代替として、 REST API を使ってコマンドラインからストレージへアプリをアップロードすることもできます。 CI 環境の利用を前提としたお客様などに便利な機能です。

概要

API を使って apk / ipa ファイルを Remote TestKit のストレージにアップロードする。

URL

https://gwjp.appkitbox.com/storage/xxxxxxxx

xxxxxxxxにアップロードするファイル名を指定してください。

Method Type

POST

curl コマンドでの実行例

RTK_USERNAME=xxxxxxxx
RTK_ACCESSTOKEN=xxxxxxxx
RTK_FILENAME=xxxxxxxx
curl -u $RTK_USERNAME:$RTK_ACCESSTOKEN -X POST -H 'Content-Type: application/octet-stream' https://gwjp.appkitbox.com/storage/$RTK_FILENAME --data-binary @/some/path/to/file

注意事項

ご利用にあたって、以下の注意事項があります。

• 日本語のファイル名を指定することはできません。
• 同じハッシュのファイルをアップロードする場合は上書きすることができます。

API を使った共有ストレージアプリ一覧取得

REST API を使って利用可能な共有ストレージアプリの一覧を取得することができます。

概要

API を使って Remote TestKit で利用可能な共有ストレージアプリの一覧を取得する。

URL

https://gwjp.appkitbox.com/storage

curl コマンドでの実行例

RTK_USERNAME=xxxxxxxx
RTK_ACCESSTOKEN=xxxxxxxx
curl -s -u $RTK_USERNAME:$RTK_ACCESSTOKEN https://gwjp.appkitbox.com/storage

API を使った共有ストレージからアプリのインストール

REST API を使ってレンタル中の端末に対してコマンドラインから共有ストレージアプリのインストールすることができます。

概要

API を使って指定端末に共有ストレージのapk / ipa ファイルをインストールする。

URL

https://gwjp.appkitbox.com/rented-devices/$DEVICE_ID/storage/$RTK_FILENAME

Method Type

POST

curl コマンドでの実行例

RTK_USERNAME=xxxxxxxx
RTK_ACCESSTOKEN=xxxxxxxx
DEVICE_ID=xxxxxxxx
RTK_FILENAME=xxxxxxxx
curl -s -H "Authorization: Bearer $RTK_ACCESSTOKEN" -X POST "https://gwjp.appkitbox.com/rented-devices/$DEVICE_ID/storage/$RTK_FILENAME"

補足

• ipaファイルを再署名ありでインストールする場合は、URLの"applications"の後に"?resign=true"を付与してご利用ください。

API を使った共有ストレージアプリの削除

REST API を使って共有ストレージアプリを削除することができます。

概要

API を使って Remote TestKit の共有ストレージアプリを削除する

URL

https://gwjp.appkitbox.com/devices/$RTK_FILENAME

Method Type

DELETE

curl コマンドでの実行例

RTK_USERNAME=xxxxxxxx
RTK_ACCESSTOKEN=xxxxxxxx
DEVICE_ID=xxxxxxxx
RTK_FILENAME=xxxxxxxx
curl -s -H "Authorization: Bearer $RTK_ACCESSTOKEN" "https://gwjp.appkitbox.com/devices/$RTK_FILENAME" -X DELETE

API を使ったアプリのインストール

REST API を使ってレンタル中の端末に対してコマンドラインからアプリのインストールすることができます。

概要

API を使って指定端末に apk / ipa ファイルをインストールする。

URL

https://gwjp.appkitbox.com/rented-devices/$DEVICE_ID/applications

Method Type

POST

curl コマンドでの実行例

RTK_USERNAME=xxxxxxxx
RTK_ACCESSTOKEN=xxxxxxxx
DEVICE_ID=xxxxxxxx
curl -s -H "Authorization: Bearer $RTK_ACCESSTOKEN" -X POST -H 'Content-Type: application/octet-stream' "https://gwjp.appkitbox.com/rented-devices/$DEVICE_ID/applications" --data-binary @/some/path/to/file

補足

• ipaファイルを再署名ありでインストールする場合は、URLの"applications"の後に"?resign=true"を付与してご利用ください。

API を使った端末一覧取得

REST API を使って利用可能な端末の一覧を取得することができます。

概要

API を使って Remote TestKit で利用可能な端末の一覧を取得する。

URL

https://gwjp.appkitbox.com/devices

curl コマンドでの実行例

RTK_USERNAME=xxxxxxxx
RTK_ACCESSTOKEN=xxxxxxxx
curl -s -u $RTK_USERNAME:$RTK_ACCESSTOKEN https://gwjp.appkitbox.com/devices

API を使った端末レンタル

REST API を使って利用可能な端末をレンタルすることができます。

概要

API を使って Remote TestKit の端末をレンタルする。

URL

https://gwjp.appkitbox.com/devices/$DEVICE_ID/rental

Method Type

POST

curl コマンドでの実行例

RTK_USERNAME=xxxxxxxx
RTK_ACCESSTOKEN=xxxxxxxx
DEVICE_ID=xxxxxxxx
curl -s -u $RTK_USERNAME:$RTK_ACCESSTOKEN "https://gwjp.appkitbox.com/devices/$DEVICE_ID/rental" -X POST

API を使った端末返却

REST API を使ってレンタル中の端末返却することができます。

概要

API を使って Remote TestKit の端末を返却する。

URL

https://gwjp.appkitbox.com/devices/$DEVICE_ID/rental

Method Type

DELETE

curl コマンドでの実行例

RTK_USERNAME=xxxxxxxx
RTK_ACCESSTOKEN=xxxxxxxx
DEVICE_ID=xxxxxxxx
curl -s -u $RTK_USERNAME:$RTK_ACCESSTOKEN "https://gwjp.appkitbox.com/devices/$DEVICE_ID/rental" -X DELETE

API を使った端末のログ取得

REST API を使ってレンタル中の端末のログを取得することができます。

概要

API を使って Remote TestKit の端末のログを取得する。

URL

https://gwjp.appkitbox.com/rented-devices/$DEVICE_ID/device_log

Method Type

GET

curl コマンドでの実行例

RTK_USERNAME=xxxxxxxx
RTK_ACCESSTOKEN=xxxxxxxx
DEVICE_ID=xxxxxxxx
curl -s -u $RTK_USERNAME:$RTK_ACCESSTOKEN -X GET "https://gwjp.appkitbox.com/rented-devices/$DEVICE_ID/device_log"

API を使ったAppiumログの取得

REST API を使ってAppium実行を行った端末のAppiumログを取得することができます。

概要

API を使って Remote TestKit の端末のAppiumログを取得する。

URL

https://gwjp.appkitbox.com/rented-devices/$DEVICE_ID/server_logs

Method Type

GET

curl コマンドでの実行例

RTK_USERNAME=xxxxxxxx
RTK_ACCESSTOKEN=xxxxxxxx
DEVICE_ID=xxxxxxxx
curl -s -u $RTK_USERNAME:$RTK_ACCESSTOKEN -X GET "https://gwjp.appkitbox.com/rented-devices/$DEVICE_ID/server_logs"

補足

• 開始時間と終了時間を指定する場合は、URLの"server_logs"の後に"?startTime=yyyyMMddHHmmss&endTime=yyyyMMddHHmmss"を付与してご利用ください。
• startTimeとendTimeに指定できるフォーマットは "yyyyMMddHHmm"、"yyyyMMddHHmmss"、"yyyy/MM/dd HH:mm"などを指定することができます。
• startTimeが未指定、もしくはレンタル開始時刻より前の時刻が指定された時はレンタル開始時刻以降のログを出力します。

API を使った端末のDeviceStats取得

REST API を使ってレンタル中端末のDeviceStatsを取得することができます。

概要

API を使ってレンタル中端末のDeviceStatusを取得する

URL

https://gwjp.appkitbox.com/rented-devices/$DEVICE_ID/device_stats

Method Type

POST、GET

curl コマンドでの実行例

RTK_USERNAME=xxxxxxxx
RTK_ACCESSTOKEN=xxxxxxxx
DEVICE_ID=xxxxxxxx
curl -s -H "Authorization: Bearer $RTK_ACCESSTOKEN" -X POST "$RTK_APPIUM/rented-devices/$DEVICE_ID/device_stats/start"
curl -s -H "Authorization: Bearer $RTK_ACCESSTOKEN" -X POST "$RTK_APPIUM/rented-devices/$DEVICE_ID/device_stats/stop"
curl -s -H "Authorization: Bearer $RTK_ACCESSTOKEN" -X GET "$RTK_APPIUM/rented-devices/$DEVICE_ID/device_stats"

補足

• 開始時間と終了時間を指定する場合は、URLの"server_logs"の後に"?startTime=yyyyMMddHHmmss&endTime=yyyyMMddHHmmss"を付与してご利用ください。
• startTimeとendTimeに指定できるフォーマットは "yyyyMMddHHmm"、"yyyyMMddHHmmss"、"yyyy/MM/dd HH:mm"などを指定することができます。
• startTimeが未指定、もしくはレンタル開始時刻より前の時刻が指定された時はレンタル開始時刻以降のログを出力します。

その他のサンプルコード

その他の言語やテストスクリプトのサンプルコードは下記のリポジトリを参照ください。
https://github.com/remotetestkit/sample-code

技術仕様および制限事項

2025.2月現在、以下の制限があります。

• Remote TestKit Appium Cloud は、 Flat 3以上のプランをご契約しているユーザの方が、無料でご利用になれる機能です。
• Appium の仕様から、対象となる端末は UiAutomator2 に対応している Android 4.4 以上または iOS 10.3 以上の端末に限られます。
• iOS 端末の場合はレンタルした iOS のバージョンに最適な Appium バージョンが選択されるため、 capability で指定はできません。作成するクライアント側のテストスクリプトは、対応バージョンを想定した実装をお願い致します。
• 端末レンタルの自動返却時間の指定が無い場合、10分間 Appium サーバ経由で同一端末にアクセスがない場合には、自動返却が行われます。また、自動返却されるまでは同じ端末に対して複数スクリプトを実行することができます。
• サーバに対して負荷のかかる処理やメモリを大量に必要とする処理は、強制終了する場合があります。
• 必要に応じて、社内の Firewall 等の設定に Remote TestKit からのアクセス許可設定を追加してください。アクセス元 IP アドレスは FAQ に記載があります。
• プロキシ環境下での動作はサポートしておりません。

Remote TestKit Appium Cloud で発生し得るエラーの一覧

実行したテストスクリプトがエラーで異常終了した際には、 Appium Client ライブラリを通じてサーバ側で発生したエラーメッセージが返却されます。「The environment you requested was unavailable」のあとに続くエラーメッセージと原因は下記の通りとなります。テストスクリプトの修正などにお役立てください。

よくあるご質問

「Appium連携のよくあるご質問（FAQ）」をまとめています。お問い合わせの前にご確認ください。