Android | Ranorex
Help CenterUser GuideInterfaces and connectivity

Android アプリ

この章では、Android アプリのインストルメントについて説明します。

tipp icon

注意

Android 開発者向け: インストルメント プロセスの一部として、テスト対象アプリは Ranorex automation library と共にコンパイルされます。このライブラリは、APK ファイルにいくつかの機能と権限を追加します。そのため、インストルメントされたアプリは、Google Play には公開しないでください。

事前準備

アプリをインストルメントおよびデプロイする前に、以下を確認してください。

アプリの準備

Ranorex Studio がインストールされているコンピューターから、APK にアクセスできることを確認してください。 APK のコピーを、対象のコンピューターのフォルダーに格納することをおすすめします。

モバイル デバイスの準備

  • ⇢ デバイスの設定 をおこなってください。
  • Ranorex Studio がインストールされているコンピューターに、⇢ デバイスを接続 してください。
  • デバイスで、Ranorex Service App を起動してください。
Note icon

メモ

インストルメント ウィザードを使用することで、アプリをインストルメントして、モバイル デバイスにすぐにデプロイできます。この場合、モバイル デバイスを USB 経由でコンピューターに接続する必要があります。

インストルメントの例

この例では、Dropbox アプリをインストルメントします。Dropbox のダウンロードおよび使用には、Dropbox, Inc. の利用規約が適用されます。

インストルメントの準備として、Ranorex Studio がインストールされているコンピューターの、Android app testing フォルダーに、アプリを格納します。

テクノロジーの選択

インストルメント ウィザードを起動します。
Android を選択します。
次へ をクリックします。

APK の選択と設定

参照… をクリックします。
APK が格納されているフォルダーを選択します。
APK ファイルを選択します。

高度な設定をおこないたい場合には、設定… をクリックします。詳しくは、このセクションの 高度なインストルメント設定 で説明しています。

テスト対象アプリのインストルメントの実行
テスト対象アプリのデプロイの実行

モバイル デバイスの選択

いずれかの方法でデバイスを選択します。

利用可能なデバイス リストボックスから選択
エンドポイント リスト ウィンドウから選択

インストルメントとデプロイの開始

次へ をクリックし、インストルメントを開始します。
インストルメントには、数分間かかる場合があります。

アプリが正常にインストルメントされました。

Note icon

メモ

インストルメントが失敗する場合には、⇢ デバイスの設定 および ⇢ デバイスの接続 が正しくおこなわれていることを確認してください。また、他のプログラムがリソースを消費していることで、インストルメントに時間がかかり、タイムアウトになる場合もあります。他のすべてのプログラムを終了するか、インストルメント関連のタイムアウト設定を変更してください。

結果

アプリが正常にインストルメントおよびデプロイされている場合、デバイスに以下のように表示されます。

Ranorex Service App に表示されたインストルメント済みアプリ
デバイスのホームスクリーンに表示されたインストルメント済みアプリ

Ranorex Studio では、モバイル テスト作成時のダイアログに、対象のアプリが表示されます。

高度なインストルメント設定

これらの設定は、このセクションの APKの選択と設定 で説明しているインストルメント ダイアログから利用できます。これらの設定には、特定の種類の Android アプリのインストルメント方法を変更するためのオプションが含まれています。

AndroidManifest.xml addons

Custom R.id package name: リソース ID が配置されているカスタムのクラス名 (例: com.ranoerx.demo.R) を指定できます。デフォルトでは、Ranorex Studio は、<manifestpackage>.R から ID を検索します。

Enable web testing: True に設定した場合、WebView の DOM コンテンツを、Ranoerx Spy の UI 要素ツリーに表示します。パフォーマンスに著しい影響を与えます。デフォルトは True です。

Full image comparison: True に設定した場合、イメージのリソース ID を決定するために、より堅牢なイメージ比較メカニズムを使用します。スタートアップ時のパフォーマンスに影響を与えます。デフォルトは False です。

Tree simplification: False に設定した場合、UI 要素ツリーの後処理をおこないません。これにより、より複雑な要素ツリーが Ranorex Spy に表示されることになりますが、サードパーティ製の Android コントロールを処理する必要がある場合には有用な場合があります。デフォルトは True です。

Instrumentation options

Avoid resources decompiling: True に設定した場合、インストルメント処理で、リソースのデコンパイル/コンパイルをおこないません。これにより、以下がおこなわれます。

  • リソースはデコンパイルされず、arsc ファイルがデコードされずにそのまま維持されます。
  • AndroidManifest.xml が、apk に組み込まれているデフォルトの Android ツールによってではなく、Ranoerx Studio によりデコードされます。

これにより、インストルメント処理が劇的に高速化されます。インストルメント済みの APK に含まれるリソースに変更を加える必要がある場合にのみ、False に設定してください。デフォルトは True です。

Debug information: True に設定した場合、インストルメント ログ ファイルに、デバッグ情報を追加します。インストルメントで問題が発生した場合のトラブルシューティングに役立ちます。

Multidex application: モバイル アプリおよび使用しているライブラリが、65,536 個以上のメソッドを参照していて、かつ、このオプションが False の場合、インストルメント中のビルド エラーが発生します。これは、Android のビルド アーキテクチャの限界値に到達したため発生するものです。このエラーを解消するには、このオプションを True に設定し、インストルメントを再度実行してください。

Other instrumentation flags: インストルメント処理に適用する、特定のフラグを追加できます。

Redistribute smali: デコンパイルした Smali コードのメソッド数に関するエラーが発生した場合には、このオプションを True に設定してください。これにより Ranorex Studio は、コードを複数のファイルに分割します。

Static instrumentation: “Register count exceeds…” または “Method count exceeds 65k” といったエラーが発生した場合には、このオプションを True に設定してください。これにより Ranorex Studio は、ユーザー アクティビティに追加する必要のあるコード量を大幅に減らすため、特別なインストルメント メカニズムを使用します。
このオプションを有効化する前に、”Redistribute smali” オプションの使用を試してください。

Signing APK

APK ファイルに署名したい場合には、これらのオプションをすべて設定してください。