Robotiumیک افزونه بر چهارچوب تست متعلق به خود سیستم اندروید است که به منظور آسان سازی امر نوشتن تست های رابط کاربری برای برنامه های اندروید تعبیه شده و بکار گرفته می شود. تست های robotium از ActivityInstrumentationTestCase2 به ارث برده و به برنامه نویس اجازه می دهند test case هایی را در تمامی activity های اندروید ایجاد کند .

نکته:

تست های Robotium برنامه های کاربردی تحت آزمایش را به عنوان جعبه سیاه (blackbox) می شناسند, به این معنا که تنها با رابط کاربری تعامل برقرار می کند و به کد داخلی برنامه ی مورد نظر کاری ندارد .

با مراجعه به URL زیر می توان به صفحه ی اصلی Robotium دسترسی پیدا کرد :

http://code.google.com/p/robotium/

چهارچوب تست اندروید را به منظور آسان سازی طراحی تست ارائه می دهد. کلاس اصلی که برای انجام تست با Robotium بکار می رود, کلاس Solo می باشد .
Solo با دستورات تست (instrumentation) test case (موردی که باید آزمایش شود) و اولین activity ی که باید تست شود مقداردهی اولیه می شود.

نصب Robotium

برای استفاده از Robotium در پروژه ی آزمایشی اندروید خود, باید کتابخانه ی Robotium.jar را از

http://code.google.com/p/robotium/

دانلود کنید .
در حال حاضر آخرین ورژن منتشر شده Robotium 5.2.1 هست .
در مرحله ی آخر, Robotium.jar را به Build path پروژه ی خود اضافی کنید .

مثال

کدی که ذیل مشاهده می کنید استفاده از Robotium را در یک تست رابط کاربری activity به نمایش می گذارد .

package de.vogella.android.test.target.test;
  
import junit.framework.Assert;
import android.test.ActivityInstrumentationTestCase2;
  
import com.robotium.solo.Solo;
  
import de.vogella.android.test.target.SimpleActivity;
import de.vogella.android.test.target.SimpleListActivity;
  
public class SimpleActivityTest extends
    ActivityInstrumentationTestCase2 {
  
  private Solo solo;
  
  public SimpleActivityTest() {
    super(SimpleActivity.class);
  }
  
  public void setUp() throws Exception {
    solo = new Solo(getInstrumentation(), getActivity());
  }
  
  
  @Override
  public void tearDown() throws Exception {
    solo.finishOpenedActivities();
  }
} 
<button></button>

ذیل مثال دیگری ارائه شده که پیاده سازی یک لیست را نمایش می دهد .

// check that we have the right activity
solo.assertCurrentActivity("wrong activity", SimpleActivity.class);
  
// Click a button which will start a new Activity
// Here we use the ID of the string to find the right button
solo.clickOnButton(solo.getString(R.string.button1));
// Validate that the Activity is the correct one
solo.assertCurrentActivity("wrong activity", SimpleListActivity.class);
solo.clickInList(1);
// searchForText has a timeout of 5 seconds
assertTrue(solo.waitForText("Android")); // Assertion
solo.clickInList(2);
assertTrue(solo.waitForText("iPhone")); // Assertion
solo.clickInList(3);
assertTrue(solo.waitForText("Blackberry")); // Assertion
solo.goBack();
solo.clickOnButton("Button2");
solo.clickOnButton("Button3");
  
// open the menu
solo.sendKey(Solo.MENU);
solo.clickOnText("Preferences");
solo.clickOnText("User");
solo.clearEditText(0);
Assert.assertTrue(solo.searchText(""));
solo.enterText(0, "http//:www.vogella.com");
Assert.assertTrue(solo.searchText("http//:www.vogella.com"));
solo.goBack(); 
<button></button>

Robotium API

کلاس Solo توابع متعددی را ویژه ی صدازنی رابط کاربری اندروید ارائه می دهد . تعداد زیادی از متدهای مذکور در لیست ذیل فهرست شده است .

جدول 1. متدهای آزمایشی کلاس solo

متد

توصیف کارایی

getView(int id)

با استفاده از شناسه (ID) مشخص شده به دنبال View مورد نظر در activity جاری می گردد .

assertCurrentActivity(text, Activity.class)

از برابری activity کنونی با پارامتر دوم اطمینان حاصل می کند .

getCurrentActivity() .getFragmentManager() .findFragmentById()

به دنبال fragment می گردد .

waitForText(text)

منتظر متنی روی صفحه ی نمایش می ماند, مهلت ((time-out آن 5 ثانیه است .

clickOnButton(text)

روی دکمه ی دربردارنده ی متن "text" کلیک می کند

sendKey(Solo.MENU);

رخدادهای مربوط به کلید منو را ارسال می کند .

clickOnText(text)

به دنبال متن مربوطه در رابط کاربری گشته و روی آن کلیک می کند .

enterText()

متن را وارد می کند .

searchText(text)

به دنبال متن در رابط کاربری جاری گشته و در صورت یافتن آن true باز می گرداند .

searchButton(text)

به دنبال دکمه ی دربردارنده ی متن مورد نظر در رابط کاربری جاری می گردد .

clickOnSearch()

اجازه ی کلیک روی قسمتی از صفحه را می دهد .

goBack()

دکمه ی بازگشت را فعال می کند .

setDatePicker()

تاریخ دلخواه را در DatePicker تنظیم می کند .

clickInList(x);

در ListView روی آیتم شماره x کلیک می کند .

pressSpinnerItem(0,2);

در spinner روی آیتم کلیک می کند .

isCheckBoxChecked()

بررسی می کند آیا کادر تیک (checkbox) چک شده یا خیر .

takeScreenshot()

یک تصویر از صفحه نمایش را روی دستگاه و در پوشه ی /sdcard/Robotium-Screenshots/ ذخیره می کند . در فایل AndroidManifest.xml اپلیکیشن تحت آزمایش به مجوز android.permission.WRITE_EXTERNAL_STORAGE نیاز دارد .

waitForActivity(SecondActivity.class, 2000)

به مدت 2 ثانیه منتظر activity مشخص شده می ماند .

جهت قرار گیری activity را می توان با استفاده از متد solo.setActivityOrientation(Solo.LANDSCAPE) تنظیم کرد .
به منظور استفاده از internationalized strings می توانید به فایل های منبع رشته (resource file) با فراخوانی متد getString(id) از پروژه ی تحت آزمایش دسترسی پیدا کرد . برای مثال :

// Here we use the ID of the string to find the right button
solo.clickOnButton(solo.getString(de.vogella.android.test.target.R.string.button1)); 
<button></button>

مرحله ی اجرای تست ها

جهت راه اندازی تست Robotium از Eclipse, روی کلاس آزمایشی راست کلیک کرده و گزینه های Run-As → Android JUnit Test انتخاب کنید .
البته می توان Robotium را از خط فرمان (command line) نیز اجرا کرد .

                    adb shell am instrument
  -w de.vogella.android.test.tester/android.test.InstrumentationTestRunner 
<button></button>

تمرین : طراحی تست های Robotium

پروژه ی جدیدی به نام com.vogella.android.test.robotium.target ایجاد کنید . حال سه دکمه در اولین activity نمایش دهید . در صورت کلیک روی اولین دکمه, باید activity ی به نمایش گذاشته شود که یک لیست را نشان می دهد .

ایجاد پروژه ی آزمایشی و افزودن Robotium

اکنون پروژه ی آزمایشی به نام com.vogella.android.test.robotium.targetTest ایجاد کنید . پوشه ای به نام libs ایجاد کرده و فایل JAR را داخل آن جای گذاری کنید .

نکته:

در صورت جای گذاری فایل ذکر شده (JAR) در این پوشه, ابزار و تجهیزات سیستم اندروید (ویژه ی Eclipse) به صورت خودکار فایل JAR را به Build path پروژه ی شما اضافه می کند . قراردهی فایل JAR در پوشه ای با نام متفاوت, مکرراً منجر به استثنای ClassNotFoundExeception برای کلاس Solo می شود

ساخت پروژه ی آزمایشی و اضافه کردن کتابخانه ی Robotium

کلاس زیر را تعریف کنید .

package de.vogella.android.test.target.test;
import junit.framework.Assert;
import android.test.ActivityInstrumentationTestCase2;
import com.robotium.solo.Solo;
import de.vogella.android.test.target.SimpleActivity;
import de.vogella.android.test.target.SimpleListActivity;
  
public class SimpleActivityTest extends
    ActivityInstrumentationTestCase2 {
  
  private Solo solo;
  
  public SimpleActivityTest() {
    super(SimpleActivity.class);
  }
  
  public void setUp() throws Exception {
    solo = new Solo(getInstrumentation(), getActivity());
  }
  
  @Override
  public void tearDown() throws Exception {
    solo.finishOpenedActivities();
  }
  
  public void testListItemClickShouldDisplayToast() throws Exception {
    // check that we have the right activity
    solo.assertCurrentActivity("wrong activity", SimpleActivity.class);
  
    // Click a button which will start a new Activity
    // Here we use the ID of the string to find the right button
    solo.clickOnButton(solo
        .getString(de.vogella.android.test.target.R.string.button1));
    // assert that the current activity is the SimpleListActivity.class
    solo.assertCurrentActivity("wrong activity", SimpleListActivity.class);
    solo.clickInList(1);
    // searchForText has a timeout of 5 seconds
    assertTrue(solo.waitForText("Android")); // Assertion
    solo.clickInList(2);
    assertTrue(solo.waitForText("iPhone")); // Assertion
    solo.clickInList(3);
    assertTrue(solo.waitForText("Blackberry")); // Assertion
    solo.goBack();
    solo.clickOnButton("Button2");
    solo.clickOnButton("Button3");
  }
  
  public void testListItemClickShouldDisplayToast() throws Exception {
    // open the menu
    solo.sendKey(Solo.MENU);
    solo.clickOnText("Preferences");
    solo.clickOnText("User");
    solo.clearEditText(0);
    Assert.assertTrue(solo.searchText(""));
    solo.enterText(0, "http//:www.vogella.com");
    Assert.assertTrue(solo.searchText("http//:www.vogella.com"));
    solo.goBack();
  
  }
  
} 
<button></button>

اصلاح و تنظیم برنامه

ابتدا اطمینان کسب کنید که تست مطابق با خصوصیات تعیین شده طراحی و تعبیه شده, سپس برنامه ی کاربردی اندروید خود را گونه ای تنظیم کنید که مرحله ی تست را با موفقیت پشت سر بگذارد .

1394/08/12 3819 2565

دانلود PDF

دانلود سورس کد

رمز عبور : tahlildadeh.com یا www.tahlildadeh.com

سوالات و نظرات

نظرات شما