INF.04 styczeń 2026 — gra w kości: aplikacja konsolowa, mobilna i testy jednostkowe

1. Na pulpicie utwórz folder o nazwie równej twojemu numerowi PESEL, a w nim trzy puste podfoldery.
2. Rozpakuj zad1.7z hasłem z arkusza. Sprawdź, czy widzisz siedem plików od kosc0.png do kosc6.png.
3. Uruchom emulator mobilny — niech się wygrzewa w tle przez cały czas pracy nad konsolą.
4. Napisz plik egzamin.txt. Zajmuje minutę, a jest osobno punktowanym elementem.

Dokumentacja narzedzi wykorzystanych na egzaminie

System operacyjny:            Windows 11 Pro 64-bit
Srodowisko - konsolowa:       Microsoft Visual Studio 2022
Srodowisko - testy:           Microsoft Visual Studio 2022, biblioteka MSTest
Srodowisko - mobilna:         Android Studio Koala
Emulator aplikacji mobilnej:  Android Emulator, Pixel 6 API 34
Jezyki programowania:         C# (aplikacja konsolowa i testy)
                            Kotlin, XML (aplikacja mobilna)

• konsola1.png — użytkownik wpisuje poprawną wartość z zakresu 1–6, program pokazuje liczbę oczek, słowo i nazwę pliku.
• konsola2.png — użytkownik wpisuje wartość spoza zakresu (np. 9), obiekt dostaje 0 i nazwę kosc0.png.
• Opcjonalnie konsola3.png — wpisanie tekstu zamiast liczby, jeśli twój program to obsługuje.

using System;

namespace GraWKosci
{
  public class Kosc
  {
      // Pole statyczne, wspolne dla wszystkich instancji klasy
      public static int LiczbaInstancji = 0;

      // Jeden generator dla calej klasy - dwa obiekty tworzone
      // w tej samej milisekundzie nie wylosuja tej samej wartosci
      private static readonly Random Generator = new Random();

      // Indeks tablicy odpowiada liczbie oczek: NazwyPlikow[3] to kosc3.png
      public string[] NazwyPlikow = {
          "kosc0.png", "kosc1.png", "kosc2.png", "kosc3.png",
          "kosc4.png", "kosc5.png", "kosc6.png"
      };

      public int LiczbaOczek;
      public int IdentyfikatorPliku;
      public bool CzyDostepna;

      // Konstruktor jednoargumentowy
      public Kosc(int wartosc)
      {
          if (wartosc < 1 || wartosc > 6)
          {
              wartosc = 0;
          }

          LiczbaOczek = wartosc;
          IdentyfikatorPliku = wartosc;
          CzyDostepna = true;
          LiczbaInstancji++;
      }

      // Konstruktor bezargumentowy - losuje wartosc kosci
      public Kosc()
      {
          int wylosowana = Generator.Next(1, 7);

          LiczbaOczek = wylosowana;
          IdentyfikatorPliku = wylosowana;
          CzyDostepna = true;
          LiczbaInstancji++;
      }

      // Rzut wykonuje sie tylko wtedy, gdy kosc jest dostepna
      public void Rzut()
      {
          if (!CzyDostepna)
          {
              return;
          }

          int wylosowana = Generator.Next(1, 7);
          LiczbaOczek = wylosowana;
          IdentyfikatorPliku = wylosowana;
      }

      public void Zablokuj()
      {
          CzyDostepna = false;
      }

      public string OczkaSlownie()
      {
          switch (LiczbaOczek)
          {
              case 1: return "jeden";
              case 2: return "dwa";
              case 3: return "trzy";
              case 4: return "cztery";
              case 5: return "piec";
              case 6: return "szesc";
              default: return "zero";
          }
      }

      public string NazwaPliku()
      {
          return NazwyPlikow[IdentyfikatorPliku];
      }
  }
}

using System;

namespace GraWKosci
{
  class Program
  {
      static void WyswietlInformacje(Kosc kosc, string opis)
      {
          Console.WriteLine();
          Console.WriteLine("--- " + opis + " ---");
          Console.WriteLine("Liczba utworzonych instancji klasy Kosc: "
              + Kosc.LiczbaInstancji);
          Console.WriteLine("Liczba wyrzuconych oczek: "
              + kosc.LiczbaOczek + " (slownie: " + kosc.OczkaSlownie() + ")");
          Console.WriteLine("Nazwa pliku z grafika kosci: "
              + kosc.NazwaPliku());
      }

      static void Main(string[] args)
      {
          Console.OutputEncoding = System.Text.Encoding.UTF8;
          Console.WriteLine("GRA W KOSCI - sprawdzenie dzialania klasy Kosc");
          Console.WriteLine();

          Console.Write("Podaj liczbe oczek pierwszej kosci (od 1 do 6): ");
          string wprowadzonyTekst = Console.ReadLine();

          int podanaWartosc;
          if (!int.TryParse(wprowadzonyTekst, out podanaWartosc))
          {
              Console.WriteLine("To nie jest liczba - kosc otrzyma wartosc 0.");
              podanaWartosc = 0;
          }

          Kosc pierwszaKosc = new Kosc(podanaWartosc);
          WyswietlInformacje(pierwszaKosc,
              "Kosc utworzona konstruktorem jednoargumentowym");

          Kosc drugaKosc = new Kosc();
          WyswietlInformacje(drugaKosc,
              "Kosc utworzona konstruktorem bezargumentowym (wartosc losowa)");

          Console.WriteLine();
          Console.WriteLine("Nacisnij dowolny klawisz, aby zakonczyc...");
          Console.ReadKey();
      }
  }
}

• Statyczny generator losowy. Gdyby każdy obiekt tworzył własny new Random(), dwie kości utworzone w tej samej milisekundzie dostałyby ten sam ziarno i tę samą wartość. Na zrzucie ekranu wyglądałoby to jak błąd losowania.
• Liczba oczek i identyfikator pliku to dwa osobne pola, mimo że zawsze mają tę samą wartość. Arkusz wymienia je osobno, więc muszą istnieć osobno — połączenie ich w jedno pole to strata punktu.
• Generator.Next(1, 7) — górna granica w C# jest wyłączna, więc to jest zakres 1–6. Klasyczny błąd o jeden: Next(1, 6) nigdy nie wyrzuci szóstki.
• Wczesny powrót w metodzie rzutu. Arkusz pisze „realizuje rzut kością tylko, gdy kość jest dostępna" — to jest dokładnie ten warunek, który potem sprawdza drugi test jednostkowy.
• Tablica nazw jako pole publiczne, indeksowana wartością oczek. Dzięki temu nazwa pliku nie wymaga żadnego mapowania, wystarczy indeks.

import random


class Kosc:
  liczba_instancji = 0

  def __init__(self, wartosc=None):
      self.nazwy_plikow = [
          "kosc0.png", "kosc1.png", "kosc2.png", "kosc3.png",
          "kosc4.png", "kosc5.png", "kosc6.png"
      ]

      if wartosc is None:
          wartosc = random.randint(1, 6)
      elif wartosc not in (1, 2, 3, 4, 5, 6):
          wartosc = 0

      self.liczba_oczek = wartosc
      self.identyfikator_pliku = wartosc
      self.czy_dostepna = True
      Kosc.liczba_instancji += 1

  def rzut(self):
      if not self.czy_dostepna:
          return
      wylosowana = random.randint(1, 6)
      self.liczba_oczek = wylosowana
      self.identyfikator_pliku = wylosowana

  def zablokuj(self):
      self.czy_dostepna = False

  def oczka_slownie(self):
      slowa = ["zero", "jeden", "dwa", "trzy", "cztery", "piec", "szesc"]
      return slowa[self.liczba_oczek]

  def nazwa_pliku(self):
      return self.nazwy_plikow[self.identyfikator_pliku]


if __name__ == "__main__":
  tekst = input("Podaj liczbe oczek pierwszej kosci (od 1 do 6): ")
  wartosc = int(tekst) if tekst.strip().isdigit() else 0

  pierwsza = Kosc(wartosc)
  print("Liczba instancji klasy Kosc:", Kosc.liczba_instancji)
  print("Oczka:", pierwsza.liczba_oczek, "slownie:", pierwsza.oczka_slownie())
  print("Plik graficzny:", pierwsza.nazwa_pliku())

  druga = Kosc()
  print("Liczba instancji klasy Kosc:", Kosc.liczba_instancji)
  print("Oczka:", druga.liczba_oczek, "slownie:", druga.oczka_slownie())
  print("Plik graficzny:", druga.nazwa_pliku())

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  android:orientation="vertical"
  android:gravity="center"
  android:background="#ED27C121">

  <LinearLayout
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:orientation="horizontal"
      android:layout_gravity="center">

      <ImageView
          android:id="@+id/obrazKosci1"
          android:layout_width="60dp"
          android:layout_height="60dp"
          android:layout_margin="10dp"
          android:src="@drawable/kosc0"
          android:contentDescription="kosc pierwsza" />

      <ImageView
          android:id="@+id/obrazKosci2"
          android:layout_width="60dp"
          android:layout_height="60dp"
          android:layout_margin="10dp"
          android:src="@drawable/kosc0"
          android:contentDescription="kosc druga" />

      <ImageView
          android:id="@+id/obrazKosci3"
          android:layout_width="60dp"
          android:layout_height="60dp"
          android:layout_margin="10dp"
          android:src="@drawable/kosc0"
          android:contentDescription="kosc trzecia" />

      <ImageView
          android:id="@+id/obrazKosci4"
          android:layout_width="60dp"
          android:layout_height="60dp"
          android:layout_margin="10dp"
          android:src="@drawable/kosc0"
          android:contentDescription="kosc czwarta" />

      <ImageView
          android:id="@+id/obrazKosci5"
          android:layout_width="60dp"
          android:layout_height="60dp"
          android:layout_margin="10dp"
          android:src="@drawable/kosc0"
          android:contentDescription="kosc piata" />
  </LinearLayout>

  <Button
      android:id="@+id/przyciskRzut"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_gravity="center"
      android:layout_margin="10dp"
      android:backgroundTint="#ED275021"
      android:text="RZUT" />

  <TextView
      android:id="@+id/poleWyniku"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_gravity="center"
      android:layout_margin="10dp"
      android:textSize="40sp"
      android:text="0" />
</LinearLayout>

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
           xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
           x:Class="GraWKosci.MainPage"
           BackgroundColor="#ED27C121">

  <VerticalStackLayout HorizontalOptions="Center"
                       VerticalOptions="Center">

      <HorizontalStackLayout HorizontalOptions="Center">
          <Image x:Name="obrazKosci1" Source="kosc0.png"
                 WidthRequest="60" Margin="10">
              <Image.GestureRecognizers>
                  <TapGestureRecognizer Tapped="PrzelaczDostepnosc"
                                        CommandParameter="0" />
              </Image.GestureRecognizers>
          </Image>
          <!-- pozostale cztery obrazy analogicznie -->
      </HorizontalStackLayout>

      <Button x:Name="przyciskRzut" Text="RZUT" Margin="10"
              BackgroundColor="#ED275021" Clicked="WykonajRzut" />

      <Label x:Name="poleWyniku" Text="0" FontSize="40"
             HorizontalOptions="Center" Margin="10" />
  </VerticalStackLayout>
</ContentPage>

package com.example.grawkosci

import kotlin.random.Random

class Kosc {

  companion object {
      var liczbaInstancji = 0
  }

  val nazwyPlikow = arrayOf(
      "kosc0.png", "kosc1.png", "kosc2.png", "kosc3.png",
      "kosc4.png", "kosc5.png", "kosc6.png"
  )

  var liczbaOczek = 0
  var identyfikatorPliku = 0
  var czyDostepna = true

  constructor(wartosc: Int) {
      val poprawnaWartosc = if (wartosc in 1..6) wartosc else 0
      liczbaOczek = poprawnaWartosc
      identyfikatorPliku = poprawnaWartosc
      czyDostepna = true
      liczbaInstancji++
  }

  constructor() {
      val wylosowana = Random.nextInt(1, 7)
      liczbaOczek = wylosowana
      identyfikatorPliku = wylosowana
      czyDostepna = true
      liczbaInstancji++
  }

  fun rzut() {
      if (!czyDostepna) return
      val wylosowana = Random.nextInt(1, 7)
      liczbaOczek = wylosowana
      identyfikatorPliku = wylosowana
  }

  fun zablokuj() {
      czyDostepna = false
  }

  fun udostepnij() {
      czyDostepna = true
  }

  fun oczkaSlownie(): String = when (liczbaOczek) {
      1 -> "jeden"
      2 -> "dwa"
      3 -> "trzy"
      4 -> "cztery"
      5 -> "piec"
      6 -> "szesc"
      else -> "zero"
  }
}

package com.example.grawkosci

import android.os.Bundle
import android.widget.Button
import android.widget.ImageView
import android.widget.TextView
import androidx.appcompat.app.AppCompatActivity

class MainActivity : AppCompatActivity() {

  private val liczbaKosci = 5

  // Piec kosci w stanie poczatkowym: wartosc 0, obraz kosc0.png
  private val kosci = List(liczbaKosci) { Kosc(0) }

  private lateinit var obrazyKosci: List<ImageView>
  private lateinit var poleWyniku: TextView
  private lateinit var przyciskRzut: Button

  override fun onCreate(zapisanyStan: Bundle?) {
      super.onCreate(zapisanyStan)
      setContentView(R.layout.activity_main)

      obrazyKosci = listOf(
          findViewById(R.id.obrazKosci1),
          findViewById(R.id.obrazKosci2),
          findViewById(R.id.obrazKosci3),
          findViewById(R.id.obrazKosci4),
          findViewById(R.id.obrazKosci5)
      )
      poleWyniku = findViewById(R.id.poleWyniku)
      przyciskRzut = findViewById(R.id.przyciskRzut)

      // Zdarzenie 1: przycisk RZUT
      przyciskRzut.setOnClickListener { wykonajRzut() }

      // Zdarzenie 2: klikniecie w obraz kosci
      obrazyKosci.forEachIndexed { indeks, obraz ->
          obraz.setOnClickListener { przelaczDostepnosc(indeks) }
      }

      // Odtworzenie stanu po obrocie ekranu
      if (zapisanyStan != null) {
          val oczka = zapisanyStan.getIntArray(KLUCZ_OCZKA)
          val dostepnosc = zapisanyStan.getBooleanArray(KLUCZ_DOSTEPNOSC)
          if (oczka != null && dostepnosc != null) {
              for (indeks in kosci.indices) {
                  kosci[indeks].liczbaOczek = oczka[indeks]
                  kosci[indeks].identyfikatorPliku = oczka[indeks]
                  kosci[indeks].czyDostepna = dostepnosc[indeks]
              }
          }
      }

      odswiezWidok()
  }

  private fun wykonajRzut() {
      // Metoda rzut() sama pomija kosci niedostepne
      kosci.forEach { kosc -> kosc.rzut() }
      odswiezWidok()
  }

  private fun przelaczDostepnosc(indeks: Int) {
      val kosc = kosci[indeks]
      if (kosc.czyDostepna) {
          kosc.zablokuj()
      } else {
          kosc.udostepnij()
      }
      odswiezWidok()
  }

  private fun odswiezWidok() {
      var sumaOczek = 0

      for (indeks in kosci.indices) {
          val kosc = kosci[indeks]
          val nazwaZasobu = "kosc" + kosc.identyfikatorPliku
          val idZasobu = resources.getIdentifier(
              nazwaZasobu, "drawable", packageName
          )

          obrazyKosci[indeks].setImageResource(idZasobu)
          obrazyKosci[indeks].alpha = if (kosc.czyDostepna) 1.0f else 0.5f

          sumaOczek += kosc.liczbaOczek
      }

      poleWyniku.text = sumaOczek.toString()
  }

  override fun onSaveInstanceState(stan: Bundle) {
      super.onSaveInstanceState(stan)
      stan.putIntArray(KLUCZ_OCZKA,
          kosci.map { kosc -> kosc.liczbaOczek }.toIntArray())
      stan.putBooleanArray(KLUCZ_DOSTEPNOSC,
          kosci.map { kosc -> kosc.czyDostepna }.toBooleanArray())
  }

  companion object {
      private const val KLUCZ_OCZKA = "oczka"
      private const val KLUCZ_DOSTEPNOSC = "dostepnosc"
  }
}

• Jedna metoda odświeżająca widok. Zamiast rozsypywać podmianę obrazków po obu obsługach zdarzeń, wszystko idzie przez odswiezWidok(). Zmiana wyglądu ma wtedy jedno miejsce, a suma oczek liczy się zawsze z aktualnego stanu wszystkich kości — także zablokowanych, co arkusz wprost nakazuje.
• Nie filtrujemy kości przed rzutem. Warunek dostępności siedzi już w metodzie rzut(). To ta sama logika, którą sprawdzi test jednostkowy — jeden warunek, dwa rezultaty egzaminacyjne.
• Cykl życia. Obrót emulatora niszczy aktywność i uruchamia onCreate od nowa. Bez onSaveInstanceState wszystkie kości wracają do zera w trakcie robienia zrzutów. Nie jest to wymagane wprost, ale kosztuje pięć linijek i ratuje przed nieprzyjemną niespodzianką.

• mobilna1.png — stan początkowy: pięć razy kosc0.png, wynik 0, wszystkie kości pełne.
• mobilna2.png — po wciśnięciu RZUT: pięć różnych grafik i suma oczek w polu tekstowym.
• mobilna3.png — po kliknięciu w kilka kości: te są wyblakłe (50% przezroczystości), a kolejny rzut zmienia tylko pozostałe.

1. Prawy przycisk na rozwiązaniu → Dodaj → Nowy projekt → MSTest Test Project. Nazwij go TestyKosci.
2. W projekcie testowym: Zależności → Dodaj odwołanie do projektu i zaznacz projekt konsolowy. Bez tego kroku klasa Kosc jest dla testów niewidoczna — to najczęstsza przyczyna „nie da się tego zrobić" na egzaminie.
3. Klasa Kosc musi być public. Domyślnie klasa w C# jest wewnętrzna i test jej nie zobaczy.
4. Uruchomienie: Test → Eksplorator testów → Uruchom wszystkie testy.

using Microsoft.VisualStudio.TestTools.UnitTesting;
using GraWKosci;

namespace TestyKosci
{
  [TestClass]
  public class KoscTesty
  {
      // Rzut jest losowy, wiec jedno wywolanie nie dowodzi niczego.
      // Powtarzamy go wiele razy - test wychwyci blad typu Next(1, 6)
      // albo Next(0, 6), ktory czasem zwroci wartosc spoza zakresu.
      private const int LiczbaPowtorzen = 1000;

      [TestMethod]
      public void RzutZwracaWartoscZZakresuOdJedenDoSzesc()
      {
          // przygotuj
          Kosc kosc = new Kosc(1);

          for (int probka = 0; probka < LiczbaPowtorzen; probka++)
          {
              // wykonaj
              kosc.Rzut();

              // sprawdz
              Assert.IsTrue(kosc.LiczbaOczek >= 1 && kosc.LiczbaOczek <= 6,
                  "Kosc wyrzucila wartosc spoza zakresu 1-6: "
                  + kosc.LiczbaOczek);
          }
      }

      [TestMethod]
      public void RzutNieZmieniaWartosciGdyKoscJestNiedostepna()
      {
          // przygotuj
          Kosc kosc = new Kosc(4);
          kosc.Zablokuj();

          int wartoscPrzedRzutem = kosc.LiczbaOczek;
          int identyfikatorPrzedRzutem = kosc.IdentyfikatorPliku;

          // wykonaj
          for (int probka = 0; probka < LiczbaPowtorzen; probka++)
          {
              kosc.Rzut();
          }

          // sprawdz
          Assert.AreEqual(wartoscPrzedRzutem, kosc.LiczbaOczek,
              "Zablokowana kosc zmienila liczbe oczek");
          Assert.AreEqual(identyfikatorPrzedRzutem, kosc.IdentyfikatorPliku,
              "Zablokowana kosc zmienila identyfikator pliku");
      }
  }
}

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertTrue;

class KoscTest {

  private static final int LICZBA_POWTORZEN = 1000;

  @Test
  void rzutZwracaWartoscZZakresuOdJedenDoSzesc() {
      Kosc kosc = new Kosc(1);

      for (int probka = 0; probka < LICZBA_POWTORZEN; probka++) {
          kosc.rzut();
          assertTrue(kosc.liczbaOczek >= 1 && kosc.liczbaOczek <= 6,
              "Wartosc spoza zakresu 1-6: " + kosc.liczbaOczek);
      }
  }

  @Test
  void rzutNieZmieniaWartosciGdyKoscJestNiedostepna() {
      Kosc kosc = new Kosc(4);
      kosc.zablokuj();

      for (int probka = 0; probka < LICZBA_POWTORZEN; probka++) {
          kosc.rzut();
      }

      assertEquals(4, kosc.liczbaOczek,
          "Zablokowana kosc zmienila liczbe oczek");
      assertEquals(4, kosc.identyfikatorPliku,
          "Zablokowana kosc zmienila identyfikator pliku");
  }
}

from kosc import Kosc

LICZBA_POWTORZEN = 1000


def test_rzut_zwraca_wartosc_z_zakresu_od_jeden_do_szesc():
  kosc = Kosc(1)

  for _ in range(LICZBA_POWTORZEN):
      kosc.rzut()
      assert 1 <= kosc.liczba_oczek <= 6, (
          "Wartosc spoza zakresu 1-6: " + str(kosc.liczba_oczek)
      )


def test_rzut_nie_zmienia_wartosci_gdy_kosc_jest_niedostepna():
  kosc = Kosc(4)
  kosc.zablokuj()

  for _ in range(LICZBA_POWTORZEN):
      kosc.rzut()

  assert kosc.liczba_oczek == 4
  assert kosc.identyfikator_pliku == 4