wiki:xamarin
Last modified 2 years ago Last modified on 2017-09-28 11:29:30

ComTest ja Xamarin

Sivut siirretty TIMiin.
























































Comtestin saa toimimaan Xamarinissa kohtuullisella vaivalla.

Huomaa että vielä ei toim Visual Studio for Mac, toivottavasti saadaan toimimaan ennenkuin tarvitaan. Tämän hetkisellä versiolla joutuu itse lisäämään Packageen aina NUnit.

Hätätilassa käytä TIMissä olevaa ComTest-pohjaa

1. Asentaminen

Muistathan että Java on asennettuna.

1.1 ComTest.jar

Lataa viimeisin ComTest.jar-tiedosto täältä:

ComTest.jar

1.2 Liitännäinen

Käynnistä VS / Xamarin Studio / MonoDevelop ja avaa Addin manager (Macilla Xamarin Studio -valikko, muilla Tools)

Gallery-välilehdellä lisää uusi osoite (All repositories -pudotusvalikon alta Manage Repositories):

Visual Studio for Mac:​

http://kurssit.it.jyu.fi/npo/ComTest/MonoDevelop-7.1

Xamarin Studion versiolla 6:

http://kurssit.it.jyu.fi/npo/ComTest/MonoDevelop-6.1/

Versiolla 5:

http://kurssit.it.jyu.fi/npo/ComTest/MonoDevelop-5.0/

Gallery-välilehdelle pitäisi nyt ilmestyä ComTest Testing-haaran alle. Asenna se ja käynnistä Xamarin Studio uudelleen. Jos Run valikkoon ei ilmesty "ComTest", suorita asennus uudelleen. Älä välitä mahdollisista varoituksista.

1.3 Asetukset

Run valikko -> comtest -> optionsista asetukset kuntoon

Sitten pitäisi pystyä testaamaan solutionia.

Sitä ennen kuitenkin pitää saada NUnit päivittymään. Sen saa tehtyä seuraavasti:

Ennen kuin ajat testejä ensimmäistä kertaa lisää solutioniisi yksi NUnit-testi:

  • solutionin nimen päällä hiiren oikeata
  • Add New Project...
  • Other/.NET/NUnit/Nunit Library Project
  • anna joku nimi projektille
  • sitten Build/Build All
  • tämän jälkeen voit tuhota tämän NUNit-projektin

1.4 Pikanäppäin ComTestille

Voit tehdä ComTestille pikanäppäimen, jolloin sitä ei tarvitse erikseen hakea menusta:

  • Tools/Options/KeyBindings (Mac: Xamarin Studio/Preferences/Key Bindings)
  • etsi ComTest kirjoittamalla se suurennuslasin kohdalle
  • valitse ComTest Solution
  • valitse kohta Edit Binding
  • paina siinä haluaamsi näppäinyhdistelmää ja Apply

Jos haluat ComTestin jollekin varatulle näppäimelle, kuten Ctrl-Q, niin poista tälle tehty liitos (binding). Esim. Qtrl-Q on Quit. Etsi ensin Quit ja sitten sen Edit Binding kohdasta pyyhi pikanäppäin pois ja Apply.

1.5 Pohja uudelle testille

Pluginissa ei ole vielä valmista pohjaa uudelle testille, mutta sellaisen saa lisättyä itse.

  1. Valitse valikosta Edit/Preferences (tai voi olla myös Tools/Options)
  2. Avaa välilehti Text editor / Code templates

  1. Lisää uusi koodipohja (Add) jolloin aukeaa uusi ikkuna. Syötä ikkunaan seuraavat tiedot:

Voit kopioida koodipohjan tästä:

/// <example>
/// <pre name="test">
/// $selected$$end$
/// </pre>
/// </example>
  1. Sulje molemmat ikkunat ok-painikkeella ja olet valmis!

Nyt testin lisääminen on helppoa. Siirrä kursori riville ennen testattavaa metodia

kirjoita comt

ja paina kaksi kertaa TAB-näppäintä, niin saat valmiin pohjan testille.

Kursorikin on jo valmiiksi oikeassa kohdassa, joten voit alkaa samantien kirjoittaa testiä.

Jos jatkossa huomaat käyttäväsi tätä aina riviltä, jossa on

///

rivin alussa, niin voit tempaltesta poistaa tuon ensimmäisen /// jottei se tule 2x. Samoin jos tuntuu siltä että käytätä tuota aina kun summary on kirjoitettu, voit poista senkin lohkon.

2. Käyttö

Alla miten pitäisi toimia, tämä ei kuitenkaan toimi kunnolla Xamarin/Monodevelop? 5.10.x -versioissa, joten tämän alla tilapäiset käyttöohjeet

  1. Kirjoita C#- tiedostoosi ComTest C# mukaisia testejä
  2. Muista tallettaa ensin testattava tiedostosi ennen testaamista
  3. Run -> ComTest -> ComTest Solution (tai kohdassa 1.4 tekemäsi pikanäppäin}}}
    • Tämä kääntää solutionissa olevat ComTest-testit NUnit-testeiksi
  4. Oikeassa reunassa näkyy "Unit Tests" -paneeli, josta testit saa ajettua (Run all).
  5. Aina kun muutat testejäsi, toista kohdat sekä 2-4. Jos muutat pelkkää ohjelmakoodia (et ComTest testejä), riittää kohdat 2. ja 4. uudelleen testaamiseen.

Tilapäiset ohjeet 5.10.x versioille (seuraavassa voi korvata myös sanana Xamarin sanalla MonoDevelop)

  1. Kirjoita C#- tiedostoosi ComTest C# mukaisia testejä
  2. Muista tallettaa ensin testattava tiedostosi ennen testaamista
  3. Run -> ComTest -> ComTest Solution (tai kohdassa 1.4 tekemäsi pikanäppäin}}}
    • Tämä kääntää solutionissa olevat ComTest-testit NUnit-testeiksi
    • tässä kohti yleensä Xamarin kaatuu ja sammuu.
  4. Käynnistä Xamarin uudelleen
  5. Pitäisi olla syntynyt projekti, jonka nimi päättyy Test
  6. Sen references kohdasta puuttuu NUnit, lisää se:
    • mene projektin päälle
    • Run/ComTest/Add NUnit dll reference
  7. Tämä jälkeen oikeassa reunassa pitäisi olla Unit Test ja siellä projektisi testit. Paina sieltä Run All
  8. Katso tulokset ja toimi niidne mukaan.
  9. Kun teet muutoksia alkuperäiseen tiedostoon, niin mikäli et muuta testejä, riittää testien ajamiseksi painaa tuota Run All
  1. Mikäli muutat ComTest-testejä (muutat olemassa olevia tai kirjoitat uusia

funktioita joita testataan), niin silloin tee aina:

Run/ComTest/Run ComTest.jar

  1. Tämä generoi uudelleen testitiedoston ja sen jälkeen paina Run All
  2. Mikäli Nunit refrenssi häviää, lisää se uudelleen kuten kohdassa 6.
  3. Tarvittaessa jatka kohdasta 9.
  4. Uuden projektin tapauksessa jatka kohdasta 1.

Attachments