instrumented test added into junit post

Author: maciej-nowak

_drafts/2019-01-14-junit.md

@@ -315,7 +315,85 @@ class PrintTestRule : TestRule {
 
 `AndroidX Test` zawiera zestaw gotowych zasad dla JUnit, które zwiększają elastyczność, redukują powtarzający się kod oraz wspomagają testowanie komponentów Android. Wykorzystywane są przede wszystkim testach UI przy użyciu `Espresso`. `ActivityTestRule` dostarcza do klasy testowej żądanej Aktywności (`Activity`), która jest dostępna w całym cyklu życia klasy testowej, `ServiceTestRule` dostarcza Usługę (`Service`) natomiast `IntentsTestRule` dostarcza Intencję (`Intent`). 
 
-//TODO maybe
+>**Przykład**  
+>Aktywność `GameActivity` umożliwia użytkownikowi prowadzenie rozgrywki opierając się na klasie `Game` co może wprowadzać potrzebę przetestowania klasy `Game` z poziomu aplikacji. W tym celu należy stworzyć testy instrumentalne (w pakieckie `androidTest`) wykonywane przez `AndroidJUnit4` i wykorzystać `ActivityTestRule` (lub bibliotekę `Robolectric`).
+
+{% highlight kotlin %}
+@RunWith(AndroidJUnit4::class)
+class InstrumentedTest {
+
+    @Rule @JvmField
+    val activityRule = ActivityTestRule(GameActivity::class.java)
+
+    //use only context
+    @Test
+    fun checkStringResourceFromContext() {
+        val appContext = InstrumentationRegistry.getTargetContext()
+        assertEquals("Game", appContext.getString(R.string.app_name))
+    }
+
+    //use activity from rule
+    @Test
+    fun startAndStopGameFromActivity() {
+        activityRule.activity.initDefaultGame()
+        activityRule.activity.startGame()
+        assertTrue(activityRule.activity.isGameRunning())
+        activityRule.activity.stopGame()
+        assertFalse(activityRule.activity.isGameRunning())
+    }
+}
+
+class MainActivity : AppCompatActivity() {
+
+    private val game = Game()
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        setContentView(R.layout.activity_main)
+        //init view
+    }
+
+    //imit real actions flow in one function
+    fun startGame() {
+        game.start()
+    }
+
+    fun stopGame() {
+        game.stop()
+    }
+
+    fun initDefaultGame() {
+        game.addPlayer(Game.Team.RED, "Johnnie")
+        game.addPlayer(Game.Team.RED, "William")
+        game.addPlayer(Game.Team.BLUE, "Jack")
+        game.addPlayer(Game.Team.BLUE, "Jim")
+    }
+
+    fun isGameRunning(): Boolean {
+        return game.hasStarted()
+    }
+}
+{% endhighlight %}
 
 ## Filtry
-`AndroidJUnitRunner` umożliwia stosowanie adnotacji dla testów instrumentalnych w celach informacyjnych. Adnotacja `@RequiresDevice` mówi, że test powinien zostać przeprowadzony tylko na urządzeniu fizycznym, `@SdkSupress` określa minimalne API natomiast `@SmallTest`, `@MediumTest` i `@LargeTest` informują o wielkości testu co przekłada się na czas jego wykonania.
+`AndroidJUnitRunner` umożliwia stosowanie adnotacji dla testów instrumentalnych w celach restrykcyjnych. Adnotacja `@RequiresDevice` mówi, że test powinien zostać przeprowadzony tylko na urządzeniu fizycznym, `@SdkSupress` określa minimalne API natomiast `@SmallTest`, `@MediumTest` i `@LargeTest` informują o wielkości testu co przekłada się na czas jego wykonania.
+
+{% highlight kotlin %}
+@RunWith(AndroidJUnit4::class)
+class FilterInstrumentedTest {
+
+    @MediumTest @SdkSuppress(minSdkVersion = 21) @RequiresDevice
+    @Test //runs only on devices with min 21 API
+    fun checkAppTitle() { 
+        val appContext = InstrumentationRegistry.getTargetContext()
+        assertEquals("Game", appContext.getString(R.string.app_name))
+    }
+
+    @SmallTest @SdkSuppress(maxSdkVersion = 20)
+    @Test //runs on devices and emulator with max 20 API
+    fun checkOldAppTitle() {
+        val appContext = InstrumentationRegistry.getTargetContext()
+        assertEquals("Game Old", appContext.getString(R.string.app_name))
+    }
+}
+{% endhighlight %}