Kehitystyökalujen asentaminen (XNA)

HUOM! Alla olevat ohjeet ovat hyvin vanhat eikä niitä tulisi enää käyttää.

Asenna ensisijaisesti MonoJypeli-työkalut!

HUOM! Asenna alla olevat työkalut vain mikäli MonoJypeli-työkalut eivät toimi.

1. Windows

Näillä ohjeilla asennetaan (huomaa että alla olevat on tehtävä järjestyksessä):

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.

2. MacOS ja Linux

MacOS- ja Linux -käyttäjille on omat versiot kehitystyökaluista.

3. Microsoft-tili

Luo itsellesi Microsoft-tili, ellet ole jo luonut (Hotmail, Outlook ja entinen Microsoft Live käy myös). Tunnareita tarvitaan Visual Studion asentamisvaiheessa. Asennuksessa tunnuksen syöttämisen voi tilapäisesti ohittaa, mutta on kuitenkin suositeltavaa tehdä ko. tunnukset, sillä VS lakkaa muuten toimimasta 30 päivän käytön jälkeen.

Voit käyttää myös yliopiston Office 365 -tunnuksia, joiden tekemiseen on ohjeet kun laajennat tämän kappaleen:

# visual-studio

4. Visual Studio 2017

Lataa ja asenna Visual Studio 2017 Community Edition.

Varaa lataamiseen ja asentamiseen aikaa, sillä se voi kestää. Et voi edetä tässä ohjeessa ennen kuin Visual Studion asennus on valmis. Kannattaa ottaa Custom-asennus ja poistaa muut valinnat paitsi ".NET desktop development". Tällöin asennus hieman nopeutuu ja vie vähemmän tilaa.

Ko. linkki ei tunnu enää olevan voimassa. Visual Studio 2019 löytyy ladattavaksi, mutta sen jälkeen kaikki loput asennusohjeet eivät enää päde. Miten eteenpäin?

VL Tein tuosta XNA:sta VS2019 version:

https://svn.cc.jyu.fi/srv/svn/ohj1/tyokalut/xnavs2019/xnavs2019.zip

saahan sitä kokeilla, mutta ainakaan itse en ole saanut yhtään toimivaa projektin VS2019:sta :-(



VL: laitoin tuonne VS2017 asennuspaketin, voihan silläkin kokeilla:

https://kurssit.it.jyu.fi/ITKP102/tyokalut/

VL: mutta mene pääasiassa asentamaan MonoGamen ohjeilla:

https://tim.jyu.fi/view/kurssit/tie/ohj1/tyokalut/kehitystyokalut-windows

— 03 Jun 19 (edited 04 Jun 19)

Jonkun käyttäjän kokemuksilla seuraavat asentuvat paremmin jos asennukset tehdään admin-käyttäjänä tai vähintään käyttäjällä on admin oikeudet. Kommentoi tähän jos sinulla on toisenlaisia kokemuksia.

Käynnistä Visual Studio 2017 ja kokeile että se toimii. Jos sinulla on MS-tunnukset, kirjaannu niillä sisään. Muuten voit tilapäisesti ohittaa kirjaantumispyynnön.

Ota File/New/Project ja katso että löytyy kohta jossa lukee tarkalleen Visual C#. Jos tällaista ei löydy, teit mahdollisesti jotain väärin tämän ohjeen edellisessä kohdassa.

Kun asennus onnistui, sammuta Visual Studio ja etene seuraavaan vaiheeseen.

Jos Visual Studio valittaa lisenssin puutteesta käynnistyksen yhteydessä

# xna

5. XNA

XNA asentui tokalla kerralla normaalisti. Ja kun Visuaaliin menee, ei siellä ole "VIsual C#" vaihtoehtoa, vaan "SharpC". SharpC:n sisältä löytyy kyllä XNA Game Studio 4.0, mutta sen sisältä ei taas löydy Windows Gamea. Mikä's tässä nyt oikeen meni vikaan :C?
VL: olet ruksinut kaikki asennusvaihtoehdot pois Visual studiota asentaessa.

— 06 Sep 17 (edited 13 Sep 17)

Täällä herjaa myös. Your installation of XNA Game Studio does not support this project (XNA Platform = 'Windows', XNA Framework Version = 'v4.0'). WindowsGame. VL: Et ole tehnyt XNA asennusta Adminina ja silloin se ei ole saanut tehdä sitä asenna.batin lopussa olevaan kopiointia. Kotso kohdasta "Jos asennus ei onnistunut" ja tee se xcopy-rivi admin käyttäjänä (Järjestelmän valvojana) käsin. Asennus on kyllä tehty järjstelmävalvojana..

— 12 Sep 17 (edited 13 Sep 17)

Lataa XNA Refresh for Visual Studio 2017

  • Tämä on .zip-tiedosto, pura se kansioon jossa sinulla on suoritusoikeudet.
  • Puretussa hakemistossa klikkaa hiiren oikealla asenna.bat, valitse Run as Administrator (tai suomeksiSuorita järjestelmän valvojana)
  • voi olla että virusohjelmat varoittavat, silloin pitää vaan jatkaa ajamista tai poistaa virustorjunta hetkeksi käytöstä
  • vastaile myöntävästi kaikkiin kysymyksiin.
  • Lopussa varmista että Visual Studio 2017 Community Edition on valittuna.
  • katso että lukee 11 files copied
  • tämän jälkeen voi valittaa ettei ole yhteensopiva, mutta siitä ei tarvitse välittää

Tämähän ei siis toimi jos ei ole asennettu C: levylle VS! (bat tiedosto)

— 18 Sep 17 (edited 18 Sep 17)

Jos em. asennus ei onnistunut

Mulla teki tota samaa et oli muka asennettu xna vs_n mukaan mutta siltikään ei toiminut. Ongelmana oli se että olin asentanut vs custom sijaintiin jolloin myös kopioitavat xna tiedostot piti kopioida custom sijaintiin, minun tapauksessani D:

— 14 Sep 17

Kokeile että XNA asentui oikein:

  1. käynnistä VS2017
  2. Ota File/New/Project...
  3. Valitse Installed/Visual C#/XNA Game Studio 4.0
  4. Valitse Windows Game(4.0)
  5. Vaihda tarvittaessa location johonkin tilapäiseen paikkaan.
  6. OK
  7. Odota että projekti lataantuu ja mikä lataantuu, niin aja ohjelma Ctrl-F5
  8. Jos tulee sininen tyhjä pelialue, niin XNA-asennus on onnistunut
# pipeline

Severity Code Description Project File Line Suppression State Error CS0246 The type or namespace name 'Jypeli' could not be found (are you missing a using directive or an assembly reference?)

— 18 Oct 17

Jos saat virheen Error loading pipeline assembly "C:\Program Files (x86)\Reference Assemblies\...\Microsoft.Build.Framework.dll" ajaessa ohjelmaa, klikkaa tästä ja lue lisäohjeita

Jos saat virheen:

Your installation of XNA Game Studio does not support this project (XNA Platform = 'Windows',...)

tai XNA ei näy palaa kohtaan "Jos em. asennus ei onnistunut" (tarvittaessa valitse Repair jos on jossakin sellainen vaihtoehto).

6. Jypeli

VL: Jos asennus tehty ennen 16.9, niin kannattaa asentaa uudelleen.

— 16 Sep 17 (edited 16 Sep 17)
  • videolla kaatui tähden keräämisääneen, mutta kun kokeilin ilman nauhoituista ja käynnistin Visual Studion uudelleen, sama projekti toimi moitteetta

Lataa ja asenna Jypeli.

  • Ota pois turhat ruksit Project templates for Visual Studio 2010-2015 mutta jätä VS 2017

Kokeile että toimii:

  1. käynnistä VS2017
  2. Ota File/New/Project...
  3. Valitse Installed/Visual C#/Jypeli
  4. Valitse Fysiikka peli
  5. Vaihdat tarvittaessa location johonkin tilapäiseen paikkaan.
  6. OK
  7. Odota että projekti lataantuu ja mikä lataantuu, niin aja ohjelma Ctrl-F5
  8. Jos tulee sininen tyhjä pelialue, niin Jypeli-asennus on onnistunut :-)
  9. Pääset "pelistä" pois ESC-painikkeella.
  10. Kokeile vielä uudestaan kohdasta 2, mutta ota kohdassa 4 Tasohyppelypeli.

Jos tätä ajaessa tulee virhe Error loading pipeline assembly, niin katso korjaus edellä XNA-kohdan lopussa.

Ongelma: There is missing project subtype

The type or namespace name ´Jypeli´ could not be found. Antaa tuollaisen virheen kun koittaa debugata fysiikkapeliä

— 18 Oct 17

Ongelma: Jos projektimallit eivät asentuneet, voit asentaa ne käsin

7. Mahdollisia ongelmia

7.1 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ää)

VL: Tämä korjaantuneen 16.9 tai uudemman version asennuksella.

— 16 Sep 17

Jos tulee virhe:

Could not load type 'Microsoft.Build.Framework.SdkReference' from assembly
'Microsoft.Build.Framework, Version=15.1.0.0, Culture=neutral,
PublicKeyToken=b03f5f7f11d50a3a'.
  • Katso ohjeita stackoverflow:sta mutta vaihda sanana "enterprise" tilalle "Community"

8. Käyttö

9. Asennuksessa havaittuja ongelmia

9.1 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 onnistunut 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. XNA-kohta 5 uudelleen.
  • yleensä vähintään Visual Studio pitää käynnistää muutosten jälkeen uudelleen, joskus bootata koko kone (kun se on Windows..)

Ei näy tuo Visual C#
VL: sulla on ollut ruksittuna kaikki pois Visual studiota asentaessa.

— 09 Sep 17 (edited 13 Sep 17)

9.2 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.

9.3 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

Linkkejä:

These are the current permissions for this document; please modify if needed. You can always modify these permissions from the manage page.