エスプレッソテストフレームワーク-インテント

Androidインテントは、内部(製品リスト画面から製品詳細画面を開く)または外部(ダイヤラーを開いて電話をかけるなど)のいずれかで新しいアクティビティを開くために使用されます。内部インテントアクティビティは、エスプレッソテストフレームワークによって透過的に処理され、ユーザー側からの特定の作業は必要ありません。ただし、外部アクティビティの呼び出しは、テスト対象のアプリケーションである私たちの範囲外であるため、実際には困難です。ユーザーが外部アプリケーションを呼び出してテスト対象のアプリケーションを終了すると、ユーザーが事前定義された一連のアクションでアプリケーションに戻る可能性はかなり低くなります。したがって、アプリケーションをテストする前に、ユーザーアクションを想定する必要があります。Espressoには、この状況を処理するための2つのオプションがあります。それらは次のとおりです、

意図されました

これにより、ユーザーはテスト対象のアプリケーションから正しいインテントが開かれていることを確認できます。

意図する

これにより、ユーザーはカメラから写真を撮ったり、連絡先リストから番号をダイヤルしたりするなどの外部アクティビティをモックし、事前定義された値のセット(実際の画像ではなくカメラからの事前定義された画像など)を使用してアプリケーションに戻ることができます。 。

セットアップ

Espressoはプラグインライブラリを介してインテントオプションをサポートしており、ライブラリはアプリケーションのgradleファイルで構成する必要があります。構成オプションは次のとおりです。

dependencies {
   // ...
   androidTestImplementation 'androidx.test.espresso:espresso-intents:3.1.1'
}

意図されました()

Espressoインテントプラグインは、呼び出されたインテントが期待されるインテントであるかどうかをチェックするための特別なマッチャーを提供します。提供されるマッチャーとマッチャーの目的は次のとおりです。

hasAction

これはインテントアクションを受け入れ、指定されたインテントに一致するマッチャーを返します。

hasData

これはデータを受け入れ、呼び出し中にインテントに提供されたデータと一致するマッチャーを返します。

toPackage

これは、インテントパッケージ名を受け入れ、呼び出されたインテントのパッケージ名と一致するマッチャーを返します。

それでは、新しいアプリケーションを作成し、意図された()を使用てアプリケーションの外部アクティビティをテストして、概念を理解しましょう。

  • AndroidStudioを起動します。

  • 前に説明したように新しいプロジェクトを作成し、IntentSampleAppという名前を付けます。

  • リファクタリング→ AndroidXへの移行オプションメニューを使用して、アプリケーションをAndroidXフレームワークに移行します。

  • 以下に示すように、activity_main.xmlを変更して、テキストボックス、連絡先リストを開くためのボタン、および電話をかけるためのボタンを作成します。

<?xml version = "1.0" encoding = "utf-8"?>
<RelativeLayout xmlns:android = "http://schemas.android.com/apk/res/android"
   xmlns:app = "http://schemas.android.com/apk/res-auto"
   xmlns:tools = "http://schemas.android.com/tools"
   android:layout_width = "match_parent"
   android:layout_height = "match_parent"
   tools:context = ".MainActivity">
   <EditText
      android:id = "@+id/edit_text_phone_number"
      android:layout_width = "wrap_content"
      android:layout_height = "wrap_content"
      android:layout_centerHorizontal = "true"
      android:text = ""
      android:autofillHints = "@string/phone_number"/>
   <Button
      android:id = "@+id/call_contact_button"
      android:layout_width = "wrap_content"
      android:layout_height = "wrap_content"
      android:layout_centerHorizontal = "true"
      android:layout_below = "@id/edit_text_phone_number"
      android:text = "@string/call_contact"/>
   <Button
      android:id = "@+id/button"
      android:layout_width = "wrap_content"
      android:layout_height = "wrap_content"
      android:layout_centerHorizontal = "true"
      android:layout_below = "@id/call_contact_button"
      android:text = "@string/call"/>
</RelativeLayout>
  • また、strings.xmlリソースファイルに以下の項目を追加します。

<string name = "phone_number">Phone number</string>
<string name = "call">Call</string>
<string name = "call_contact">Select from contact list</string>
  • 次に、onCreateメソッドの下のメインアクティビティ(MainActivity.java)に以下のコードを追加します。

public class MainActivity extends AppCompatActivity {
   @Override
   protected void onCreate(Bundle savedInstanceState) {
      // ... code
      // Find call from contact button
      Button contactButton = (Button) findViewById(R.id.call_contact_button);
      contactButton.setOnClickListener(new View.OnClickListener() {
         @Override
         public void onClick(View view) {
            // Uri uri = Uri.parse("content://contacts");
            Intent contactIntent = new Intent(Intent.ACTION_PICK,
               ContactsContract.Contacts.CONTENT_URI);
            contactIntent.setType(ContactsContract.CommonDataKinds.Phone.CONTENT_TYPE);
            startActivityForResult(contactIntent, REQUEST_CODE);
         }
      });
      // Find edit view
      final EditText phoneNumberEditView = (EditText)
         findViewById(R.id.edit_text_phone_number);
      // Find call button
      Button button = (Button) findViewById(R.id.button);
      button.setOnClickListener(new View.OnClickListener() {
         @Override
         public void onClick(View view) {
            if(phoneNumberEditView.getText() != null) {
               Uri number = Uri.parse("tel:" + phoneNumberEditView.getText());
               Intent callIntent = new Intent(Intent.ACTION_DIAL, number);
               startActivity(callIntent);
            }
         }
      });
   }
   // ... code
}

ここでは、連絡先リストを開くためのid、call_contact_buttonのボタンと、通話をダイヤルするためのid、buttonのボタンをプログラムしました。

  • 静的変数の追加REQUEST_CODEMainActivityの以下に示すように、クラスを

public class MainActivity extends AppCompatActivity {
   // ...
   private static final int REQUEST_CODE = 1;
   // ...
}
  • 次に、以下のようにMainActivityクラスにonActivityResultメソッドを追加します。

public class MainActivity extends AppCompatActivity {
   // ...
   @Override
   protected void onActivityResult(int requestCode, int resultCode, Intent data) {
      if (requestCode == REQUEST_CODE) {
         if (resultCode == RESULT_OK) {
            // Bundle extras = data.getExtras();
            // String phoneNumber = extras.get("data").toString();
            Uri uri = data.getData();
            Log.e("ACT_RES", uri.toString());
            String[] projection = {
               ContactsContract.CommonDataKinds.Phone.NUMBER, 
               ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME };
            Cursor cursor = getContentResolver().query(uri, projection, null, null, null);
            cursor.moveToFirst();
            
            int numberColumnIndex =
               cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER);
            String number = cursor.getString(numberColumnIndex);
            
            int nameColumnIndex = cursor.getColumnIndex(
               ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME);
            String name = cursor.getString(nameColumnIndex);
            Log.d("MAIN_ACTIVITY", "Selected number : " + number +" , name : "+name);
            
            // Find edit view
            final EditText phoneNumberEditView = (EditText)
               findViewById(R.id.edit_text_phone_number);
            phoneNumberEditView.setText(number);
         }
      }
   };
   // ...
}

ここで、onActivityResultは、ユーザーがcall_contact_buttonボタンを使用して連絡先リストを開き、連絡先を選択した後、アプリケーションに戻ったときに呼び出されます。いったんonActivityResultメソッドが呼び出され、それはユーザーが選択した連絡先、連絡先の電話番号を検索し、テキストボックスに設定を取得します。

  • アプリケーションを実行し、すべてが正常であることを確認します。インテントサンプルアプリケーションの最終的な外観は次のとおりです。

  • 次に、以下に示すように、アプリケーションのgradleファイルでエスプレッソインテントを構成します。

dependencies {
   // ...
   androidTestImplementation 'androidx.test.espresso:espresso-intents:3.1.1'
}
  • AndroidStudioが提供する[今すぐ同期]メニューオプションをクリックします。これにより、インテントテストライブラリがダウンロードされ、適切に構成されます。

  • ExampleInstrumentedTest.javaファイルを開き、通常使用されるAndroidTestRuleの代わりにIntentsTestRuleを追加します。IntentTestRuleは、インテントテストを処理するための特別なルールです。

public class ExampleInstrumentedTest {
   // ... code
   @Rule
   public IntentsTestRule<MainActivity> mActivityRule =
   new IntentsTestRule<>(MainActivity.class);
   // ... code
}
  • 2つのローカル変数を追加して、テスト電話番号とダイヤラパッケージ名を次のように設定します。

public class ExampleInstrumentedTest {
   // ... code
   private static final String PHONE_NUMBER = "1 234-567-890";
   private static final String DIALER_PACKAGE_NAME = "com.google.android.dialer";
   // ... code
}
  • androidstudioが提供するAlt + Enterオプションを使用してインポートの問題を修正するか、以下のインポートステートメントを含めます。

import android.content.Context;
import android.content.Intent;

import androidx.test.InstrumentationRegistry;
import androidx.test.espresso.intent.rule.IntentsTestRule;
import androidx.test.runner.AndroidJUnit4;

import org.junit.Rule;
import org.junit.Test;
import org.junit.runner.RunWith;

import static androidx.test.espresso.Espresso.onView;
import static androidx.test.espresso.action.ViewActions.click;
import static androidx.test.espresso.action.ViewActions.closeSoftKeyboard;
import static androidx.test.espresso.action.ViewActions.typeText;
import static androidx.test.espresso.intent.Intents.intended;
import static androidx.test.espresso.intent.matcher.IntentMatchers.hasAction;
import static androidx.test.espresso.intent.matcher.IntentMatchers.hasData;
import static androidx.test.espresso.intent.matcher.IntentMatchers.toPackage;
import static androidx.test.espresso.matcher.ViewMatchers.withId;
import static org.hamcrest.core.AllOf.allOf;
import static org.junit.Assert.*;
  • 以下のテストケースを追加して、ダイヤラが正しく呼び出されているかどうかをテストします。

public class ExampleInstrumentedTest {
   // ... code
   @Test
   public void validateIntentTest() {
      onView(withId(R.id.edit_text_phone_number))
         .perform(typeText(PHONE_NUMBER), closeSoftKeyboard());
      onView(withId(R.id.button)) .perform(click());
      intended(allOf(
         hasAction(Intent.ACTION_DIAL),
         hasData("tel:" + PHONE_NUMBER),
         toPackage(DIALER_PACKAGE_NAME)));
   }
   // ... code
}

ここでは、hasActionhasData、およびtoPackageマッチャーがallOfマッチャーとともに使用され、すべてのマッチャーが渡された場合にのみ成功します。

  • 次に、AndroidStudioのコンテンツメニューからExampleInstrumentedTestを実行します。

意図する()

Espressoは、外部インテントアクションをモックするintentioning()という特別なメソッドを提供します。意図()は、モックされるインテントのパッケージ名を受け入れ、以下に指定されているように、モックされたインテントがどのように応答される必要があるかを設定するメソッドrespondWithを提供します。

intending(toPackage("com.android.contacts")).respondWith(result);

ここで、respondWith()は、Instrumentation.ActivityResult型のインテント結果を受け入れます。新しいスタブインテントを作成し、以下に指定するように手動で結果を設定できます。

// Stub intent
Intent intent = new Intent();
intent.setData(Uri.parse("content://com.android.contacts/data/1"));
Instrumentation.ActivityResult result =
   new Instrumentation.ActivityResult(Activity.RESULT_OK, intent);

連絡先アプリケーションが正しく開かれているかどうかをテストするための完全なコードは次のとおりです。

@Test
public void stubIntentTest() {
   // Stub intent
   Intent intent = new Intent();
   intent.setData(Uri.parse("content://com.android.contacts/data/1"));
   Instrumentation.ActivityResult result =
      new Instrumentation.ActivityResult(Activity.RESULT_OK, intent);
   intending(toPackage("com.android.contacts")).respondWith(result);
   
   // find the button and perform click action
   onView(withId(R.id.call_contact_button)).perform(click());
   
   // get context
   Context targetContext2 = InstrumentationRegistry.getInstrumentation().getTargetContext();
   
   // get phone number
   String[] projection = { ContactsContract.CommonDataKinds.Phone.NUMBER,
      ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME };
   Cursor cursor =
      targetContext2.getContentResolver().query(Uri.parse("content://com.android.cont
      acts/data/1"), projection, null, null, null);
   
   cursor.moveToFirst();
   int numberColumnIndex =
      cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER);
   String number = cursor.getString(numberColumnIndex);
   
   // now, check the data
   onView(withId(R.id.edit_text_phone_number))
   .check(matches(withText(number)));
}

ここでは、新しいインテントを作成し、(インテントを呼び出すときの)戻り値を連絡先リストの最初のエントリcontent://com.android.contacts/data/1として設定しました。次に、連絡先リストの代わりに新しく作成されたインテントをモックする意図メソッドを設定しました。パッケージcom.android.contactsが呼び出され、リストのデフォルトの最初のエントリが返されると、新しく作成されたインテントが設定されて呼び出されます。次に、click()アクションを実行してモックインテントを開始し、最後にモックインテントを呼び出した電話番号と連絡先リストの最初のエントリの番号が同じであるかどうかを確認します。

不足しているインポートの問題がある場合は、androidstudioが提供するAlt + Enterオプションを使用してこれらのインポートの問題を修正するか、以下のインポートステートメントを含めます。

import android.app.Activity;
import android.app.Instrumentation;
import android.content.Context;
import android.content.Intent;
import android.database.Cursor;
import android.net.Uri;
import android.provider.ContactsContract;

import androidx.test.InstrumentationRegistry;
import androidx.test.espresso.ViewInteraction;
import androidx.test.espresso.intent.rule.IntentsTestRule;
import androidx.test.runner.AndroidJUnit4;

import org.junit.Rule;
import org.junit.Test;
import org.junit.runner.RunWith;

import static androidx.test.espresso.Espresso.onView;
import static androidx.test.espresso.action.ViewActions.click;
import static androidx.test.espresso.action.ViewActions.closeSoftKeyboard;
import static androidx.test.espresso.action.ViewActions.typeText;
import static androidx.test.espresso.assertion.ViewAssertions.matches;
import static androidx.test.espresso.intent.Intents.intended;
import static androidx.test.espresso.intent.Intents.intending;
import static androidx.test.espresso.intent.matcher.IntentMatchers.hasAction;
import static androidx.test.espresso.intent.matcher.IntentMatchers.hasData;
import static androidx.test.espresso.intent.matcher.IntentMatchers.toPackage;
import static androidx.test.espresso.matcher.ViewMatchers.withId;
import static androidx.test.espresso.matcher.ViewMatchers.withText;
import static org.hamcrest.core.AllOf.allOf;
import static org.junit.Assert.*;

テストクラスに以下のルールを追加して、連絡先リストを読み取る権限を付与します-

@Rule
public GrantPermissionRule permissionRule =
GrantPermissionRule.grant(Manifest.permission.READ_CONTACTS);

以下のオプションをアプリケーションマニフェストファイルAndroidManifest.xmlに追加します-

<uses-permission android:name = "android.permission.READ_CONTACTS" />

ここで、連絡先リストに少なくとも1つのエントリがあることを確認してから、AndroidStudioのコンテキストメニューを使用してテストを実行します。