Kehitystyökalujen asentaminen

Näillä ohjeilla asennetaan

• Visual Studio 2015 Community
• XNA ja
• Jypeli.

Tällä sivulla olevat ohjeet toimivat Windowsin versioille 10 ja 8.1. Myös Windows 7 toimii jos Service Pack 1 tai uudempi on asennettuna.

Mac OS X- ja Linux -käyttäjille on omat versiot kehitystyökaluista.

Vanhempiin Windowseihin asenna jokin muu VS:n versio.

VS 2017 katso erilliset ohjeet

Microsoft Live -tunnus

Tee Microsoftin Live -tunnukset, ellei sinulla jo ole niitä (Windows Phonessa, Hotmail, tms.). Tunnareita tarvitaan Visual Studion asentamisvaiheessa. Tosin asennuksen voi tehdä niin, että tilapäisesti ohittaa tunnuskysymyksen. On kuitenkin suositeltavaa tehdä ko. tunnukset.

Visual Studio 2015

Visual Studion lataamista ja asennusta varten kannattaa varata runsaasti aikaa. Kannattaa siis varautua tähän ja asettaa esimerkiksi tietokoneen automaattinen lepotila pois päältä.

Lataa ja asenna Visual Studio 2015 Community Edition. Asennus kestää helposti useita tunteja. Et voi edetä tässä ohjeessa ennenkuin asennus on valmis. Toki voit tehdä koneella muuta samaan aikaan. Kannattaa ottaa Custom-asennus ja ruksia pois kaikki vaihtoehdot, niin asennus hieman nopeutuu ja vie vähemmän tilaa.

XNA

Lataa XNA Refresh for Visual Studio 2015

• Tämä on .zip-tiedosto, pura se kansioon jossa sinulla on suoritusoikeudet.
• Klikkaa asenna.bat ja vastaile myöntävästi kaikkiin kysymyksiin.
• Lopussa varmista että Visual Studio 2015 Community Edition on valittuna.

Jos yo. ohje ei toimi, asenna osat manuaalisesti käsin seuraavassa järjestyksessä (huomaa, että KAIKKI 5 kohtaa pitää tehdä):

• 1. DirectX\DXSETUP.exe
• 2. XNA Framework 4.0 Redistribution\XNA Framework 4.0 Redist.msi
• 3. XNA Game Studio 4.0 Platform Tools\XNA Game Studio Platform Tools.msi
• 4. XNA Game Studio 4.0 Shared\XNA Game Studio Shared.msi
• 5. XNA Game Studio 4.0.vsix (jos koneellasi on vain yksi käyttäjä) TAI XNA Game Studio 4.0 ALL.vsix (jos konetta käyttää useampi käyttäjä ja haluat asentaa kaikille)

HUOM! Kaikki nuo ylläolevat viisi kohtaa täytyy käydä läpi, ja viidennessä kohdassa valita mahdollisista vaihtoehdoista VS 2015.

Mikäli Jypeli näyttää asentuneen, projektin voi tehdä ja projektin voi ajaa, mutta tulee virheilmoitus:

"There is missing project subtype.
Subtype: '{6D335F3A-9D43-41b4-9D22-F6F17C4BE596}' is unsupported
by this installation."

niin kohdan 5 tekeminen ei ole onnistunut oikein.

Jypeli

Lataa ja asenna Jypeli.

• Ota pois turhat ruksit Project templates for Visual Studio 2010-2013 ja jätä vain Project templates for Visual Studio 2015 Community Edition. kuva
• Windows 8/8.1 saattaa estää asennuksen ja näyttää seuraavan virheilmoituksen kun suorittaa asennusohjelman: virheilmoitus
• Tästä ei tarvitse välittää: paina More info (suomeksi lisää tietoja?) ja sitten Run anyway kuva.

Mahdollisia ongelmia

Peli-ikkuna väärässä kohdassa ruutua

Korkean resoluution näytöillä Jypelin peli-ikkuna karkaa ohi vasemmasta yläreunasta. Valitettavasti tämä on tavallaan ratkaisematon ongelma ja vaatii Windowsin skaalaus-asetuksen muuttamisen.

Ratkaisu / workaround:

• mene desktopille windowsissa
• hiiren oikea
• display settings
• skaalaus 100%:iin (se kohta missä lukee jotain tekstin ym. suurentamiseen liittyvää)

Projektimallit

Alla olevat kohdat pitäisi tulla automaattisesti Jypelin asennuksen yhteydessä. Mikäli jonkin ajan odottelun jälkeenkään Visual Studiosta ei näitä projektimalleja löydy (File \(\rightarrow\) New project \(\rightarrow\) C# \(\rightarrow\) Jypeli) niin tee allaolevat kohdat itse käsin:

Lataa Jypelin projektimallit

• Jokaisen .zip-tiedoston kohdalla klikkaa hiiren oikeaa, ja Save link as
• Talleta tiedosto allaolevaan hakemistoon (jos hakemisto Jypeli puuttuu, tee se ensin)
• Suomenkielisessä Windowsissa

C:\Käyttäjät\kayttajanimi\Tiedostot\Visual Studio 2015\Templates\ProjectTemplates\Visual C#\Jypeli

• Englanninkielisessä Windowsissa

C:\users\kayttajanimi\Documents\Visual Studio 2015\Templates\ProjectTemplates\Visual C#\Jypeli

Käyttö

• ks: Visual Studio, käyttö

Lisätietoa kiinnostuneille

Kurssin tarpeita varten riittää siis Visual Studio 2015 Community-versio, mutta jos haluat enemmän ominaisuuksia (ja ongelmia :-), niin voit DreamSpark Premiumista ottaa Professional tai ''Ultimate''. Vertaile versioita. Dreamspark Premiumiin tunnarit saa näiden ohjeiden mukaan: DreamSpark Premium

Asennuksessa havaittuja ongelmia

Aluksi tarkista

Kun valitse että File/New Project niin siellä pitäisi näkyä Visual C#-kohdan alla Jypeli ja XNA Game Studio 4.0. Mikäli XNA:ta ei näy, niin

• yleisin syy on että edellä XNA kohdassa ei ole kaikkia VIITTÄ kohtaa ajettu huolella läpi. Aja ne uudelleen käsin.
  Ja erityisesti kohta 5.
  
• jossain tilanteessa XNA-"lisuke" on asentunut, mutta jotenkin onistunut menemään pois päältä. Tätä voi katsoa:
  • Tools/Extension and Updates...
  • jos siellä viimeisenä on XNA Game Studio 4.0 niin valitse se ja jos siinä on Enable-painike, paina sitä.
  • Voit kokeille myös Unisntall ja sitten tee em. kohdan 5 uudelleen.
• yleensä vähintään Visual Studio pitää käynnistää muutosten jälkeen uudelleen, joskus bootata koko kone (kun se on Windows..)

Jos .vsix tiedostojen ajaminen ei onnistu

Jos

XNA Game Studio 4.0.vsix

tai

ComTestCSPlugin.vsix

ajo kaatuu, niin voi yrittää seuraavaa:

• luo hakemisto c:\MyTemp\temp
• kirjoita komentoriviltä Control
• ota System/Advanced System Settings/Advanced/Environment Variables
• vaihda muuttujien TEMP ja TMP arvoksi tuo c:\MyTemp\temp

Sitten kokeile uudelleen klikata vsix-tiedostoja.

Jos valittaa ettei ole oikeutta käyttää rekisteriä

Jos tulee virheilmoitus:

Visual Studio does not have permissions to read the 
template information from the system registry. 
This is often caused by registry permission problems

Ohjeen lähde

• jos uskallat, lataa
  http://www.softpedia.com/get/Security/Security-Related/Security-Restore.shtml
• pura ja aja se ylimmässä hakemistossa oleva tiedosto.
• tämä auttaa, mutta ko sovellus on "tuntemattomasta lähteestä" ja 100% varmaa ei tietenkään ole etteikö se voisi olla Troijan hevonenkin...